Install Astro on GCP
Overview
This guide provides steps for getting started with Astro on Google Cloud Platform (GCP). Below, you'll find instructions for how to complete the Astro install process, including prerequisites and the steps required for our team to provision resources in your network.
At a high-level, we'll ask that you come prepared with a new Google Cloud project. From there, you can expect to:
- Create an account on Astro.
- Activate your Astro Data Plane by enabling Google Cloud APIs and adding service accounts to your project's IAM.
- Share information about your Google Cloud project with our team.
Astronomer will then create a Cluster within your Google Cloud project that hosts the resources and Apache Airflow components necessary to deploy DAGs and execute tasks.
For more information on managing Google Cloud projects, see GCP documentation.
Prerequisites
To install Astro on GCP, you need:
- A clean Google Cloud project with billing enabled. For security reasons, the install process is not currently supported on a Google Cloud project that has other tooling running in it.
- A user with Owner permissions in your project.
- Google Cloud Shell.
- A minimum CPU quota of 36.
- A minimum N2_CPU quota of 24.
- A subscription to the Astro Status Page. This will ensure that you're alerted in the case of an incident or scheduled maintenance.
For more information about the resources required to run Astro on GCP, see GCP Resource Reference.
VPC Peering Prerequisites (Optional)
If any of your GCP resources are on a private network, you can access them using one of the following options:
- Private Services Connect
- A VPC Peering connection between Astronomer's VPC and the VPCs for your broader network
Astro uses 4 different CIDR blocks for creating the infrastructure for your Astronomer Cluster. If you plan on peering with an existing VPC and want to use custom values for your CIDRs, then you must additionally provide your own CIDR ranges (RFC 1918 IP Space) of /19
or better for the following services:
- Subnet CIDR: Used by nodes in your GKE cluster (Default:
172.20.0.0/19
) - Pod CIDR: Used by GKE pods (Default:
172.21.0.0/19
) - Service Address CIDR: Used by GKE services (Default:
172.22.0.0/19
) - Service VPC Peering: Used by Private Service Connections (Default:
172.23.0.0/19
)
Step 1: Access Astro
To get started with Astro, create an account at https://cloud.astronomer.io/.
When you first authenticate to Astro, you can sign in with a Google account, a GitHub account, or an email and password.

If you're the first person from your team to authenticate, the Astronomer team will add you as a Workspace Admin to a new Workspace named after your Organization. From there, you'll be able to add other team members to that Workspace without Astronomer's assistance.
tip
After completing your initial installation, we recommend setting up an identity provider (IdP) so that users can log in to Astro through your IdP.
Step 2: Activate the Data Plane
The Data Plane is a collection of infrastructure components for Astro that run in your cloud and are fully managed by Astronomer. This includes a central database, storage for Airflow tasks logs, and the resources required for task execution.
To activate the Data Plane on your GCP project:
Run the following commands in your Google Cloud Shell:
$ gcloud services enable storage-component.googleapis.com
$ gcloud services enable storage-api.googleapis.com
$ gcloud services enable compute.googleapis.com
$ gcloud services enable container.googleapis.com
$ gcloud services enable deploymentmanager.googleapis.com
$ gcloud services enable cloudresourcemanager.googleapis.com
$ gcloud services enable cloudkms.googleapis.com
$ gcloud services enable sqladmin.googleapis.com
$ gcloud services enable servicenetworking.googleapis.com
$ curl \
https://storage.googleapis.com/storage/v1/projects/$GOOGLE_CLOUD_PROJECT/serviceAccount \
--header "Authorization: Bearer `gcloud auth application-default print-access-token`" \
--header 'Accept: application/json' --compressedRun the following commands in your Google Cloud Shell:
$ export MY_PROJECT_NUMBER=$(gcloud projects describe $GOOGLE_CLOUD_PROJECT --format="value(projectNumber)")
$ gcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT --member=serviceAccount:$MY_PROJECT_NUMBER@cloudservices.gserviceaccount.com --role=roles/owner
$ gcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT --member=serviceAccount:astronomer@astro-remote-mgmt.iam.gserviceaccount.com --role=roles/owner
Step 3: Provide Setup Information to Astronomer
Once you've activated your Data Plane, provide Astronomer with:
- Your preferred Astro Cluster name.
- The GCP region that you want to host your Cluster in.
- Your preferred node instance type.
- Your preferred CloudSQL instance type.
- Your preferred maximum node count.
- (Optional) Your custom CIDR ranges for connecting to Astronomer's services.
If you don't specify your organization's preferred configurations, Astronomer will create a Cluster in us-central1
with default configurations for Astro on GCP. For more information, see GCP Resource Reference.
info
If you need to VPC peer with Astronomer, additionally provide the following information to Astronomer:
- VPC Name/ID and region for peering with Astronomer.
- The IPs of your DNS servers.
You then need to accept a VPC peering request from Astronomer after Astro is installed. To accept the request, follow Using VPC Network Peering in GCP documentation.
Once VPC peered with Astronomer, configure and validate the following to ensure successful network communications between Astro and your resources:
- Egress routes on Astronomer's route table
- Network ACLs and/or Security Group rules of your resources
Step 4: Let Astronomer Complete the Install
Once you've provided Astronomer with the information for your setup, the Astronomer team will finish creating your first Cluster on GCP.
This process can take some time. Wait for confirmation that the installation was successful before proceeding to the next step.
Step 5: Create a Deployment
Once Astronomer confirms that your Astro Cluster has been created, you are ready to create a Deployment and start deploying DAGs. Log in to the Cloud UI and create a new Deployment. If the installation was successful, your new Astro Cluster will be listed as an option under the Cluster menu:

Next Steps
Now that you have an Astro Cluster up and running, take a look at the docs below for information on how to start working in Astro: