From cf5ab60e4adfef169012199e08e334e3a60375b3 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 29 Jun 2022 09:00:05 +0000 Subject: [PATCH] gcloud: Wed Jun 29 09:00:05 UTC 2022 --- gcloud/_version | 8 +- gcloud/alpha/bigtable/backups/copy | 145 +++++++++++++++ gcloud/alpha/bigtable/backups/help | 3 + gcloud/alpha/bigtable/clusters/create | 15 +- gcloud/alpha/bigtable/clusters/update | 10 +- gcloud/alpha/bigtable/instances/create | 13 +- gcloud/alpha/bigtable/instances/tables/help | 2 +- .../alpha/bigtable/instances/tables/undelete | 10 +- gcloud/alpha/builds/triggers/create/github | 22 ++- .../certificate-manager/certificates/create | 4 +- .../certificate-manager/certificates/delete | 4 +- .../certificate-manager/certificates/describe | 4 +- .../certificate-manager/certificates/help | 4 +- .../certificate-manager/certificates/list | 4 +- .../certificate-manager/certificates/update | 4 +- .../dns-authorizations/create | 4 +- .../dns-authorizations/delete | 4 +- .../dns-authorizations/describe | 4 +- .../dns-authorizations/help | 4 +- .../dns-authorizations/list | 4 +- .../dns-authorizations/update | 4 +- gcloud/alpha/certificate-manager/help | 4 +- gcloud/alpha/certificate-manager/maps/create | 4 +- gcloud/alpha/certificate-manager/maps/delete | 4 +- .../alpha/certificate-manager/maps/describe | 4 +- .../certificate-manager/maps/entries/create | 4 +- .../certificate-manager/maps/entries/delete | 4 +- .../certificate-manager/maps/entries/describe | 4 +- .../certificate-manager/maps/entries/help | 4 +- .../certificate-manager/maps/entries/list | 4 +- .../certificate-manager/maps/entries/update | 4 +- gcloud/alpha/certificate-manager/maps/help | 4 +- gcloud/alpha/certificate-manager/maps/list | 4 +- gcloud/alpha/certificate-manager/maps/update | 4 +- .../certificate-manager/operations/describe | 4 +- .../alpha/certificate-manager/operations/help | 4 +- .../alpha/certificate-manager/operations/list | 4 +- .../compute/instance-groups/managed/create | 14 ++ .../compute/instance-groups/managed/update | 14 ++ gcloud/alpha/compute/os-config/troubleshoot | 6 +- gcloud/alpha/compute/ssh | 6 +- gcloud/alpha/container/aws/clusters/update | 19 +- gcloud/alpha/container/aws/node-pools/update | 4 + gcloud/alpha/container/azure/clusters/update | 19 +- gcloud/alpha/container/clusters/create | 55 +++++- gcloud/alpha/container/clusters/update | 45 ++++- .../container/node-pools/complete-upgrade | 57 ++++++ gcloud/alpha/container/node-pools/create | 49 ++++- gcloud/alpha/container/node-pools/help | 3 + gcloud/alpha/container/node-pools/rollback | 8 +- gcloud/alpha/container/node-pools/update | 44 ++++- gcloud/alpha/container/operations/cancel | 4 +- gcloud/alpha/deploy/releases/abandon | 78 ++++++++ gcloud/alpha/deploy/releases/help | 3 + gcloud/alpha/kms/import-jobs/create | 4 +- gcloud/alpha/pubsub/subscriptions/ack | 34 ++-- .../pubsub/subscriptions/modify-ack-deadline | 34 ++-- .../subscriptions/modify-message-ack-deadline | 34 ++-- gcloud/alpha/run/revisions/logs/help | 3 + gcloud/alpha/run/revisions/logs/tail | 127 +++++++++++++ gcloud/alpha/run/services/logs/tail | 13 ++ gcloud/alpha/scc/settings/services/describe | 3 +- .../scc/settings/services/describe-explicit | 3 +- gcloud/alpha/scc/settings/services/disable | 3 +- gcloud/alpha/scc/settings/services/enable | 3 +- gcloud/alpha/scc/settings/services/inherit | 3 +- .../scc/settings/services/modules/describe | 3 +- .../services/modules/describe-explicit | 3 +- .../scc/settings/services/modules/disable | 3 +- .../scc/settings/services/modules/enable | 3 +- .../scc/settings/services/modules/update | 3 +- gcloud/alpha/vmware/network-peerings/help | 9 +- .../alpha/vmware/network-peerings/routes/help | 28 +++ .../alpha/vmware/network-peerings/routes/list | 91 ++++++++++ gcloud/beta/bigtable/clusters/create | 15 +- gcloud/beta/bigtable/clusters/update | 10 +- gcloud/beta/bigtable/instances/create | 13 +- gcloud/beta/bigtable/instances/tables/help | 3 + .../beta/bigtable/instances/tables/undelete | 69 +++++++ gcloud/beta/builds/triggers/create/github | 22 ++- .../certificate-manager/certificates/create | 6 +- .../certificate-manager/certificates/delete | 6 +- .../certificate-manager/certificates/describe | 6 +- .../certificate-manager/certificates/help | 6 +- .../certificate-manager/certificates/list | 6 +- .../certificate-manager/certificates/update | 6 +- .../dns-authorizations/create | 6 +- .../dns-authorizations/delete | 6 +- .../dns-authorizations/describe | 6 +- .../dns-authorizations/help | 6 +- .../dns-authorizations/list | 6 +- .../dns-authorizations/update | 6 +- gcloud/beta/certificate-manager/help | 6 +- gcloud/beta/certificate-manager/maps/create | 6 +- gcloud/beta/certificate-manager/maps/delete | 6 +- gcloud/beta/certificate-manager/maps/describe | 6 +- .../certificate-manager/maps/entries/create | 6 +- .../certificate-manager/maps/entries/delete | 6 +- .../certificate-manager/maps/entries/describe | 6 +- .../certificate-manager/maps/entries/help | 6 +- .../certificate-manager/maps/entries/list | 6 +- .../certificate-manager/maps/entries/update | 6 +- gcloud/beta/certificate-manager/maps/help | 6 +- gcloud/beta/certificate-manager/maps/list | 6 +- gcloud/beta/certificate-manager/maps/update | 6 +- .../certificate-manager/operations/describe | 6 +- .../beta/certificate-manager/operations/help | 6 +- .../beta/certificate-manager/operations/list | 6 +- .../compute/instance-groups/managed/create | 14 ++ .../compute/instance-groups/managed/update | 14 ++ gcloud/beta/compute/ssh | 6 +- gcloud/beta/container/clusters/create | 69 ++++++- gcloud/beta/container/clusters/update | 56 +++++- .../container/node-pools/complete-upgrade | 55 ++++++ gcloud/beta/container/node-pools/create | 46 ++++- gcloud/beta/container/node-pools/help | 3 + gcloud/beta/container/node-pools/rollback | 8 +- gcloud/beta/container/node-pools/update | 44 ++++- gcloud/beta/container/operations/cancel | 6 +- gcloud/beta/deploy/releases/abandon | 76 ++++++++ gcloud/beta/deploy/releases/help | 3 + gcloud/beta/kms/import-jobs/create | 4 +- gcloud/beta/pubsub/subscriptions/ack | 34 ++-- .../pubsub/subscriptions/modify-ack-deadline | 34 ++-- .../subscriptions/modify-message-ack-deadline | 34 ++-- gcloud/bigtable/clusters/create | 15 +- gcloud/bigtable/clusters/update | 10 +- gcloud/bigtable/instances/create | 13 +- gcloud/bigtable/instances/tables/help | 3 + gcloud/bigtable/instances/tables/undelete | 68 +++++++ .../certificate-manager/certificates/create | 168 ++++++++++++++++++ .../certificate-manager/certificates/delete | 63 +++++++ .../certificate-manager/certificates/describe | 62 +++++++ gcloud/certificate-manager/certificates/help | 40 +++++ gcloud/certificate-manager/certificates/list | 80 +++++++++ .../certificate-manager/certificates/update | 116 ++++++++++++ .../dns-authorizations/create | 85 +++++++++ .../dns-authorizations/delete | 69 +++++++ .../dns-authorizations/describe | 63 +++++++ .../dns-authorizations/help | 41 +++++ .../dns-authorizations/list | 85 +++++++++ .../dns-authorizations/update | 102 +++++++++++ gcloud/certificate-manager/help | 37 ++++ gcloud/certificate-manager/maps/create | 76 ++++++++ gcloud/certificate-manager/maps/delete | 63 +++++++ gcloud/certificate-manager/maps/describe | 60 +++++++ .../certificate-manager/maps/entries/create | 118 ++++++++++++ .../certificate-manager/maps/entries/delete | 73 ++++++++ .../certificate-manager/maps/entries/describe | 68 +++++++ gcloud/certificate-manager/maps/entries/help | 40 +++++ gcloud/certificate-manager/maps/entries/list | 92 ++++++++++ .../certificate-manager/maps/entries/update | 126 +++++++++++++ gcloud/certificate-manager/maps/help | 46 +++++ gcloud/certificate-manager/maps/list | 79 ++++++++ gcloud/certificate-manager/maps/update | 98 ++++++++++ .../certificate-manager/operations/describe | 62 +++++++ gcloud/certificate-manager/operations/help | 31 ++++ gcloud/certificate-manager/operations/list | 84 +++++++++ gcloud/compute/ssh | 6 +- gcloud/compute/target-https-proxies/create | 18 +- gcloud/compute/target-https-proxies/update | 96 ++++++---- gcloud/compute/target-ssl-proxies/create | 35 +++- gcloud/compute/target-ssl-proxies/update | 41 ++++- gcloud/container/aws/clusters/update | 4 + gcloud/container/aws/node-pools/update | 4 + gcloud/container/azure/clusters/update | 7 +- gcloud/container/clusters/create | 39 +++- gcloud/container/clusters/update | 39 +++- gcloud/container/node-pools/complete-upgrade | 53 ++++++ gcloud/container/node-pools/create | 47 ++++- gcloud/container/node-pools/help | 3 + gcloud/container/node-pools/rollback | 7 +- gcloud/container/node-pools/update | 44 ++++- gcloud/container/operations/cancel | 52 ++++++ gcloud/container/operations/help | 3 + gcloud/deploy/releases/abandon | 74 ++++++++ gcloud/deploy/releases/help | 3 + gcloud/eventarc/channels/create | 8 +- gcloud/eventarc/channels/help | 3 + gcloud/eventarc/channels/update | 75 ++++++++ gcloud/eventarc/google-channels/describe | 39 ++++ gcloud/eventarc/google-channels/help | 22 +++ gcloud/eventarc/google-channels/update | 56 ++++++ gcloud/eventarc/help | 3 + gcloud/kms/import-jobs/create | 4 +- gcloud/metastore/services/create | 42 +++-- gcloud/network-connectivity/spokes/delete | 1 + gcloud/network-connectivity/spokes/describe | 1 + gcloud/privateca/certificates/create | 21 ++- gcloud/privateca/roots/create | 19 +- gcloud/privateca/subordinates/create | 19 +- gcloud/privateca/templates/create | 2 +- gcloud/privateca/templates/update | 2 +- gcloud/pubsub/subscriptions/ack | 2 +- .../subscriptions/modify-message-ack-deadline | 2 +- 195 files changed, 4700 insertions(+), 413 deletions(-) create mode 100644 gcloud/alpha/bigtable/backups/copy create mode 100644 gcloud/alpha/container/node-pools/complete-upgrade create mode 100644 gcloud/alpha/deploy/releases/abandon create mode 100644 gcloud/alpha/run/revisions/logs/tail create mode 100644 gcloud/alpha/vmware/network-peerings/routes/help create mode 100644 gcloud/alpha/vmware/network-peerings/routes/list create mode 100644 gcloud/beta/bigtable/instances/tables/undelete create mode 100644 gcloud/beta/container/node-pools/complete-upgrade create mode 100644 gcloud/beta/deploy/releases/abandon create mode 100644 gcloud/bigtable/instances/tables/undelete create mode 100644 gcloud/certificate-manager/certificates/create create mode 100644 gcloud/certificate-manager/certificates/delete create mode 100644 gcloud/certificate-manager/certificates/describe create mode 100644 gcloud/certificate-manager/certificates/help create mode 100644 gcloud/certificate-manager/certificates/list create mode 100644 gcloud/certificate-manager/certificates/update create mode 100644 gcloud/certificate-manager/dns-authorizations/create create mode 100644 gcloud/certificate-manager/dns-authorizations/delete create mode 100644 gcloud/certificate-manager/dns-authorizations/describe create mode 100644 gcloud/certificate-manager/dns-authorizations/help create mode 100644 gcloud/certificate-manager/dns-authorizations/list create mode 100644 gcloud/certificate-manager/dns-authorizations/update create mode 100644 gcloud/certificate-manager/help create mode 100644 gcloud/certificate-manager/maps/create create mode 100644 gcloud/certificate-manager/maps/delete create mode 100644 gcloud/certificate-manager/maps/describe create mode 100644 gcloud/certificate-manager/maps/entries/create create mode 100644 gcloud/certificate-manager/maps/entries/delete create mode 100644 gcloud/certificate-manager/maps/entries/describe create mode 100644 gcloud/certificate-manager/maps/entries/help create mode 100644 gcloud/certificate-manager/maps/entries/list create mode 100644 gcloud/certificate-manager/maps/entries/update create mode 100644 gcloud/certificate-manager/maps/help create mode 100644 gcloud/certificate-manager/maps/list create mode 100644 gcloud/certificate-manager/maps/update create mode 100644 gcloud/certificate-manager/operations/describe create mode 100644 gcloud/certificate-manager/operations/help create mode 100644 gcloud/certificate-manager/operations/list create mode 100644 gcloud/container/node-pools/complete-upgrade create mode 100644 gcloud/container/operations/cancel create mode 100644 gcloud/deploy/releases/abandon create mode 100644 gcloud/eventarc/channels/update create mode 100644 gcloud/eventarc/google-channels/describe create mode 100644 gcloud/eventarc/google-channels/help create mode 100644 gcloud/eventarc/google-channels/update diff --git a/gcloud/_version b/gcloud/_version index 5a37186c1..7d03eab02 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,6 +1,6 @@ -Google Cloud SDK 391.0.0 -alpha 2022.06.17 -beta 2022.06.17 +Google Cloud SDK 392.0.0 +alpha 2022.06.24 +beta 2022.06.24 bq 2.0.75 -core 2022.06.17 +core 2022.06.24 gsutil 5.10 diff --git a/gcloud/alpha/bigtable/backups/copy b/gcloud/alpha/bigtable/backups/copy new file mode 100644 index 000000000..7324ea394 --- /dev/null +++ b/gcloud/alpha/bigtable/backups/copy @@ -0,0 +1,145 @@ +NAME + gcloud alpha bigtable backups copy - copy a Cloud Bigtable backup to a new + backup + +SYNOPSIS + gcloud alpha bigtable backups copy + (--destination=DESTINATION : --destination-cluster=DESTINATION_CLUSTER + --destination-instance=DESTINATION_INSTANCE) + (--expiration-date=EXPIRATION_DATE + | --retention-period=RETENTION_PERIOD) + (--source=SOURCE + : --source-cluster=SOURCE_CLUSTER --source-instance=SOURCE_INSTANCE) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command copies a Cloud Bigtable backup to a new backup. + +EXAMPLES + To copy backup SOURCE_BACKUP to DESTINATION_BACKUP, run: + + $ gcloud alpha bigtable backups copy \ + --source-instance=SOURCE_INSTANCE \ + --source-cluster=SOURCE_CLUSTER --source=SOURCE_BACKUP \ + --destination-instance=DESTINATION_INSTANCE \ + --destination-cluster=DESTINATION_CLUSTER \ + --destination=DESTINATION_BACKUP \ + --expiration-date=2022-08-01T10:49:41Z + + To copy backup SOURCE_BACKUP to DESTINATION_BACKUP using relative names, + run: + + $ gcloud alpha bigtable backups copy \ + --source=projects/SOURCE_PROJECT/instances/SOURCE_INSTANCE/\ + clusters/SOURCE_CLUSTER/backups/SOURCE_BACKUP \ + --destination=projects/DESTINATION_PROJECT/instances/\ + DESTINATION_INSTANCE/clusters/DESTINATION_CLUSTER/backups/\ + DESTINATION_BACKUP --expiration-date=2022-08-01T10:49:41Z + + To set retention period and run asyncronously, run: + + $ gcloud alpha bigtable backups copy \ + --source=projects/SOURCE_PROJECT/instances/SOURCE_INSTANCE/\ + clusters/SOURCE_CLUSTER/backups/SOURCE_BACKUP \ + --destination=projects/DESTINATION_PROJECT/instances/\ + DESTINATION_INSTANCE/clusters/DESTINATION_CLUSTER/backups/\ + DESTINATION_BACKUP --retention-period=2w --async + +REQUIRED FLAGS + Backup resource - The destination to copy to. The arguments in this group + can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument --destination on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --destination=DESTINATION + ID of the backup or fully qualified identifier for the backup. To set + the source attribute: + ▸ provide the argument --destination on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --destination-cluster=DESTINATION_CLUSTER + The name of the Cloud Bigtable cluster. To set the cluster attribute: + ▸ provide the argument --destination on the command line with a + fully specified name; + ▸ provide the argument --destination-cluster on the command line. + + --destination-instance=DESTINATION_INSTANCE + The name of the Cloud Bigtable instance. To set the instance + attribute: + ▸ provide the argument --destination on the command line with a + fully specified name; + ▸ provide the argument --destination-instance on the command line; + ▸ provide the argument --source-instance on the command line. + + Exactly one of these must be specified: + + --expiration-date=EXPIRATION_DATE + Expiration time of the backup, must be at least 6 hours and at most + 30 days from the time the request is received. See $ gcloud topic + datetimes for information on date/time formats. + + --retention-period=RETENTION_PERIOD + Retention period of the backup relative from now, must be at least 6 + hours and at most 30 days. See $ gcloud topic datetimes for + information on duration formats. + + Backup resource - The source to copy from. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument --source on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --source=SOURCE + ID of the backup or fully qualified identifier for the backup. To set + the source attribute: + ▸ provide the argument --source on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --source-cluster=SOURCE_CLUSTER + The name of the Cloud Bigtable cluster. To set the cluster attribute: + ▸ provide the argument --source on the command line with a fully + specified name; + ▸ provide the argument --source-cluster on the command line. + + --source-instance=SOURCE_INSTANCE + The name of the Cloud Bigtable instance. To set the instance + attribute: + ▸ provide the argument --source on the command line with a fully + specified name; + ▸ provide the argument --source-instance on the command line; + ▸ provide the argument --destination-instance on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/bigtable/backups/help b/gcloud/alpha/bigtable/backups/help index ae4bf5fb3..1290a4d36 100644 --- a/gcloud/alpha/bigtable/backups/help +++ b/gcloud/alpha/bigtable/backups/help @@ -18,6 +18,9 @@ COMMANDS add-iam-policy-binding (ALPHA) Add an IAM policy binding to a Cloud Bigtable Backup. + copy + (ALPHA) Copy a Cloud Bigtable backup to a new backup. + create (ALPHA) Creates a backup of a Cloud Bigtable table. diff --git a/gcloud/alpha/bigtable/clusters/create b/gcloud/alpha/bigtable/clusters/create index 4ceeae0ba..652accfd3 100644 --- a/gcloud/alpha/bigtable/clusters/create +++ b/gcloud/alpha/bigtable/clusters/create @@ -7,9 +7,11 @@ SYNOPSIS [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [--num-nodes=NUM_NODES; default=3 - | --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET + | [--autoscaling-cpu-target=AUTOSCALING_CPU_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES - --autoscaling-min-nodes=AUTOSCALING_MIN_NODES] [GCLOUD_WIDE_FLAG ...] + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + : --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a bigtable cluster. @@ -103,8 +105,8 @@ OPTIONAL FLAGS Autoscaling --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET - The target CPU utilization percent for autoscaling. Accepted values - are from 10 to 80. + The target CPU utilization percentage for autoscaling. Accepted + values are from 10 to 80. This flag must be specified if any of the other arguments in this group are specified. @@ -121,6 +123,11 @@ OPTIONAL FLAGS This flag must be specified if any of the other arguments in this group are specified. + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + The target storage utilization gibibytes per node for autoscaling. + Accepted values are from 2560 to 5120 for SSD clusters and 8192 to + 16384 for HDD clusters. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/bigtable/clusters/update b/gcloud/alpha/bigtable/clusters/update index b24046a28..a1a70ad44 100644 --- a/gcloud/alpha/bigtable/clusters/update +++ b/gcloud/alpha/bigtable/clusters/update @@ -7,6 +7,7 @@ SYNOPSIS (--autoscaling-cpu-target=AUTOSCALING_CPU_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET | [--num-nodes=NUM_NODES : --disable-autoscaling]) [--async] [GCLOUD_WIDE_FLAG ...] @@ -52,8 +53,8 @@ REQUIRED FLAGS Autoscaling --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET - The target CPU utilization percent for autoscaling. Accepted values - are from 10 to 80. + The target CPU utilization percentage for autoscaling. Accepted + values are from 10 to 80. --autoscaling-max-nodes=AUTOSCALING_MAX_NODES The maximum number of nodes for autoscaling. @@ -61,6 +62,11 @@ REQUIRED FLAGS --autoscaling-min-nodes=AUTOSCALING_MIN_NODES The minimum number of nodes for autoscaling. + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + The target storage utilization gibibytes per node for autoscaling. + Accepted values are from 2560 to 5120 for SSD clusters and 8192 to + 16384 for HDD clusters. + Manual Scaling --num-nodes=NUM_NODES diff --git a/gcloud/alpha/bigtable/instances/create b/gcloud/alpha/bigtable/instances/create index a0053e70b..9725b57ef 100644 --- a/gcloud/alpha/bigtable/instances/create +++ b/gcloud/alpha/bigtable/instances/create @@ -7,7 +7,8 @@ SYNOPSIS [--cluster-config=[id=ID,zone=ZONE,nodes=NODES,kms-key=KMS_KEY, autoscaling-min-nodes=AUTOSCALING_MIN_NODES, autoscaling-max-nodes=AUTOSCALING_MAX_NODES, - autoscaling-cpu-target=AUTOSCALING_CPU_TARGET,...]] + autoscaling-cpu-target=AUTOSCALING_CPU_TARGET, + autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET,...]] [--cluster-num-nodes=CLUSTER_NUM_NODES] [--cluster-storage-type=CLUSTER_STORAGE_TYPE; default="ssd"] [--cluster-zone=CLUSTER_ZONE] @@ -68,7 +69,7 @@ OPTIONAL FLAGS The --cluster argument is deprecated; use --cluster-config instead. - --cluster-config=[id=ID,zone=ZONE,nodes=NODES,kms-key=KMS_KEY,autoscaling-min-nodes=AUTOSCALING_MIN_NODES,autoscaling-max-nodes=AUTOSCALING_MAX_NODES,autoscaling-cpu-target=AUTOSCALING_CPU_TARGET,...] + --cluster-config=[id=ID,zone=ZONE,nodes=NODES,kms-key=KMS_KEY,autoscaling-min-nodes=AUTOSCALING_MIN_NODES,autoscaling-max-nodes=AUTOSCALING_MAX_NODES,autoscaling-cpu-target=AUTOSCALING_CPU_TARGET,autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET,...] Repeatable. Specify cluster config as a key-value dictionary. This is the recommended argument for specifying cluster configurations. @@ -83,6 +84,14 @@ OPTIONAL FLAGS *kms-key*: The Cloud KMS (Key Management Service) cryptokey that will be used to protect the cluster. + *autoscaling-min-nodes*: The minimum number of nodes for autoscaling. + + *autoscaling-max-nodes*: The maximum number of nodes for autoscaling. + + *autoscaling-cpu-target*: The target CPU utilization percentage for autoscaling. Accepted values are from 10 to 80. + + *autoscaling-storage-target*: The target storage utilization gibibytes per node for autoscaling. Accepted values are from 2560 to 5120 for SSD clusters and 8192 to 16384 for HDD clusters. + If this argument is specified, the deprecated arguments for configuring a single cluster will be ignored, including --cluster, --cluster-zone, --cluster-num-nodes. diff --git a/gcloud/alpha/bigtable/instances/tables/help b/gcloud/alpha/bigtable/instances/tables/help index 91a275f28..faf59acd9 100644 --- a/gcloud/alpha/bigtable/instances/tables/help +++ b/gcloud/alpha/bigtable/instances/tables/help @@ -44,7 +44,7 @@ COMMANDS (ALPHA) Set an IAM policy on a Cloud Bigtable table. undelete - (ALPHA) Undeletes a previously deleted Cloud Bigtable table. + (ALPHA) Undelete a previously deleted Cloud Bigtable table. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/bigtable/instances/tables/undelete b/gcloud/alpha/bigtable/instances/tables/undelete index 8f0850d3e..8f947fb39 100644 --- a/gcloud/alpha/bigtable/instances/tables/undelete +++ b/gcloud/alpha/bigtable/instances/tables/undelete @@ -1,5 +1,5 @@ NAME - gcloud alpha bigtable instances tables undelete - undeletes a previously + gcloud alpha bigtable instances tables undelete - undelete a previously deleted Cloud Bigtable table SYNOPSIS @@ -7,7 +7,7 @@ SYNOPSIS (TABLE : --instance=INSTANCE) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Undeletes a previously deleted Cloud Bigtable table. + (ALPHA) Undelete a previously deleted Cloud Bigtable table. EXAMPLES To undelete the table 'my-table' in instance 'my-instance', run: @@ -63,5 +63,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud bigtable instances tables undelete + + $ gcloud beta bigtable instances tables undelete diff --git a/gcloud/alpha/builds/triggers/create/github b/gcloud/alpha/builds/triggers/create/github index 9dc529a51..af0c31ef2 100644 --- a/gcloud/alpha/builds/triggers/create/github +++ b/gcloud/alpha/builds/triggers/create/github @@ -7,9 +7,9 @@ SYNOPSIS (--trigger-config=PATH | [--repo-name=REPO_NAME --repo-owner=REPO_OWNER (--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; - default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH - | --dockerfile=DOCKERFILE --dockerfile-dir=DOCKERFILE_DIR; + default="COMMENTS_ENABLED"]) (--build-config=PATH + | --inline-config=PATH | --dockerfile=DOCKERFILE + --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE) : --description=DESCRIPTION --ignored-files=[GLOB,...] --include-logs-with-status --included-files=[GLOB,...] --name=NAME @@ -152,9 +152,21 @@ REQUIRED FLAGS This flag must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' - on a pull request before running the build. + on a pull request before running the build. COMMENT_CONTROL + must be one of: + + COMMENTS_DISABLED + Do not require comments on Pull Requests before builds are + triggered. + COMMENTS_ENABLED + Enforce that repository owners or collaborators must + comment on Pull Requests before builds are triggered. + COMMENTS_ENABLED_FOR_EXTERNAL_CONTRIBUTORS_ONLY + Enforce that repository owners or collaborators must + comment on external contributors' Pull Requests before + builds are triggered. Exactly one of these must be specified: diff --git a/gcloud/alpha/certificate-manager/certificates/create b/gcloud/alpha/certificate-manager/certificates/create index 243b77bef..54a640bb2 100644 --- a/gcloud/alpha/certificate-manager/certificates/create +++ b/gcloud/alpha/certificate-manager/certificates/create @@ -165,7 +165,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager certificates create $ gcloud beta certificate-manager certificates create diff --git a/gcloud/alpha/certificate-manager/certificates/delete b/gcloud/alpha/certificate-manager/certificates/delete index 41fbf358d..c7fa67278 100644 --- a/gcloud/alpha/certificate-manager/certificates/delete +++ b/gcloud/alpha/certificate-manager/certificates/delete @@ -58,7 +58,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager certificates delete $ gcloud beta certificate-manager certificates delete diff --git a/gcloud/alpha/certificate-manager/certificates/describe b/gcloud/alpha/certificate-manager/certificates/describe index fdab2fe6e..cd8a731d2 100644 --- a/gcloud/alpha/certificate-manager/certificates/describe +++ b/gcloud/alpha/certificate-manager/certificates/describe @@ -58,7 +58,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager certificates describe $ gcloud beta certificate-manager certificates describe diff --git a/gcloud/alpha/certificate-manager/certificates/help b/gcloud/alpha/certificate-manager/certificates/help index 37ea51ed1..b44a09ef1 100644 --- a/gcloud/alpha/certificate-manager/certificates/help +++ b/gcloud/alpha/certificate-manager/certificates/help @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager certificates $ gcloud beta certificate-manager certificates diff --git a/gcloud/alpha/certificate-manager/certificates/list b/gcloud/alpha/certificate-manager/certificates/list index eddb4815c..324625b2b 100644 --- a/gcloud/alpha/certificate-manager/certificates/list +++ b/gcloud/alpha/certificate-manager/certificates/list @@ -75,7 +75,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager certificates list $ gcloud beta certificate-manager certificates list diff --git a/gcloud/alpha/certificate-manager/certificates/update b/gcloud/alpha/certificate-manager/certificates/update index f0547a713..6b33b67c5 100644 --- a/gcloud/alpha/certificate-manager/certificates/update +++ b/gcloud/alpha/certificate-manager/certificates/update @@ -111,7 +111,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager certificates update $ gcloud beta certificate-manager certificates update diff --git a/gcloud/alpha/certificate-manager/dns-authorizations/create b/gcloud/alpha/certificate-manager/dns-authorizations/create index c4456ccb6..9bc676516 100644 --- a/gcloud/alpha/certificate-manager/dns-authorizations/create +++ b/gcloud/alpha/certificate-manager/dns-authorizations/create @@ -80,7 +80,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager dns-authorizations create $ gcloud beta certificate-manager dns-authorizations create diff --git a/gcloud/alpha/certificate-manager/dns-authorizations/delete b/gcloud/alpha/certificate-manager/dns-authorizations/delete index 6b3282bcb..ac65c19c8 100644 --- a/gcloud/alpha/certificate-manager/dns-authorizations/delete +++ b/gcloud/alpha/certificate-manager/dns-authorizations/delete @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager dns-authorizations delete $ gcloud beta certificate-manager dns-authorizations delete diff --git a/gcloud/alpha/certificate-manager/dns-authorizations/describe b/gcloud/alpha/certificate-manager/dns-authorizations/describe index 2780f37a5..0bd443800 100644 --- a/gcloud/alpha/certificate-manager/dns-authorizations/describe +++ b/gcloud/alpha/certificate-manager/dns-authorizations/describe @@ -58,7 +58,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager dns-authorizations describe $ gcloud beta certificate-manager dns-authorizations describe diff --git a/gcloud/alpha/certificate-manager/dns-authorizations/help b/gcloud/alpha/certificate-manager/dns-authorizations/help index 744f33ac6..d14c4571b 100644 --- a/gcloud/alpha/certificate-manager/dns-authorizations/help +++ b/gcloud/alpha/certificate-manager/dns-authorizations/help @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager dns-authorizations $ gcloud beta certificate-manager dns-authorizations diff --git a/gcloud/alpha/certificate-manager/dns-authorizations/list b/gcloud/alpha/certificate-manager/dns-authorizations/list index c341cbf61..8eed0183f 100644 --- a/gcloud/alpha/certificate-manager/dns-authorizations/list +++ b/gcloud/alpha/certificate-manager/dns-authorizations/list @@ -81,7 +81,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager dns-authorizations list $ gcloud beta certificate-manager dns-authorizations list diff --git a/gcloud/alpha/certificate-manager/dns-authorizations/update b/gcloud/alpha/certificate-manager/dns-authorizations/update index 2929bec7d..cabeffcd7 100644 --- a/gcloud/alpha/certificate-manager/dns-authorizations/update +++ b/gcloud/alpha/certificate-manager/dns-authorizations/update @@ -98,7 +98,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager dns-authorizations update $ gcloud beta certificate-manager dns-authorizations update diff --git a/gcloud/alpha/certificate-manager/help b/gcloud/alpha/certificate-manager/help index 673b1945e..1ce9690fb 100644 --- a/gcloud/alpha/certificate-manager/help +++ b/gcloud/alpha/certificate-manager/help @@ -32,7 +32,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager $ gcloud beta certificate-manager diff --git a/gcloud/alpha/certificate-manager/maps/create b/gcloud/alpha/certificate-manager/maps/create index 7fd5f6cd6..5a367b552 100644 --- a/gcloud/alpha/certificate-manager/maps/create +++ b/gcloud/alpha/certificate-manager/maps/create @@ -71,7 +71,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps create $ gcloud beta certificate-manager maps create diff --git a/gcloud/alpha/certificate-manager/maps/delete b/gcloud/alpha/certificate-manager/maps/delete index 05edb6579..7c410cf32 100644 --- a/gcloud/alpha/certificate-manager/maps/delete +++ b/gcloud/alpha/certificate-manager/maps/delete @@ -58,7 +58,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps delete $ gcloud beta certificate-manager maps delete diff --git a/gcloud/alpha/certificate-manager/maps/describe b/gcloud/alpha/certificate-manager/maps/describe index 8f6c6fe5a..c57b63fc6 100644 --- a/gcloud/alpha/certificate-manager/maps/describe +++ b/gcloud/alpha/certificate-manager/maps/describe @@ -55,7 +55,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps describe $ gcloud beta certificate-manager maps describe diff --git a/gcloud/alpha/certificate-manager/maps/entries/create b/gcloud/alpha/certificate-manager/maps/entries/create index eb02f0d78..e92e70051 100644 --- a/gcloud/alpha/certificate-manager/maps/entries/create +++ b/gcloud/alpha/certificate-manager/maps/entries/create @@ -113,7 +113,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps entries create $ gcloud beta certificate-manager maps entries create diff --git a/gcloud/alpha/certificate-manager/maps/entries/delete b/gcloud/alpha/certificate-manager/maps/entries/delete index 1e6c5d769..b001e5e88 100644 --- a/gcloud/alpha/certificate-manager/maps/entries/delete +++ b/gcloud/alpha/certificate-manager/maps/entries/delete @@ -68,7 +68,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps entries delete $ gcloud beta certificate-manager maps entries delete diff --git a/gcloud/alpha/certificate-manager/maps/entries/describe b/gcloud/alpha/certificate-manager/maps/entries/describe index cbcd26e0d..25fbad737 100644 --- a/gcloud/alpha/certificate-manager/maps/entries/describe +++ b/gcloud/alpha/certificate-manager/maps/entries/describe @@ -63,7 +63,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps entries describe $ gcloud beta certificate-manager maps entries describe diff --git a/gcloud/alpha/certificate-manager/maps/entries/help b/gcloud/alpha/certificate-manager/maps/entries/help index ac8892c74..05dcc76b6 100644 --- a/gcloud/alpha/certificate-manager/maps/entries/help +++ b/gcloud/alpha/certificate-manager/maps/entries/help @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps entries $ gcloud beta certificate-manager maps entries diff --git a/gcloud/alpha/certificate-manager/maps/entries/list b/gcloud/alpha/certificate-manager/maps/entries/list index 7ca296828..852f677bb 100644 --- a/gcloud/alpha/certificate-manager/maps/entries/list +++ b/gcloud/alpha/certificate-manager/maps/entries/list @@ -89,7 +89,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps entries list $ gcloud beta certificate-manager maps entries list diff --git a/gcloud/alpha/certificate-manager/maps/entries/update b/gcloud/alpha/certificate-manager/maps/entries/update index 1a4abc921..5b8b75ae2 100644 --- a/gcloud/alpha/certificate-manager/maps/entries/update +++ b/gcloud/alpha/certificate-manager/maps/entries/update @@ -121,7 +121,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps entries update $ gcloud beta certificate-manager maps entries update diff --git a/gcloud/alpha/certificate-manager/maps/help b/gcloud/alpha/certificate-manager/maps/help index 9f4f1bb4e..1effc9c9d 100644 --- a/gcloud/alpha/certificate-manager/maps/help +++ b/gcloud/alpha/certificate-manager/maps/help @@ -42,7 +42,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps $ gcloud beta certificate-manager maps diff --git a/gcloud/alpha/certificate-manager/maps/list b/gcloud/alpha/certificate-manager/maps/list index e4afc0766..92bac04b0 100644 --- a/gcloud/alpha/certificate-manager/maps/list +++ b/gcloud/alpha/certificate-manager/maps/list @@ -74,7 +74,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps list $ gcloud beta certificate-manager maps list diff --git a/gcloud/alpha/certificate-manager/maps/update b/gcloud/alpha/certificate-manager/maps/update index 80b8b0480..b4bb1b43f 100644 --- a/gcloud/alpha/certificate-manager/maps/update +++ b/gcloud/alpha/certificate-manager/maps/update @@ -93,7 +93,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager maps update $ gcloud beta certificate-manager maps update diff --git a/gcloud/alpha/certificate-manager/operations/describe b/gcloud/alpha/certificate-manager/operations/describe index 6eb47e406..71b1991cb 100644 --- a/gcloud/alpha/certificate-manager/operations/describe +++ b/gcloud/alpha/certificate-manager/operations/describe @@ -58,7 +58,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager operations describe $ gcloud beta certificate-manager operations describe diff --git a/gcloud/alpha/certificate-manager/operations/help b/gcloud/alpha/certificate-manager/operations/help index 5c51fbcbf..fcae05272 100644 --- a/gcloud/alpha/certificate-manager/operations/help +++ b/gcloud/alpha/certificate-manager/operations/help @@ -26,7 +26,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager operations $ gcloud beta certificate-manager operations diff --git a/gcloud/alpha/certificate-manager/operations/list b/gcloud/alpha/certificate-manager/operations/list index 218e0ecd0..3fccfcfd1 100644 --- a/gcloud/alpha/certificate-manager/operations/list +++ b/gcloud/alpha/certificate-manager/operations/list @@ -80,7 +80,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud certificate-manager operations list $ gcloud beta certificate-manager operations list diff --git a/gcloud/alpha/compute/instance-groups/managed/create b/gcloud/alpha/compute/instance-groups/managed/create index 2fb14dfab..2e7cb1267 100644 --- a/gcloud/alpha/compute/instance-groups/managed/create +++ b/gcloud/alpha/compute/instance-groups/managed/create @@ -7,6 +7,7 @@ SYNOPSIS --template=TEMPLATE [--base-instance-name=BASE_INSTANCE_NAME] [--description=DESCRIPTION] [--initial-delay=INITIAL_DELAY] [--instance-redistribution-type=TYPE] + [--list-managed-instances-results=MODE] [--stateful-disk=[auto-delete=AUTO-DELETE],[device-name=DEVICE-NAME]] [--stateful-external-ip=[enabled], [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]] @@ -77,6 +78,19 @@ OPTIONAL FLAGS TYPE must be one of: NONE, PROACTIVE. + --list-managed-instances-results=MODE + Pagination behavior for the group's listManagedInstances API method. + This flag does not affect the group's gcloud or console list-instances + behavior. By default it is set to PAGELESS. MODE must be one of: + + PAGELESS + Pagination is disabled for the group's listManagedInstances API + method. maxResults and pageToken query parameters are ignored and + all instances are returned in a single response. + PAGINATED + Pagination is enabled for the group's listManagedInstances API + method. maxResults and pageToken query parameters are respected. + --stateful-disk=[auto-delete=AUTO-DELETE],[device-name=DEVICE-NAME] Disks considered stateful by the instance group. Managed instance groups preserve and reattach stateful disks on VM autohealing, update, diff --git a/gcloud/alpha/compute/instance-groups/managed/update b/gcloud/alpha/compute/instance-groups/managed/update index 04a4ab8f0..2e902ac03 100644 --- a/gcloud/alpha/compute/instance-groups/managed/update +++ b/gcloud/alpha/compute/instance-groups/managed/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud alpha compute instance-groups managed update NAME [--description=DESCRIPTION] [--instance-redistribution-type=TYPE] + [--list-managed-instances-results=MODE] [--remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...]] [--remove-stateful-external-ips=INTERFACE_NAME,[...]] [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] @@ -70,6 +71,19 @@ FLAGS TYPE must be one of: NONE, PROACTIVE. + --list-managed-instances-results=MODE + Pagination behavior for the group's listManagedInstances API method. + This flag does not affect the group's gcloud or console list-instances + behavior. By default it is set to PAGELESS. MODE must be one of: + + PAGELESS + Pagination is disabled for the group's listManagedInstances API + method. maxResults and pageToken query parameters are ignored and + all instances are returned in a single response. + PAGINATED + Pagination is enabled for the group's listManagedInstances API + method. maxResults and pageToken query parameters are respected. + --remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...] Remove stateful configuration for the specified disks. diff --git a/gcloud/alpha/compute/os-config/troubleshoot b/gcloud/alpha/compute/os-config/troubleshoot index 714b21750..c67c8fb6d 100644 --- a/gcloud/alpha/compute/os-config/troubleshoot +++ b/gcloud/alpha/compute/os-config/troubleshoot @@ -10,7 +10,11 @@ DESCRIPTION (ALPHA) gcloud alpha compute os-config troubleshoot troubleshoots issues with the setup of VM Manager on a specified VM instance - Troubleshoot checks if the OS Config API is enabled for the instance. + The troubleshoot command investigates the following issues with VM Manager: + + + Checks if the OS Config API is enabled in the project. + + + Checks if the required metadata is set up correctly in the VM instance. EXAMPLES To troubleshoot an instance named my-instance in zone us-west1-a, run diff --git a/gcloud/alpha/compute/ssh b/gcloud/alpha/compute/ssh index 66f3f2fae..d964584d4 100644 --- a/gcloud/alpha/compute/ssh +++ b/gcloud/alpha/compute/ssh @@ -17,10 +17,8 @@ DESCRIPTION command that takes care of authentication and the translation of the instance name into an IP address. - Note, this command does not work when connecting to Windows VMs. To connect - to a Windows instance, including connecting using a command-line method, - refer to this guide: - https://cloud.google.com/compute/docs/instances/connecting-to-windows + To use SSH to connect to a Windows VM, refer to this guide: + https://cloud.google.com/compute/docs/connect/windows-ssh The default network comes preconfigured to allow ssh access to all VMs. If the default network was edited, or if not using the default network, you diff --git a/gcloud/alpha/container/aws/clusters/update b/gcloud/alpha/container/aws/clusters/update index 4d50c2c93..dae577590 100644 --- a/gcloud/alpha/container/aws/clusters/update +++ b/gcloud/alpha/container/aws/clusters/update @@ -7,8 +7,9 @@ SYNOPSIS [--admin-users=USER,[USER,...]] [--async] [--cluster-version=CLUSTER_VERSION] [--config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN] - [--instance-type=INSTANCE_TYPE] [--role-arn=ROLE_ARN] - [--role-session-name=ROLE_SESSION_NAME] + [--iam-instance-profile=IAM_INSTANCE_PROFILE] + [--instance-type=INSTANCE_TYPE] [--logging=COMPONENT,[COMPONENT,...]] + [--role-arn=ROLE_ARN] [--role-session-name=ROLE_SESSION_NAME] [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] @@ -71,9 +72,23 @@ FLAGS --config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN Amazon Resource Name (ARN) of the AWS KMS key to encrypt the user data. + --iam-instance-profile=IAM_INSTANCE_PROFILE + Name or ARN of the IAM instance profile associated with the cluster. + --instance-type=INSTANCE_TYPE AWS EC2 instance type for the control plane's nodes. + --logging=COMPONENT,[COMPONENT,...] + Set the components that have logging enabled. + + Examples: + + $ gcloud alpha container aws clusters update --logging=SYSTEM + $ gcloud alpha container aws clusters update \ + --logging=SYSTEM,WORKLOAD + + COMPONENT must be one of: SYSTEM, WORKLOAD. + --role-arn=ROLE_ARN Amazon Resource Name (ARN) of the IAM role to assume when managing AWS resources. diff --git a/gcloud/alpha/container/aws/node-pools/update b/gcloud/alpha/container/aws/node-pools/update index ba208b213..53d2da605 100644 --- a/gcloud/alpha/container/aws/node-pools/update +++ b/gcloud/alpha/container/aws/node-pools/update @@ -6,6 +6,7 @@ SYNOPSIS gcloud alpha container aws node-pools update (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] [--config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN] + [--iam-instance-profile=IAM_INSTANCE_PROFILE] [--node-version=NODE_VERSION] [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] @@ -71,6 +72,9 @@ FLAGS --config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN Amazon Resource Name (ARN) of the AWS KMS key to encrypt the user data. + --iam-instance-profile=IAM_INSTANCE_PROFILE + Name or ARN of the IAM instance profile associated with the node pool. + --node-version=NODE_VERSION Kubernetes version to use for the node pool. diff --git a/gcloud/alpha/container/azure/clusters/update b/gcloud/alpha/container/azure/clusters/update index e7c2d1560..bc507f0bf 100644 --- a/gcloud/alpha/container/azure/clusters/update +++ b/gcloud/alpha/container/azure/clusters/update @@ -6,8 +6,9 @@ SYNOPSIS gcloud alpha container azure clusters update (CLUSTER : --location=LOCATION) --client=CLIENT [--admin-users=USER,[USER,...]] [--async] - [--cluster-version=CLUSTER_VERSION] [--validate-only] - [--vm-size=VM_SIZE] [GCLOUD_WIDE_FLAG ...] + [--cluster-version=CLUSTER_VERSION] + [--logging=COMPONENT,[COMPONENT,...]] [--ssh-public-key=SSH_PUBLIC_KEY] + [--validate-only] [--vm-size=VM_SIZE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update an Anthos cluster on Azure. @@ -76,6 +77,20 @@ FLAGS --cluster-version=CLUSTER_VERSION Kubernetes version to use for the cluster. + --logging=COMPONENT,[COMPONENT,...] + Set the components that have logging enabled. + + Examples: + + $ gcloud alpha container azure clusters update --logging=SYSTEM + $ gcloud alpha container azure clusters update \ + --logging=SYSTEM,WORKLOAD + + COMPONENT must be one of: SYSTEM, WORKLOAD. + + --ssh-public-key=SSH_PUBLIC_KEY + SSH public key to use for authentication. + --validate-only Validate the update of the cluster, but don't actually perform it. diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index d4ef00c94..b70976946 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -20,7 +20,7 @@ SYNOPSIS [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autorepair] [--no-enable-autoupgrade] [--enable-binauthz] [--enable-cloud-logging] [--enable-cloud-monitoring] [--enable-cloud-run-alpha] - [--enable-confidential-nodes] [--enable-cost-management] + [--enable-confidential-nodes] [--enable-cost-allocation] [--enable-dataplane-v2] [--enable-gke-oidc] [--enable-gvnic] [--enable-identity-service] [--enable-image-streaming] [--enable-intra-node-visibility] [--enable-ip-alias] @@ -32,7 +32,7 @@ SYNOPSIS [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--identity-provider=IDENTITY_PROVIDER] [--image-type=IMAGE_TYPE] - [--issue-client-certificate] + [--ipv6-access-type=IPV6_ACCESS_TYPE] [--issue-client-certificate] [--istio-config=[auth=MTLS_PERMISSIVE,...]] [--labels=[KEY=VALUE,...]] [--linux-sysctls=KEY=VALUE,[KEY=VALUE,...]] [--logging=[COMPONENT,...]] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] @@ -53,7 +53,7 @@ SYNOPSIS [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] - [--subnetwork=SUBNETWORK] + [--stack-type=STACK_TYPE] [--subnetwork=SUBNETWORK] [--system-config-from-file=SYSTEM_CONFIG_FROM_FILE] [--tags=TAG,[TAG,...]] [--threads-per-core=THREADS_PER_CORE] [--workload-metadata=WORKLOAD_METADATA] [--workload-pool=WORKLOAD_POOL] @@ -67,8 +67,12 @@ SYNOPSIS --autoprovisioning-locations=ZONE,[ZONE,...] --autoprovisioning-min-cpu-platform=PLATFORM --min-cpu=MIN_CPU --min-memory=MIN_MEMORY - --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-scopes=[SCOPE, - ...] + --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...] + --enable-autoprovisioning-blue-green-upgrade + | --enable-autoprovisioning-surge-upgrade + --autoprovisioning-scopes=[SCOPE,...] --autoprovisioning-service-account=AUTOPROVISIONING_SERVICE_ACCOUNT --enable-autoprovisioning-autorepair --enable-autoprovisioning-autoupgrade @@ -379,7 +383,7 @@ FLAGS will create nodes using Confidential VM https://cloud.google.com/compute/confidential-vm/docs/about-cvm. - --enable-cost-management + --enable-cost-allocation Enable the cost management feature. When enabled, you can get informational GKE cost breakdowns by cluster, @@ -531,6 +535,10 @@ FLAGS $ gcloud container get-server-config + --ipv6-access-type=IPV6_ACCESS_TYPE + IPv6 access type of the subnetwork. Defaults to 'external'. + IPV6_ACCESS_TYPE must be one of: external, internal. + --issue-client-certificate Issue a TLS client certificate with admin permissions. @@ -930,6 +938,10 @@ FLAGS New nodes, including ones created by resize or recreate, will use spot VM instances. + --stack-type=STACK_TYPE + IP stack type of the node VMs. Defaults to 'ipv4'. STACK_TYPE must be + one of: ipv4, ipv4-ipv6. + --subnetwork=SUBNETWORK The Google Compute Engine subnetwork (https://cloud.google.com/compute/docs/subnetworks) to which the @@ -1256,6 +1268,37 @@ FLAGS Number of nodes that can be unavailable at the same time on each upgrade of an autoprovisioned node pool. + --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the update. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + Batch sizes are specfied by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + Example: + --standard-rollout-policy=batch-node-count=3,batch-soak-duration=60s + --standard-rollout-policy=batch-percent=0.05,batch-soak-duration=180s + + Flag group to choose the top level upgrade option: + + At most one of these can be specified: + + --enable-autoprovisioning-blue-green-upgrade + Whether to use blue-green upgrade for the autoprovisioned + node pool. + + --enable-autoprovisioning-surge-upgrade + Whether to use surge upgrade for the autoprovisioned node + pool. + Flags to specify identity for autoprovisioned nodes: --autoprovisioning-scopes=[SCOPE,...] diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 1850e4e38..a310d0022 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -10,7 +10,7 @@ SYNOPSIS | --database-encryption-key=DATABASE_ENCRYPTION_KEY | --disable-database-encryption | --disable-default-snat | --disable-workload-identity | --enable-autoscaling - | --enable-binauthz | --enable-cost-management | --enable-gke-oidc + | --enable-binauthz | --enable-cost-allocation | --enable-gke-oidc | --enable-identity-service | --enable-image-streaming | --enable-intra-node-visibility | --enable-l4-ilb-subsetting | --enable-legacy-authorization @@ -51,8 +51,12 @@ SYNOPSIS --autoprovisioning-locations=ZONE,[ZONE,...] --autoprovisioning-min-cpu-platform=PLATFORM --max-cpu=MAX_CPU --max-memory=MAX_MEMORY --min-cpu=MIN_CPU --min-memory=MIN_MEMORY - --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-scopes=[SCOPE, - ...] + --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...] + --enable-autoprovisioning-blue-green-upgrade + | --enable-autoprovisioning-surge-upgrade + --autoprovisioning-scopes=[SCOPE,...] --autoprovisioning-service-account=AUTOPROVISIONING_SERVICE_ACCOUNT --enable-autoprovisioning-autorepair --enable-autoprovisioning-autoupgrade @@ -181,7 +185,7 @@ REQUIRED FLAGS --enable-binauthz Enable Binary Authorization for this cluster. - --enable-cost-management + --enable-cost-allocation Enable the cost management feature. When enabled, you can get informational GKE cost breakdowns by @@ -189,7 +193,7 @@ REQUIRED FLAGS BigQuery (https://cloud.google.com/billing/docs/how-to/export-data-bigquery). - Use --no-enable-cost-management to disable this feature. + Use --no-enable-cost-allocation to disable this feature. --enable-gke-oidc (DEPRECATED) Enable GKE OIDC authentication on the cluster. @@ -855,6 +859,37 @@ REQUIRED FLAGS Number of nodes that can be unavailable at the same time on each upgrade of an autoprovisioned node pool. + --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the update. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + Batch sizes are specfied by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + Example: + --standard-rollout-policy=batch-node-count=3,batch-soak-duration=60s + --standard-rollout-policy=batch-percent=0.05,batch-soak-duration=180s + + Flag group to choose the top level upgrade option: + + At most one of these can be specified: + + --enable-autoprovisioning-blue-green-upgrade + Whether to use blue-green upgrade for the autoprovisioned + node pool. + + --enable-autoprovisioning-surge-upgrade + Whether to use surge upgrade for the autoprovisioned node + pool. + Flags to specify identity for autoprovisioned nodes: --autoprovisioning-scopes=[SCOPE,...] diff --git a/gcloud/alpha/container/node-pools/complete-upgrade b/gcloud/alpha/container/node-pools/complete-upgrade new file mode 100644 index 000000000..e5f97749f --- /dev/null +++ b/gcloud/alpha/container/node-pools/complete-upgrade @@ -0,0 +1,57 @@ +NAME + gcloud alpha container node-pools complete-upgrade - complete a node pool + upgrade + +SYNOPSIS + gcloud alpha container node-pools complete-upgrade NAME [--cluster=CLUSTER] + [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Complete a node pool upgrade. + + Complete upgrade is a method used to skip the remaining node pool soaking + phase during blue-green node pool upgrades. + +EXAMPLES + To complete an active upgrade in node-pool-1 in the cluster sample-cluster, + run: + + $ gcloud alpha container node-pools complete-upgrade node-pool-1 \ + --cluster=sample-cluster + +POSITIONAL ARGUMENTS + NAME + Name of the node pool for which the upgrade is to be completed. + +FLAGS + --cluster=CLUSTER + Cluster to which the node pool belongs. Overrides the default + container/cluster property value for this command invocation. + + At most one of these can be specified: + + --region=REGION + Compute region (e.g. us-central1) for the cluster. + + --zone=ZONE, -z ZONE + Compute zone (e.g. us-central1-a) for the cluster. Overrides the + default compute/zone property value for this command invocation. + +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 help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud container node-pools complete-upgrade + + $ gcloud beta container node-pools complete-upgrade + diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index f23fded70..54a3cf2d3 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -9,9 +9,9 @@ SYNOPSIS [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autoprovisioning] [--enable-autorepair] [--no-enable-autoupgrade] - [--enable-confidential-nodes] [--enable-gvnic] - [--enable-image-streaming] [--image-type=IMAGE_TYPE] - [--linux-sysctls=KEY=VALUE,[KEY=VALUE,...]] + [--enable-blue-green-upgrade] [--enable-confidential-nodes] + [--enable-gvnic] [--enable-image-streaming] [--enable-surge-upgrade] + [--image-type=IMAGE_TYPE] [--linux-sysctls=KEY=VALUE,[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] [--max-surge-upgrade=MAX_SURGE_UPGRADE; default=1] @@ -21,11 +21,15 @@ SYNOPSIS [--min-cpu-platform=PLATFORM] [--network-performance-configs=[PROPERTY=VALUE,...]] [--node-group=NODE_GROUP] [--node-labels=[NODE_LABEL,...]] - [--node-locations=ZONE,[ZONE,...]] [--node-taints=[NODE_TAINT,...]] - [--node-version=NODE_VERSION] [--num-nodes=NUM_NODES; default=3] - [--placement-type=PLACEMENT_TYPE] [--preemptible] - [--sandbox=[type=TYPE]] [--shielded-integrity-monitoring] - [--shielded-secure-boot] [--spot] + [--node-locations=ZONE,[ZONE,...]] + [--node-pool-soak-duration=NODE_POOL_SOAK_DURATION] + [--node-taints=[NODE_TAINT,...]] [--node-version=NODE_VERSION] + [--num-nodes=NUM_NODES; default=3] [--placement-type=PLACEMENT_TYPE] + [--preemptible] [--sandbox=[type=TYPE]] + [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] + [--standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...]] [--system-config-from-file=SYSTEM_CONFIG_FROM_FILE] [--tags=TAG,[TAG,...]] [--threads-per-core=THREADS_PER_CORE] [--workload-metadata=WORKLOAD_METADATA] @@ -135,6 +139,9 @@ FLAGS Enabled by default, use --no-enable-autoupgrade to disable. + --enable-blue-green-upgrade + Changes node pool upgrade strategy to blue-green upgrade. + --enable-confidential-nodes Enable confidential nodes for the node pool. Enabling Confidential Nodes will create nodes using Confidential VM @@ -147,6 +154,9 @@ FLAGS --enable-image-streaming Specifies whether to enable image streaming on node pool. + --enable-surge-upgrade + Changes node pool upgrade strategy to surge upgrade. + --image-type=IMAGE_TYPE The image type to use for the node pool. Defaults to server-specified. @@ -337,6 +347,13 @@ FLAGS --cluster=sample-cluster \ --node-locations=us-central1-a,us-central1-b + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade before + deleting the blue pool and completing the upgrade. + + $ gcloud alpha container node-pools create node-pool-1 \ + --cluster=example-cluster --node-pool-soak-duration=600s + --node-taints=[NODE_TAINT,...] Applies the given kubernetes taints on all nodes in the new node pool, which can be used with tolerations for pod scheduling. @@ -416,6 +433,22 @@ FLAGS New nodes, including ones created by resize or recreate, will use spot VM instances. + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. + + Batch sizes are specfied by one of, batch-node-count or batch-percent. + The duration between batches is specified by batch-soak-duration. + + $ gcloud alpha container node-pools create node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-node-count=3,\ + batch-soak-duration=60s + + $ gcloud alpha container node-pools create node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-percent=0.3,\ + batch-soak-duration=60s + --system-config-from-file=SYSTEM_CONFIG_FROM_FILE Path of the YAML/JSON file that contains the node configuration, including Linux kernel parameters (sysctls) and kubelet configs. diff --git a/gcloud/alpha/container/node-pools/help b/gcloud/alpha/container/node-pools/help index 9f320cae5..76ad8a458 100644 --- a/gcloud/alpha/container/node-pools/help +++ b/gcloud/alpha/container/node-pools/help @@ -34,6 +34,9 @@ GROUPS COMMANDS COMMAND is one of the following: + complete-upgrade + (ALPHA) Complete a node pool upgrade. + create (ALPHA) Create a node pool in a running cluster. diff --git a/gcloud/alpha/container/node-pools/rollback b/gcloud/alpha/container/node-pools/rollback index 136905baf..c52ba4912 100644 --- a/gcloud/alpha/container/node-pools/rollback +++ b/gcloud/alpha/container/node-pools/rollback @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud alpha container node-pools rollback NAME [--async] - [--cluster=CLUSTER] [--region=REGION | --zone=ZONE, -z ZONE] - [GCLOUD_WIDE_FLAG ...] + [--cluster=CLUSTER] [--respect-pdb=RESPECT_PDB] + [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Rollback a node-pool upgrade. @@ -32,6 +32,10 @@ FLAGS The cluster from which to rollback the node pool. Overrides the default container/cluster property value for this command invocation. + --respect-pdb=RESPECT_PDB + Indicates whether node pool rollbacks should respect pod disruption + budgets. + At most one of these can be specified: --region=REGION diff --git a/gcloud/alpha/container/node-pools/update b/gcloud/alpha/container/node-pools/update index 735ede0ef..645918092 100644 --- a/gcloud/alpha/container/node-pools/update +++ b/gcloud/alpha/container/node-pools/update @@ -14,17 +14,21 @@ SYNOPSIS | --enable-autoprovisioning --enable-autoscaling --max-nodes=MAX_NODES --min-nodes=MIN_NODES | --enable-autorepair --enable-autoupgrade - | --max-surge-upgrade=MAX_SURGE_UPGRADE - --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE) - [--cluster=CLUSTER] [--region=REGION | --zone=ZONE, -z ZONE] - [GCLOUD_WIDE_FLAG ...] + | --enable-blue-green-upgrade --enable-surge-upgrade + --max-surge-upgrade=MAX_SURGE_UPGRADE + --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...]) [--cluster=CLUSTER] + [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha container node-pools update updates a node pool in a Google Kubernetes Engine cluster. EXAMPLES - To turn on node auto repair in "node-pool-1" in the cluster + To turn on node autoupgrade in "node-pool-1" in the cluster "sample-cluster", run: $ gcloud alpha container node-pools update node-pool-1 \ @@ -254,6 +258,12 @@ REQUIRED FLAGS Upgrade settings + --enable-blue-green-upgrade + Changes node pool upgrade strategy to blue-green upgrade. + + --enable-surge-upgrade + Changes node pool upgrade strategy to surge upgrade. + --max-surge-upgrade=MAX_SURGE_UPGRADE Number of extra (surge) nodes to be created on each upgrade of the node pool. @@ -286,6 +296,30 @@ REQUIRED FLAGS Must be used in conjunction with '--max-surge-upgrade'. + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the upgrade. + + $ gcloud alpha container node-pools update node-pool-1 \ + --cluster=example-cluster --node-pool-soak-duration=600s + + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. + + Batch sizes are specfied by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + $ gcloud alpha container node-pools update node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-node-count=3,\ + batch-soak-duration=60s + + $ gcloud alpha container node-pools update node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-percent=0.3,\ + batch-soak-duration=60s + OPTIONAL FLAGS --cluster=CLUSTER The name of the cluster. Overrides the default container/cluster diff --git a/gcloud/alpha/container/operations/cancel b/gcloud/alpha/container/operations/cancel index 98bbdc501..5c2ca2636 100644 --- a/gcloud/alpha/container/operations/cancel +++ b/gcloud/alpha/container/operations/cancel @@ -47,7 +47,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container operations cancel $ gcloud beta container operations cancel diff --git a/gcloud/alpha/deploy/releases/abandon b/gcloud/alpha/deploy/releases/abandon new file mode 100644 index 000000000..e442103cd --- /dev/null +++ b/gcloud/alpha/deploy/releases/abandon @@ -0,0 +1,78 @@ +NAME + gcloud alpha deploy releases abandon - abandons a release + +SYNOPSIS + gcloud alpha deploy releases abandon + (RELEASE : --delivery-pipeline=DELIVERY_PIPELINE --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) After a release is abandoned, no new rollouts can be created from + it. + + Rollouts of abandoned releases can't be rolled back to. + + Existing rollouts of abandoned releases will be unaffected. + +EXAMPLES + To abandon a release called test-release for delivery pipeline + test-pipeline in region us-central1, run: + + $ gcloud alpha deploy releases abandon test-release \ + --delivery-pipeline=test-pipeline --region=us-central1 + +POSITIONAL ARGUMENTS + Release resource - The name of the Release. The arguments in this group + can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument release on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + RELEASE + ID of the release or fully qualified identifier for the release. To + set the release attribute: + ▸ provide the argument release on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --delivery-pipeline=DELIVERY_PIPELINE + The delivery pipeline associated with the release. Alternatively, set + the property [deploy/delivery-pipeline]. To set the delivery-pipeline + attribute: + ▸ provide the argument release on the command line with a fully + specified name; + ▸ provide the argument --delivery-pipeline on the command line; + ▸ set the property deploy/delivery_pipeline. + + --region=REGION + The Cloud region for the release. Alternatively, set the property + [deploy/region]. To set the region attribute: + ▸ provide the argument release on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + +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 help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud deploy releases abandon + + $ gcloud beta deploy releases abandon + diff --git a/gcloud/alpha/deploy/releases/help b/gcloud/alpha/deploy/releases/help index 07275cc6e..5bff7dcb8 100644 --- a/gcloud/alpha/deploy/releases/help +++ b/gcloud/alpha/deploy/releases/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + abandon + (ALPHA) Abandons a release. + create (ALPHA) Creates a new release, delivery pipeline qualified. diff --git a/gcloud/alpha/kms/import-jobs/create b/gcloud/alpha/kms/import-jobs/create index 1c915c947..96c48ef4e 100644 --- a/gcloud/alpha/kms/import-jobs/create +++ b/gcloud/alpha/kms/import-jobs/create @@ -27,7 +27,9 @@ REQUIRED FLAGS The wrapping method to be used for incoming key material. For more information about choosing an import method, see https://cloud.google.com/kms/docs/key-wrapping. IMPORT_METHOD must be - one of: rsa-oaep-3072-sha1-aes-256, rsa-oaep-4096-sha1-aes-256. + one of: rsa-oaep-3072-sha1-aes-256, rsa-oaep-3072-sha256, + rsa-oaep-3072-sha256-aes-256, rsa-oaep-4096-sha1-aes-256, + rsa-oaep-4096-sha256, rsa-oaep-4096-sha256-aes-256. --protection-level=PROTECTION_LEVEL Protection level of the import job. PROTECTION_LEVEL must be one of: diff --git a/gcloud/alpha/pubsub/subscriptions/ack b/gcloud/alpha/pubsub/subscriptions/ack index f7e783853..f32ad2cbb 100644 --- a/gcloud/alpha/pubsub/subscriptions/ack +++ b/gcloud/alpha/pubsub/subscriptions/ack @@ -3,8 +3,8 @@ NAME on the specified subscription SYNOPSIS - gcloud alpha pubsub subscriptions ack SUBSCRIPTION [ACK_ID ...] - [--ack-ids=[ACK_ID,...]] [GCLOUD_WIDE_FLAG ...] + gcloud alpha pubsub subscriptions ack SUBSCRIPTION + ([ACK_ID ...] --ack-ids=[ACK_ID,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Acknowledges one or more messages as having been successfully @@ -32,22 +32,24 @@ POSITIONAL ARGUMENTS subscription. To set the subscription attribute: ▸ provide the argument subscription on the command line. - [ACK_ID ...] - (DEPRECATED) One or more ACK_ID to acknowledge. An ACK_ID is a string - that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + Exactly one of these must be specified: - Positional argument ACK_ID is deprecated. Please use --ack-ids instead. + [ACK_ID ...] + (DEPRECATED) One or more ACK_IDs to acknowledge. An ACK_ID is a + string that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). -FLAGS - --ack-ids=[ACK_ID,...] - One or more ACK_ID to acknowledge. An ACK_ID is a string that is - returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + Positional argument ACK_ID is deprecated. Please use --ack-ids + instead. + + --ack-ids=[ACK_ID,...] + One or more ACK_IDs to acknowledge. An ACK_ID is a string that is + returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/pubsub/subscriptions/modify-ack-deadline b/gcloud/alpha/pubsub/subscriptions/modify-ack-deadline index f29bb70eb..f07516274 100644 --- a/gcloud/alpha/pubsub/subscriptions/modify-ack-deadline +++ b/gcloud/alpha/pubsub/subscriptions/modify-ack-deadline @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha pubsub subscriptions modify-ack-deadline SUBSCRIPTION - [ACK_ID ...] --ack-deadline=ACK_DEADLINE [--ack-ids=[ACK_ID,...]] + ([ACK_ID ...] --ack-ids=[ACK_ID,...]) --ack-deadline=ACK_DEADLINE [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -35,28 +35,30 @@ POSITIONAL ARGUMENTS subscription. To set the subscription attribute: ▸ provide the argument subscription on the command line. - [ACK_ID ...] - (DEPRECATED) One or more ACK_ID to modify the deadline for. An ACK_ID - is a string that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + Exactly one of these must be specified: - Positional argument ACK_ID is deprecated. Please use --ack-ids instead. + [ACK_ID ...] + (DEPRECATED) One or more ACK_IDs to modify the deadline for. An + ACK_ID is a string that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + + Positional argument ACK_ID is deprecated. Please use --ack-ids + instead. + + --ack-ids=[ACK_ID,...] + One or more ACK_IDs to modify the deadline for. An ACK_ID is a string + that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). REQUIRED FLAGS --ack-deadline=ACK_DEADLINE The number of seconds the system will wait for a subscriber to acknowledge receiving a message before re-attempting delivery. -OPTIONAL FLAGS - --ack-ids=[ACK_ID,...] - One or more ACK_ID to modify the deadline for. An ACK_ID is a string - that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/pubsub/subscriptions/modify-message-ack-deadline b/gcloud/alpha/pubsub/subscriptions/modify-message-ack-deadline index 0923ae398..9c0eb7cc8 100644 --- a/gcloud/alpha/pubsub/subscriptions/modify-message-ack-deadline +++ b/gcloud/alpha/pubsub/subscriptions/modify-message-ack-deadline @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha pubsub subscriptions modify-message-ack-deadline SUBSCRIPTION - [ACK_ID ...] --ack-deadline=ACK_DEADLINE [--ack-ids=[ACK_ID,...]] + ([ACK_ID ...] --ack-ids=[ACK_ID,...]) --ack-deadline=ACK_DEADLINE [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -29,28 +29,30 @@ POSITIONAL ARGUMENTS subscription. To set the subscription attribute: ▸ provide the argument subscription on the command line. - [ACK_ID ...] - (DEPRECATED) One or more ACK_ID to modify the deadline for. An ACK_ID - is a string that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + Exactly one of these must be specified: - Positional argument ACK_ID is deprecated. Please use --ack-ids instead. + [ACK_ID ...] + (DEPRECATED) One or more ACK_IDs to modify the deadline for. An + ACK_ID is a string that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + + Positional argument ACK_ID is deprecated. Please use --ack-ids + instead. + + --ack-ids=[ACK_ID,...] + One or more ACK_IDs to modify the deadline for. An ACK_ID is a string + that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). REQUIRED FLAGS --ack-deadline=ACK_DEADLINE The number of seconds the system will wait for a subscriber to acknowledge receiving a message before re-attempting delivery. -OPTIONAL FLAGS - --ack-ids=[ACK_ID,...] - One or more ACK_ID to modify the deadline for. An ACK_ID is a string - that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/run/revisions/logs/help b/gcloud/alpha/run/revisions/logs/help index d8c972074..2e70a074b 100644 --- a/gcloud/alpha/run/revisions/logs/help +++ b/gcloud/alpha/run/revisions/logs/help @@ -99,6 +99,9 @@ COMMANDS read (ALPHA) Read logs for a revision. + tail + (ALPHA) Tail logs for a revision. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/run/revisions/logs/tail b/gcloud/alpha/run/revisions/logs/tail new file mode 100644 index 000000000..1b1713bba --- /dev/null +++ b/gcloud/alpha/run/revisions/logs/tail @@ -0,0 +1,127 @@ +NAME + gcloud alpha run revisions logs tail - tail logs for a revision + +SYNOPSIS + gcloud alpha run revisions logs tail REVISION [--log-filter=LOG_FILTER] + [--platform=PLATFORM; default="managed"] + [--region=REGION + | --cluster=CLUSTER --cluster-location=CLUSTER_LOCATION + | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha run revisions logs tail tails log-entries for a + particular Cloud Run revision in real time. The log entries are formatted + for consumption in a terminal. + +EXAMPLES + To tail log entries for a Cloud Run revision, run: + + $ gcloud alpha run revisions logs tail my-revision + + To tail log entries with severity ERROR or higher, run: + + $ gcloud alpha run revisions logs tail my-revision \ + --log-filter="severity>=ERROR" + + Detailed information about filters can be found at: + https://cloud.google.com/logging/docs/view/advanced_filters + +POSITIONAL ARGUMENTS + REVISION + Name for a Cloud Run revision. + +FLAGS + --log-filter=LOG_FILTER + Filter expression that specifies the log entries to return. Detailed + information about filters can be found at: + https://cloud.google.com/logging/docs/view/logging-query-language + + --platform=PLATFORM; default="managed" + Target platform for running commands. Alternatively, set the property + [run/platform]. PLATFORM must be one of: + + managed + Fully managed version of Cloud Run. Use with the --region flag or + set the [run/region] property to specify a Cloud Run region. + gke + Cloud Run for Anthos on Google Cloud. Use with the --cluster and + --cluster-location flags or set the [run/cluster] and + [run/cluster_location] properties to specify a cluster in a given + zone. + kubernetes + Use a Knative-compatible kubernetes cluster. Use with the + --kubeconfig and --context flags to specify a kubeconfig file and + the context for connecting. + + Arguments to locate resources, depending on the platform used. + + At most one of these can be specified: + + Only applicable if connecting to Cloud Run (fully managed). Specify + --platform=managed to use: + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + Only applicable if connecting to Cloud Run for Anthos deployed on Google + Cloud. Specify --platform=gke to use: + + Cluster resource - Kubernetes Engine cluster to connect to. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group + but can be set in other ways. To set the project attribute: + ▫ provide the argument --cluster on the command line with a fully + specified name; + ▫ set the property run/cluster with a fully specified name; + ▫ specify the cluster from a list of available clusters with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --cluster=CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + To set the cluster attribute: + ◇ provide the argument --cluster on the command line; + ◇ set the property run/cluster; + ◇ specify the cluster from a list of available clusters. + + --cluster-location=CLUSTER_LOCATION + Zone in which the cluster is located. Alternatively, set the + property [run/cluster_location]. To set the location attribute: + ◇ provide the argument --cluster on the command line with a + fully specified name; + ◇ set the property run/cluster with a fully specified name; + ◇ specify the cluster from a list of available clusters with a + fully specified name; + ◇ provide the argument --cluster-location on the command line; + ◇ set the property run/cluster_location; + ◇ specify the cluster location from a list of available zones. + + Only applicable if connecting to Cloud Run for Anthos deployed on + VMware. Specify --platform=kubernetes to use: + + --context=CONTEXT + The name of the context in your kubectl config file to use for + connecting. + + --kubeconfig=KUBECONFIG + The absolute path to your kubectl config file. If not specified, + the colon- or semicolon-delimited list of paths specified by + $KUBECONFIG will be used. If $KUBECONFIG is unset, this defaults to + ~/.kube/config. + +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 help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/run/services/logs/tail b/gcloud/alpha/run/services/logs/tail index af58a1219..062a54ab7 100644 --- a/gcloud/alpha/run/services/logs/tail +++ b/gcloud/alpha/run/services/logs/tail @@ -13,6 +13,19 @@ DESCRIPTION particular Cloud Run service in real time. The log entries are formatted for consumption in a terminal. +EXAMPLES + To tail log entries for a Cloud Run Service, run: + + $ gcloud alpha run services logs tail my-service + + To tail log entries with severity ERROR or higher, run: + + $ gcloud alpha run services logs tail my-service \ + --log-filter="severity>=ERROR" + + Detailed information about filters can be found at: + https://cloud.google.com/logging/docs/view/advanced_filters + POSITIONAL ARGUMENTS SERVICE Name for a Cloud Run service. diff --git a/gcloud/alpha/scc/settings/services/describe b/gcloud/alpha/scc/settings/services/describe index ab9222891..8eaea7b12 100644 --- a/gcloud/alpha/scc/settings/services/describe +++ b/gcloud/alpha/scc/settings/services/describe @@ -21,7 +21,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/describe-explicit b/gcloud/alpha/scc/settings/services/describe-explicit index cd7be41af..5064b27b4 100644 --- a/gcloud/alpha/scc/settings/services/describe-explicit +++ b/gcloud/alpha/scc/settings/services/describe-explicit @@ -20,7 +20,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/disable b/gcloud/alpha/scc/settings/services/disable index 3497bc75c..0d1b950e2 100644 --- a/gcloud/alpha/scc/settings/services/disable +++ b/gcloud/alpha/scc/settings/services/disable @@ -20,7 +20,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/enable b/gcloud/alpha/scc/settings/services/enable index e0d0d02de..21256c483 100644 --- a/gcloud/alpha/scc/settings/services/enable +++ b/gcloud/alpha/scc/settings/services/enable @@ -20,7 +20,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/inherit b/gcloud/alpha/scc/settings/services/inherit index 678306b1e..c5a40053b 100644 --- a/gcloud/alpha/scc/settings/services/inherit +++ b/gcloud/alpha/scc/settings/services/inherit @@ -21,7 +21,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/describe b/gcloud/alpha/scc/settings/services/modules/describe index a19f50d74..3c7c8306f 100644 --- a/gcloud/alpha/scc/settings/services/modules/describe +++ b/gcloud/alpha/scc/settings/services/modules/describe @@ -26,7 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/describe-explicit b/gcloud/alpha/scc/settings/services/modules/describe-explicit index c37d33d86..d8380f8a3 100644 --- a/gcloud/alpha/scc/settings/services/modules/describe-explicit +++ b/gcloud/alpha/scc/settings/services/modules/describe-explicit @@ -26,7 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/disable b/gcloud/alpha/scc/settings/services/modules/disable index a5a3ca8dc..dcd7de1d8 100644 --- a/gcloud/alpha/scc/settings/services/modules/disable +++ b/gcloud/alpha/scc/settings/services/modules/disable @@ -26,7 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/enable b/gcloud/alpha/scc/settings/services/modules/enable index a92f61fe5..2f18d48e8 100644 --- a/gcloud/alpha/scc/settings/services/modules/enable +++ b/gcloud/alpha/scc/settings/services/modules/enable @@ -26,7 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/update b/gcloud/alpha/scc/settings/services/modules/update index 8796617ca..6bac986db 100644 --- a/gcloud/alpha/scc/settings/services/modules/update +++ b/gcloud/alpha/scc/settings/services/modules/update @@ -52,7 +52,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - security-health-analytics, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS Config value group in Security Command Center. diff --git a/gcloud/alpha/vmware/network-peerings/help b/gcloud/alpha/vmware/network-peerings/help index 476ecf809..9e6c6a1f1 100644 --- a/gcloud/alpha/vmware/network-peerings/help +++ b/gcloud/alpha/vmware/network-peerings/help @@ -3,7 +3,7 @@ NAME using Google Cloud VMware Engine SYNOPSIS - gcloud alpha vmware network-peerings COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud alpha vmware network-peerings GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Manage VMware Engine VPC peering using Google Cloud VMware Engine. @@ -13,6 +13,13 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + routes + (ALPHA) Manage VMware Engine VPC peering routes using Google Cloud + VMware Engine. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/alpha/vmware/network-peerings/routes/help b/gcloud/alpha/vmware/network-peerings/routes/help new file mode 100644 index 000000000..a7f097f1a --- /dev/null +++ b/gcloud/alpha/vmware/network-peerings/routes/help @@ -0,0 +1,28 @@ +NAME + gcloud alpha vmware network-peerings routes - manage VMware Engine VPC + peering routes using Google Cloud VMware Engine + +SYNOPSIS + gcloud alpha vmware network-peerings routes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage VMware Engine VPC peering routes using Google Cloud VMware + Engine. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + (ALPHA) List Google Cloud VMware Engine VPC network peering routes. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/vmware/network-peerings/routes/list b/gcloud/alpha/vmware/network-peerings/routes/list new file mode 100644 index 000000000..d701dabb2 --- /dev/null +++ b/gcloud/alpha/vmware/network-peerings/routes/list @@ -0,0 +1,91 @@ +NAME + gcloud alpha vmware network-peerings routes list - list Google Cloud VMware + Engine VPC network peering routes + +SYNOPSIS + gcloud alpha vmware network-peerings routes list + --network-peering=NETWORK_PEERING [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List VPC network peering routes across all locations in your + project. + +EXAMPLES + To list peering routes imported from peer network via my-peering: + + $ gcloud alpha vmware network-peerings routes list \ + --network-peering=my-peering --filter="direction=INCOMING" + + To list peering routes exported to peer network via my-peering: + + $ gcloud alpha vmware network-peerings routes list \ + --network-peering=my-peering --filter="direction=OUTGOING" + + In above examples, the location is taken as global. + +REQUIRED FLAGS + VMware Engine VPC network peering resource - network_peering. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --network-peering on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + --network-peering=NETWORK_PEERING + ID of the VMware Engine VPC network peering or fully qualified + identifier for the VMware Engine VPC network peering. To set the + network-peering attribute: + ▸ provide the argument --network-peering on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/beta/bigtable/clusters/create b/gcloud/beta/bigtable/clusters/create index 6d45a682b..913a6c4e7 100644 --- a/gcloud/beta/bigtable/clusters/create +++ b/gcloud/beta/bigtable/clusters/create @@ -7,9 +7,11 @@ SYNOPSIS [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [--num-nodes=NUM_NODES; default=3 - | --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET + | [--autoscaling-cpu-target=AUTOSCALING_CPU_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES - --autoscaling-min-nodes=AUTOSCALING_MIN_NODES] [GCLOUD_WIDE_FLAG ...] + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + : --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a bigtable cluster. @@ -103,8 +105,8 @@ OPTIONAL FLAGS Autoscaling --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET - The target CPU utilization percent for autoscaling. Accepted values - are from 10 to 80. + The target CPU utilization percentage for autoscaling. Accepted + values are from 10 to 80. This flag must be specified if any of the other arguments in this group are specified. @@ -121,6 +123,11 @@ OPTIONAL FLAGS This flag must be specified if any of the other arguments in this group are specified. + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + The target storage utilization gibibytes per node for autoscaling. + Accepted values are from 2560 to 5120 for SSD clusters and 8192 to + 16384 for HDD clusters. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/bigtable/clusters/update b/gcloud/beta/bigtable/clusters/update index 70960f1a1..831b61708 100644 --- a/gcloud/beta/bigtable/clusters/update +++ b/gcloud/beta/bigtable/clusters/update @@ -7,6 +7,7 @@ SYNOPSIS (--autoscaling-cpu-target=AUTOSCALING_CPU_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET | [--num-nodes=NUM_NODES : --disable-autoscaling]) [--async] [GCLOUD_WIDE_FLAG ...] @@ -52,8 +53,8 @@ REQUIRED FLAGS Autoscaling --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET - The target CPU utilization percent for autoscaling. Accepted values - are from 10 to 80. + The target CPU utilization percentage for autoscaling. Accepted + values are from 10 to 80. --autoscaling-max-nodes=AUTOSCALING_MAX_NODES The maximum number of nodes for autoscaling. @@ -61,6 +62,11 @@ REQUIRED FLAGS --autoscaling-min-nodes=AUTOSCALING_MIN_NODES The minimum number of nodes for autoscaling. + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + The target storage utilization gibibytes per node for autoscaling. + Accepted values are from 2560 to 5120 for SSD clusters and 8192 to + 16384 for HDD clusters. + Manual Scaling --num-nodes=NUM_NODES diff --git a/gcloud/beta/bigtable/instances/create b/gcloud/beta/bigtable/instances/create index 8f3d40f8e..899b1b232 100644 --- a/gcloud/beta/bigtable/instances/create +++ b/gcloud/beta/bigtable/instances/create @@ -7,7 +7,8 @@ SYNOPSIS [--cluster-config=[id=ID,zone=ZONE,nodes=NODES,kms-key=KMS_KEY, autoscaling-min-nodes=AUTOSCALING_MIN_NODES, autoscaling-max-nodes=AUTOSCALING_MAX_NODES, - autoscaling-cpu-target=AUTOSCALING_CPU_TARGET,...]] + autoscaling-cpu-target=AUTOSCALING_CPU_TARGET, + autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET,...]] [--cluster-num-nodes=CLUSTER_NUM_NODES] [--cluster-storage-type=CLUSTER_STORAGE_TYPE; default="ssd"] [--cluster-zone=CLUSTER_ZONE] @@ -68,7 +69,7 @@ OPTIONAL FLAGS The --cluster argument is deprecated; use --cluster-config instead. - --cluster-config=[id=ID,zone=ZONE,nodes=NODES,kms-key=KMS_KEY,autoscaling-min-nodes=AUTOSCALING_MIN_NODES,autoscaling-max-nodes=AUTOSCALING_MAX_NODES,autoscaling-cpu-target=AUTOSCALING_CPU_TARGET,...] + --cluster-config=[id=ID,zone=ZONE,nodes=NODES,kms-key=KMS_KEY,autoscaling-min-nodes=AUTOSCALING_MIN_NODES,autoscaling-max-nodes=AUTOSCALING_MAX_NODES,autoscaling-cpu-target=AUTOSCALING_CPU_TARGET,autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET,...] Repeatable. Specify cluster config as a key-value dictionary. This is the recommended argument for specifying cluster configurations. @@ -83,6 +84,14 @@ OPTIONAL FLAGS *kms-key*: The Cloud KMS (Key Management Service) cryptokey that will be used to protect the cluster. + *autoscaling-min-nodes*: The minimum number of nodes for autoscaling. + + *autoscaling-max-nodes*: The maximum number of nodes for autoscaling. + + *autoscaling-cpu-target*: The target CPU utilization percentage for autoscaling. Accepted values are from 10 to 80. + + *autoscaling-storage-target*: The target storage utilization gibibytes per node for autoscaling. Accepted values are from 2560 to 5120 for SSD clusters and 8192 to 16384 for HDD clusters. + If this argument is specified, the deprecated arguments for configuring a single cluster will be ignored, including --cluster, --cluster-zone, --cluster-num-nodes. diff --git a/gcloud/beta/bigtable/instances/tables/help b/gcloud/beta/bigtable/instances/tables/help index a4b39b8aa..cea34b570 100644 --- a/gcloud/beta/bigtable/instances/tables/help +++ b/gcloud/beta/bigtable/instances/tables/help @@ -36,6 +36,9 @@ COMMANDS set-iam-policy (BETA) Set an IAM policy on a Cloud Bigtable table. + undelete + (BETA) Undelete a previously deleted Cloud Bigtable table. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/bigtable/instances/tables/undelete b/gcloud/beta/bigtable/instances/tables/undelete new file mode 100644 index 000000000..10b45280c --- /dev/null +++ b/gcloud/beta/bigtable/instances/tables/undelete @@ -0,0 +1,69 @@ +NAME + gcloud beta bigtable instances tables undelete - undelete a previously + deleted Cloud Bigtable table + +SYNOPSIS + gcloud beta bigtable instances tables undelete + (TABLE : --instance=INSTANCE) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Undelete a previously deleted Cloud Bigtable table. + +EXAMPLES + To undelete the table 'my-table' in instance 'my-instance', run: + + $ gcloud beta bigtable instances tables undelete my-table \ + --instance=my-instance + +POSITIONAL ARGUMENTS + Table resource - Cloud Bigtable table to undelete. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument table on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + TABLE + ID of the table or fully qualified identifier for the table. To set + the table attribute: + ▸ provide the argument table on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --instance=INSTANCE + The name of the Cloud Bigtable instance. To set the instance + attribute: + ▸ provide the argument table on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 help for details. + +API REFERENCE + This command uses the bigtableadmin/v2 API. The full documentation for this + API can be found at: https://cloud.google.com/bigtable/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud bigtable instances tables undelete + + $ gcloud alpha bigtable instances tables undelete + diff --git a/gcloud/beta/builds/triggers/create/github b/gcloud/beta/builds/triggers/create/github index 6dde47102..dad1aea98 100644 --- a/gcloud/beta/builds/triggers/create/github +++ b/gcloud/beta/builds/triggers/create/github @@ -7,9 +7,9 @@ SYNOPSIS (--trigger-config=PATH | [--repo-name=REPO_NAME --repo-owner=REPO_OWNER (--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; - default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH - | --dockerfile=DOCKERFILE --dockerfile-dir=DOCKERFILE_DIR; + default="COMMENTS_ENABLED"]) (--build-config=PATH + | --inline-config=PATH | --dockerfile=DOCKERFILE + --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE) : --description=DESCRIPTION --ignored-files=[GLOB,...] --include-logs-with-status --included-files=[GLOB,...] --name=NAME @@ -152,9 +152,21 @@ REQUIRED FLAGS This flag must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' - on a pull request before running the build. + on a pull request before running the build. COMMENT_CONTROL + must be one of: + + COMMENTS_DISABLED + Do not require comments on Pull Requests before builds are + triggered. + COMMENTS_ENABLED + Enforce that repository owners or collaborators must + comment on Pull Requests before builds are triggered. + COMMENTS_ENABLED_FOR_EXTERNAL_CONTRIBUTORS_ONLY + Enforce that repository owners or collaborators must + comment on external contributors' Pull Requests before + builds are triggered. Exactly one of these must be specified: diff --git a/gcloud/beta/certificate-manager/certificates/create b/gcloud/beta/certificate-manager/certificates/create index cb1261515..0aa823dae 100644 --- a/gcloud/beta/certificate-manager/certificates/create +++ b/gcloud/beta/certificate-manager/certificates/create @@ -162,8 +162,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/certificate-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager certificates create $ gcloud alpha certificate-manager certificates create diff --git a/gcloud/beta/certificate-manager/certificates/delete b/gcloud/beta/certificate-manager/certificates/delete index 061b31496..9881497f9 100644 --- a/gcloud/beta/certificate-manager/certificates/delete +++ b/gcloud/beta/certificate-manager/certificates/delete @@ -55,8 +55,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager certificates delete $ gcloud alpha certificate-manager certificates delete diff --git a/gcloud/beta/certificate-manager/certificates/describe b/gcloud/beta/certificate-manager/certificates/describe index b4c85686f..38d5803c1 100644 --- a/gcloud/beta/certificate-manager/certificates/describe +++ b/gcloud/beta/certificate-manager/certificates/describe @@ -55,8 +55,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/certificate-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager certificates describe $ gcloud alpha certificate-manager certificates describe diff --git a/gcloud/beta/certificate-manager/certificates/help b/gcloud/beta/certificate-manager/certificates/help index 2d7aa3ab7..d4a05b6db 100644 --- a/gcloud/beta/certificate-manager/certificates/help +++ b/gcloud/beta/certificate-manager/certificates/help @@ -32,8 +32,10 @@ COMMANDS (BETA) Update a certificate. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager certificates $ gcloud alpha certificate-manager certificates diff --git a/gcloud/beta/certificate-manager/certificates/list b/gcloud/beta/certificate-manager/certificates/list index 871882d62..dc068dc80 100644 --- a/gcloud/beta/certificate-manager/certificates/list +++ b/gcloud/beta/certificate-manager/certificates/list @@ -72,8 +72,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager certificates list $ gcloud alpha certificate-manager certificates list diff --git a/gcloud/beta/certificate-manager/certificates/update b/gcloud/beta/certificate-manager/certificates/update index 733d35a99..76dae1364 100644 --- a/gcloud/beta/certificate-manager/certificates/update +++ b/gcloud/beta/certificate-manager/certificates/update @@ -108,8 +108,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager certificates update $ gcloud alpha certificate-manager certificates update diff --git a/gcloud/beta/certificate-manager/dns-authorizations/create b/gcloud/beta/certificate-manager/dns-authorizations/create index 720f92c16..c0183e568 100644 --- a/gcloud/beta/certificate-manager/dns-authorizations/create +++ b/gcloud/beta/certificate-manager/dns-authorizations/create @@ -77,8 +77,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/certificate-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager dns-authorizations create $ gcloud alpha certificate-manager dns-authorizations create diff --git a/gcloud/beta/certificate-manager/dns-authorizations/delete b/gcloud/beta/certificate-manager/dns-authorizations/delete index 745acd564..5eb56f803 100644 --- a/gcloud/beta/certificate-manager/dns-authorizations/delete +++ b/gcloud/beta/certificate-manager/dns-authorizations/delete @@ -61,8 +61,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/certificate-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager dns-authorizations delete $ gcloud alpha certificate-manager dns-authorizations delete diff --git a/gcloud/beta/certificate-manager/dns-authorizations/describe b/gcloud/beta/certificate-manager/dns-authorizations/describe index ba93741d4..59a4a8f6e 100644 --- a/gcloud/beta/certificate-manager/dns-authorizations/describe +++ b/gcloud/beta/certificate-manager/dns-authorizations/describe @@ -55,8 +55,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/certificate-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager dns-authorizations describe $ gcloud alpha certificate-manager dns-authorizations describe diff --git a/gcloud/beta/certificate-manager/dns-authorizations/help b/gcloud/beta/certificate-manager/dns-authorizations/help index 7c40e9213..090b7f547 100644 --- a/gcloud/beta/certificate-manager/dns-authorizations/help +++ b/gcloud/beta/certificate-manager/dns-authorizations/help @@ -33,8 +33,10 @@ COMMANDS (BETA) Update a DNS Authorization. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager dns-authorizations $ gcloud alpha certificate-manager dns-authorizations diff --git a/gcloud/beta/certificate-manager/dns-authorizations/list b/gcloud/beta/certificate-manager/dns-authorizations/list index 26477a34e..f545fd6d1 100644 --- a/gcloud/beta/certificate-manager/dns-authorizations/list +++ b/gcloud/beta/certificate-manager/dns-authorizations/list @@ -78,8 +78,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/certificate-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager dns-authorizations list $ gcloud alpha certificate-manager dns-authorizations list diff --git a/gcloud/beta/certificate-manager/dns-authorizations/update b/gcloud/beta/certificate-manager/dns-authorizations/update index 3558f5f97..6ff522327 100644 --- a/gcloud/beta/certificate-manager/dns-authorizations/update +++ b/gcloud/beta/certificate-manager/dns-authorizations/update @@ -95,8 +95,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/certificate-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager dns-authorizations update $ gcloud alpha certificate-manager dns-authorizations update diff --git a/gcloud/beta/certificate-manager/help b/gcloud/beta/certificate-manager/help index b897a4bf0..7d9032fb4 100644 --- a/gcloud/beta/certificate-manager/help +++ b/gcloud/beta/certificate-manager/help @@ -29,8 +29,10 @@ GROUPS (BETA) Manage Certificate Manager operations. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager $ gcloud alpha certificate-manager diff --git a/gcloud/beta/certificate-manager/maps/create b/gcloud/beta/certificate-manager/maps/create index d7710b31a..98388a08a 100644 --- a/gcloud/beta/certificate-manager/maps/create +++ b/gcloud/beta/certificate-manager/maps/create @@ -68,8 +68,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps create $ gcloud alpha certificate-manager maps create diff --git a/gcloud/beta/certificate-manager/maps/delete b/gcloud/beta/certificate-manager/maps/delete index 0ba1cfc9d..26b9d68ef 100644 --- a/gcloud/beta/certificate-manager/maps/delete +++ b/gcloud/beta/certificate-manager/maps/delete @@ -55,8 +55,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps delete $ gcloud alpha certificate-manager maps delete diff --git a/gcloud/beta/certificate-manager/maps/describe b/gcloud/beta/certificate-manager/maps/describe index cc067cace..4f0b14226 100644 --- a/gcloud/beta/certificate-manager/maps/describe +++ b/gcloud/beta/certificate-manager/maps/describe @@ -52,8 +52,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps describe $ gcloud alpha certificate-manager maps describe diff --git a/gcloud/beta/certificate-manager/maps/entries/create b/gcloud/beta/certificate-manager/maps/entries/create index 77dca3c21..54ccc0b72 100644 --- a/gcloud/beta/certificate-manager/maps/entries/create +++ b/gcloud/beta/certificate-manager/maps/entries/create @@ -110,8 +110,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps entries create $ gcloud alpha certificate-manager maps entries create diff --git a/gcloud/beta/certificate-manager/maps/entries/delete b/gcloud/beta/certificate-manager/maps/entries/delete index 5111f5f8d..338c23e8d 100644 --- a/gcloud/beta/certificate-manager/maps/entries/delete +++ b/gcloud/beta/certificate-manager/maps/entries/delete @@ -65,8 +65,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps entries delete $ gcloud alpha certificate-manager maps entries delete diff --git a/gcloud/beta/certificate-manager/maps/entries/describe b/gcloud/beta/certificate-manager/maps/entries/describe index a904fb239..a60744bf2 100644 --- a/gcloud/beta/certificate-manager/maps/entries/describe +++ b/gcloud/beta/certificate-manager/maps/entries/describe @@ -60,8 +60,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps entries describe $ gcloud alpha certificate-manager maps entries describe diff --git a/gcloud/beta/certificate-manager/maps/entries/help b/gcloud/beta/certificate-manager/maps/entries/help index 2054061d2..458b8fcd9 100644 --- a/gcloud/beta/certificate-manager/maps/entries/help +++ b/gcloud/beta/certificate-manager/maps/entries/help @@ -32,8 +32,10 @@ COMMANDS (BETA) Update a certificate map entry. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps entries $ gcloud alpha certificate-manager maps entries diff --git a/gcloud/beta/certificate-manager/maps/entries/list b/gcloud/beta/certificate-manager/maps/entries/list index 83c2d9d10..8444890a7 100644 --- a/gcloud/beta/certificate-manager/maps/entries/list +++ b/gcloud/beta/certificate-manager/maps/entries/list @@ -86,8 +86,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps entries list $ gcloud alpha certificate-manager maps entries list diff --git a/gcloud/beta/certificate-manager/maps/entries/update b/gcloud/beta/certificate-manager/maps/entries/update index c3b18033f..c397ba7d5 100644 --- a/gcloud/beta/certificate-manager/maps/entries/update +++ b/gcloud/beta/certificate-manager/maps/entries/update @@ -118,8 +118,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps entries update $ gcloud alpha certificate-manager maps entries update diff --git a/gcloud/beta/certificate-manager/maps/help b/gcloud/beta/certificate-manager/maps/help index 3f4115a6d..22bb871cb 100644 --- a/gcloud/beta/certificate-manager/maps/help +++ b/gcloud/beta/certificate-manager/maps/help @@ -38,8 +38,10 @@ COMMANDS (BETA) Update a certificate map. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps $ gcloud alpha certificate-manager maps diff --git a/gcloud/beta/certificate-manager/maps/list b/gcloud/beta/certificate-manager/maps/list index 619fb6f50..0c9fa74f3 100644 --- a/gcloud/beta/certificate-manager/maps/list +++ b/gcloud/beta/certificate-manager/maps/list @@ -71,8 +71,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps list $ gcloud alpha certificate-manager maps list diff --git a/gcloud/beta/certificate-manager/maps/update b/gcloud/beta/certificate-manager/maps/update index b3eb16ce9..2a2a4e856 100644 --- a/gcloud/beta/certificate-manager/maps/update +++ b/gcloud/beta/certificate-manager/maps/update @@ -90,8 +90,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager maps update $ gcloud alpha certificate-manager maps update diff --git a/gcloud/beta/certificate-manager/operations/describe b/gcloud/beta/certificate-manager/operations/describe index a4b0e5e0d..e34cd354a 100644 --- a/gcloud/beta/certificate-manager/operations/describe +++ b/gcloud/beta/certificate-manager/operations/describe @@ -55,8 +55,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/certificate-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager operations describe $ gcloud alpha certificate-manager operations describe diff --git a/gcloud/beta/certificate-manager/operations/help b/gcloud/beta/certificate-manager/operations/help index 265232506..5eadec2e9 100644 --- a/gcloud/beta/certificate-manager/operations/help +++ b/gcloud/beta/certificate-manager/operations/help @@ -23,8 +23,10 @@ COMMANDS (BETA) List long-running operations. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager operations $ gcloud alpha certificate-manager operations diff --git a/gcloud/beta/certificate-manager/operations/list b/gcloud/beta/certificate-manager/operations/list index 6828b4b5b..a33c86e73 100644 --- a/gcloud/beta/certificate-manager/operations/list +++ b/gcloud/beta/certificate-manager/operations/list @@ -77,8 +77,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/certificate-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager operations list $ gcloud alpha certificate-manager operations list diff --git a/gcloud/beta/compute/instance-groups/managed/create b/gcloud/beta/compute/instance-groups/managed/create index a98b7c991..b6cab3af9 100644 --- a/gcloud/beta/compute/instance-groups/managed/create +++ b/gcloud/beta/compute/instance-groups/managed/create @@ -7,6 +7,7 @@ SYNOPSIS --template=TEMPLATE [--base-instance-name=BASE_INSTANCE_NAME] [--description=DESCRIPTION] [--initial-delay=INITIAL_DELAY] [--instance-redistribution-type=TYPE] + [--list-managed-instances-results=MODE] [--stateful-disk=[auto-delete=AUTO-DELETE],[device-name=DEVICE-NAME]] [--stateful-external-ip=[enabled], [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]] @@ -77,6 +78,19 @@ OPTIONAL FLAGS TYPE must be one of: NONE, PROACTIVE. + --list-managed-instances-results=MODE + Pagination behavior for the group's listManagedInstances API method. + This flag does not affect the group's gcloud or console list-instances + behavior. By default it is set to PAGELESS. MODE must be one of: + + PAGELESS + Pagination is disabled for the group's listManagedInstances API + method. maxResults and pageToken query parameters are ignored and + all instances are returned in a single response. + PAGINATED + Pagination is enabled for the group's listManagedInstances API + method. maxResults and pageToken query parameters are respected. + --stateful-disk=[auto-delete=AUTO-DELETE],[device-name=DEVICE-NAME] Disks considered stateful by the instance group. Managed instance groups preserve and reattach stateful disks on VM autohealing, update, diff --git a/gcloud/beta/compute/instance-groups/managed/update b/gcloud/beta/compute/instance-groups/managed/update index e3b401ed7..5de30b10b 100644 --- a/gcloud/beta/compute/instance-groups/managed/update +++ b/gcloud/beta/compute/instance-groups/managed/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud beta compute instance-groups managed update NAME [--description=DESCRIPTION] [--instance-redistribution-type=TYPE] + [--list-managed-instances-results=MODE] [--remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...]] [--remove-stateful-external-ips=INTERFACE_NAME,[...]] [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] @@ -70,6 +71,19 @@ FLAGS TYPE must be one of: NONE, PROACTIVE. + --list-managed-instances-results=MODE + Pagination behavior for the group's listManagedInstances API method. + This flag does not affect the group's gcloud or console list-instances + behavior. By default it is set to PAGELESS. MODE must be one of: + + PAGELESS + Pagination is disabled for the group's listManagedInstances API + method. maxResults and pageToken query parameters are ignored and + all instances are returned in a single response. + PAGINATED + Pagination is enabled for the group's listManagedInstances API + method. maxResults and pageToken query parameters are respected. + --remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...] Remove stateful configuration for the specified disks. diff --git a/gcloud/beta/compute/ssh b/gcloud/beta/compute/ssh index 8e3ddc480..2baf66c7c 100644 --- a/gcloud/beta/compute/ssh +++ b/gcloud/beta/compute/ssh @@ -16,10 +16,8 @@ DESCRIPTION that takes care of authentication and the translation of the instance name into an IP address. - Note, this command does not work when connecting to Windows VMs. To connect - to a Windows instance, including connecting using a command-line method, - refer to this guide: - https://cloud.google.com/compute/docs/instances/connecting-to-windows + To use SSH to connect to a Windows VM, refer to this guide: + https://cloud.google.com/compute/docs/connect/windows-ssh The default network comes preconfigured to allow ssh access to all VMs. If the default network was edited, or if not using the default network, you diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 230b79688..89623a3ca 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -20,18 +20,19 @@ SYNOPSIS [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autorepair] [--no-enable-autoupgrade] [--enable-binauthz] [--enable-cloud-logging] [--enable-cloud-monitoring] [--enable-cloud-run-alpha] - [--enable-confidential-nodes] [--enable-dataplane-v2] - [--enable-gke-oidc] [--enable-gvnic] [--enable-identity-service] - [--enable-image-streaming] [--enable-intra-node-visibility] - [--enable-ip-alias] [--enable-kubernetes-alpha] - [--enable-l4-ilb-subsetting] [--enable-legacy-authorization] + [--enable-confidential-nodes] [--enable-cost-allocation] + [--enable-dataplane-v2] [--enable-gke-oidc] [--enable-gvnic] + [--enable-identity-service] [--enable-image-streaming] + [--enable-intra-node-visibility] [--enable-ip-alias] + [--enable-kubernetes-alpha] [--enable-l4-ilb-subsetting] + [--enable-legacy-authorization] [--enable-logging-monitoring-system-only] [--enable-managed-prometheus] [--enable-master-global-access] [--enable-network-policy] [--enable-pod-security-policy] [--enable-service-externalips] [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--identity-provider=IDENTITY_PROVIDER] [--image-type=IMAGE_TYPE] - [--issue-client-certificate] + [--ipv6-access-type=IPV6_ACCESS_TYPE] [--issue-client-certificate] [--istio-config=[auth=MTLS_PERMISSIVE,...]] [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] @@ -51,7 +52,7 @@ SYNOPSIS [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] - [--subnetwork=SUBNETWORK] + [--stack-type=STACK_TYPE] [--subnetwork=SUBNETWORK] [--system-config-from-file=SYSTEM_CONFIG_FROM_FILE] [--tags=TAG,[TAG,...]] [--threads-per-core=THREADS_PER_CORE] [--workload-metadata=WORKLOAD_METADATA] [--workload-pool=WORKLOAD_POOL] @@ -65,8 +66,12 @@ SYNOPSIS --autoprovisioning-locations=ZONE,[ZONE,...] --autoprovisioning-min-cpu-platform=PLATFORM --min-cpu=MIN_CPU --min-memory=MIN_MEMORY - --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-scopes=[SCOPE, - ...] + --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...] + --enable-autoprovisioning-blue-green-upgrade + | --enable-autoprovisioning-surge-upgrade + --autoprovisioning-scopes=[SCOPE,...] --autoprovisioning-service-account=AUTOPROVISIONING_SERVICE_ACCOUNT --enable-autoprovisioning-autorepair --enable-autoprovisioning-autoupgrade @@ -374,6 +379,13 @@ FLAGS will create nodes using Confidential VM https://cloud.google.com/compute/confidential-vm/docs/about-cvm. + --enable-cost-allocation + Enable the cost management feature. + + When enabled, you can get informational GKE cost breakdowns by cluster, + namespace and label in your billing data exported to BigQuery + (https://cloud.google.com/billing/docs/how-to/export-data-bigquery). + --enable-dataplane-v2 Enables the new eBPF dataplane for GKE clusters that is required for network security, scalability and visibility features. @@ -519,6 +531,10 @@ FLAGS $ gcloud container get-server-config + --ipv6-access-type=IPV6_ACCESS_TYPE + IPv6 access type of the subnetwork. Defaults to 'external'. + IPV6_ACCESS_TYPE must be one of: external, internal. + --issue-client-certificate Issue a TLS client certificate with admin permissions. @@ -893,6 +909,10 @@ FLAGS New nodes, including ones created by resize or recreate, will use spot VM instances. + --stack-type=STACK_TYPE + IP stack type of the node VMs. Defaults to 'ipv4'. STACK_TYPE must be + one of: ipv4, ipv4-ipv6. + --subnetwork=SUBNETWORK The Google Compute Engine subnetwork (https://cloud.google.com/compute/docs/subnetworks) to which the @@ -1219,6 +1239,37 @@ FLAGS Number of nodes that can be unavailable at the same time on each upgrade of an autoprovisioned node pool. + --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the update. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + Batch sizes are specfied by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + Example: + --standard-rollout-policy=batch-node-count=3,batch-soak-duration=60s + --standard-rollout-policy=batch-percent=0.05,batch-soak-duration=180s + + Flag group to choose the top level upgrade option: + + At most one of these can be specified: + + --enable-autoprovisioning-blue-green-upgrade + Whether to use blue-green upgrade for the autoprovisioned + node pool. + + --enable-autoprovisioning-surge-upgrade + Whether to use surge upgrade for the autoprovisioned node + pool. + Flags to specify identity for autoprovisioned nodes: --autoprovisioning-scopes=[SCOPE,...] diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index b06ca86d1..3a14dd650 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -10,9 +10,10 @@ SYNOPSIS | --database-encryption-key=DATABASE_ENCRYPTION_KEY | --disable-database-encryption | --disable-default-snat | --disable-workload-identity | --enable-autoscaling - | --enable-binauthz | --enable-gke-oidc | --enable-identity-service - | --enable-image-streaming | --enable-intra-node-visibility - | --enable-l4-ilb-subsetting | --enable-legacy-authorization + | --enable-binauthz | --enable-cost-allocation | --enable-gke-oidc + | --enable-identity-service | --enable-image-streaming + | --enable-intra-node-visibility | --enable-l4-ilb-subsetting + | --enable-legacy-authorization | --enable-logging-monitoring-system-only | --enable-master-authorized-networks | --enable-master-global-access | --enable-network-policy | --enable-pod-security-policy @@ -49,8 +50,12 @@ SYNOPSIS --autoprovisioning-locations=ZONE,[ZONE,...] --autoprovisioning-min-cpu-platform=PLATFORM --max-cpu=MAX_CPU --max-memory=MAX_MEMORY --min-cpu=MIN_CPU --min-memory=MIN_MEMORY - --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-scopes=[SCOPE, - ...] + --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...] + --enable-autoprovisioning-blue-green-upgrade + | --enable-autoprovisioning-surge-upgrade + --autoprovisioning-scopes=[SCOPE,...] --autoprovisioning-service-account=AUTOPROVISIONING_SERVICE_ACCOUNT --enable-autoprovisioning-autorepair --enable-autoprovisioning-autoupgrade @@ -179,6 +184,16 @@ REQUIRED FLAGS --enable-binauthz Enable Binary Authorization for this cluster. + --enable-cost-allocation + Enable the cost management feature. + + When enabled, you can get informational GKE cost breakdowns by + cluster, namespace and label in your billing data exported to + BigQuery + (https://cloud.google.com/billing/docs/how-to/export-data-bigquery). + + Use --no-enable-cost-allocation to disable this feature. + --enable-gke-oidc (DEPRECATED) Enable GKE OIDC authentication on the cluster. @@ -832,6 +847,37 @@ REQUIRED FLAGS Number of nodes that can be unavailable at the same time on each upgrade of an autoprovisioned node pool. + --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the update. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + Batch sizes are specfied by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + Example: + --standard-rollout-policy=batch-node-count=3,batch-soak-duration=60s + --standard-rollout-policy=batch-percent=0.05,batch-soak-duration=180s + + Flag group to choose the top level upgrade option: + + At most one of these can be specified: + + --enable-autoprovisioning-blue-green-upgrade + Whether to use blue-green upgrade for the autoprovisioned + node pool. + + --enable-autoprovisioning-surge-upgrade + Whether to use surge upgrade for the autoprovisioned node + pool. + Flags to specify identity for autoprovisioned nodes: --autoprovisioning-scopes=[SCOPE,...] diff --git a/gcloud/beta/container/node-pools/complete-upgrade b/gcloud/beta/container/node-pools/complete-upgrade new file mode 100644 index 000000000..493537ce4 --- /dev/null +++ b/gcloud/beta/container/node-pools/complete-upgrade @@ -0,0 +1,55 @@ +NAME + gcloud beta container node-pools complete-upgrade - complete a node pool + upgrade + +SYNOPSIS + gcloud beta container node-pools complete-upgrade NAME [--cluster=CLUSTER] + [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Complete a node pool upgrade. + + Complete upgrade is a method used to skip the remaining node pool soaking + phase during blue-green node pool upgrades. + +EXAMPLES + To complete an active upgrade in node-pool-1 in the cluster sample-cluster, + run: + + $ gcloud beta container node-pools complete-upgrade node-pool-1 \ + --cluster=sample-cluster + +POSITIONAL ARGUMENTS + NAME + Name of the node pool for which the upgrade is to be completed. + +FLAGS + --cluster=CLUSTER + Cluster to which the node pool belongs. Overrides the default + container/cluster property value for this command invocation. + + At most one of these can be specified: + + --region=REGION + Compute region (e.g. us-central1) for the cluster. + + --zone=ZONE, -z ZONE + Compute zone (e.g. us-central1-a) for the cluster. Overrides the + default compute/zone property value for this command invocation. + +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 help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container node-pools complete-upgrade + + $ gcloud alpha container node-pools complete-upgrade + diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index 8b9dba437..ed9a3db27 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -9,8 +9,9 @@ SYNOPSIS [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autoprovisioning] [--enable-autorepair] [--no-enable-autoupgrade] - [--enable-confidential-nodes] [--enable-gvnic] - [--enable-image-streaming] [--image-type=IMAGE_TYPE] + [--enable-blue-green-upgrade] [--enable-confidential-nodes] + [--enable-gvnic] [--enable-image-streaming] [--enable-surge-upgrade] + [--image-type=IMAGE_TYPE] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] [--max-surge-upgrade=MAX_SURGE_UPGRADE; default=1] @@ -20,11 +21,15 @@ SYNOPSIS [--min-cpu-platform=PLATFORM] [--network-performance-configs=[PROPERTY=VALUE,...]] [--node-group=NODE_GROUP] [--node-labels=[NODE_LABEL,...]] - [--node-locations=ZONE,[ZONE,...]] [--node-taints=[NODE_TAINT,...]] - [--node-version=NODE_VERSION] [--num-nodes=NUM_NODES; default=3] - [--placement-type=PLACEMENT_TYPE] [--preemptible] - [--sandbox=[type=TYPE]] [--shielded-integrity-monitoring] - [--shielded-secure-boot] [--spot] + [--node-locations=ZONE,[ZONE,...]] + [--node-pool-soak-duration=NODE_POOL_SOAK_DURATION] + [--node-taints=[NODE_TAINT,...]] [--node-version=NODE_VERSION] + [--num-nodes=NUM_NODES; default=3] [--placement-type=PLACEMENT_TYPE] + [--preemptible] [--sandbox=[type=TYPE]] + [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] + [--standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...]] [--system-config-from-file=SYSTEM_CONFIG_FROM_FILE] [--tags=TAG,[TAG,...]] [--threads-per-core=THREADS_PER_CORE] [--workload-metadata=WORKLOAD_METADATA] @@ -132,6 +137,9 @@ FLAGS Enabled by default, use --no-enable-autoupgrade to disable. + --enable-blue-green-upgrade + Changes node pool upgrade strategy to blue-green upgrade. + --enable-confidential-nodes Enable confidential nodes for the node pool. Enabling Confidential Nodes will create nodes using Confidential VM @@ -144,6 +152,9 @@ FLAGS --enable-image-streaming Specifies whether to enable image streaming on node pool. + --enable-surge-upgrade + Changes node pool upgrade strategy to surge upgrade. + --image-type=IMAGE_TYPE The image type to use for the node pool. Defaults to server-specified. @@ -324,6 +335,13 @@ FLAGS --cluster=sample-cluster \ --node-locations=us-central1-a,us-central1-b + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade before + deleting the blue pool and completing the upgrade. + + $ gcloud beta container node-pools create example-cluster \ + --node-pool-soak-duration=600s + --node-taints=[NODE_TAINT,...] Applies the given kubernetes taints on all nodes in the new node pool, which can be used with tolerations for pod scheduling. @@ -403,6 +421,20 @@ FLAGS New nodes, including ones created by resize or recreate, will use spot VM instances. + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. + + Batch sizes are specfied by one of, batch-node-count or batch-percent. + The duration between batches is specified by batch-soak-duration. + + $ gcloud beta container node-pools create example-cluster \ + --standard-rollout-policy=batch-node-count=3,\ + batch-soak-duration=60s + + $ gcloud beta container node-pools create example-cluster \ + --standard-rollout-policy=batch-percent=0.3,\ + batch-soak-duration=60s + --system-config-from-file=SYSTEM_CONFIG_FROM_FILE Path of the YAML/JSON file that contains the node configuration, including Linux kernel parameters (sysctls) and kubelet configs. diff --git a/gcloud/beta/container/node-pools/help b/gcloud/beta/container/node-pools/help index 589ac4e05..962ef0873 100644 --- a/gcloud/beta/container/node-pools/help +++ b/gcloud/beta/container/node-pools/help @@ -28,6 +28,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + complete-upgrade + (BETA) Complete a node pool upgrade. + create (BETA) Create a node pool in a running cluster. diff --git a/gcloud/beta/container/node-pools/rollback b/gcloud/beta/container/node-pools/rollback index c618149b4..c78b0d460 100644 --- a/gcloud/beta/container/node-pools/rollback +++ b/gcloud/beta/container/node-pools/rollback @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud beta container node-pools rollback NAME [--async] - [--cluster=CLUSTER] [--region=REGION | --zone=ZONE, -z ZONE] - [GCLOUD_WIDE_FLAG ...] + [--cluster=CLUSTER] [--respect-pdb=RESPECT_PDB] + [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Rollback a node-pool upgrade. @@ -32,6 +32,10 @@ FLAGS The cluster from which to rollback the node pool. Overrides the default container/cluster property value for this command invocation. + --respect-pdb=RESPECT_PDB + Indicates whether node pool rollbacks should respect pod disruption + budgets. + At most one of these can be specified: --region=REGION diff --git a/gcloud/beta/container/node-pools/update b/gcloud/beta/container/node-pools/update index 8b12a779f..7a626a604 100644 --- a/gcloud/beta/container/node-pools/update +++ b/gcloud/beta/container/node-pools/update @@ -14,17 +14,21 @@ SYNOPSIS | --enable-autoprovisioning --enable-autoscaling --max-nodes=MAX_NODES --min-nodes=MIN_NODES | --enable-autorepair --enable-autoupgrade - | --max-surge-upgrade=MAX_SURGE_UPGRADE - --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE) - [--cluster=CLUSTER] [--region=REGION | --zone=ZONE, -z ZONE] - [GCLOUD_WIDE_FLAG ...] + | --enable-blue-green-upgrade --enable-surge-upgrade + --max-surge-upgrade=MAX_SURGE_UPGRADE + --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...]) [--cluster=CLUSTER] + [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta container node-pools update updates a node pool in a Google Kubernetes Engine cluster. EXAMPLES - To turn on node auto repair in "node-pool-1" in the cluster + To turn on node autoupgrade in "node-pool-1" in the cluster "sample-cluster", run: $ gcloud beta container node-pools update node-pool-1 \ @@ -254,6 +258,12 @@ REQUIRED FLAGS Upgrade settings + --enable-blue-green-upgrade + Changes node pool upgrade strategy to blue-green upgrade. + + --enable-surge-upgrade + Changes node pool upgrade strategy to surge upgrade. + --max-surge-upgrade=MAX_SURGE_UPGRADE Number of extra (surge) nodes to be created on each upgrade of the node pool. @@ -286,6 +296,30 @@ REQUIRED FLAGS Must be used in conjunction with '--max-surge-upgrade'. + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the upgrade. + + $ gcloud beta container node-pools update node-pool-1 \ + --cluster=example-cluster --node-pool-soak-duration=600s + + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. + + Batch sizes are specfied by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + $ gcloud beta container node-pools update node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-node-count=3,\ + batch-soak-duration=60s + + $ gcloud beta container node-pools update node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-percent=0.3,\ + batch-soak-duration=60s + OPTIONAL FLAGS --cluster=CLUSTER The name of the cluster. Overrides the default container/cluster diff --git a/gcloud/beta/container/operations/cancel b/gcloud/beta/container/operations/cancel index 1d947b2d0..b548424cc 100644 --- a/gcloud/beta/container/operations/cancel +++ b/gcloud/beta/container/operations/cancel @@ -44,8 +44,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container operations cancel $ gcloud alpha container operations cancel diff --git a/gcloud/beta/deploy/releases/abandon b/gcloud/beta/deploy/releases/abandon new file mode 100644 index 000000000..dbf8586e1 --- /dev/null +++ b/gcloud/beta/deploy/releases/abandon @@ -0,0 +1,76 @@ +NAME + gcloud beta deploy releases abandon - abandons a release + +SYNOPSIS + gcloud beta deploy releases abandon + (RELEASE : --delivery-pipeline=DELIVERY_PIPELINE --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) After a release is abandoned, no new rollouts can be created from + it. + + Rollouts of abandoned releases can't be rolled back to. + + Existing rollouts of abandoned releases will be unaffected. + +EXAMPLES + To abandon a release called test-release for delivery pipeline + test-pipeline in region us-central1, run: + + $ gcloud beta deploy releases abandon test-release \ + --delivery-pipeline=test-pipeline --region=us-central1 + +POSITIONAL ARGUMENTS + Release resource - The name of the Release. The arguments in this group + can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument release on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + RELEASE + ID of the release or fully qualified identifier for the release. To + set the release attribute: + ▸ provide the argument release on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --delivery-pipeline=DELIVERY_PIPELINE + The delivery pipeline associated with the release. Alternatively, set + the property [deploy/delivery-pipeline]. To set the delivery-pipeline + attribute: + ▸ provide the argument release on the command line with a fully + specified name; + ▸ provide the argument --delivery-pipeline on the command line; + ▸ set the property deploy/delivery_pipeline. + + --region=REGION + The Cloud region for the release. Alternatively, set the property + [deploy/region]. To set the region attribute: + ▸ provide the argument release on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + +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 help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud deploy releases abandon + + $ gcloud alpha deploy releases abandon + diff --git a/gcloud/beta/deploy/releases/help b/gcloud/beta/deploy/releases/help index 805519ae1..b7df18d02 100644 --- a/gcloud/beta/deploy/releases/help +++ b/gcloud/beta/deploy/releases/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + abandon + (BETA) Abandons a release. + create (BETA) Creates a new release, delivery pipeline qualified. diff --git a/gcloud/beta/kms/import-jobs/create b/gcloud/beta/kms/import-jobs/create index b49fb710f..53d12d8b0 100644 --- a/gcloud/beta/kms/import-jobs/create +++ b/gcloud/beta/kms/import-jobs/create @@ -27,7 +27,9 @@ REQUIRED FLAGS The wrapping method to be used for incoming key material. For more information about choosing an import method, see https://cloud.google.com/kms/docs/key-wrapping. IMPORT_METHOD must be - one of: rsa-oaep-3072-sha1-aes-256, rsa-oaep-4096-sha1-aes-256. + one of: rsa-oaep-3072-sha1-aes-256, rsa-oaep-3072-sha256, + rsa-oaep-3072-sha256-aes-256, rsa-oaep-4096-sha1-aes-256, + rsa-oaep-4096-sha256, rsa-oaep-4096-sha256-aes-256. --protection-level=PROTECTION_LEVEL Protection level of the import job. PROTECTION_LEVEL must be one of: diff --git a/gcloud/beta/pubsub/subscriptions/ack b/gcloud/beta/pubsub/subscriptions/ack index 1daf59001..7cf79717a 100644 --- a/gcloud/beta/pubsub/subscriptions/ack +++ b/gcloud/beta/pubsub/subscriptions/ack @@ -3,8 +3,8 @@ NAME the specified subscription SYNOPSIS - gcloud beta pubsub subscriptions ack SUBSCRIPTION [ACK_ID ...] - [--ack-ids=[ACK_ID,...]] [GCLOUD_WIDE_FLAG ...] + gcloud beta pubsub subscriptions ack SUBSCRIPTION + ([ACK_ID ...] --ack-ids=[ACK_ID,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Acknowledges one or more messages as having been successfully @@ -32,22 +32,24 @@ POSITIONAL ARGUMENTS subscription. To set the subscription attribute: ▸ provide the argument subscription on the command line. - [ACK_ID ...] - (DEPRECATED) One or more ACK_ID to acknowledge. An ACK_ID is a string - that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + Exactly one of these must be specified: - Positional argument ACK_ID is deprecated. Please use --ack-ids instead. + [ACK_ID ...] + (DEPRECATED) One or more ACK_IDs to acknowledge. An ACK_ID is a + string that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). -FLAGS - --ack-ids=[ACK_ID,...] - One or more ACK_ID to acknowledge. An ACK_ID is a string that is - returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + Positional argument ACK_ID is deprecated. Please use --ack-ids + instead. + + --ack-ids=[ACK_ID,...] + One or more ACK_IDs to acknowledge. An ACK_ID is a string that is + returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/pubsub/subscriptions/modify-ack-deadline b/gcloud/beta/pubsub/subscriptions/modify-ack-deadline index dceffd1a3..ed4a91471 100644 --- a/gcloud/beta/pubsub/subscriptions/modify-ack-deadline +++ b/gcloud/beta/pubsub/subscriptions/modify-ack-deadline @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta pubsub subscriptions modify-ack-deadline SUBSCRIPTION - [ACK_ID ...] --ack-deadline=ACK_DEADLINE [--ack-ids=[ACK_ID,...]] + ([ACK_ID ...] --ack-ids=[ACK_ID,...]) --ack-deadline=ACK_DEADLINE [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -35,28 +35,30 @@ POSITIONAL ARGUMENTS subscription. To set the subscription attribute: ▸ provide the argument subscription on the command line. - [ACK_ID ...] - (DEPRECATED) One or more ACK_ID to modify the deadline for. An ACK_ID - is a string that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + Exactly one of these must be specified: - Positional argument ACK_ID is deprecated. Please use --ack-ids instead. + [ACK_ID ...] + (DEPRECATED) One or more ACK_IDs to modify the deadline for. An + ACK_ID is a string that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + + Positional argument ACK_ID is deprecated. Please use --ack-ids + instead. + + --ack-ids=[ACK_ID,...] + One or more ACK_IDs to modify the deadline for. An ACK_ID is a string + that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). REQUIRED FLAGS --ack-deadline=ACK_DEADLINE The number of seconds the system will wait for a subscriber to acknowledge receiving a message before re-attempting delivery. -OPTIONAL FLAGS - --ack-ids=[ACK_ID,...] - One or more ACK_ID to modify the deadline for. An ACK_ID is a string - that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/pubsub/subscriptions/modify-message-ack-deadline b/gcloud/beta/pubsub/subscriptions/modify-message-ack-deadline index 6de92e36b..79ce03e98 100644 --- a/gcloud/beta/pubsub/subscriptions/modify-message-ack-deadline +++ b/gcloud/beta/pubsub/subscriptions/modify-message-ack-deadline @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta pubsub subscriptions modify-message-ack-deadline SUBSCRIPTION - [ACK_ID ...] --ack-deadline=ACK_DEADLINE [--ack-ids=[ACK_ID,...]] + ([ACK_ID ...] --ack-ids=[ACK_ID,...]) --ack-deadline=ACK_DEADLINE [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -29,28 +29,30 @@ POSITIONAL ARGUMENTS subscription. To set the subscription attribute: ▸ provide the argument subscription on the command line. - [ACK_ID ...] - (DEPRECATED) One or more ACK_ID to modify the deadline for. An ACK_ID - is a string that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + Exactly one of these must be specified: - Positional argument ACK_ID is deprecated. Please use --ack-ids instead. + [ACK_ID ...] + (DEPRECATED) One or more ACK_IDs to modify the deadline for. An + ACK_ID is a string that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). + + Positional argument ACK_ID is deprecated. Please use --ack-ids + instead. + + --ack-ids=[ACK_ID,...] + One or more ACK_IDs to modify the deadline for. An ACK_ID is a string + that is returned to subscribers + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). + along with the message. The ACK_ID is different from the message ID + (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). REQUIRED FLAGS --ack-deadline=ACK_DEADLINE The number of seconds the system will wait for a subscriber to acknowledge receiving a message before re-attempting delivery. -OPTIONAL FLAGS - --ack-ids=[ACK_ID,...] - One or more ACK_ID to modify the deadline for. An ACK_ID is a string - that is returned to subscribers - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). - along with the message. The ACK_ID is different from the message ID - (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.PubsubMessage). - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/bigtable/clusters/create b/gcloud/bigtable/clusters/create index 0a67b042d..8947bab29 100644 --- a/gcloud/bigtable/clusters/create +++ b/gcloud/bigtable/clusters/create @@ -7,9 +7,11 @@ SYNOPSIS [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [--num-nodes=NUM_NODES; default=3 - | --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET + | [--autoscaling-cpu-target=AUTOSCALING_CPU_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES - --autoscaling-min-nodes=AUTOSCALING_MIN_NODES] [GCLOUD_WIDE_FLAG ...] + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + : --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a bigtable cluster. @@ -103,8 +105,8 @@ OPTIONAL FLAGS Autoscaling --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET - The target CPU utilization percent for autoscaling. Accepted values - are from 10 to 80. + The target CPU utilization percentage for autoscaling. Accepted + values are from 10 to 80. This flag must be specified if any of the other arguments in this group are specified. @@ -121,6 +123,11 @@ OPTIONAL FLAGS This flag must be specified if any of the other arguments in this group are specified. + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + The target storage utilization gibibytes per node for autoscaling. + Accepted values are from 2560 to 5120 for SSD clusters and 8192 to + 16384 for HDD clusters. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/bigtable/clusters/update b/gcloud/bigtable/clusters/update index 6a53ef2fe..f450d3654 100644 --- a/gcloud/bigtable/clusters/update +++ b/gcloud/bigtable/clusters/update @@ -7,6 +7,7 @@ SYNOPSIS (--autoscaling-cpu-target=AUTOSCALING_CPU_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET | [--num-nodes=NUM_NODES : --disable-autoscaling]) [--async] [GCLOUD_WIDE_FLAG ...] @@ -52,8 +53,8 @@ REQUIRED FLAGS Autoscaling --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET - The target CPU utilization percent for autoscaling. Accepted values - are from 10 to 80. + The target CPU utilization percentage for autoscaling. Accepted + values are from 10 to 80. --autoscaling-max-nodes=AUTOSCALING_MAX_NODES The maximum number of nodes for autoscaling. @@ -61,6 +62,11 @@ REQUIRED FLAGS --autoscaling-min-nodes=AUTOSCALING_MIN_NODES The minimum number of nodes for autoscaling. + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + The target storage utilization gibibytes per node for autoscaling. + Accepted values are from 2560 to 5120 for SSD clusters and 8192 to + 16384 for HDD clusters. + Manual Scaling --num-nodes=NUM_NODES diff --git a/gcloud/bigtable/instances/create b/gcloud/bigtable/instances/create index 498d08a40..e2f5db826 100644 --- a/gcloud/bigtable/instances/create +++ b/gcloud/bigtable/instances/create @@ -7,7 +7,8 @@ SYNOPSIS [--cluster-config=[id=ID,zone=ZONE,nodes=NODES,kms-key=KMS_KEY, autoscaling-min-nodes=AUTOSCALING_MIN_NODES, autoscaling-max-nodes=AUTOSCALING_MAX_NODES, - autoscaling-cpu-target=AUTOSCALING_CPU_TARGET,...]] + autoscaling-cpu-target=AUTOSCALING_CPU_TARGET, + autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET,...]] [--cluster-num-nodes=CLUSTER_NUM_NODES] [--cluster-storage-type=CLUSTER_STORAGE_TYPE; default="ssd"] [--cluster-zone=CLUSTER_ZONE] @@ -68,7 +69,7 @@ OPTIONAL FLAGS The --cluster argument is deprecated; use --cluster-config instead. - --cluster-config=[id=ID,zone=ZONE,nodes=NODES,kms-key=KMS_KEY,autoscaling-min-nodes=AUTOSCALING_MIN_NODES,autoscaling-max-nodes=AUTOSCALING_MAX_NODES,autoscaling-cpu-target=AUTOSCALING_CPU_TARGET,...] + --cluster-config=[id=ID,zone=ZONE,nodes=NODES,kms-key=KMS_KEY,autoscaling-min-nodes=AUTOSCALING_MIN_NODES,autoscaling-max-nodes=AUTOSCALING_MAX_NODES,autoscaling-cpu-target=AUTOSCALING_CPU_TARGET,autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET,...] Repeatable. Specify cluster config as a key-value dictionary. This is the recommended argument for specifying cluster configurations. @@ -83,6 +84,14 @@ OPTIONAL FLAGS *kms-key*: The Cloud KMS (Key Management Service) cryptokey that will be used to protect the cluster. + *autoscaling-min-nodes*: The minimum number of nodes for autoscaling. + + *autoscaling-max-nodes*: The maximum number of nodes for autoscaling. + + *autoscaling-cpu-target*: The target CPU utilization percentage for autoscaling. Accepted values are from 10 to 80. + + *autoscaling-storage-target*: The target storage utilization gibibytes per node for autoscaling. Accepted values are from 2560 to 5120 for SSD clusters and 8192 to 16384 for HDD clusters. + If this argument is specified, the deprecated arguments for configuring a single cluster will be ignored, including --cluster, --cluster-zone, --cluster-num-nodes. diff --git a/gcloud/bigtable/instances/tables/help b/gcloud/bigtable/instances/tables/help index 736113ff6..458ba51a2 100644 --- a/gcloud/bigtable/instances/tables/help +++ b/gcloud/bigtable/instances/tables/help @@ -36,6 +36,9 @@ COMMANDS set-iam-policy Set an IAM policy on a Cloud Bigtable table. + undelete + Undelete a previously deleted Cloud Bigtable table. + NOTES These variants are also available: diff --git a/gcloud/bigtable/instances/tables/undelete b/gcloud/bigtable/instances/tables/undelete new file mode 100644 index 000000000..202804532 --- /dev/null +++ b/gcloud/bigtable/instances/tables/undelete @@ -0,0 +1,68 @@ +NAME + gcloud bigtable instances tables undelete - undelete a previously deleted + Cloud Bigtable table + +SYNOPSIS + gcloud bigtable instances tables undelete (TABLE : --instance=INSTANCE) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Undelete a previously deleted Cloud Bigtable table. + +EXAMPLES + To undelete the table 'my-table' in instance 'my-instance', run: + + $ gcloud bigtable instances tables undelete my-table \ + --instance=my-instance + +POSITIONAL ARGUMENTS + Table resource - Cloud Bigtable table to undelete. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument table on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + TABLE + ID of the table or fully qualified identifier for the table. To set + the table attribute: + ▸ provide the argument table on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --instance=INSTANCE + The name of the Cloud Bigtable instance. To set the instance + attribute: + ▸ provide the argument table on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 help for details. + +API REFERENCE + This command uses the bigtableadmin/v2 API. The full documentation for this + API can be found at: https://cloud.google.com/bigtable/ + +NOTES + These variants are also available: + + $ gcloud alpha bigtable instances tables undelete + + $ gcloud beta bigtable instances tables undelete + diff --git a/gcloud/certificate-manager/certificates/create b/gcloud/certificate-manager/certificates/create new file mode 100644 index 000000000..463e5c340 --- /dev/null +++ b/gcloud/certificate-manager/certificates/create @@ -0,0 +1,168 @@ +NAME + gcloud certificate-manager certificates create - create a certificate + +SYNOPSIS + gcloud certificate-manager certificates create + (CERTIFICATE : --location=LOCATION) + (--certificate-file=CERTIFICATE_FILE + --private-key-file=PRIVATE_KEY_FILE | [--domains=[DOMAINS,...] + : --dns-authorizations=[DNS_AUTHORIZATIONS,...]]) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--scope=SCOPE; default="DEFAULT"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new certificate. + + ▪ Managed certificates can be created by supplying one or more domain + names and an (optional) list of DNS authorizations for those domain + names. + ▪ Self-managed certificates can be created by uploading a certificate + and its corresponding private key (both in PEM format). + +EXAMPLES + To create (upload) a self-managed certificate called www-example-com, run: + + $ gcloud certificate-manager certificates create www-example-com \ + --private-key-file=key.pem --certificate-file=cert.pem + + To create a certificate managed by Certificate Manager called + api-example-com, run: + + $ gcloud certificate-manager certificates create api-example-com \ + --domains="api.example.com" + + To create a certificate managed by Certificate Manager called + api-example-com, using an existing DNS authorization, run: + + $ gcloud certificate-manager certificates create api-example-com \ + --dns-authorizations=api-example-com --domains="api.example.com" + +POSITIONAL ARGUMENTS + Certificate resource - The name of the certificate to create. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument certificate on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + CERTIFICATE + ID of the certificate or fully qualified identifier for the + certificate. To set the certificate attribute: + ▸ provide the argument certificate on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument certificate on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +REQUIRED FLAGS + Configuration for creating and uploading certificates to Cloud Certificate + Manager. + + Exactly one of these must be specified: + + Configuration for uploading self-managed certificates and keys. + + --certificate-file=CERTIFICATE_FILE + Certificate data in PEM-encoded form. + + This flag must be specified if any of the other arguments in this + group are specified. + + --private-key-file=PRIVATE_KEY_FILE + Private key data in PEM-encoded form + + This flag must be specified if any of the other arguments in this + group are specified. + + Configuration for creating new managed certificates. + + --domains=[DOMAINS,...] + Public domain name(s) to create a certificate for. + + ▫ If a DNS authorization is provided for the domain, the + certificate will be validated against the DNS record you added as + part of the authorization flow. + ▫ If no DNS authorization is provided, Certificate Manager will + attempt to validate the domain against the serving endpoint + directly. + + You may list multiple, comma-separated domain names to include + multiple names as Subject Alternative Names on the issued + certificate. + + This flag must be specified if any of the other arguments in this + group are specified. + + --dns-authorizations=[DNS_AUTHORIZATIONS,...] + Name(s) of the DNS authorizations for each listed domain. + + Note that each domain requires a matching authorization, and any + domain that fails authorization will prevent issuance and/or + renewal of the certificate. + + To reference multiple DNS authorizations, provide a list of comma + separated DNS authorization resource names or URLs. For example: + + $ gcloud certificate-manager certificates create \ + --dns-authorizations=api-example-com,www-example-com + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Human-readable description of the resource. + + --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. + + --scope=SCOPE; default="DEFAULT" + Scope of the managed certificate. This determines which services the + certificate can be attached to/associated with. Defaults to DEFAULT. + SCOPE must be one of: + + default + Certificates with DEFAULT scope are used for Load Balancing and + Cloud CDN. + + If unsure, choose this option. + + edge-cache + Certificates with scope EDGE_CACHE are special-purposed + certificates, scoped for use with Media Edge services only. + +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 help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager certificates create + + $ gcloud beta certificate-manager certificates create + diff --git a/gcloud/certificate-manager/certificates/delete b/gcloud/certificate-manager/certificates/delete new file mode 100644 index 000000000..b6cb738d5 --- /dev/null +++ b/gcloud/certificate-manager/certificates/delete @@ -0,0 +1,63 @@ +NAME + gcloud certificate-manager certificates delete - delete a certificate + +SYNOPSIS + gcloud certificate-manager certificates delete + (CERTIFICATE : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a certificate resource. + +EXAMPLES + To delete the certificate with name simple-cert, run: + + $ gcloud certificate-manager certificates delete simple-cert + +POSITIONAL ARGUMENTS + Certificate resource - The certificate to delete. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument certificate on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CERTIFICATE + ID of the certificate or fully qualified identifier for the + certificate. To set the certificate attribute: + ▸ provide the argument certificate on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate. To set the location + attribute: + ▸ provide the argument certificate on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager certificates delete + + $ gcloud beta certificate-manager certificates delete + diff --git a/gcloud/certificate-manager/certificates/describe b/gcloud/certificate-manager/certificates/describe new file mode 100644 index 000000000..ee3357315 --- /dev/null +++ b/gcloud/certificate-manager/certificates/describe @@ -0,0 +1,62 @@ +NAME + gcloud certificate-manager certificates describe - describe an existing + certificate + +SYNOPSIS + gcloud certificate-manager certificates describe + (CERTIFICATE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command fetches and prints information about an existing certificate. + +EXAMPLES + To describe a certificate with name my-cert, run: + + $ gcloud certificate-manager certificates describe my-cert + +POSITIONAL ARGUMENTS + Certificate resource - The certificate you want to describe. The arguments + in this group can be used to specify the attributes of this resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. To set the project attribute: + ◆ provide the argument certificate on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + CERTIFICATE + ID of the certificate or fully qualified identifier for the + certificate. To set the certificate attribute: + ▸ provide the argument certificate on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument certificate on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +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 help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager certificates describe + + $ gcloud beta certificate-manager certificates describe + diff --git a/gcloud/certificate-manager/certificates/help b/gcloud/certificate-manager/certificates/help new file mode 100644 index 000000000..5c41dbcb7 --- /dev/null +++ b/gcloud/certificate-manager/certificates/help @@ -0,0 +1,40 @@ +NAME + gcloud certificate-manager certificates - manage Certificate Manager + certificates + +SYNOPSIS + gcloud certificate-manager certificates COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing certificates. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a certificate. + + delete + Delete a certificate. + + describe + Describe an existing certificate. + + list + List certificates. + + update + Update a certificate. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager certificates + + $ gcloud beta certificate-manager certificates + diff --git a/gcloud/certificate-manager/certificates/list b/gcloud/certificate-manager/certificates/list new file mode 100644 index 000000000..964fd3eb2 --- /dev/null +++ b/gcloud/certificate-manager/certificates/list @@ -0,0 +1,80 @@ +NAME + gcloud certificate-manager certificates list - list certificates + +SYNOPSIS + gcloud certificate-manager certificates list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Certificate Manager certificates in the project. + +EXAMPLES + To list all certificates in the project, run: + + $ gcloud certificate-manager certificates list + +FLAGS + Location resource - The Cloud location to list certificates for. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ default value of location is [global] with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager certificates list + + $ gcloud beta certificate-manager certificates list + diff --git a/gcloud/certificate-manager/certificates/update b/gcloud/certificate-manager/certificates/update new file mode 100644 index 000000000..e15e0a54c --- /dev/null +++ b/gcloud/certificate-manager/certificates/update @@ -0,0 +1,116 @@ +NAME + gcloud certificate-manager certificates update - update a certificate + +SYNOPSIS + gcloud certificate-manager certificates update + (CERTIFICATE : --location=LOCATION) [--description=DESCRIPTION] + [--certificate-file=CERTIFICATE_FILE + --private-key-file=PRIVATE_KEY_FILE] [--async] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command updates existing certificate. + +EXAMPLES + To update a certificate with name simple-cert, run: + + $ gcloud certificate-manager certificates update simple-cert \ + --description="desc" --update-labels="key=value" \ + --certificate-file=cert.pem --private-key-file=key.pem + +POSITIONAL ARGUMENTS + Certificate resource - The certificate to update. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument certificate on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CERTIFICATE + ID of the certificate or fully qualified identifier for the + certificate. To set the certificate attribute: + ▸ provide the argument certificate on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate. To set the location + attribute: + ▸ provide the argument certificate on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +COMMONLY USED FLAGS + --description=DESCRIPTION + Text description of a certificate. + + Arguments to configure self-managed certificate data. + + --certificate-file=CERTIFICATE_FILE + The certificate data in PEM-encoded form. + + This flag must be specified if any of the other arguments in this + group are specified. + + --private-key-file=PRIVATE_KEY_FILE + The private key data in PEM-encoded form. + + This flag must be specified if any of the other arguments in this + group are specified. + +OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + 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. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud certificate-manager certificates update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud certificate-manager certificates update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager certificates update + + $ gcloud beta certificate-manager certificates update + diff --git a/gcloud/certificate-manager/dns-authorizations/create b/gcloud/certificate-manager/dns-authorizations/create new file mode 100644 index 000000000..d0c69f985 --- /dev/null +++ b/gcloud/certificate-manager/dns-authorizations/create @@ -0,0 +1,85 @@ +NAME + gcloud certificate-manager dns-authorizations create - create a DNS + Authorization + +SYNOPSIS + gcloud certificate-manager dns-authorizations create + (DNS_AUTHORIZATION : --location=LOCATION) --domain=DOMAIN [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new DNS Authorization. + +EXAMPLES + To create a DNS authorization called my-authorization, run: + + $ gcloud certificate-manager dns-authorizations create \ + my-authorization --domain=host.example.com + +POSITIONAL ARGUMENTS + DnsAuthorization resource - The name of the DNS Authorization to create. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument dns_authorization on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + DNS_AUTHORIZATION + ID of the dnsAuthorization or fully qualified identifier for the + dnsAuthorization. To set the dns_authorization attribute: + ▸ provide the argument dns_authorization on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument dns_authorization on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +REQUIRED FLAGS + --domain=DOMAIN + Public domain name to create an authorization for. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Human-readable description of the resource. + + --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. + +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 help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager dns-authorizations create + + $ gcloud beta certificate-manager dns-authorizations create + diff --git a/gcloud/certificate-manager/dns-authorizations/delete b/gcloud/certificate-manager/dns-authorizations/delete new file mode 100644 index 000000000..9a466594d --- /dev/null +++ b/gcloud/certificate-manager/dns-authorizations/delete @@ -0,0 +1,69 @@ +NAME + gcloud certificate-manager dns-authorizations delete - delete a DNS + Authorization + +SYNOPSIS + gcloud certificate-manager dns-authorizations delete + (DNS_AUTHORIZATION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a DNS Authorization. + +EXAMPLES + To delete a DNS Authorization called my-authorization, run: + + $ gcloud certificate-manager dns-authorizations delete \ + my-authorization + +POSITIONAL ARGUMENTS + DnsAuthorization resource - The name of the DNS Authorization to delete. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument dns_authorization on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + DNS_AUTHORIZATION + ID of the dnsAuthorization or fully qualified identifier for the + dnsAuthorization. To set the dns_authorization attribute: + ▸ provide the argument dns_authorization on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument dns_authorization on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager dns-authorizations delete + + $ gcloud beta certificate-manager dns-authorizations delete + diff --git a/gcloud/certificate-manager/dns-authorizations/describe b/gcloud/certificate-manager/dns-authorizations/describe new file mode 100644 index 000000000..f1a92e7f8 --- /dev/null +++ b/gcloud/certificate-manager/dns-authorizations/describe @@ -0,0 +1,63 @@ +NAME + gcloud certificate-manager dns-authorizations describe - show details about + a DNS Authorization + +SYNOPSIS + gcloud certificate-manager dns-authorizations describe + (DNS_AUTHORIZATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details about a DNS Authorization. + +EXAMPLES + To show details about an existing authorization, run: + + $ gcloud certificate-manager dns-authorizations describe \ + my-authorization + +POSITIONAL ARGUMENTS + DnsAuthorization resource - The DNS Authorization you want to describe. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument dns_authorization on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + DNS_AUTHORIZATION + ID of the dnsAuthorization or fully qualified identifier for the + dnsAuthorization. To set the dns_authorization attribute: + ▸ provide the argument dns_authorization on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument dns_authorization on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +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 help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager dns-authorizations describe + + $ gcloud beta certificate-manager dns-authorizations describe + diff --git a/gcloud/certificate-manager/dns-authorizations/help b/gcloud/certificate-manager/dns-authorizations/help new file mode 100644 index 000000000..6b7503ae6 --- /dev/null +++ b/gcloud/certificate-manager/dns-authorizations/help @@ -0,0 +1,41 @@ +NAME + gcloud certificate-manager dns-authorizations - manage Certificate Manager + DNS authorizations + +SYNOPSIS + gcloud certificate-manager dns-authorizations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing DNS authorizations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a DNS Authorization. + + delete + Delete a DNS Authorization. + + describe + Show details about a DNS Authorization. + + list + List all DNS Authorizations in a project. + + update + Update a DNS Authorization. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager dns-authorizations + + $ gcloud beta certificate-manager dns-authorizations + diff --git a/gcloud/certificate-manager/dns-authorizations/list b/gcloud/certificate-manager/dns-authorizations/list new file mode 100644 index 000000000..acaf82a3b --- /dev/null +++ b/gcloud/certificate-manager/dns-authorizations/list @@ -0,0 +1,85 @@ +NAME + gcloud certificate-manager dns-authorizations list - list all DNS + Authorizations in a project + +SYNOPSIS + gcloud certificate-manager dns-authorizations list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List existing DNS Authorizations. + +EXAMPLES + To list existing DNS authorizations, run: + + $ gcloud certificate-manager dns-authorizations list + +FLAGS + Location resource - The location (defaults to global) of the resources. + This represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ default value of location is [global] with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager dns-authorizations list + + $ gcloud beta certificate-manager dns-authorizations list + diff --git a/gcloud/certificate-manager/dns-authorizations/update b/gcloud/certificate-manager/dns-authorizations/update new file mode 100644 index 000000000..e09497aae --- /dev/null +++ b/gcloud/certificate-manager/dns-authorizations/update @@ -0,0 +1,102 @@ +NAME + gcloud certificate-manager dns-authorizations update - update a DNS + Authorization + +SYNOPSIS + gcloud certificate-manager dns-authorizations update + (DNS_AUTHORIZATION : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a DNS Authorization. + +EXAMPLES + To Update a DNS Authorization called my-authorization, run: + + $ gcloud certificate-manager dns-authorizations update \ + my-authorization + +POSITIONAL ARGUMENTS + DnsAuthorization resource - The name of the DNS Authorization to delete. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument dns_authorization on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + DNS_AUTHORIZATION + ID of the dnsAuthorization or fully qualified identifier for the + dnsAuthorization. To set the dns_authorization attribute: + ▸ provide the argument dns_authorization on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument dns_authorization on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Human-readable description of the resource. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + 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. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud certificate-manager dns-authorizations update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud certificate-manager dns-authorizations update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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 help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager dns-authorizations update + + $ gcloud beta certificate-manager dns-authorizations update + diff --git a/gcloud/certificate-manager/help b/gcloud/certificate-manager/help new file mode 100644 index 000000000..851cef80f --- /dev/null +++ b/gcloud/certificate-manager/help @@ -0,0 +1,37 @@ +NAME + gcloud certificate-manager - manage SSL certificates for your Google Cloud + projects + +SYNOPSIS + gcloud certificate-manager GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage SSL certificates for your Google Cloud projects. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + certificates + Manage Certificate Manager certificates. + + dns-authorizations + Manage Certificate Manager DNS authorizations. + + maps + Manage Certificate Manager certificate maps. + + operations + Manage Certificate Manager operations. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager + + $ gcloud beta certificate-manager + diff --git a/gcloud/certificate-manager/maps/create b/gcloud/certificate-manager/maps/create new file mode 100644 index 000000000..e80fc87be --- /dev/null +++ b/gcloud/certificate-manager/maps/create @@ -0,0 +1,76 @@ +NAME + gcloud certificate-manager maps create - create a certificate map + +SYNOPSIS + gcloud certificate-manager maps create (MAP : --location=LOCATION) + [--description=DESCRIPTION] [--async] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command creates a certificate map. + +EXAMPLES + To create a certificate map with name simple-map, run: + + $ gcloud certificate-manager maps create simple-map + +POSITIONAL ARGUMENTS + Certificate map resource - The certificate map to create. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument map on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MAP + ID of the certificate map or fully qualified identifier for the + certificate map. To set the map attribute: + ▸ provide the argument map on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate map. To set the location + attribute: + ▸ provide the argument map on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +COMMONLY USED FLAGS + --description=DESCRIPTION + Text description of a certificate map. + +OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --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. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps create + + $ gcloud beta certificate-manager maps create + diff --git a/gcloud/certificate-manager/maps/delete b/gcloud/certificate-manager/maps/delete new file mode 100644 index 000000000..ea2bd0626 --- /dev/null +++ b/gcloud/certificate-manager/maps/delete @@ -0,0 +1,63 @@ +NAME + gcloud certificate-manager maps delete - delete a certificate map + +SYNOPSIS + gcloud certificate-manager maps delete (MAP : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a certificate map resource. + +EXAMPLES + To delete the certificate map with name simple-map, run: + + $ gcloud certificate-manager maps delete simple-map + +POSITIONAL ARGUMENTS + Certificate map resource - The certificate map to delete. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument map on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MAP + ID of the certificate map or fully qualified identifier for the + certificate map. To set the map attribute: + ▸ provide the argument map on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate map. To set the location + attribute: + ▸ provide the argument map on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps delete + + $ gcloud beta certificate-manager maps delete + diff --git a/gcloud/certificate-manager/maps/describe b/gcloud/certificate-manager/maps/describe new file mode 100644 index 000000000..daf1626a7 --- /dev/null +++ b/gcloud/certificate-manager/maps/describe @@ -0,0 +1,60 @@ +NAME + gcloud certificate-manager maps describe - describe an existing certificate + map + +SYNOPSIS + gcloud certificate-manager maps describe (MAP : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command fetches and prints information about an existing certificate + map. + +EXAMPLES + To describe a certificate map with name simple-map, run: + + $ gcloud certificate-manager maps describe simple-map + +POSITIONAL ARGUMENTS + Certificate map resource - The certificate map to describe. The arguments + in this group can be used to specify the attributes of this resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. To set the project attribute: + ◆ provide the argument map on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MAP + ID of the certificate map or fully qualified identifier for the + certificate map. To set the map attribute: + ▸ provide the argument map on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate map. To set the location + attribute: + ▸ provide the argument map on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps describe + + $ gcloud beta certificate-manager maps describe + diff --git a/gcloud/certificate-manager/maps/entries/create b/gcloud/certificate-manager/maps/entries/create new file mode 100644 index 000000000..16a257e26 --- /dev/null +++ b/gcloud/certificate-manager/maps/entries/create @@ -0,0 +1,118 @@ +NAME + gcloud certificate-manager maps entries create - create a certificate map + entry + +SYNOPSIS + gcloud certificate-manager maps entries create + (ENTRY : --location=LOCATION --map=MAP) + (--hostname=HOSTNAME | --set-primary) [--description=DESCRIPTION] + --certificates=[CERTIFICATES,...] [--async] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command creates a certificate map entry. + +EXAMPLES + To create a certificate map entry with name simple-entry, run: + + $ gcloud certificate-manager maps entries create simple-entry \ + --map=simple-map --certificates=simple-cert + +POSITIONAL ARGUMENTS + Certificate map entry resource - The certificate map entry to create. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument entry on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ENTRY + ID of the certificate map entry or fully qualified identifier for the + certificate map entry. To set the entry attribute: + ▸ provide the argument entry on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate map entry. To set the location + attribute: + ▸ provide the argument entry on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + + --map=MAP + The certificate map for the certificate map entry. To set the map + attribute: + ▸ provide the argument entry on the command line with a fully + specified name; + ▸ provide the argument --map on the command line. + +REQUIRED FLAGS + Arguments to configure matcher for the certificate map entry. + + Exactly one of these must be specified: + + --hostname=HOSTNAME + A domain name (FQDN), which controls when list of certificates + specified in the resource will be taken under consideration for + certificate selection. + + --set-primary + The certificate will be used as the default cert if no other + certificate in the map matches on SNI. + +COMMONLY USED FLAGS + --description=DESCRIPTION + Text description of a certificate map entry. + +OTHER FLAGS + Certificate resource - The certificates to be attached to the entry. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --certificates on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. To set the location attribute: + ◆ provide the argument --certificates on the command line with a fully + specified name; + ◆ default value of location is [global]. + + --certificates=[CERTIFICATES,...] + IDs of the certificates or fully qualified identifiers for the + certificates. To set the certificate attribute: + ▸ provide the argument --certificates on the command line. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --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. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps entries create + + $ gcloud beta certificate-manager maps entries create + diff --git a/gcloud/certificate-manager/maps/entries/delete b/gcloud/certificate-manager/maps/entries/delete new file mode 100644 index 000000000..a334f8515 --- /dev/null +++ b/gcloud/certificate-manager/maps/entries/delete @@ -0,0 +1,73 @@ +NAME + gcloud certificate-manager maps entries delete - delete a certificate map + entry + +SYNOPSIS + gcloud certificate-manager maps entries delete + (ENTRY : --location=LOCATION --map=MAP) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a certificate map entry resource. + +EXAMPLES + To delete the certificate map entry with name simple-entry, run: + + $ gcloud certificate-manager maps entries delete simple-entry \ + --map=simple-map + +POSITIONAL ARGUMENTS + Certificate map entry resource - The certificate map entry to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument entry on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ENTRY + ID of the certificate map entry or fully qualified identifier for the + certificate map entry. To set the entry attribute: + ▸ provide the argument entry on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate map entry. To set the location + attribute: + ▸ provide the argument entry on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + + --map=MAP + The certificate map for the certificate map entry. To set the map + attribute: + ▸ provide the argument entry on the command line with a fully + specified name; + ▸ provide the argument --map on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps entries delete + + $ gcloud beta certificate-manager maps entries delete + diff --git a/gcloud/certificate-manager/maps/entries/describe b/gcloud/certificate-manager/maps/entries/describe new file mode 100644 index 000000000..24edeebf0 --- /dev/null +++ b/gcloud/certificate-manager/maps/entries/describe @@ -0,0 +1,68 @@ +NAME + gcloud certificate-manager maps entries describe - describe an existing + certificate map entry + +SYNOPSIS + gcloud certificate-manager maps entries describe + (ENTRY : --location=LOCATION --map=MAP) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command fetches and prints information about an existing certificate + map entry. + +EXAMPLES + To describe a certificate map entry with name simple-entry, run: + + $ gcloud certificate-manager maps entries describe simple-entry \ + --map=simple-map + +POSITIONAL ARGUMENTS + Certificate map entry resource - The certificate map entry to describe. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument entry on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ENTRY + ID of the certificate map entry or fully qualified identifier for the + certificate map entry. To set the entry attribute: + ▸ provide the argument entry on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate map entry. To set the location + attribute: + ▸ provide the argument entry on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + + --map=MAP + The certificate map for the certificate map entry. To set the map + attribute: + ▸ provide the argument entry on the command line with a fully + specified name; + ▸ provide the argument --map on the command line. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps entries describe + + $ gcloud beta certificate-manager maps entries describe + diff --git a/gcloud/certificate-manager/maps/entries/help b/gcloud/certificate-manager/maps/entries/help new file mode 100644 index 000000000..305fd11d3 --- /dev/null +++ b/gcloud/certificate-manager/maps/entries/help @@ -0,0 +1,40 @@ +NAME + gcloud certificate-manager maps entries - manage Certificate Manager + certificate map entries + +SYNOPSIS + gcloud certificate-manager maps entries COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing certificate map entries. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a certificate map entry. + + delete + Delete a certificate map entry. + + describe + Describe an existing certificate map entry. + + list + List certificate map entries. + + update + Update a certificate map entry. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps entries + + $ gcloud beta certificate-manager maps entries + diff --git a/gcloud/certificate-manager/maps/entries/list b/gcloud/certificate-manager/maps/entries/list new file mode 100644 index 000000000..b9a0424da --- /dev/null +++ b/gcloud/certificate-manager/maps/entries/list @@ -0,0 +1,92 @@ +NAME + gcloud certificate-manager maps entries list - list certificate map entries + +SYNOPSIS + gcloud certificate-manager maps entries list + (--map=MAP : --location=LOCATION) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Certificate Manager certificate map entries in the certificate map. + +EXAMPLES + To list all certificate map entries in the certificate map, run: + + $ gcloud certificate-manager maps entries list --map=simple-map + +REQUIRED FLAGS + Certificate map resource - The certificate map to list map entries for. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument --map on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --map=MAP + ID of the certificate map or fully qualified identifier for the + certificate map. To set the map attribute: + ▸ provide the argument --map on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --location=LOCATION + The Cloud location for the certificate map. To set the location + attribute: + ▸ provide the argument --map on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps entries list + + $ gcloud beta certificate-manager maps entries list + diff --git a/gcloud/certificate-manager/maps/entries/update b/gcloud/certificate-manager/maps/entries/update new file mode 100644 index 000000000..71d5ce9ff --- /dev/null +++ b/gcloud/certificate-manager/maps/entries/update @@ -0,0 +1,126 @@ +NAME + gcloud certificate-manager maps entries update - update a certificate map + entry + +SYNOPSIS + gcloud certificate-manager maps entries update + (ENTRY : --location=LOCATION --map=MAP) [--description=DESCRIPTION] + --certificates=[CERTIFICATES,...] [--async] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command updates existing certificate map entry. + +EXAMPLES + To update a certificate map entry with name simple-entry, run: + + $ gcloud certificate-manager maps entries update simple-entry \ + --map="simple-map" --description="desc" \ + --update-labels="key=value" --certificates="simple-cert" + +POSITIONAL ARGUMENTS + Certificate map entry resource - The certificate map entry to update. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument entry on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ENTRY + ID of the certificate map entry or fully qualified identifier for the + certificate map entry. To set the entry attribute: + ▸ provide the argument entry on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate map entry. To set the location + attribute: + ▸ provide the argument entry on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + + --map=MAP + The certificate map for the certificate map entry. To set the map + attribute: + ▸ provide the argument entry on the command line with a fully + specified name; + ▸ provide the argument --map on the command line. + +COMMONLY USED FLAGS + --description=DESCRIPTION + Text description of a certificate map entry. + +OTHER FLAGS + Certificate resource - The certificates to be attached to the entry. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --certificates on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. To set the location attribute: + ◆ provide the argument --certificates on the command line with a fully + specified name; + ◆ default value of location is [global]. + + --certificates=[CERTIFICATES,...] + IDs of the certificates or fully qualified identifiers for the + certificates. To set the certificate attribute: + ▸ provide the argument --certificates on the command line. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + 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. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud certificate-manager maps entries update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud certificate-manager maps entries update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps entries update + + $ gcloud beta certificate-manager maps entries update + diff --git a/gcloud/certificate-manager/maps/help b/gcloud/certificate-manager/maps/help new file mode 100644 index 000000000..dfead9671 --- /dev/null +++ b/gcloud/certificate-manager/maps/help @@ -0,0 +1,46 @@ +NAME + gcloud certificate-manager maps - manage Certificate Manager certificate + maps + +SYNOPSIS + gcloud certificate-manager maps GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing certificate maps. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + entries + Manage Certificate Manager certificate map entries. + +COMMANDS + COMMAND is one of the following: + + create + Create a certificate map. + + delete + Delete a certificate map. + + describe + Describe an existing certificate map. + + list + List certificate maps. + + update + Update a certificate map. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps + + $ gcloud beta certificate-manager maps + diff --git a/gcloud/certificate-manager/maps/list b/gcloud/certificate-manager/maps/list new file mode 100644 index 000000000..98782c5f3 --- /dev/null +++ b/gcloud/certificate-manager/maps/list @@ -0,0 +1,79 @@ +NAME + gcloud certificate-manager maps list - list certificate maps + +SYNOPSIS + gcloud certificate-manager maps list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Certificate Manager maps in the project. + +EXAMPLES + To list all certificate maps in the project, run: + + $ gcloud certificate-manager maps list + +FLAGS + Location resource - The Cloud location to list maps for. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ default value of location is [global] with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps list + + $ gcloud beta certificate-manager maps list + diff --git a/gcloud/certificate-manager/maps/update b/gcloud/certificate-manager/maps/update new file mode 100644 index 000000000..19b2565ca --- /dev/null +++ b/gcloud/certificate-manager/maps/update @@ -0,0 +1,98 @@ +NAME + gcloud certificate-manager maps update - update a certificate map + +SYNOPSIS + gcloud certificate-manager maps update (MAP : --location=LOCATION) + [--description=DESCRIPTION] [--async] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command updates existing certificate map. + +EXAMPLES + To update a certificate map with name simple-map, run: + + $ gcloud certificate-manager maps update simple-map \ + --description="desc" --update-labels="key=value" + +POSITIONAL ARGUMENTS + Certificate map resource - The certificate map to update. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument map on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MAP + ID of the certificate map or fully qualified identifier for the + certificate map. To set the map attribute: + ▸ provide the argument map on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the certificate map. To set the location + attribute: + ▸ provide the argument map on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +COMMONLY USED FLAGS + --description=DESCRIPTION + Text description of a certificate map. + +OTHER FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + 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. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud certificate-manager maps update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud certificate-manager maps update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager maps update + + $ gcloud beta certificate-manager maps update + diff --git a/gcloud/certificate-manager/operations/describe b/gcloud/certificate-manager/operations/describe new file mode 100644 index 000000000..6fe60f68d --- /dev/null +++ b/gcloud/certificate-manager/operations/describe @@ -0,0 +1,62 @@ +NAME + gcloud certificate-manager operations describe - describe a long-running + operation + +SYNOPSIS + gcloud certificate-manager operations describe + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Certificate Manager long-running operation. + +EXAMPLES + To describe an operation with name simple-operation, run: + + $ gcloud certificate-manager operations describe simple-operation + +POSITIONAL ARGUMENTS + Operation resource - Certificate Manager operation to describe. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +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 help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager operations describe + + $ gcloud beta certificate-manager operations describe + diff --git a/gcloud/certificate-manager/operations/help b/gcloud/certificate-manager/operations/help new file mode 100644 index 000000000..aa818d224 --- /dev/null +++ b/gcloud/certificate-manager/operations/help @@ -0,0 +1,31 @@ +NAME + gcloud certificate-manager operations - manage Certificate Manager + operations + +SYNOPSIS + gcloud certificate-manager operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing long-running operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe a long-running operation. + + list + List long-running operations. + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager operations + + $ gcloud beta certificate-manager operations + diff --git a/gcloud/certificate-manager/operations/list b/gcloud/certificate-manager/operations/list new file mode 100644 index 000000000..fafa930d7 --- /dev/null +++ b/gcloud/certificate-manager/operations/list @@ -0,0 +1,84 @@ +NAME + gcloud certificate-manager operations list - list long-running operations + +SYNOPSIS + gcloud certificate-manager operations list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Certificate Manager long-running operations. + +EXAMPLES + To list all operations, run: + + $ gcloud certificate-manager operations list + +FLAGS + Location resource - Certificate Manager location to list all operations. + This represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ default value of location is [global] with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager operations list + + $ gcloud beta certificate-manager operations list + diff --git a/gcloud/compute/ssh b/gcloud/compute/ssh index d388f0378..32f77ed19 100644 --- a/gcloud/compute/ssh +++ b/gcloud/compute/ssh @@ -16,10 +16,8 @@ DESCRIPTION care of authentication and the translation of the instance name into an IP address. - Note, this command does not work when connecting to Windows VMs. To connect - to a Windows instance, including connecting using a command-line method, - refer to this guide: - https://cloud.google.com/compute/docs/instances/connecting-to-windows + To use SSH to connect to a Windows VM, refer to this guide: + https://cloud.google.com/compute/docs/connect/windows-ssh The default network comes preconfigured to allow ssh access to all VMs. If the default network was edited, or if not using the default network, you diff --git a/gcloud/compute/target-https-proxies/create b/gcloud/compute/target-https-proxies/create index efea6991e..96943d77d 100644 --- a/gcloud/compute/target-https-proxies/create +++ b/gcloud/compute/target-https-proxies/create @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud compute target-https-proxies create NAME --url-map=URL_MAP - [--description=DESCRIPTION] + --certificate-map=CERTIFICATE_MAP [--description=DESCRIPTION] [--quic-override=QUIC_OVERRIDE; default="NONE"] [--ssl-certificates=SSL_CERTIFICATE,[...]] [--ssl-policy=SSL_POLICY] [--global | --region=REGION] @@ -48,6 +48,22 @@ REQUIRED FLAGS referring to, you must first delete the target HTTPS proxy. OPTIONAL FLAGS + Certificate map resource - The certificate map to attach. This represents + a Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. To set the project attribute: + ◆ provide the argument --certificate-map on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. To set the location attribute: + ◆ provide the argument --certificate-map on the command line with a + fully specified name; + ◆ default value of location is [global]. + + --certificate-map=CERTIFICATE_MAP + ID of the certificate map or fully qualified identifier for the + certificate map. To set the map attribute: + ▸ provide the argument --certificate-map on the command line. + --description=DESCRIPTION An optional, textual description for the target HTTPS proxy. diff --git a/gcloud/compute/target-https-proxies/update b/gcloud/compute/target-https-proxies/update index a9766d403..54f7d3376 100644 --- a/gcloud/compute/target-https-proxies/update +++ b/gcloud/compute/target-https-proxies/update @@ -3,12 +3,12 @@ NAME SYNOPSIS gcloud compute target-https-proxies update NAME - [--quic-override=QUIC_OVERRIDE] - [--ssl-certificates=SSL_CERTIFICATE,[...]] [--url-map=URL_MAP] + [--quic-override=QUIC_OVERRIDE] [--url-map=URL_MAP] + [[--certificate-map=CERTIFICATE_MAP : --clear-certificate-map] + | --ssl-certificates=SSL_CERTIFICATE,[...] --global-ssl-certificates + | --ssl-certificates-region=SSL_CERTIFICATES_REGION] [--clear-ssl-policy | --ssl-policy=SSL_POLICY] [--global | --region=REGION] - [--global-ssl-certificates - | --ssl-certificates-region=SSL_CERTIFICATES_REGION] [--global-url-map | --url-map-region=URL_MAP_REGION] [GCLOUD_WIDE_FLAG ...] @@ -62,19 +62,68 @@ FLAGS NONE Allows Google to control when QUIC is rolled out. - --ssl-certificates=SSL_CERTIFICATE,[...] - References to at most 15 SSL certificate resources that are used for - server-side authentication. The first SSL certificate in this list is - considered the primary SSL certificate associated with the load - balancer. The SSL certificates must exist and cannot be deleted while - referenced by a target HTTPS proxy. - --url-map=URL_MAP A reference to a URL map resource. A URL map defines the mapping of URLs to backend services. Before you can refer to a URL map, you must create the URL map. To delete a URL map that a target proxy is referring to, you must first delete the target HTTPS proxy. + At most one of these can be specified: + + At most one of these can be specified: + + Certificate map resource - The certificate map to attach. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the + project attribute: + ▫ provide the argument --certificate-map on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. To set the location attribute: + ▫ provide the argument --certificate-map on the command line with a + fully specified name; + ▫ default value of location is [global]. + + --certificate-map=CERTIFICATE_MAP + ID of the certificate map or fully qualified identifier for the + certificate map. To set the map attribute: + ◇ provide the argument --certificate-map on the command line. + + --clear-certificate-map + Removes any attached certificate map from the HTTPS proxy. + + --ssl-certificates=SSL_CERTIFICATE,[...] + References to at most 15 SSL certificate resources that are used for + server-side authentication. The first SSL certificate in this list is + considered the primary SSL certificate associated with the load + balancer. The SSL certificates must exist and cannot be deleted while + referenced by a target HTTPS proxy. + + At most one of these can be specified: + + --global-ssl-certificates + If set, the ssl certificates are global. + + --ssl-certificates-region=SSL_CERTIFICATES_REGION + Region of the ssl certificates to operate on. If not specified, you + might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + At most one of these can be specified: --clear-ssl-policy @@ -111,31 +160,6 @@ FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. - At most one of these can be specified: - - --global-ssl-certificates - If set, the ssl certificates are global. - - --ssl-certificates-region=SSL_CERTIFICATES_REGION - Region of the ssl certificates to operate on. If not specified, you - might be prompted to select a region (interactive mode only). - - To avoid prompting when this flag is omitted, you can set the - compute/region property: - - $ gcloud config set compute/region REGION - - A list of regions can be fetched by running: - - $ gcloud compute regions list - - To unset the property, run: - - $ gcloud config unset compute/region - - Alternatively, the region can be stored in the environment variable - CLOUDSDK_COMPUTE_REGION. - At most one of these can be specified: --global-url-map diff --git a/gcloud/compute/target-ssl-proxies/create b/gcloud/compute/target-ssl-proxies/create index e96aeb013..e949a3242 100644 --- a/gcloud/compute/target-ssl-proxies/create +++ b/gcloud/compute/target-ssl-proxies/create @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud compute target-ssl-proxies create NAME --backend-service=BACKEND_SERVICE - --ssl-certificates=SSL_CERTIFICATE,[...] [--description=DESCRIPTION] + (--certificate-map=CERTIFICATE_MAP + : --ssl-certificates=SSL_CERTIFICATE,[...]) + [--description=DESCRIPTION] [--proxy-header=PROXY_HEADER; default="NONE"] [--ssl-policy=SSL_POLICY] [GCLOUD_WIDE_FLAG ...] @@ -26,12 +28,31 @@ REQUIRED FLAGS A backend service that will be used for connections to the target SSL proxy. - --ssl-certificates=SSL_CERTIFICATE,[...] - References to at most 15 SSL certificate resources that are used for - server-side authentication. The first SSL certificate in this list is - considered the primary SSL certificate associated with the load - balancer. The SSL certificates must exist and cannot be deleted while - referenced by a target SSL proxy. + At least one of these must be specified: + + Certificate map resource - The certificate map to attach. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ▸ provide the argument --certificate-map on the command line with a + fully specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. To set the location attribute: + ▸ provide the argument --certificate-map on the command line with a + fully specified name; + ▸ default value of location is [global]. + + --certificate-map=CERTIFICATE_MAP + ID of the certificate map or fully qualified identifier for the + certificate map. To set the map attribute: + ▫ provide the argument --certificate-map on the command line. + + --ssl-certificates=SSL_CERTIFICATE,[...] + References to at most 15 SSL certificate resources that are used for + server-side authentication. The first SSL certificate in this list is + considered the primary SSL certificate associated with the load + balancer. The SSL certificates must exist and cannot be deleted while + referenced by a target SSL proxy. OPTIONAL FLAGS --description=DESCRIPTION diff --git a/gcloud/compute/target-ssl-proxies/update b/gcloud/compute/target-ssl-proxies/update index 9e7603651..d8a7df9d8 100644 --- a/gcloud/compute/target-ssl-proxies/update +++ b/gcloud/compute/target-ssl-proxies/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud compute target-ssl-proxies update NAME [--backend-service=BACKEND_SERVICE] [--proxy-header=PROXY_HEADER] - [--ssl-certificates=SSL_CERTIFICATE,[...]] + [--certificate-map=CERTIFICATE_MAP + : --ssl-certificates=SSL_CERTIFICATE,[...] | --clear-ssl-certificates + | --clear-certificate-map] [--clear-ssl-policy | --ssl-policy=SSL_POLICY] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -36,12 +38,37 @@ FLAGS Enables PROXY protocol (version 1) for passing client connection information. - --ssl-certificates=SSL_CERTIFICATE,[...] - References to at most 15 SSL certificate resources that are used for - server-side authentication. The first SSL certificate in this list is - considered the primary SSL certificate associated with the load - balancer. The SSL certificates must exist and cannot be deleted while - referenced by a target SSL proxy. + At most one of these can be specified: + + --ssl-certificates=SSL_CERTIFICATE,[...] + References to at most 15 SSL certificate resources that are used for + server-side authentication. The first SSL certificate in this list is + considered the primary SSL certificate associated with the load + balancer. The SSL certificates must exist and cannot be deleted while + referenced by a target SSL proxy. + + --clear-ssl-certificates + Removes any attached SSL Certificates from the SSL proxy. + + Certificate map resource - The certificate map to attach. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ▸ provide the argument --certificate-map on the command line with a + fully specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. To set the location attribute: + ▸ provide the argument --certificate-map on the command line with a + fully specified name; + ▸ default value of location is [global]. + + --certificate-map=CERTIFICATE_MAP + ID of the certificate map or fully qualified identifier for the + certificate map. To set the map attribute: + ▫ provide the argument --certificate-map on the command line. + + --clear-certificate-map + Removes any attached certificate map from the SSL proxy. At most one of these can be specified: diff --git a/gcloud/container/aws/clusters/update b/gcloud/container/aws/clusters/update index b568bd22c..07332ffc7 100644 --- a/gcloud/container/aws/clusters/update +++ b/gcloud/container/aws/clusters/update @@ -6,6 +6,7 @@ SYNOPSIS [--admin-users=USER,[USER,...]] [--async] [--cluster-version=CLUSTER_VERSION] [--config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN] + [--iam-instance-profile=IAM_INSTANCE_PROFILE] [--instance-type=INSTANCE_TYPE] [--role-arn=ROLE_ARN] [--role-session-name=ROLE_SESSION_NAME] [--root-volume-iops=ROOT_VOLUME_IOPS] @@ -70,6 +71,9 @@ FLAGS --config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN Amazon Resource Name (ARN) of the AWS KMS key to encrypt the user data. + --iam-instance-profile=IAM_INSTANCE_PROFILE + Name or ARN of the IAM instance profile associated with the cluster. + --instance-type=INSTANCE_TYPE AWS EC2 instance type for the control plane's nodes. diff --git a/gcloud/container/aws/node-pools/update b/gcloud/container/aws/node-pools/update index 2e49f9c13..a5083413f 100644 --- a/gcloud/container/aws/node-pools/update +++ b/gcloud/container/aws/node-pools/update @@ -6,6 +6,7 @@ SYNOPSIS gcloud container aws node-pools update (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] [--config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN] + [--iam-instance-profile=IAM_INSTANCE_PROFILE] [--node-version=NODE_VERSION] [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] @@ -71,6 +72,9 @@ FLAGS --config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN Amazon Resource Name (ARN) of the AWS KMS key to encrypt the user data. + --iam-instance-profile=IAM_INSTANCE_PROFILE + Name or ARN of the IAM instance profile associated with the node pool. + --node-version=NODE_VERSION Kubernetes version to use for the node pool. diff --git a/gcloud/container/azure/clusters/update b/gcloud/container/azure/clusters/update index ff6adaff4..b6b70f5db 100644 --- a/gcloud/container/azure/clusters/update +++ b/gcloud/container/azure/clusters/update @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud container azure clusters update (CLUSTER : --location=LOCATION) --client=CLIENT [--admin-users=USER,[USER,...]] [--async] - [--cluster-version=CLUSTER_VERSION] [--validate-only] - [--vm-size=VM_SIZE] [GCLOUD_WIDE_FLAG ...] + [--cluster-version=CLUSTER_VERSION] [--ssh-public-key=SSH_PUBLIC_KEY] + [--validate-only] [--vm-size=VM_SIZE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update an Anthos cluster on Azure. @@ -74,6 +74,9 @@ FLAGS --cluster-version=CLUSTER_VERSION Kubernetes version to use for the cluster. + --ssh-public-key=SSH_PUBLIC_KEY + SSH public key to use for authentication. + --validate-only Validate the update of the cluster, but don't actually perform it. diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 10d34dee4..893bd577a 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -60,8 +60,12 @@ SYNOPSIS --autoprovisioning-locations=ZONE,[ZONE,...] --autoprovisioning-min-cpu-platform=PLATFORM --min-cpu=MIN_CPU --min-memory=MIN_MEMORY - --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-scopes=[SCOPE, - ...] + --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...] + --enable-autoprovisioning-blue-green-upgrade + | --enable-autoprovisioning-surge-upgrade + --autoprovisioning-scopes=[SCOPE,...] --autoprovisioning-service-account=AUTOPROVISIONING_SERVICE_ACCOUNT --enable-autoprovisioning-autorepair --enable-autoprovisioning-autoupgrade @@ -1110,6 +1114,37 @@ FLAGS Number of nodes that can be unavailable at the same time on each upgrade of an autoprovisioned node pool. + --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the update. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + Batch sizes are specfied by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + Example: + --standard-rollout-policy=batch-node-count=3,batch-soak-duration=60s + --standard-rollout-policy=batch-percent=0.05,batch-soak-duration=180s + + Flag group to choose the top level upgrade option: + + At most one of these can be specified: + + --enable-autoprovisioning-blue-green-upgrade + Whether to use blue-green upgrade for the autoprovisioned + node pool. + + --enable-autoprovisioning-surge-upgrade + Whether to use surge upgrade for the autoprovisioned node + pool. + Flags to specify identity for autoprovisioned nodes: --autoprovisioning-scopes=[SCOPE,...] diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 94005c475..d21370fa4 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -45,8 +45,12 @@ SYNOPSIS --autoprovisioning-locations=ZONE,[ZONE,...] --autoprovisioning-min-cpu-platform=PLATFORM --max-cpu=MAX_CPU --max-memory=MAX_MEMORY --min-cpu=MIN_CPU --min-memory=MIN_MEMORY - --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-scopes=[SCOPE, - ...] + --autoprovisioning-max-surge-upgrade=AUTOPROVISIONING_MAX_SURGE_UPGRADE --autoprovisioning-max-unavailable-upgrade=AUTOPROVISIONING_MAX_UNAVAILABLE_UPGRADE --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...] + --enable-autoprovisioning-blue-green-upgrade + | --enable-autoprovisioning-surge-upgrade + --autoprovisioning-scopes=[SCOPE,...] --autoprovisioning-service-account=AUTOPROVISIONING_SERVICE_ACCOUNT --enable-autoprovisioning-autorepair --enable-autoprovisioning-autoupgrade @@ -754,6 +758,37 @@ REQUIRED FLAGS Number of nodes that can be unavailable at the same time on each upgrade of an autoprovisioned node pool. + --autoprovisioning-node-pool-soak-duration=AUTOPROVISIONING_NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the update. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + --autoprovisioning-standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. This + argument should be used in conjunction with + --enable-autoprovisioning-blue-green-upgrade to take effect. + + Batch sizes are specfied by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + Example: + --standard-rollout-policy=batch-node-count=3,batch-soak-duration=60s + --standard-rollout-policy=batch-percent=0.05,batch-soak-duration=180s + + Flag group to choose the top level upgrade option: + + At most one of these can be specified: + + --enable-autoprovisioning-blue-green-upgrade + Whether to use blue-green upgrade for the autoprovisioned + node pool. + + --enable-autoprovisioning-surge-upgrade + Whether to use surge upgrade for the autoprovisioned node + pool. + Flags to specify identity for autoprovisioned nodes: --autoprovisioning-scopes=[SCOPE,...] diff --git a/gcloud/container/node-pools/complete-upgrade b/gcloud/container/node-pools/complete-upgrade new file mode 100644 index 000000000..466081919 --- /dev/null +++ b/gcloud/container/node-pools/complete-upgrade @@ -0,0 +1,53 @@ +NAME + gcloud container node-pools complete-upgrade - complete a node pool upgrade + +SYNOPSIS + gcloud container node-pools complete-upgrade NAME [--cluster=CLUSTER] + [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Complete a node pool upgrade. + + Complete upgrade is a method used to skip the remaining node pool soaking + phase during blue-green node pool upgrades. + +EXAMPLES + To complete an active upgrade in node-pool-1 in the cluster sample-cluster, + run: + + $ gcloud container node-pools complete-upgrade node-pool-1 \ + --cluster=sample-cluster + +POSITIONAL ARGUMENTS + NAME + Name of the node pool for which the upgrade is to be completed. + +FLAGS + --cluster=CLUSTER + Cluster to which the node pool belongs. Overrides the default + container/cluster property value for this command invocation. + + At most one of these can be specified: + + --region=REGION + Compute region (e.g. us-central1) for the cluster. + + --zone=ZONE, -z ZONE + Compute zone (e.g. us-central1-a) for the cluster. Overrides the + default compute/zone property value for this command invocation. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container node-pools complete-upgrade + + $ gcloud beta container node-pools complete-upgrade + diff --git a/gcloud/container/node-pools/create b/gcloud/container/node-pools/create index 618231964..c6bcf1003 100644 --- a/gcloud/container/node-pools/create +++ b/gcloud/container/node-pools/create @@ -8,9 +8,10 @@ SYNOPSIS [--boot-disk-kms-key=BOOT_DISK_KMS_KEY] [--cluster=CLUSTER] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autoprovisioning] [--enable-autorepair] - [--no-enable-autoupgrade] [--enable-confidential-nodes] - [--enable-gvnic] [--enable-image-streaming] [--image-type=IMAGE_TYPE] - [--local-ssd-count=LOCAL_SSD_COUNT] + [--no-enable-autoupgrade] [--enable-blue-green-upgrade] + [--enable-confidential-nodes] [--enable-gvnic] + [--enable-image-streaming] [--enable-surge-upgrade] + [--image-type=IMAGE_TYPE] [--local-ssd-count=LOCAL_SSD_COUNT] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] [--max-surge-upgrade=MAX_SURGE_UPGRADE; default=1] @@ -20,10 +21,15 @@ SYNOPSIS [--min-cpu-platform=PLATFORM] [--network-performance-configs=[PROPERTY=VALUE,...]] [--node-group=NODE_GROUP] [--node-labels=[NODE_LABEL,...]] - [--node-locations=ZONE,[ZONE,...]] [--node-taints=[NODE_TAINT,...]] - [--node-version=NODE_VERSION] [--num-nodes=NUM_NODES; default=3] - [--preemptible] [--sandbox=[type=TYPE]] - [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] + [--node-locations=ZONE,[ZONE,...]] + [--node-pool-soak-duration=NODE_POOL_SOAK_DURATION] + [--node-taints=[NODE_TAINT,...]] [--node-version=NODE_VERSION] + [--num-nodes=NUM_NODES; default=3] [--preemptible] + [--sandbox=[type=TYPE]] [--shielded-integrity-monitoring] + [--shielded-secure-boot] [--spot] + [--standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...]] [--system-config-from-file=SYSTEM_CONFIG_FROM_FILE] [--tags=TAG,[TAG,...]] [--threads-per-core=THREADS_PER_CORE] [--workload-metadata=WORKLOAD_METADATA] @@ -125,6 +131,9 @@ FLAGS Enabled by default, use --no-enable-autoupgrade to disable. + --enable-blue-green-upgrade + Changes node pool upgrade strategy to blue-green upgrade. + --enable-confidential-nodes Enable confidential nodes for the node pool. Enabling Confidential Nodes will create nodes using Confidential VM @@ -137,6 +146,9 @@ FLAGS --enable-image-streaming Specifies whether to enable image streaming on node pool. + --enable-surge-upgrade + Changes node pool upgrade strategy to surge upgrade. + --image-type=IMAGE_TYPE The image type to use for the node pool. Defaults to server-specified. @@ -327,6 +339,13 @@ FLAGS --cluster=sample-cluster \ --node-locations=us-central1-a,us-central1-b + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade before + deleting the blue pool and completing the upgrade. + + $ gcloud container node-pools create example-cluster \ + --node-pool-soak-duration=600s + --node-taints=[NODE_TAINT,...] Applies the given kubernetes taints on all nodes in the new node pool, which can be used with tolerations for pod scheduling. @@ -390,6 +409,20 @@ FLAGS New nodes, including ones created by resize or recreate, will use spot VM instances. + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. + + Batch sizes are specfied by one of, batch-node-count or batch-percent. + The duration between batches is specified by batch-soak-duration. + + $ gcloud container node-pools create example-cluster \ + --standard-rollout-policy=batch-node-count=3,\ + batch-soak-duration=60s + + $ gcloud container node-pools create example-cluster \ + --standard-rollout-policy=batch-percent=0.3,\ + batch-soak-duration=60s + --system-config-from-file=SYSTEM_CONFIG_FROM_FILE Path of the YAML/JSON file that contains the node configuration, including Linux kernel parameters (sysctls) and kubelet configs. diff --git a/gcloud/container/node-pools/help b/gcloud/container/node-pools/help index 86195e34f..77c9adb45 100644 --- a/gcloud/container/node-pools/help +++ b/gcloud/container/node-pools/help @@ -27,6 +27,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + complete-upgrade + Complete a node pool upgrade. + create Create a node pool in a running cluster. diff --git a/gcloud/container/node-pools/rollback b/gcloud/container/node-pools/rollback index de3ba6282..8b7d12cd9 100644 --- a/gcloud/container/node-pools/rollback +++ b/gcloud/container/node-pools/rollback @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud container node-pools rollback NAME [--async] [--cluster=CLUSTER] - [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] + [--respect-pdb=RESPECT_PDB] [--region=REGION | --zone=ZONE, -z ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Rollback a node-pool upgrade. @@ -31,6 +32,10 @@ FLAGS The cluster from which to rollback the node pool. Overrides the default container/cluster property value for this command invocation. + --respect-pdb=RESPECT_PDB + Indicates whether node pool rollbacks should respect pod disruption + budgets. + At most one of these can be specified: --region=REGION diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index 01b86a59d..30780e981 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -14,17 +14,21 @@ SYNOPSIS | --enable-autoprovisioning --enable-autoscaling --max-nodes=MAX_NODES --min-nodes=MIN_NODES | --enable-autorepair --enable-autoupgrade - | --max-surge-upgrade=MAX_SURGE_UPGRADE - --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE) - [--cluster=CLUSTER] [--region=REGION | --zone=ZONE, -z ZONE] - [GCLOUD_WIDE_FLAG ...] + | --enable-blue-green-upgrade --enable-surge-upgrade + --max-surge-upgrade=MAX_SURGE_UPGRADE + --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...]) [--cluster=CLUSTER] + [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud container node-pools update updates a node pool in a Google Kubernetes Engine cluster. EXAMPLES - To turn on node auto repair in "node-pool-1" in the cluster + To turn on node autoupgrade in "node-pool-1" in the cluster "sample-cluster", run: $ gcloud container node-pools update node-pool-1 \ @@ -236,6 +240,12 @@ REQUIRED FLAGS Upgrade settings + --enable-blue-green-upgrade + Changes node pool upgrade strategy to blue-green upgrade. + + --enable-surge-upgrade + Changes node pool upgrade strategy to surge upgrade. + --max-surge-upgrade=MAX_SURGE_UPGRADE Number of extra (surge) nodes to be created on each upgrade of the node pool. @@ -268,6 +278,30 @@ REQUIRED FLAGS Must be used in conjunction with '--max-surge-upgrade'. + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the upgrade. + + $ gcloud container node-pools update node-pool-1 \ + --cluster=example-cluster --node-pool-soak-duration=600s + + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. + + Batch sizes are specfied by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + $ gcloud container node-pools update node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-node-count=3,\ + batch-soak-duration=60s + + $ gcloud container node-pools update node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-percent=0.3,\ + batch-soak-duration=60s + OPTIONAL FLAGS --cluster=CLUSTER The name of the cluster. Overrides the default container/cluster diff --git a/gcloud/container/operations/cancel b/gcloud/container/operations/cancel new file mode 100644 index 000000000..6af3d4dae --- /dev/null +++ b/gcloud/container/operations/cancel @@ -0,0 +1,52 @@ +NAME + gcloud container operations cancel - cancel a running operation + +SYNOPSIS + gcloud container operations cancel OPERATION_ID + [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Cancel a running operation. + + Cancel is a best-effort method for aborting a running operation. Operations + that have already completed can not be cancelled. If the operation has + passed the "point of no-return", cancel will have no effect. + + An example of "point of no-return" in the context of Upgrade operations + would be if all the nodes have been upgraded but the operation hasn't been + marked as complete. + +EXAMPLES + To cancel an operation, run: + + $ gcloud container operations cancel sample-operation-id + +POSITIONAL ARGUMENTS + OPERATION_ID + The operation id to cancel. + +FLAGS + At most one of these can be specified: + + --region=REGION + Compute region (e.g. us-central1) for the cluster. + + --zone=ZONE, -z ZONE + Compute zone (e.g. us-central1-a) for the cluster. Overrides the + default compute/zone property value for this command invocation. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container operations cancel + + $ gcloud beta container operations cancel + diff --git a/gcloud/container/operations/help b/gcloud/container/operations/help index 9bec0ecba..a2efa5c28 100644 --- a/gcloud/container/operations/help +++ b/gcloud/container/operations/help @@ -27,6 +27,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + cancel + Cancel a running operation. + describe Describe an operation. diff --git a/gcloud/deploy/releases/abandon b/gcloud/deploy/releases/abandon new file mode 100644 index 000000000..0af14eac0 --- /dev/null +++ b/gcloud/deploy/releases/abandon @@ -0,0 +1,74 @@ +NAME + gcloud deploy releases abandon - abandons a release + +SYNOPSIS + gcloud deploy releases abandon + (RELEASE : --delivery-pipeline=DELIVERY_PIPELINE --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + After a release is abandoned, no new rollouts can be created from it. + + Rollouts of abandoned releases can't be rolled back to. + + Existing rollouts of abandoned releases will be unaffected. + +EXAMPLES + To abandon a release called test-release for delivery pipeline + test-pipeline in region us-central1, run: + + $ gcloud deploy releases abandon test-release \ + --delivery-pipeline=test-pipeline --region=us-central1 + +POSITIONAL ARGUMENTS + Release resource - The name of the Release. The arguments in this group + can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument release on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + RELEASE + ID of the release or fully qualified identifier for the release. To + set the release attribute: + ▸ provide the argument release on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --delivery-pipeline=DELIVERY_PIPELINE + The delivery pipeline associated with the release. Alternatively, set + the property [deploy/delivery-pipeline]. To set the delivery-pipeline + attribute: + ▸ provide the argument release on the command line with a fully + specified name; + ▸ provide the argument --delivery-pipeline on the command line; + ▸ set the property deploy/delivery_pipeline. + + --region=REGION + The Cloud region for the release. Alternatively, set the property + [deploy/region]. To set the region attribute: + ▸ provide the argument release on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + +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 help for details. + +NOTES + These variants are also available: + + $ gcloud alpha deploy releases abandon + + $ gcloud beta deploy releases abandon + diff --git a/gcloud/deploy/releases/help b/gcloud/deploy/releases/help index e408b1432..29f8fc21d 100644 --- a/gcloud/deploy/releases/help +++ b/gcloud/deploy/releases/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + abandon + Abandons a release. + create Creates a new release, delivery pipeline qualified. diff --git a/gcloud/eventarc/channels/create b/gcloud/eventarc/channels/create index 346c8ed09..4fabf7a43 100644 --- a/gcloud/eventarc/channels/create +++ b/gcloud/eventarc/channels/create @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud eventarc channels create (CHANNEL : --location=LOCATION) - --provider=PROVIDER [--async] [GCLOUD_WIDE_FLAG ...] + --provider=PROVIDER [--async] [--crypto-key=CRYPTO_KEY] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create an Eventarc channel. @@ -72,6 +73,11 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --crypto-key=CRYPTO_KEY + The fully qualified name of the crypto key to use for customer-managed + encryption. If this is unspecified, Google-managed keys will be used + for encryption. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/eventarc/channels/help b/gcloud/eventarc/channels/help index f351cb0a9..796bc724b 100644 --- a/gcloud/eventarc/channels/help +++ b/gcloud/eventarc/channels/help @@ -26,3 +26,6 @@ COMMANDS list List Eventarc channels. + + update + Updates an Eventarc channel. diff --git a/gcloud/eventarc/channels/update b/gcloud/eventarc/channels/update new file mode 100644 index 000000000..4ed2621b6 --- /dev/null +++ b/gcloud/eventarc/channels/update @@ -0,0 +1,75 @@ +NAME + gcloud eventarc channels update - updates an Eventarc channel + +SYNOPSIS + gcloud eventarc channels update (CHANNEL : --location=LOCATION) [--async] + [--clear-crypto-key | --crypto-key=CRYPTO_KEY] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Updates an Eventarc channel. + +EXAMPLES + To update the channel my-channel in location us-central1, run: + + $ gcloud eventarc channels update my-channel --location=us-central1 + + To configure the channel my-channel in location us-central1 with a Cloud + KMS CryptoKey, run: + + $ gcloud eventarc channels update my-channel \ + --location=us-central1 \ + --crypto-key=projects/PROJECT_ID/locations/KMS_LOCATION/\ + keyRings/KEYRING/cryptoKeys/KEY + +POSITIONAL ARGUMENTS + Channel resource - Channel to update. The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set + the project attribute: + ◆ provide the argument channel on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CHANNEL + ID of the channel or fully qualified identifier for the channel. To + set the channel attribute: + ▸ provide the argument channel on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location for the Eventarc channel, which should be either global + or one of the supported regions. Alternatively, set the + [eventarc/location] property. To set the location attribute: + ▸ provide the argument channel on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + At most one of these can be specified: + + --clear-crypto-key + Remove the previously configured crypto key. The channel will + continue to be encrypted using Google-managed keys. + + --crypto-key=CRYPTO_KEY + The fully qualified name of the crypto key to use for + customer-managed encryption. If this is unspecified, Google-managed + keys will be used for encryption. + +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 help for details. diff --git a/gcloud/eventarc/google-channels/describe b/gcloud/eventarc/google-channels/describe new file mode 100644 index 000000000..cf904379f --- /dev/null +++ b/gcloud/eventarc/google-channels/describe @@ -0,0 +1,39 @@ +NAME + gcloud eventarc google-channels describe - describes an Eventarc Google + channel + +SYNOPSIS + gcloud eventarc google-channels describe [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describes an Eventarc Google channel. + +EXAMPLES + To describe the google channel in location us-central1, run: + + $ gcloud eventarc google-channels describe --location=us-central1 + +FLAGS + Location resource - The location of the Google Channel. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property eventarc/location with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + +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 help for details. diff --git a/gcloud/eventarc/google-channels/help b/gcloud/eventarc/google-channels/help new file mode 100644 index 000000000..1342bd787 --- /dev/null +++ b/gcloud/eventarc/google-channels/help @@ -0,0 +1,22 @@ +NAME + gcloud eventarc google-channels - manage Eventarc Google channels + +SYNOPSIS + gcloud eventarc google-channels COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Eventarc Google channels. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describes an Eventarc Google channel. + + update + Updates an Eventarc Google channel. diff --git a/gcloud/eventarc/google-channels/update b/gcloud/eventarc/google-channels/update new file mode 100644 index 000000000..23ad8afd2 --- /dev/null +++ b/gcloud/eventarc/google-channels/update @@ -0,0 +1,56 @@ +NAME + gcloud eventarc google-channels update - updates an Eventarc Google channel + +SYNOPSIS + gcloud eventarc google-channels update [--location=LOCATION] + [--clear-crypto-key | --crypto-key=CRYPTO_KEY] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Updates an Eventarc Google channel. + +EXAMPLES + To update the google channel in location us-central1, run: + + $ gcloud eventarc google-channels update --location=us-central1 + + To configure the google channel in location us-central1 with a Cloud KMS + CryptoKey, run: + + $ gcloud eventarc google-channels update --location=us-central1 \ + --crypto-key=projects/PROJECT_ID/locations/KMS_LOCATION/\ + keyRings/KEYRING/cryptoKeys/KEY + +FLAGS + Location resource - The location of the Google Channel. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property eventarc/location with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + + At most one of these can be specified: + + --clear-crypto-key + Remove the previously configured crypto key. The channel will + continue to be encrypted using Google-managed keys. + + --crypto-key=CRYPTO_KEY + The fully qualified name of the crypto key to use for + customer-managed encryption. If this is unspecified, Google-managed + keys will be used for encryption. + +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 help for details. diff --git a/gcloud/eventarc/help b/gcloud/eventarc/help index 1ef561c93..0f2909079 100644 --- a/gcloud/eventarc/help +++ b/gcloud/eventarc/help @@ -25,6 +25,9 @@ GROUPS channels Manage Eventarc channels. + google-channels + Manage Eventarc Google channels. + locations Explore locations available for Eventarc. diff --git a/gcloud/kms/import-jobs/create b/gcloud/kms/import-jobs/create index a849c4141..0c4a388a1 100644 --- a/gcloud/kms/import-jobs/create +++ b/gcloud/kms/import-jobs/create @@ -27,7 +27,9 @@ REQUIRED FLAGS The wrapping method to be used for incoming key material. For more information about choosing an import method, see https://cloud.google.com/kms/docs/key-wrapping. IMPORT_METHOD must be - one of: rsa-oaep-3072-sha1-aes-256, rsa-oaep-4096-sha1-aes-256. + one of: rsa-oaep-3072-sha1-aes-256, rsa-oaep-3072-sha256, + rsa-oaep-3072-sha256-aes-256, rsa-oaep-4096-sha1-aes-256, + rsa-oaep-4096-sha256, rsa-oaep-4096-sha256-aes-256. --protection-level=PROTECTION_LEVEL Protection level of the import job. PROTECTION_LEVEL must be one of: diff --git a/gcloud/metastore/services/create b/gcloud/metastore/services/create index 3d7d29b34..39a7f891d 100644 --- a/gcloud/metastore/services/create +++ b/gcloud/metastore/services/create @@ -5,9 +5,10 @@ SYNOPSIS gcloud metastore services create (SERVICE : --location=LOCATION) [--async] [--encryption-kms-key=ENCRYPTION_KMS_KEY] [--hive-metastore-version=HIVE_METASTORE_VERSION] - [--labels=[KEY=VALUE,...]] [--network=NETWORK; default="default"] - [--port=PORT; default=9083] + [--labels=[KEY=VALUE,...]] [--port=PORT; default=9083] [--release-channel=RELEASE_CHANNEL; default="stable"] [--tier=TIER] + [--consumer-subnetworks=[CONSUMER_SUBNETWORKS,...] | --network=NETWORK + | --network-config-from-file=NETWORK_CONFIG_FROM_FILE] [--hive-metastore-configs=KEY=VALUE | --hive-metastore-configs-from-file=HIVE_METASTORE_CONFIGS_FROM_FILE] [--kerberos-principal=KERBEROS_PRINCIPAL @@ -98,14 +99,6 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. - Network configuration for the metastore service. - - --network=NETWORK; default="default" - The name of the network on which the service can be accessed. This - can be the network's ID, fully-qualified URL, or relative name in the - form projects/{project_id}/global/networks/{network}. If unspecified, - the "default" network will be used. - --port=PORT; default=9083 The TCP port on which the Metastore service will listen. If unspecified, the default port 9083 will be used. @@ -135,6 +128,35 @@ FLAGS sufficient scalability for enterprise-level Dataproc Metastore workloads. + Network configuration for the metastore service. + + At most one of these can be specified: + + --consumer-subnetworks=[CONSUMER_SUBNETWORKS,...] + The list of subnetworks from which the service can be accessed. This + can be the subnetwork's ID, fully-qualified URL, or relative name in + the form + projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork}. + + --network=NETWORK + The name of the network on which the service can be accessed. This + can be the network's ID, fully-qualified URL, or relative name in the + form projects/{project_id}/global/networks/{network}. If "network", + "consumer-subnetworks" and "network-config" are unspecified, the + "default" network will be used. + + --network-config-from-file=NETWORK_CONFIG_FROM_FILE + Path to a YAML file containing the network configuration for Dataproc + Metastore instance. The contents of the file should be structured as + follows: + + YAML: consumers: + ▸ subnetwork: + projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id} + ▸ subnetwork: + projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id} + ... + Configuration properties specific to running Hive metastore software as the metastore service. diff --git a/gcloud/network-connectivity/spokes/delete b/gcloud/network-connectivity/spokes/delete index 2d232c531..3c8c78c34 100644 --- a/gcloud/network-connectivity/spokes/delete +++ b/gcloud/network-connectivity/spokes/delete @@ -24,6 +24,7 @@ POSITIONAL ARGUMENTS ◆ set the property core/project. To set the location attribute: ◆ provide the argument spoke on the command line with a fully specified name; + ◆ provide the argument --global on the command line; ◆ provide the argument --region on the command line. This must be specified. diff --git a/gcloud/network-connectivity/spokes/describe b/gcloud/network-connectivity/spokes/describe index b6576a20c..89a9d02b1 100644 --- a/gcloud/network-connectivity/spokes/describe +++ b/gcloud/network-connectivity/spokes/describe @@ -25,6 +25,7 @@ POSITIONAL ARGUMENTS ◆ set the property core/project. To set the location attribute: ◆ provide the argument spoke on the command line with a fully specified name; + ◆ provide the argument --global on the command line; ◆ provide the argument --region on the command line. This must be specified. diff --git a/gcloud/privateca/certificates/create b/gcloud/privateca/certificates/create index 59cb6efe5..8f9dff3c3 100644 --- a/gcloud/privateca/certificates/create +++ b/gcloud/privateca/certificates/create @@ -15,8 +15,8 @@ SYNOPSIS --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]) : --use-preset-profile=USE_PRESET_PROFILE | --extended-key-usages=[EXTENDED_KEY_USAGES,...] --is-ca-cert - --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH]) - [--ca=CA] [--labels=[KEY=VALUE,...]] + --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH + | --unconstrained-chain-length]) [--ca=CA] [--labels=[KEY=VALUE,...]] [--validity=VALIDITY; default="P30D"] [--template=TEMPLATE : --template-location=TEMPLATE_LOCATION] [GCLOUD_WIDE_FLAG ...] @@ -223,10 +223,19 @@ REQUIRED FLAGS key_encipherment, data_encipherment, key_agreement, cert_sign, crl_sign, encipher_only, decipher_only. - --max-chain-length=MAX_CHAIN_LENGTH - Maximum depth of subordinate CAs allowed under this CA for a CA - certificate. This can only be provided if --use-preset-profile is - not provided. + At most one of these can be specified: + + --max-chain-length=MAX_CHAIN_LENGTH + Maximum depth of subordinate CAs allowed under this CA for a CA + certificate. This can only be provided if neither + --use-preset-profile nor --unconstrained-chain-length are + provided. + + --unconstrained-chain-length + If set, allows an unbounded number of subordinate CAs under + this newly issued CA certificate. This can only be provided if + neither --use-preset-profile nor --max-chain-length are + provided. OPTIONAL FLAGS --ca=CA diff --git a/gcloud/privateca/roots/create b/gcloud/privateca/roots/create index f89c130c3..fbd815593 100644 --- a/gcloud/privateca/roots/create +++ b/gcloud/privateca/roots/create @@ -15,8 +15,8 @@ SYNOPSIS --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]] [--use-preset-profile=USE_PRESET_PROFILE | --extended-key-usages=[EXTENDED_KEY_USAGES,...] - --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH] - [GCLOUD_WIDE_FLAG ...] + --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH + | --unconstrained-chain-length] [GCLOUD_WIDE_FLAG ...] EXAMPLES To create a root CA that supports one layer of subordinates: @@ -213,10 +213,17 @@ FLAGS data_encipherment, key_agreement, cert_sign, crl_sign, encipher_only, decipher_only. - --max-chain-length=MAX_CHAIN_LENGTH - Maximum depth of subordinate CAs allowed under this CA for a CA - certificate. This can only be provided if --use-preset-profile is not - provided. + At most one of these can be specified: + + --max-chain-length=MAX_CHAIN_LENGTH + Maximum depth of subordinate CAs allowed under this CA for a CA + certificate. This can only be provided if neither + --use-preset-profile nor --unconstrained-chain-length are provided. + + --unconstrained-chain-length + If set, allows an unbounded number of subordinate CAs under this + newly issued CA certificate. This can only be provided if neither + --use-preset-profile nor --max-chain-length are provided. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/privateca/subordinates/create b/gcloud/privateca/subordinates/create index 63a373102..7df5afc71 100644 --- a/gcloud/privateca/subordinates/create +++ b/gcloud/privateca/subordinates/create @@ -18,8 +18,8 @@ SYNOPSIS --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]] [--use-preset-profile=USE_PRESET_PROFILE | --extended-key-usages=[EXTENDED_KEY_USAGES,...] - --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH] - [GCLOUD_WIDE_FLAG ...] + --key-usages=[KEY_USAGES,...] --max-chain-length=MAX_CHAIN_LENGTH + | --unconstrained-chain-length] [GCLOUD_WIDE_FLAG ...] EXAMPLES To create a subordinate CA named 'server-tls-1' whose issuer is on Private @@ -282,10 +282,17 @@ OPTIONAL FLAGS data_encipherment, key_agreement, cert_sign, crl_sign, encipher_only, decipher_only. - --max-chain-length=MAX_CHAIN_LENGTH - Maximum depth of subordinate CAs allowed under this CA for a CA - certificate. This can only be provided if --use-preset-profile is not - provided. + At most one of these can be specified: + + --max-chain-length=MAX_CHAIN_LENGTH + Maximum depth of subordinate CAs allowed under this CA for a CA + certificate. This can only be provided if neither + --use-preset-profile nor --unconstrained-chain-length are provided. + + --unconstrained-chain-length + If set, allows an unbounded number of subordinate CAs under this + newly issued CA certificate. This can only be provided if neither + --use-preset-profile nor --max-chain-length are provided. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/privateca/templates/create b/gcloud/privateca/templates/create index d512340a3..c673563e8 100644 --- a/gcloud/privateca/templates/create +++ b/gcloud/privateca/templates/create @@ -91,7 +91,7 @@ REQUIRED FLAGS --copy-subject If this is specified, the Subject from the certificate request will be copied into the signed certificate. Specify --no-copy-subject to drop - any caller-specifed subjects from the certificate request. + any caller-specified subjects from the certificate request. OPTIONAL FLAGS --description=DESCRIPTION diff --git a/gcloud/privateca/templates/update b/gcloud/privateca/templates/update index 81e15a28b..c2f8e41ac 100644 --- a/gcloud/privateca/templates/update +++ b/gcloud/privateca/templates/update @@ -83,7 +83,7 @@ FLAGS --copy-subject If this is specified, the Subject from the certificate request will be copied into the signed certificate. Specify --no-copy-subject to drop - any caller-specifed subjects from the certificate request. + any caller-specified subjects from the certificate request. --description=DESCRIPTION A text description for the Certificate Template. diff --git a/gcloud/pubsub/subscriptions/ack b/gcloud/pubsub/subscriptions/ack index 460faa5c3..d36b159d7 100644 --- a/gcloud/pubsub/subscriptions/ack +++ b/gcloud/pubsub/subscriptions/ack @@ -33,7 +33,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --ack-ids=[ACK_ID,...] - One or more ACK_ID to acknowledge. An ACK_ID is a string that is + One or more ACK_IDs to acknowledge. An ACK_ID is a string that is returned to subscribers (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). along with the message. The ACK_ID is different from the message ID diff --git a/gcloud/pubsub/subscriptions/modify-message-ack-deadline b/gcloud/pubsub/subscriptions/modify-message-ack-deadline index cee70e9ee..11d3abda5 100644 --- a/gcloud/pubsub/subscriptions/modify-message-ack-deadline +++ b/gcloud/pubsub/subscriptions/modify-message-ack-deadline @@ -35,7 +35,7 @@ REQUIRED FLAGS acknowledge receiving a message before re-attempting delivery. --ack-ids=[ACK_ID,...] - One or more ACK_ID to modify the deadline for. An ACK_ID is a string + One or more ACK_IDs to modify the deadline for. An ACK_ID is a string that is returned to subscribers (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#google.pubsub.v1.ReceivedMessage). along with the message. The ACK_ID is different from the message ID