Skip to main content

starship-usage

You might have defined Airflow connections and variables in the following places on your source Airflow environment:

  • The Airflow UI (stored in the Airflow metadata database).
  • Environment variables
  • A secrets backend.

If you defined your Airflow variables and connections in the Airflow UI, you can migrate those to Astro with Starship. You can check which resources will be migrated by going to Admin > Variables and Admin > Connections in the Airflow UI to find your source Airflow environment information.

caution

Some environment variables or Airflow Settings, like global environment variable values, can't be migrated to Astro. See Global environment variables for a list of variables that you can't migrate to Astro.

  1. In the Airflow UI for your source Airflow environment, go to Astronomer > Migration Tool ๐Ÿš€.

    Location of the Astro migration menu in the Cloud UI

  2. Click Get Token.

  3. If required, log in to cloud.astronomer.io.

  4. Copy the access token that appears after logging in.

  5. In the Migration Tool ๐Ÿš€ page of the Airflow UI, paste the access token into the Authentication Token field.

  6. Click Sign in.

  7. In the Target Deployment menu, select the Deployment where you want to migrate your Airflow variables and connections, then click Select.

  8. Click Connections. In the table that appears, click Migrate for each connection that you want to migrate to Astro. After the migration is complete, the status Migrated โœ… appears.

  9. Click Variables.

  10. In the table that appears, click Migrate for each variable that you want to migrate to Astro. After the migration is complete, the status Migrated โœ… appears.

  11. Click Environment variables.

  12. In the table that appears, check the box for each environment variable that you want to migrate to Astro, then click Migrate. After the migration is complete, the status Migrated โœ… appears.

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.