wodby migrate wodby1 app
Plan or run a resumable Wodby 1 application migration
Migrate one Wodby 1 application through plan, prepare, sync-data, finalize, and verify. Reuse the same Wodby 1 token, Wodby 2 API key, mapping options, plan path, and state path for every phase. Before sync-data, enable maintenance mode and create a fresh backup in Wodby 1. Update DNS only after sync-data succeeds and before finalize. If a target mutation is ambiguous, inspect Wodby 2 and pass --retry-ambiguous only with the exact operation ID printed by the command.
Usage
wodby migrate wodby1 app SOURCE_APP_UUID [flags]
Examples
wodby migrate wodby1 app APP_UUID --phase plan [target and mapping options]
wodby migrate wodby1 app APP_UUID --phase prepare --approve-plan PLAN_HASH [same options]
wodby migrate wodby1 app APP_UUID --phase sync-data --approve-plan PLAN_HASH [same options]
wodby migrate wodby1 app APP_UUID --phase finalize --approve-plan PLAN_HASH [same options]
wodby migrate wodby1 app APP_UUID --phase verify --approve-plan PLAN_HASH [same options]
Options
| Flag | Description | Default |
|---|---|---|
--approve-plan string |
Exact reviewed plan hash required by mutation phases | - |
-h, --help |
help for app | false |
--max-backup-age duration |
Maximum backup age accepted by sync-data | 1h0m0s |
-o, --output string |
Output format: text or json | text |
--phase string |
Migration phase: plan, prepare, sync-data, finalize, or verify | plan |
--plan-file string |
Plan JSON path (defaults beside the current working directory) | - |
--poll-interval duration |
Target operation polling interval | 2s |
--retry-ambiguous string |
Retry exactly one inspected ambiguous operation ID | - |
--skip-code |
Intentionally omit repository/build-source migration | false |
--skip-data |
Intentionally omit database and files imports | false |
--source-base-url string |
Wodby 1 API base URL | https://api.wodby.com |
--source-token string |
Wodby 1 API token (defaults to WODBY1_SOURCE_TOKEN) | - |
--state-file string |
Secure resume-state path (defaults beside the plan) | - |
--target-ci-integration-id int |
Wodby 2 Git integration ID | 0 |
--target-cluster string |
Wodby 2 cluster ID or exact name | - |
--target-code-service string |
Target connect-build service name when the stack has more than one | - |
--target-env-map stringArray |
Source-to-target environment mapping (SOURCE=TARGET) | [] |
--target-git-ref string |
Git branch, tag, or commit to build (defaults to the source ref) | - |
--target-git-ref-type string |
Git ref type: branch, tag, or commit | - |
--target-import-map stringArray |
Backup-to-import mapping ([INSTANCE/]COMPONENT=SERVICE:IMPORT) | [] |
--target-org string |
Wodby 2 organization ID or exact name | - |
--target-project string |
Wodby 2 project ID or exact name | - |
--target-remote-git-repo-id string |
Repository ID in the selected Wodby 2 Git integration | - |
--target-service-map stringArray |
Source-to-target service mapping ([INSTANCE/]SOURCE=TARGET) | [] |
--target-stack-map stringArray |
Source-to-target stack mapping ([INSTANCE/]SOURCE=TARGET) | [] |
--wait-timeout duration |
Timeout for each target operation | 30m0s |
Options inherited from parent commands
| Flag | Description | Default |
|---|---|---|
--access-token string |
Access token | - |
--api-base-url string |
Public REST API base URL | https://apiv2.wodby.com/v1 |
--api-key string |
API key | - |
--ci-config-path string |
Path to CI config | /tmp/.wodby-ci.json |
--verbose |
Verbose output | false |