Astro CLI release notes archive: 1.19 through 1.10

​

Additional improvements

• The Astro CLI now shows a warning if you attempt to deploy a project with an empty dags folder to Astro. To remove this warning along with all other CLI warnings, run astro config set show_warnings false.

​

Bug fixes

• Fixed an issue where astro deployment create sometimes showed an invalid Runtime version error for valid Runtime versions.

​

Additional improvements

• Sample test test/dags/test_dag_integrity.py was renamed to test/dags/test_dag_example.py to highlight that this test is an example.

​

Bug fixes

• Fixed an issue where CI/CD pipelines were unable to use Deployments as Code to create Deployment Previews for Deployments using the Kubernetes executor.
• Fixed an issue where the CLI was asking users to select from the wrong regions when creating a Deployment on an AWS cluster.
• Fixed an issue where secret variables values were being printed to local logs.

​

Additional improvements

• When you run astro dev upgrade-test, the generated HTML report for dag tests now shows how many dags passed and failed the test.

​

Bug fixes

• Fixed an issue where you couldn’t create a Deployment on a dedicated cluster using a Deployment file and API token.
• Fixed an issue where the Deployment URL that appears after you run astro deploy was not formatted properly.
• Fixed an issue where astro dev upgrade-test would occasionally output that it was testing an upgrade to the latest version of Astro Runtime, even if it wasn’t.
• Fixed an issue where astro dev upgrade-test didn’t produce an HTML report for dag tests.

​

Bug fixes

• Fixed an issue where dags would fail to parse correctly when running astro dev parse or astro deploy, resulting in a command execution failure.

​

Additional improvements

• You can now grant Astro users the WORKSPACE_AUTHOR role.
• You can now run an Astro project from the same directory an Apache Airflow project.
• astro deployment inspect now shows you a Deployment’s workload identity.

​

Bug fixes

• Fixed an issue where some dags could be missed during astro deploy when dag-only deploys are enabled.
• Fixed an issue where astro dev pytest would incorrectly fail when testing an Astro project within a CI/CD process.
• Fixed an issue where you couldn’t update a Deployment on a standard cluster using a Deployment file.

​

Bug fixes

• Fixed an issue where running astro deployment create on Astro Hosted would create Deployments where dag-only deploys were turned off by default.

​

Bug fixes

• Fixed an issue where astro run didn’t work properly.

​

New command to test Astro projects before you upgrade

​

Additional improvements

• You can now specify the --description flag with astro deploy to add a description for your deploy. You can use this description to let other users know why you made a deploy or what changes a deploy contains.
• You can now specify the --role flag with astro organization team create/update to update a Team’s Organization-level role.
• You can now specify the --execution-date flag with astro run to trigger a dag run for a specific execution date.
• You can now specify the --verbose flag with astro run to stream all logs to your terminal after the dag run triggers.

​

Bug fixes

• Fixed an issue where astro deployment inspect was showing the wrong value for a Deployment’s workload identity on Astro Hosted.
• Fixed an issue were astro dev restart would occasionally not work.

​

Bug fixes

• Fixed an issue were some Astro Hosted Deployment updates triggered by the Astro CLI were not working.

​

Manage Organization API tokens with the Astro CLI

• astro organization token create
• astro organization token roles
• astro organization token list
• astro organization token update
• astro organization token rotate
• astro organization token delete

​

Download resources from the Astronomer Registry to your Astro project

• astro registry dag add
• astro registry provider add

​

Additional improvements

• You can now create Deployments on AWS standard clusters.
• If you belong to only one Workspace, the Astro CLI now uses that Workspace by default for all commands.

​

Bug fixes

• Fixed an issue where the Astro CLI could not retrieve the health status of a Deployment.
• Fixed an issue where you could not set worker_concurrency to 0 in a Deployment file.

​

Bug fixes

• Fixed an issue where the isHighAvailability and CICDEnforcement fields in Deployment files were not processed correctly.

​

Manage Teams using the Astro CLI

• astro workspace team add
• astro workspace team list
• astro workspace team update
• astro workspace team remove
• astro organization team create
• astro organization team list
• astro organization team update
• astro organization team delete
• astro organization team user remove
• astro organization team user add
• astro organization team user list

​

Manage Workspace API tokens with the Astro CLI

• astro workspace token create
• astro workspace token add
• astro workspace token list
• astro workspace token update
• astro workspace token rotate
• astro workspace token delete

​

Additional improvements

• You can now specify the --cluster-type "dedicated" flag when using astro deployment create to create a Deployment on a dedicated cluster in Astro Hosted.
• You can now retrieve a Deployment’s Workload Identity when using astro deployment inspect.
• You can now specify the --enforce-cicd flag with astro deployment create and astro deployment update to enforce CI/CD on a given Deployment.
• You can now manage Deployments as code on Astro Hosted.

​

Bug fixes

• Fixed an issue where you could not create a Deployment on a standard Hosted cluster.

​

New commands to manage Airflow resources on Deployments

• astro deployment connection list
• astro deployment connection create
• astro deployment connection update
• astro deployment connection copy
• astro deployment airflow-variable list
• astro deployment airflow-variable create
• astro deployment airflow-variable update
• astro deployment airflow-variable copy
• astro deployment pool list
• astro deployment pool create
• astro deployment pool update
• astro deployment pool copy

​

Additional improvements

• You can now use the --args flag to specify pytest arguments to run with astro dev pytest. For example, you can run astro dev pytest --args "-p pytest_cov" to plugin the pytest_cov plugin with your pyests.
• You can now use Organization API tokens to automate Astro CLI tokens. Specify the Organization API token using the environment variable ASTRO_API_TOKEN in the environment where you run the Astro CLI.
• You can now create a custom Docker/Podman compose file for your Astro project with the command astro dev object export --compose. After you modify the file, you can use it to start your project with astro dev start --compose-file <compose-file-location>.
• You can now set postgres.repository and postgres.tag with astro config set. You can use these configurations to customize the postgres database used in your local Airflow environments.
• The Astro CLI now automatically trims quotation marks from the beginning and end of environment variables being pushed to Astro.
• The command astro user invite has been deprecated.

​

Bug fixes

• Fixed an issue were astro deployment variable create/update was not producing error when it failed to create an environment variable.
• Fixed an issue were Podman deploys were failing if the user didn’t have the Docker CLI installed.

​

Bug fixes

• Fixed an issue where astro workspace user list didn’t work when using a Workspace API token.

​

New commands to manage Astro Workspaces

• astro workspace create
• astro workspace update
• astro workspace delete

​

Bug fixes

• Fixed an issue where the CLI added the dags folder to .dockerignore whenever an image build was interrupted, resulting in dags not being deployed on the next image build.

​

New flag --clean-output for Deployment commands

• astro deployment inspect
• astro deployment create
• astro deployment update

​

New environment variable ASTRO_HOME

​

Additional improvements

• The command astro login won’t ask for email input in the command line anymore. You can now provide your email address in the browser when you log in.

​

Bug fixes

• Fixed an issue where you couldn’t authenticate to the Astro from the Astro CLI using single sign-on (SSO).

​

Additional improvements

• You can now expose your local Airflow webserver and postgres database to all networks you’re connected to using the following command:
  astro config set airflow.expose_port true
  
• When you trigger a dag deploy to Astro, the CLI now includes the name of the dag bundle version that it pushed. You can use this name to verify that your Deployment uses the correct version of your dags after a deploy.
• If you add the environment variable ASTRO_API_TOKEN=<workspace-api-token> to your environment, the Astro CLI will use the specified Workspace API token to perform Workspace and Deployment actions without requiring you to log in.
• You can now disable astro run commands and exclude astro-run-dag from any images built by the CLI using the following command:
  astro config set disable_astro_run true
  
• In new Astro projects, requirements.txt now includes a commented list of the pre-installed provider packages on Astro Runtime.

​

Bug fixes

• Fixed an issue where the default dag integrity test would sometimes generate an error for valid uses of os.getenv(key,default).
• Fixed bugs in the default Astro project dags.

​

Support for Podman

​

Bug fixes

• Fixed an issue where you couldn’t run Astro CLI commands with a Deployment API key if you logged out of your personal account using astro logout.
• Fixed an issue where you couldn’t set the minimum worker count for a worker queue to zero.
• Fixed an issue where running astro deploy would not return an error when you specified a Deployment name that didn’t exist.
• Fixed an issue where you could not update a Deployment with a file using a Deployment API key.

​

New commands to manage Astro users

• astro organization user invite: Invite a new user to your Astronomer Organization.
• astro organization user update: Update a user’s Organization role.
• astro organization user list: List all users in your Organization.
• astro workspace user add: Add a user to a Workspace.
• astro workspace user update: Update a user’s role in a Workspace.
• astro workspace user list: List all users in a Workspace.
• astro workspace user remove: Remove a user from a Workspace.