gcloud alpha composer environments check-upgrade Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud alpha composer environments check-upgrade - check that upgrading a Cloud Composer environment does not result in PyPI module conflicts
- SYNOPSIS
gcloud alpha composer environments check-upgrade(ENVIRONMENT:--location=LOCATION)[--async][--airflow-version=AIRFLOW_VERSION|--image-version=IMAGE_VERSION][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(ALPHA)Check that upgrading a Cloud Composer environment does notresult in PyPI module conflicts.- EXAMPLES
- To check that upgrading to the 'composer-1.16.5-airflow-1.10.15' image
inaCloudComposerenvironmentnamed'env-1'doesnotcausePyPIpackageconflicts,run:
gcloudalphacomposerenvironmentscheck-upgradeenv-1--image-version=composer-1.16.5-airflow-1.10.15 - POSITIONAL ARGUMENTS
- Environment resource - The environment to check upgrade for. The arguments inthis group can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.
To set the
projectattribute:- provide the argument
environmenton the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
ENVIRONMENT- ID of the environment or fully qualified identifier for the environment.
To set the
environmentattribute:- provide the argument
environmenton the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--location=LOCATION- Region where Composer environment runs or in which to create the environment.
To set the
locationattribute:- provide the argument
environmenton the command line with a fullyspecified name; - provide the argument
--locationon the command line; - set the property
composer/location.
- provide the argument
- provide the argument
- Environment resource - The environment to check upgrade for. The arguments inthis group can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.
- FLAGS
--async- Return immediately, without waiting for the operation in progress to complete.
- Group of arguments for performing in-place environment upgrades.
At most one of these can be specified:
--airflow-version=AIRFLOW_VERSION- Upgrade the environment to a later Apache Airflow version in-place.
Must be of the form
X[.Y[.Z]], where[]denotesoptional fragments. Examples:2,2.3,2.3.4.The Apache Airflow version is a semantic version or an alias in the form ofmajor or major.minor version numbers, resolved to the latest matching ApacheAirflow version supported in the current Cloud Composer version. The resolvedversion is stored in the upgraded environment.
--image-version=IMAGE_VERSION- Upgrade the environment to a later version in-place.
The image version encapsulates the versions of both Cloud Composer and ApacheAirflow. Must be of the form
composer-A[.B.C[-D.E]]-airflow-X[.Y[.Z]], where[]denotes optional fragments.Examples:
composer-2-airflow-2,composer-2-airflow-2.2,composer-2.1.2-airflow-2.3.4.The Cloud Composer portion of the image version is a semantic version or analias in the form of major version number or
latest, resolved tothe current Cloud Composer version. The Apache Airflow portion of the imageversion is a semantic version or an alias in the form of major or major.minorversion numbers, resolved to the latest matching Apache Airflow versionsupported in the given Cloud Composer version. The resolved versions are storedin the upgraded environment.
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$gcloud helpfor details. - NOTES
- This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudcomposerenvironmentscheck-upgradegcloudbetacomposerenvironmentscheck-upgrade
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-22 UTC.