Skip to main content
The behavior and format of this command are the same for both Astro and Astro Private Cloud.
Test your local Astro project against a new version of Astro Runtime to prepare for an upgrade. Specifically, this command will run the following tests:
  • Identify major and minor version changes of the Python packages in your upgrade version.
  • Identify dag import errors that will appear after you upgrade.
See Test before upgrading your Astro project for more detailed information about usage and test results.

​
Usage

By default, the command runs all three available tests on your project against the latest version of Astro Runtime.

​
Options

​
Examples

  • Run all tests before upgrading to the latest version of Astro Runtime:
  • Test an Astro project file against a the Astro Runtime distribution of a Airflow 2.6.3:
  • Include deprecation warnings in lint tests (exports to ruff-lint-results.txt):
  • Test only dependency version changes against the Astro Runtime distribution for Airflow 2.6.3:
  • Test a custom image for an upgrade to a custom versioned distribution of Astro Runtime:
    If you were upgrading from quay.io/example-organization/new-example-organization-image:1.0.5, for example, the Astro CLI creates a new Dockerfile located in upgrade-test-1.0.5--1.0.7/Dockerfile that contains the image you specified and tests against it.