--account <ACCOUNT> | Google Cloud Platform user account to use for invocation. Overrides the default *core/account* property value for this command invocation |
--airflow-configs <KEY=VALUE> | A list of Airflow software configuration override KEY=VALUE pairs to set. For
information on how to structure KEYs and VALUEs, run
`$ {top_command} help composer environments update` |
--airflow-version <AIRFLOW_VERSION> | Version of Airflow to run in the environment.
+
Must be of the form `X.Y[.Z]`.
+
The latest supported Cloud Composer version will be used within
the created environment |
--async | Return immediately, without waiting for the operation in progress to
complete |
--billing-project <BILLING_PROJECT> | The Google Cloud Platform project that will be charged quota for operations performed in gcloud. If you need to operate on one project, but need quota against a different project, you can use this flag to specify the billing project. If both `billing/quota_project` and `--billing-project` are specified, `--billing-project` takes precedence. Run `$ gcloud config set --help` to see more information about `billing/quota_project` |
--cloud-sql-ipv4-cidr <CLOUD_SQL_IPV4_CIDR> | IPv4 CIDR range to use for the Cloud SQL network. This should have a size
of the netmask not greater than 24.
+
Cannot be specified unless '--enable-private-environment' is also
specified |
--cluster-ipv4-cidr <CLUSTER_IPV4_CIDR> | IP address range for the pods in this cluster in CIDR notation
(e.g. 10.0.0.0/14).
+
Cannot be specified unless '--enable-ip-alias' is also specified |
--cluster-secondary-range-name <CLUSTER_SECONDARY_RANGE_NAME> | Secondary range to be used as the source for pod IPs. Alias ranges will be
allocated from this secondary range. NAME must be the name of an existing
secondary range in the cluster subnetwork.
+
Cannot be specified unless '--enable-ip-alias' is also specified |
--configuration <CONFIGURATION> | The configuration to use for this command invocation. For more
information on how to use configurations, run:
`gcloud topic configurations`. You can also use the CLOUDSDK_ACTIVE_CONFIG_NAME environment
variable to set the equivalent of this flag for a terminal
session |
--disk-size <DISK_SIZE> | The disk size for each VM node in the environment. The minimum size is 20GB, and the maximum is 64TB. Specified value must be an integer multiple of gigabytes. Cannot be updated after the environment has been created. If units are not provided, defaults to GB |
--enable-ip-alias | Enable use of alias IPs (https://cloud.google.com/compute/docs/alias-ip/)
for Pod IPs. This will require at least two secondary ranges in the
subnetwork, one for the pod IPs and another to reserve space for the
services range |
--enable-private-endpoint | Environment cluster is managed using the private IP address of the master
API endpoint. Therefore access to the master endpoint must be from
internal IP addresses.
+
If not specified, the master API endpoint will be accessible by its public
IP address.
+
Cannot be specified unless '--enable-private-environment' is also
specified |
--enable-private-environment | Environment cluster is created with no public IP addresses on the cluster
nodes.
+
If not specified, cluster nodes will be assigned public IP addresses.
+
Cannot be specified unless '--enable-ip-alias' is also specified |
--env-variables <NAME=VALUE> | A comma-delimited list of environment variable `NAME=VALUE` pairs to provide to the Airflow scheduler, worker, and webserver processes. NAME may contain upper and lowercase letters, digits, and underscores, but they may not begin with a digit. To include commas as part of a `VALUE`, see `{top_command} topics escaping` for information about overriding the delimiter |
--flags-file <YAML_FILE> | A YAML or JSON file that specifies a *--flag*:*value* dictionary.
Useful for specifying complex flag values with special characters
that work with any command interpreter. Additionally, each
*--flags-file* arg is replaced by its constituent flags. See
$ gcloud topic flags-file for more information |
--flatten <KEY> | Flatten _name_[] output resource slices in _KEY_ into separate records
for each item in each slice. Multiple keys and slices may be specified.
This also flattens keys for *--format* and *--filter*. For example,
*--flatten=abc.def* flattens *abc.def[].ghi* references to
*abc.def.ghi*. A resource record containing *abc.def[]* with N elements
will expand to N records in the flattened output. This flag interacts
with other flags that are applied in this order: *--flatten*,
*--sort-by*, *--filter*, *--limit* |
--format <FORMAT> | Set the format for printing command output resources. The default is a
command-specific human-friendly output format. The supported formats
are: `config`, `csv`, `default`, `diff`, `disable`, `flattened`, `get`, `json`, `list`, `multi`, `none`, `object`, `table`, `text`, `value`, `yaml`. For more details run $ gcloud topic formats |
--help | Display detailed help |
--image-version <IMAGE_VERSION> | Version of the image to run in the environment.
+
The image version encapsulates the versions of both Cloud Composer
and Apache Airflow. Must be of the form
`composer-A.B.C[-D.E]-airflow-X.Y[.Z]`.
+
The Cloud Composer and Airflow versions are semantic versions.
`latest` can be provided instead of an explicit Cloud Composer
version number indicating that the server will replace `latest`
with the current Cloud Composer version. For the Apache Airflow
portion, the patch version can be omitted and the current
version will be selected. The version numbers that are used will
be stored |
--impersonate-service-account <SERVICE_ACCOUNT_EMAIL> | For this gcloud invocation, all API requests will be made as the given service account instead of the currently selected account. This is done without needing to create, download, and activate a key for the account. In order to perform operations as the service account, your currently selected account must have an IAM role that includes the iam.serviceAccounts.getAccessToken permission for the service account. The roles/iam.serviceAccountTokenCreator role has this permission or you may create a custom role. Overrides the default *auth/impersonate_service_account* property value for this command invocation |
--labels <KEY=VALUE> | List of label KEY=VALUE pairs to add.
+
Keys must start with a lowercase character and contain only hyphens (`-`), underscores (```_```), lowercase characters, and numbers. Values must contain only hyphens (`-`), underscores (```_```), lowercase characters, and numbers |
--location <LOCATION> | Compute Engine region in which to create the environment |
--log-http | Log all HTTP server requests and responses to stderr. Overrides the default *core/log_http* property value for this command invocation |
--machine-type <MACHINE_TYPE> | The Compute Engine machine type (https://cloud.google.com/compute/docs/machine-types) to use for nodes. For example `--machine-type=n1-standard-1` |
--master-ipv4-cidr <MASTER_IPV4_CIDR> | IPv4 CIDR range to use for the cluste master network. This should have a
size of the netmask between 23 and 28.
+
Cannot be specified unless '--enable-private-environment' is also
specified |
--network <NETWORK> | The Compute Engine Network to which the environment will be connected. If a 'Custom Subnet Network' is provided, `--subnetwork` must be specified as well |
--node-count <NODE_COUNT> | The number of nodes to create to run the environment |
--oauth-scopes <SCOPE> | The set of Google API scopes to be made available on all of the node VMs. Defaults to ['https://www.googleapis.com/auth/cloud-platform']. Cannot be updated |
--project <PROJECT_ID> | The Google Cloud Platform project ID to use for this invocation. If
omitted, then the current project is assumed; the current project can
be listed using `gcloud config list --format='text(core.project)'`
and can be set using `gcloud config set project PROJECTID`.
+
`--project` and its fallback `core/project` property play two roles
in the invocation. It specifies the project of the resource to
operate on. It also specifies the project for API enablement check,
quota, and billing. To specify a different project for quota and
billing, use `--billing-project` or `billing/quota_project` property |
--python-version <PYTHON_VERSION> | The Python version to be used within the created environment. Supplied value should represent the desired major Python version. Cannot be updated. _PYTHON_VERSION_ must be one of:
+
*2*::: Created environment will use Python 2
*3*::: Created environment will use Python 3
:::
+ |
--quiet | Disable all interactive prompts when running gcloud commands. If input
is required, defaults will be used, or an error will be raised.
Overrides the default core/disable_prompts property value for this
command invocation. This is equivalent to setting the environment
variable `CLOUDSDK_CORE_DISABLE_PROMPTS` to 1 |
--service-account <SERVICE_ACCOUNT> | The Google Cloud Platform service account to be used by the node VMs. If a service account is not specified, the "default" Compute Engine service account for the project is used. Cannot be updated |
--services-ipv4-cidr <SERVICES_IPV4_CIDR> | IP range for the services IPs.
+
Can be specified as a netmask size (e.g. '/20') or as in CIDR notion
(e.g. '10.100.0.0/20'). If given as a netmask size, the IP range will
be chosen automatically from the available space in the network.
+
If unspecified, the services CIDR range will be chosen with a default
mask size.
+
Cannot be specified unless '--enable-ip-alias' is also specified |
--services-secondary-range-name <SERVICES_SECONDARY_RANGE_NAME> | Secondary range to be used for services (e.g. ClusterIPs). NAME must be the
name of an existing secondary range in the cluster subnetwork.
+
Cannot be specified unless '--enable-ip-alias' is also specified |
--subnetwork <SUBNETWORK> | The Compute Engine subnetwork (https://cloud.google.com/compute/docs/subnetworks) to which the environment will be connected |
--tags <TAG> | The set of instance tags applied to all node VMs. Tags are used to identify valid sources or targets for network firewalls. Each tag within the list must comply with RFC 1035. Cannot be updated |
--trace-token <TRACE_TOKEN> | Token used to route traces of service requests for investigation of issues. Overrides the default *core/trace_token* property value for this command invocation |
--user-output-enabled | Print user intended output to the console. Overrides the default *core/user_output_enabled* property value for this command invocation. Use *--no-user-output-enabled* to disable |
--verbosity <VERBOSITY> | Override the default verbosity for this command. Overrides the default *core/verbosity* property value for this command invocation. _VERBOSITY_ must be one of: *debug*, *info*, *warning*, *error*, *critical*, *none* |
--web-server-ipv4-cidr <WEB_SERVER_IPV4_CIDR> | IPv4 CIDR range to use for the Airflow web server network. This should have
a size of the netmask between 24 and 29.
+
Cannot be specified unless '--enable-private-environment' is also
specified |
--zone <ZONE> | The Compute Engine zone in which the environment will be created. For example `--zone=us-central1-a` |