Direct Resolution
The error Error: Cannot connect to detaspace service typically indicates a network-level failure or an authentication mismatch between the migration tool and the target API endpoint. Because this occurs during the connection phase, the migration has not yet begun moving data, meaning your source environment remains the single source of truth.
Likely Causes vs. Confirmed Facts
While the specific internal logs of the detaspace service are unavailable, the following distinctions apply to this error state:
- Likely Causes: Incorrect API keys, firewall restrictions blocking the migration tool's outbound traffic, or a temporary service outage at the target endpoint.
- Confirmed Facts: The connection failure happens before data transmission. Therefore, no partial data has been written to the target, and no data has been deleted from the source.
Recommended Migration Sequence
To achieve a transition with minimal interruption for small applications, follow this staged approach rather than a single-step migration:
- Connectivity Validation: Verify the API endpoint is reachable via a simple
curl or ping request from the machine running the migration tool.
- Dry Run: Execute the migration tool with a
--dry-run or --validate flag (if supported) to confirm credentials without initiating data transfer.
- Read-Only Migration: Perform an initial data sync while the application is still live. This populates the target environment without affecting the source.
- Maintenance Window (Cutover): Set the source application to read-only mode, perform a final delta sync to capture recent changes, and update your DNS or load balancer to point to detaspace.
Ensuring Data Consistency
If a connection error occurs mid-migration, consistency is maintained by avoiding "in-place" updates. Use a shadow migration strategy: migrate data to a new, isolated space. Only once the migration is verified as complete and consistent should you switch the application traffic to the new environment. If the tool supports it, enable transaction-based uploads to ensure that partial batches are rolled back on the target side.
Missing Diagnostic Detail
To provide a more specific network fix, please clarify: Is the migration tool being run from a local machine or a CI/CD pipeline (e.g., GitHub Actions, GitLab CI)?