The Nextmv CLI has evolved to better serve our users with enhanced functionality, improved installation options, and a more modern interface. This new CLI is based on the major version (v1) release of our nextmv Python SDK, which introduces significant improvements alongside necessary breaking changes.
The new CLI maintains similar functionality to the old version while improving the command structure and user experience. Most commands have direct equivalents, though some have been reorganized for better clarity.
While we understand that migrating isn't easy, we believe the benefits far outweigh the challenges. We will continue to support the old CLI on a case-by-case basis but it will not receive updates or new features moving forward. We will sunset the old CLI entirely in the future.
Please don't hesitate to contact us if you need help.
- Major version release: This CLI is built on our Python SDK v1, a major version release that brings significant new functionality including shadow testing, switchback experiments, and complete CRUD operations (create, read, update, delete) for all platform resources.
- Feature parity & enhanced functionality: The new CLI builds upon our Python SDK, offering all the capabilities of the previous version plus additional features and improved performance. New capabilities include enhanced experiment management and user-friendly prompting.
- Multiple installation options: By distributing through PyPI, we've made it easier for enterprise customers with strict security policies to install and manage the CLI using their preferred Python package manager.
- Modern user experience: The new CLI features an enhanced interface with better help documentation, improved error messages, and a more intuitive command structure.
- Better maintenance: Consolidating our CLI with the Python SDK allows for faster feature development and more consistent behavior across our tools.
You should consider the new CLI as a different tool from the old one. This means that it introduces breaking changes in several places. We recommend that you review the new commands and update any scripts or workflows that depend on the old CLI accordingly.
This migration guide is grouped into sections, based on the feature being migrated. Each section contains a table mapping old commands to their new equivalents and where applicable, a table with the new functionality added in this latest CLI. The last sections are dedicated to entirely new features that did not exist in the old CLI.
The best way to migrate is to get the help for a command, read the description, and see the available options. You can do this by running nextmv <COMMAND> -h.
| Old command | New command | Notes |
|---|
nextmv completion | nextmv --install-completion/--show-completion | Changed to use options instead of subcommands. |
nextmv configure | nextmv configuration create | Added the delete and list subcommands to configuration as well. |
nextmv help | nextmv --help/-h | The core help command is changed to only use the options. |
nextmv release-notes | N/A | See the release notes in the nextmv-py GitHub repo directly. |
nextmv update | N/A | Use your package manager to update the CLI. |
nextmv version | nextmv version or nextmv --version | No changes. |
| Old command | New command | Notes |
|---|
nextmv account create | nextmv cloud account create | Account management moved under cloud. |
nextmv account delete | nextmv cloud account delete | Account management moved under cloud. |
nextmv account get | nextmv cloud account get | Account management moved under cloud. |
nextmv account queue | nextmv cloud run list | Queue functionality moved to cloud runs. Use --status to filter on a particular run status, e.g. queued. |
nextmv account update | nextmv cloud account update | Account management moved under cloud. |
nextmv account sso | nextmv cloud sso | SSO management moved under cloud. |
| Old command | New command | Notes |
|---|
nextmv account sso configure | nextmv cloud sso configure | SSO account management from app to cloud sso. |
nextmv account sso delete | nextmv cloud sso delete | SSO account management from app to cloud sso. |
nextmv account sso disable | nextmv cloud sso disable | SSO account management from app to cloud sso. |
nextmv account sso enable | nextmv cloud sso enable | SSO account management from app to cloud sso. |
nextmv account sso get | nextmv cloud sso get | SSO account management from app to cloud sso. |
| Old command | New command | Notes |
|---|
nextmv app create | nextmv cloud app create | Application management moved under cloud. |
nextmv app delete | nextmv cloud app delete | Application management moved under cloud. |
nextmv app get | nextmv cloud app get | Application management moved under cloud. |
nextmv app list | nextmv cloud app list | Application management moved under cloud. |
nextmv app promote | nextmv cloud app push | "Promotion" happens after pushing. The nextmv cloud app push command will prompt users or allow them to use options. |
nextmv app push | nextmv cloud app push | Application management moved under cloud. |
nextmv app update | nextmv cloud app update | Application management moved under cloud. |
✨ New commands added for application management.
| ✨ New command | Notes |
|---|
nextmv cloud app exists | Tells you if an application with the given ID exists. |
nextmv cloud data upload | Upload data for Nextmv Cloud app components. |
nextmv cloud upload create | Create temporary upload URLs for Nextmv Cloud applications. |
| Old command | New command | Notes |
|---|
nextmv app instance create | nextmv cloud instance create | Instance management moved from app to cloud instance. |
nextmv app instance delete | nextmv cloud instance delete | Instance management moved from app to cloud instance. |
nextmv app instance get | nextmv cloud instance get | Instance management moved from app to cloud instance. |
nextmv app instance list | nextmv cloud instance list | Instance management moved from app to cloud instance. |
nextmv app instance update | nextmv cloud instance update | Instance management moved from app to cloud instance. |
✨ New commands added for instance management.
| ✨ New command | Notes |
|---|
nextmv cloud instance exists | Tells you if an instance with the given ID exists. |
| Old command | New command | Notes |
|---|
nextmv app version create | nextmv cloud app version create | Version management moved from app to cloud version. |
nextmv app version delete | nextmv cloud app version delete | Version management moved from app to cloud version. |
nextmv app version get | nextmv cloud app version get | Version management moved from app to cloud version. |
nextmv app version list | nextmv cloud app version list | Version management moved from app to cloud version. |
nextmv app version update | nextmv cloud app version update | Version management moved from app to cloud version. |
✨ New commands added for version management.
| ✨ New command | Notes |
|---|
nextmv cloud version exists | Tells you if an version with the given ID exists. |
| Old command | New command | Notes |
|---|
nextmv app cancel | nextmv cloud run cancel | Run management moved from app to cloud run. |
nextmv app input | nextmv cloud run input | Run management moved from app to cloud run. |
nextmv app logs | nextmv cloud run logs | Run management moved from app to cloud run. |
nextmv app metadata | nextmv cloud run metadata | Run management moved from app to cloud run. |
nextmv app output | nextmv cloud run get | The output (result) of the run can be fetched from getting the run directly. |
nextmv app result | nextmv cloud run get | The result of the run can be fetched from getting the run directly. |
nextmv app run | nextmv cloud run create | Run management moved from app to cloud run. |
nextmv app status | nextmv cloud run metadata | You can get the status from the metadata. |
nextmv app tail | nextmv cloud run logs --tail | Consolidated logs fetching and tailing in a single command. |
✨ New commands added for run management.
| ✨ New command | Notes |
|---|
nextmv cloud run list | Lists all the runs in an app. |
nextmv cloud run track | Track an external run in an app. |
| Old command | New command | Notes |
|---|
nextmv community clone | nextmv community clone | No changes. |
nextmv community list | nextmv community list | No changes. |
| Old command | New command | Notes |
|---|
nextmv experiment acceptance delete | nextmv cloud acceptance delete | Acceptance test management moved from experiment to cloud acceptance. |
nextmv experiment acceptance init | nextmv cloud acceptance create | You don't initialize and start separately anymore. Use create to create and run an acceptance test. |
nextmv experiment acceptance start | nextmv cloud acceptance start | Acceptance test management moved from experiment to cloud acceptance. |
✨ New commands added for acceptance test management.
| ✨ New command | Notes |
|---|
nextmv cloud acceptance get | Get details and the result of an acceptance test. |
nextmv cloud acceptance list | List all acceptance tests for an application. |
nextmv cloud acceptance update | Update an acceptance test. |
| Old command | New command | Notes |
|---|
nextmv experiment batch delete | nextmv cloud batch delete | Batch experiment management moved from experiment to cloud batch. |
nextmv experiment batch result | nextmv cloud batch get | Batch experiment management moved from experiment to cloud batch. |
nextmv experiment batch start | nextmv cloud batch create | Batch experiment management moved from experiment to cloud batch. |
✨ New commands added for batch experiment management.
| ✨ New command | Notes |
|---|
nextmv cloud batch list | List all batch experiments for an application. |
nextmv cloud batch metadata | Get the metadata of a batch experiment. |
nextmv cloud batch update | Update a batch experiment. |
| Old command | New command | Notes |
|---|
nextmv experiment input create | nextmv cloud managed-input create | Managed inputs handling moved from experiment to cloud managed-input. |
nextmv experiment input get | nextmv cloud managed-input get | Managed inputs handling moved from experiment to cloud managed-input. |
nextmv experiment input list | nextmv cloud managed-input list | Managed inputs handling moved from experiment to cloud managed-input. |
nextmv experiment input update | nextmv cloud managed-input update | Managed inputs handling moved from experiment to cloud managed-input. |
✨ New commands added for managed inputs handling.
| ✨ New command | Notes |
|---|
nextmv cloud managed-input delete | Delete a managed input. |
| Old command | New command | Notes |
|---|
nextmv experiment input-set create | nextmv cloud input-set create | Input set management moved from experiment to cloud input-set. |
nextmv experiment input-set get | nextmv cloud input-set get | Input set management moved from experiment to cloud input-set. |
nextmv experiment input-set list | nextmv cloud input-set list | Input set management moved from experiment to cloud input-set. |
nextmv experiment input-set update | nextmv cloud input-set update | Input set management moved from experiment to cloud input-set. |
✨ New commands added for input set management.
| ✨ New command | Notes |
|---|
nextmv cloud input-set delete | Delete an input set. |
| Old command | New command | Notes |
|---|
nextmv experiment shadow create | nextmv cloud shadow create | Shadow test management moved from experiment to cloud shadow. |
nextmv experiment shadow list | nextmv cloud shadow list | Shadow test management moved from experiment to cloud shadow. |
nextmv experiment shadow result | nextmv cloud shadow get | Shadow test management moved from experiment to cloud shadow. |
nextmv experiment shadow runs | nextmv cloud shadow get | Runs and result are both returned in the nextmv cloud shadow get command. |
nextmv experiment shadow start | nextmv cloud shadow start | Shadow test management moved from experiment to cloud shadow. |
nextmv experiment shadow stop | nextmv cloud shadow stop | Shadow test management moved from experiment to cloud shadow. |
✨ New commands added for shadow test management.
| ✨ New command | Notes |
|---|
nextmv cloud shadow delete | Delete a shadow test. |
nextmv cloud shadow metadata | Get metadata of a shadow test. |
nextmv cloud shadow update | Update a shadow test. |
✨ This feature is new to the CLI.
| ✨ New command | Notes |
|---|
nextmv cloud ensemble create | Create an ensemble definition. |
nextmv cloud ensemble delete | Delete an ensemble definition. |
nextmv cloud ensemble get | Get details of an ensemble definition. |
nextmv cloud ensemble list | List all ensemble definitions for an application. |
nextmv cloud ensemble update | Update an ensemble definition. |
✨ This feature is new to the CLI.
| ✨ New command | Notes |
|---|
nextmv cloud scenario create | Create a scenario test. |
nextmv cloud scenario delete | Delete a scenario test. |
nextmv cloud scenario get | Get details of a scenario test. |
nextmv cloud scenario list | List all scenario tests for an application. |
nextmv cloud scenario metadata | Get metadata of a scenario test. |
nextmv cloud scenario update | Update a scenario test. |
✨ This feature is new to the CLI.
| ✨ New command | Notes |
|---|
nextmv cloud secrets create | Create a secrets collection. |
nextmv cloud secrets delete | Delete a secrets collection. |
nextmv cloud secrets get | Get details of a secrets collection. |
nextmv cloud secrets list | List all secrets collections for an application. |
nextmv cloud secrets update | Update a secrets collection. |
✨ This feature is new to the CLI.
| ✨ New command | Notes |
|---|
nextmv cloud switchback create | Create a switchback test. |
nextmv cloud switchback delete | Delete a switchback test. |
nextmv cloud switchback get | Get details of a switchback test. |
nextmv cloud switchback list | List all switchback tests for an application. |
nextmv cloud switchback metadata | Get metadata of a switchback test. |
nextmv cloud switchback start | Start a switchback test. |
nextmv cloud switchback stop | Stop a switchback test. |
nextmv cloud switchback update | Update a switchback test. |