Skip to main content

astro deployment pool copy

Copy Airflow pools from one Astro Deployment to another. Airflow pools are stored in the target Deployment's metadata database and appear in the Airflow UI.


astro deployment pool copy

This command only copies Airflow pools that were configured through the Airflow UI or otherwise stored in the Airflow metadata database.


This command is recommended for automated workflows. To run this command in an automated process such as a CI/CD pipeline, set the following OS-level environment pools in a way that the Astro CLI can access them:


After setting the pools, this command works for a Deployment without you having to manually authenticate to Astronomer. Astronomer recommends storing ASTRONOMER_KEY_SECRET as a secret before using it to programmatically update production-level Deployments.


OptionDescriptionPossible Values
-s,--source-idThe ID of the Deployment to copy Airflow pools from.Any valid Deployment ID
-n, --source-nameThe name of the Deployment from which to copy Airflow pools. Use as an alternative to <source-id>.Any valid Deployment name
-t, --target-idThe ID of the Deployment to receive the copied Airflow pools
--target-nameThe name of the Deployment to receive the copied Airflow pools. Use as an alternative to <target-id>.Any valid Deployment name
-w,--workspace-idSpecify to copy Airflow pools to a Deployment that is not in your current Workspace. If not specified, your current Workspace is assumed.Any valid Workspace ID


# copy pools stored in the Deployment with an ID of cl03oiq7d80402nwn7fsl3dmv to a deployment with an ID of cl03oiq7d80402nwn7fsl3dcd
astro deployment pool copy --source-id cl03oiq7d80402nwn7fsl3dmv --target cl03oiq7d80402nwn7fsl3dcd

# copy pools stored in the Deployment "My Deployment" to another Deployment "My Other Deployment"
astro deployment pool copy --source-name="My Deployment" --target-name="My Other Deployment"

Was this page helpful?

Sign up for Developer Updates

Get a summary of new Astro features once a month.

You can unsubscribe at any time.
By proceeding you agree to our Privacy Policy, our Website Terms and to receive emails from Astronomer.