Cloud Composer 1 | Cloud Composer 2
This page explains how an environment can be updated.
About update operations
When you change parameters of your environment, such as specifying new scaling and performance parameters, or installing custom PyPI packages, your environment updates.
After this operation is completed, changes become available in your environment.
For a single Cloud Composer environment, you can start only one update operation at a time. You must wait for an update operation to complete before starting another environment operation.
About updating with Terraform
terraform plan before
terraform apply to see if Terraform creates a new
environment instead of updating it.
Before you begin
Check that your account, the service account of your environment, and the Cloud Composer Service Agent account in your project have required permissions:
Your account must have a role that can trigger environment update operations.
The service account of your environment must have a role that has enough permissions to perform update operations.
The Cloud Composer Service Agent account must have permissions to create bindings between your environment's service account and the Kubernetes service account of your environment's cluster.
gcloud composer environments updatecommand terminates when the operation is finished. You can use the
--asyncflag to avoid waiting for the operation to complete.
View environment details
In Google Cloud console, go to the Environments page.
In the list of environments, click the name of your environment. The Environment details page opens.
Run the following
gcloud composer environments describe ENVIRONMENT_NAME \ --location LOCATION
ENVIRONMENT_NAMEwith the name of the environment.
LOCATIONwith the region where the environment is located.
environments.get API request.
GET https://composer.googleapis.com/v1/projects/example-project/ locations/us-central1/environments/example-environment
terraform state show command for your environment's resource.
The name of your environment's Terraform resource might be different than the name of your environment.
terraform state show google_composer_environment.RESOURCE_NAME
RESOURCE_NAMEwith the name of your environment's resource.
For more information about updating your environment, see other documentation pages about specific update operations. For example:
- Override Airflow configuration options
- Set environment variables
- Install Python dependencies
- Scale environments
- Configure authorized networks