From 6c60d7f07fd128577b39820f8d2b559be9704da9 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 27 Sep 2023 12:05:40 +0000 Subject: [PATCH] gcloud: Wed Sep 27 12:05:40 UTC 2023 --- gcloud/_version | 8 +- gcloud/alpha/compute/help | 3 + .../compute/instance-groups/managed/create | 4 +- .../compute/instance-groups/managed/update | 4 +- .../alpha/compute/project-zonal-metadata/add | 53 ++ .../compute/project-zonal-metadata/describe | 36 ++ .../alpha/compute/project-zonal-metadata/help | 33 ++ .../compute/project-zonal-metadata/remove | 60 ++ .../compute/security-policies/rules/create | 2 +- .../compute/security-policies/rules/update | 2 +- gcloud/alpha/compute/start-iap-tunnel | 8 +- .../bare-metal/admin-clusters/create | 4 +- .../bare-metal/admin-clusters/describe | 4 +- .../bare-metal/admin-clusters/enroll | 4 +- .../container/bare-metal/admin-clusters/help | 4 +- .../container/bare-metal/admin-clusters/list | 4 +- .../admin-clusters/query-version-config | 4 +- .../bare-metal/admin-clusters/unenroll | 4 +- .../bare-metal/admin-clusters/update | 4 +- .../container/bare-metal/clusters/create | 4 +- .../container/bare-metal/clusters/delete | 4 +- .../container/bare-metal/clusters/describe | 4 +- .../container/bare-metal/clusters/enroll | 4 +- .../alpha/container/bare-metal/clusters/help | 4 +- .../alpha/container/bare-metal/clusters/list | 4 +- .../bare-metal/clusters/query-version-config | 4 +- .../container/bare-metal/clusters/update | 4 +- gcloud/alpha/container/bare-metal/help | 4 +- .../container/bare-metal/node-pools/create | 4 +- .../container/bare-metal/node-pools/delete | 4 +- .../container/bare-metal/node-pools/describe | 4 +- .../container/bare-metal/node-pools/enroll | 4 +- .../container/bare-metal/node-pools/help | 4 +- .../container/bare-metal/node-pools/list | 4 +- .../container/bare-metal/node-pools/update | 4 +- .../container/bare-metal/operations/describe | 4 +- .../container/bare-metal/operations/help | 4 +- .../container/bare-metal/operations/list | 4 +- .../container/bare-metal/operations/wait | 4 +- gcloud/alpha/container/clusters/create | 8 +- gcloud/alpha/container/node-pools/create | 8 +- .../container/vmware/admin-clusters/describe | 4 +- .../container/vmware/admin-clusters/enroll | 4 +- .../container/vmware/admin-clusters/help | 4 +- .../container/vmware/admin-clusters/list | 4 +- .../container/vmware/admin-clusters/unenroll | 4 +- .../container/vmware/admin-clusters/update | 4 +- gcloud/alpha/container/vmware/clusters/create | 4 +- gcloud/alpha/container/vmware/clusters/delete | 4 +- .../alpha/container/vmware/clusters/describe | 4 +- gcloud/alpha/container/vmware/clusters/enroll | 4 +- gcloud/alpha/container/vmware/clusters/help | 4 +- gcloud/alpha/container/vmware/clusters/list | 4 +- .../vmware/clusters/query-version-config | 4 +- gcloud/alpha/container/vmware/clusters/update | 4 +- .../alpha/container/vmware/clusters/upgrade | 4 +- gcloud/alpha/container/vmware/help | 4 +- .../alpha/container/vmware/node-pools/create | 4 +- .../alpha/container/vmware/node-pools/delete | 4 +- .../container/vmware/node-pools/describe | 4 +- .../alpha/container/vmware/node-pools/enroll | 4 +- gcloud/alpha/container/vmware/node-pools/help | 4 +- gcloud/alpha/container/vmware/node-pools/list | 4 +- .../alpha/container/vmware/node-pools/update | 4 +- .../container/vmware/operations/describe | 4 +- gcloud/alpha/container/vmware/operations/help | 4 +- gcloud/alpha/container/vmware/operations/list | 4 +- gcloud/alpha/container/vmware/operations/wait | 4 +- .../edge-cloud/container/clusters/create | 9 + gcloud/alpha/healthcare/hl7v2-stores/create | 29 +- gcloud/alpha/iam/policies/lint-condition | 3 +- gcloud/alpha/infra-manager/deployments/apply | 28 +- gcloud/alpha/infra-manager/deployments/delete | 8 +- .../alpha/infra-manager/deployments/describe | 8 +- .../infra-manager/deployments/export-lock | 4 +- .../deployments/export-statefile | 4 +- gcloud/alpha/infra-manager/deployments/help | 4 +- .../deployments/import-statefile | 4 +- gcloud/alpha/infra-manager/deployments/list | 8 +- gcloud/alpha/infra-manager/deployments/lock | 4 +- gcloud/alpha/infra-manager/deployments/unlock | 4 +- gcloud/alpha/infra-manager/help | 4 +- gcloud/alpha/infra-manager/resources/describe | 8 +- gcloud/alpha/infra-manager/resources/help | 4 +- gcloud/alpha/infra-manager/resources/list | 8 +- gcloud/alpha/infra-manager/revisions/describe | 8 +- .../infra-manager/revisions/export-statefile | 4 +- gcloud/alpha/infra-manager/revisions/help | 4 +- gcloud/alpha/infra-manager/revisions/list | 8 +- gcloud/alpha/netapp/volumes/create | 23 +- gcloud/alpha/netapp/volumes/update | 23 +- .../firewall-endpoints/create | 7 +- .../firewall-endpoints/update | 6 +- gcloud/alpha/run/deploy | 9 +- gcloud/alpha/run/services/update | 10 +- gcloud/alpha/sql/instances/create | 12 +- gcloud/alpha/sql/instances/patch | 14 +- gcloud/alpha/workstations/configs/create | 12 +- .../compute/security-policies/rules/create | 2 +- .../compute/security-policies/rules/update | 2 +- .../bare-metal/admin-clusters/create | 6 +- .../bare-metal/admin-clusters/describe | 6 +- .../bare-metal/admin-clusters/enroll | 6 +- .../container/bare-metal/admin-clusters/help | 6 +- .../container/bare-metal/admin-clusters/list | 6 +- .../admin-clusters/query-version-config | 6 +- .../bare-metal/admin-clusters/unenroll | 6 +- .../bare-metal/admin-clusters/update | 6 +- .../beta/container/bare-metal/clusters/create | 6 +- .../beta/container/bare-metal/clusters/delete | 6 +- .../container/bare-metal/clusters/describe | 6 +- .../beta/container/bare-metal/clusters/enroll | 6 +- .../beta/container/bare-metal/clusters/help | 6 +- .../beta/container/bare-metal/clusters/list | 6 +- .../bare-metal/clusters/query-version-config | 6 +- .../beta/container/bare-metal/clusters/update | 6 +- gcloud/beta/container/bare-metal/help | 6 +- .../container/bare-metal/node-pools/create | 6 +- .../container/bare-metal/node-pools/delete | 6 +- .../container/bare-metal/node-pools/describe | 6 +- .../container/bare-metal/node-pools/enroll | 6 +- .../beta/container/bare-metal/node-pools/help | 6 +- .../beta/container/bare-metal/node-pools/list | 6 +- .../container/bare-metal/node-pools/update | 6 +- .../container/bare-metal/operations/describe | 6 +- .../beta/container/bare-metal/operations/help | 6 +- .../beta/container/bare-metal/operations/list | 6 +- .../beta/container/bare-metal/operations/wait | 6 +- gcloud/beta/container/clusters/create | 8 +- gcloud/beta/container/node-pools/create | 8 +- .../container/vmware/admin-clusters/describe | 6 +- .../container/vmware/admin-clusters/enroll | 6 +- .../beta/container/vmware/admin-clusters/help | 6 +- .../beta/container/vmware/admin-clusters/list | 6 +- .../container/vmware/admin-clusters/unenroll | 6 +- .../container/vmware/admin-clusters/update | 6 +- gcloud/beta/container/vmware/clusters/create | 6 +- gcloud/beta/container/vmware/clusters/delete | 6 +- .../beta/container/vmware/clusters/describe | 6 +- gcloud/beta/container/vmware/clusters/enroll | 6 +- gcloud/beta/container/vmware/clusters/help | 6 +- gcloud/beta/container/vmware/clusters/list | 6 +- .../vmware/clusters/query-version-config | 6 +- gcloud/beta/container/vmware/clusters/update | 6 +- gcloud/beta/container/vmware/clusters/upgrade | 6 +- gcloud/beta/container/vmware/help | 6 +- .../beta/container/vmware/node-pools/create | 6 +- .../beta/container/vmware/node-pools/delete | 6 +- .../beta/container/vmware/node-pools/describe | 6 +- .../beta/container/vmware/node-pools/enroll | 6 +- gcloud/beta/container/vmware/node-pools/help | 6 +- gcloud/beta/container/vmware/node-pools/list | 6 +- .../beta/container/vmware/node-pools/update | 6 +- .../beta/container/vmware/operations/describe | 6 +- gcloud/beta/container/vmware/operations/help | 6 +- gcloud/beta/container/vmware/operations/list | 6 +- gcloud/beta/container/vmware/operations/wait | 6 +- gcloud/beta/dataproc/sessions/create/help | 6 +- gcloud/beta/dataproc/sessions/create/spark | 6 +- gcloud/beta/healthcare/hl7v2-stores/create | 29 +- gcloud/beta/netapp/volumes/create | 23 +- gcloud/beta/netapp/volumes/update | 23 +- .../firewall-endpoints/create | 7 +- .../firewall-endpoints/update | 6 +- gcloud/beta/sql/instances/create | 12 +- gcloud/beta/sql/instances/patch | 14 +- gcloud/beta/workstations/configs/create | 12 +- gcloud/compute/security-policies/rules/create | 2 +- gcloud/compute/security-policies/rules/update | 2 +- .../bare-metal/admin-clusters/create | 262 +++++++++ .../bare-metal/admin-clusters/describe | 66 +++ .../bare-metal/admin-clusters/enroll | 113 ++++ .../container/bare-metal/admin-clusters/help | 48 ++ .../container/bare-metal/admin-clusters/list | 84 +++ .../admin-clusters/query-version-config | 90 +++ .../bare-metal/admin-clusters/unenroll | 86 +++ .../bare-metal/admin-clusters/update | 157 ++++++ gcloud/container/bare-metal/clusters/create | 518 ++++++++++++++++++ gcloud/container/bare-metal/clusters/delete | 85 +++ gcloud/container/bare-metal/clusters/describe | 63 +++ gcloud/container/bare-metal/clusters/enroll | 124 +++++ gcloud/container/bare-metal/clusters/help | 47 ++ gcloud/container/bare-metal/clusters/list | 84 +++ .../bare-metal/clusters/query-version-config | 152 +++++ gcloud/container/bare-metal/clusters/update | 360 ++++++++++++ gcloud/container/bare-metal/help | 37 ++ gcloud/container/bare-metal/node-pools/create | 123 +++++ gcloud/container/bare-metal/node-pools/delete | 90 +++ .../container/bare-metal/node-pools/describe | 73 +++ gcloud/container/bare-metal/node-pools/enroll | 82 +++ gcloud/container/bare-metal/node-pools/help | 43 ++ gcloud/container/bare-metal/node-pools/list | 98 ++++ gcloud/container/bare-metal/node-pools/update | 128 +++++ .../container/bare-metal/operations/describe | 63 +++ gcloud/container/bare-metal/operations/help | 34 ++ gcloud/container/bare-metal/operations/list | 83 +++ gcloud/container/bare-metal/operations/wait | 64 +++ gcloud/container/clusters/create | 8 +- gcloud/container/help | 6 + gcloud/container/node-pools/create | 8 +- .../container/vmware/admin-clusters/describe | 66 +++ gcloud/container/vmware/admin-clusters/enroll | 113 ++++ gcloud/container/vmware/admin-clusters/help | 40 ++ gcloud/container/vmware/admin-clusters/list | 84 +++ .../container/vmware/admin-clusters/unenroll | 80 +++ gcloud/container/vmware/admin-clusters/update | 78 +++ gcloud/container/vmware/clusters/create | 406 ++++++++++++++ gcloud/container/vmware/clusters/delete | 85 +++ gcloud/container/vmware/clusters/describe | 63 +++ gcloud/container/vmware/clusters/enroll | 138 +++++ gcloud/container/vmware/clusters/help | 50 ++ gcloud/container/vmware/clusters/list | 83 +++ .../vmware/clusters/query-version-config | 137 +++++ gcloud/container/vmware/clusters/update | 216 ++++++++ gcloud/container/vmware/clusters/upgrade | 68 +++ gcloud/container/vmware/help | 37 ++ gcloud/container/vmware/node-pools/create | 154 ++++++ gcloud/container/vmware/node-pools/delete | 90 +++ gcloud/container/vmware/node-pools/describe | 73 +++ gcloud/container/vmware/node-pools/enroll | 78 +++ gcloud/container/vmware/node-pools/help | 43 ++ gcloud/container/vmware/node-pools/list | 98 ++++ gcloud/container/vmware/node-pools/update | 144 +++++ gcloud/container/vmware/operations/describe | 63 +++ gcloud/container/vmware/operations/help | 34 ++ gcloud/container/vmware/operations/list | 83 +++ gcloud/container/vmware/operations/wait | 63 +++ gcloud/edge-cloud/container/clusters/create | 9 + gcloud/eventarc/triggers/create | 16 + gcloud/healthcare/hl7v2-stores/create | 28 +- gcloud/healthcare/hl7v2-stores/help | 2 +- gcloud/healthcare/hl7v2-stores/update | 6 +- gcloud/infra-manager/deployments/apply | 246 +++++++++ gcloud/infra-manager/deployments/delete | 77 +++ gcloud/infra-manager/deployments/describe | 66 +++ gcloud/infra-manager/deployments/export-lock | 64 +++ .../deployments/export-statefile | 68 +++ gcloud/infra-manager/deployments/help | 49 ++ .../deployments/import-statefile | 69 +++ gcloud/infra-manager/deployments/list | 84 +++ gcloud/infra-manager/deployments/lock | 67 +++ gcloud/infra-manager/deployments/unlock | 73 +++ gcloud/infra-manager/help | 31 ++ gcloud/infra-manager/resources/describe | 85 +++ gcloud/infra-manager/resources/help | 29 + gcloud/infra-manager/resources/list | 107 ++++ gcloud/infra-manager/revisions/describe | 75 +++ .../infra-manager/revisions/export-statefile | 72 +++ gcloud/infra-manager/revisions/help | 31 ++ gcloud/infra-manager/revisions/list | 100 ++++ gcloud/netapp/volumes/create | 23 +- gcloud/netapp/volumes/update | 23 +- gcloud/sql/instances/create | 12 +- gcloud/sql/instances/patch | 14 +- gcloud/vmware/private-clouds/clusters/update | 49 +- gcloud/workstations/configs/create | 12 +- 256 files changed, 8313 insertions(+), 442 deletions(-) create mode 100644 gcloud/alpha/compute/project-zonal-metadata/add create mode 100644 gcloud/alpha/compute/project-zonal-metadata/describe create mode 100644 gcloud/alpha/compute/project-zonal-metadata/help create mode 100644 gcloud/alpha/compute/project-zonal-metadata/remove create mode 100644 gcloud/container/bare-metal/admin-clusters/create create mode 100644 gcloud/container/bare-metal/admin-clusters/describe create mode 100644 gcloud/container/bare-metal/admin-clusters/enroll create mode 100644 gcloud/container/bare-metal/admin-clusters/help create mode 100644 gcloud/container/bare-metal/admin-clusters/list create mode 100644 gcloud/container/bare-metal/admin-clusters/query-version-config create mode 100644 gcloud/container/bare-metal/admin-clusters/unenroll create mode 100644 gcloud/container/bare-metal/admin-clusters/update create mode 100644 gcloud/container/bare-metal/clusters/create create mode 100644 gcloud/container/bare-metal/clusters/delete create mode 100644 gcloud/container/bare-metal/clusters/describe create mode 100644 gcloud/container/bare-metal/clusters/enroll create mode 100644 gcloud/container/bare-metal/clusters/help create mode 100644 gcloud/container/bare-metal/clusters/list create mode 100644 gcloud/container/bare-metal/clusters/query-version-config create mode 100644 gcloud/container/bare-metal/clusters/update create mode 100644 gcloud/container/bare-metal/help create mode 100644 gcloud/container/bare-metal/node-pools/create create mode 100644 gcloud/container/bare-metal/node-pools/delete create mode 100644 gcloud/container/bare-metal/node-pools/describe create mode 100644 gcloud/container/bare-metal/node-pools/enroll create mode 100644 gcloud/container/bare-metal/node-pools/help create mode 100644 gcloud/container/bare-metal/node-pools/list create mode 100644 gcloud/container/bare-metal/node-pools/update create mode 100644 gcloud/container/bare-metal/operations/describe create mode 100644 gcloud/container/bare-metal/operations/help create mode 100644 gcloud/container/bare-metal/operations/list create mode 100644 gcloud/container/bare-metal/operations/wait create mode 100644 gcloud/container/vmware/admin-clusters/describe create mode 100644 gcloud/container/vmware/admin-clusters/enroll create mode 100644 gcloud/container/vmware/admin-clusters/help create mode 100644 gcloud/container/vmware/admin-clusters/list create mode 100644 gcloud/container/vmware/admin-clusters/unenroll create mode 100644 gcloud/container/vmware/admin-clusters/update create mode 100644 gcloud/container/vmware/clusters/create create mode 100644 gcloud/container/vmware/clusters/delete create mode 100644 gcloud/container/vmware/clusters/describe create mode 100644 gcloud/container/vmware/clusters/enroll create mode 100644 gcloud/container/vmware/clusters/help create mode 100644 gcloud/container/vmware/clusters/list create mode 100644 gcloud/container/vmware/clusters/query-version-config create mode 100644 gcloud/container/vmware/clusters/update create mode 100644 gcloud/container/vmware/clusters/upgrade create mode 100644 gcloud/container/vmware/help create mode 100644 gcloud/container/vmware/node-pools/create create mode 100644 gcloud/container/vmware/node-pools/delete create mode 100644 gcloud/container/vmware/node-pools/describe create mode 100644 gcloud/container/vmware/node-pools/enroll create mode 100644 gcloud/container/vmware/node-pools/help create mode 100644 gcloud/container/vmware/node-pools/list create mode 100644 gcloud/container/vmware/node-pools/update create mode 100644 gcloud/container/vmware/operations/describe create mode 100644 gcloud/container/vmware/operations/help create mode 100644 gcloud/container/vmware/operations/list create mode 100644 gcloud/container/vmware/operations/wait create mode 100644 gcloud/infra-manager/deployments/apply create mode 100644 gcloud/infra-manager/deployments/delete create mode 100644 gcloud/infra-manager/deployments/describe create mode 100644 gcloud/infra-manager/deployments/export-lock create mode 100644 gcloud/infra-manager/deployments/export-statefile create mode 100644 gcloud/infra-manager/deployments/help create mode 100644 gcloud/infra-manager/deployments/import-statefile create mode 100644 gcloud/infra-manager/deployments/list create mode 100644 gcloud/infra-manager/deployments/lock create mode 100644 gcloud/infra-manager/deployments/unlock create mode 100644 gcloud/infra-manager/help create mode 100644 gcloud/infra-manager/resources/describe create mode 100644 gcloud/infra-manager/resources/help create mode 100644 gcloud/infra-manager/resources/list create mode 100644 gcloud/infra-manager/revisions/describe create mode 100644 gcloud/infra-manager/revisions/export-statefile create mode 100644 gcloud/infra-manager/revisions/help create mode 100644 gcloud/infra-manager/revisions/list diff --git a/gcloud/_version b/gcloud/_version index aed174da8..6f7c526e2 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 447.0.0 -alpha 2023.09.15 -beta 2023.09.15 +Google Cloud SDK 448.0.0 +alpha 2023.09.22 +beta 2023.09.22 bq 2.0.98 bundled-python3-unix 3.9.16 -core 2023.09.15 +core 2023.09.22 gcloud-crc32c 1.0.0 gsutil 5.25 diff --git a/gcloud/alpha/compute/help b/gcloud/alpha/compute/help index a84fddd37..35fb4d422 100644 --- a/gcloud/alpha/compute/help +++ b/gcloud/alpha/compute/help @@ -133,6 +133,9 @@ GROUPS (ALPHA) Read and manipulate project-level data like quotas and metadata. + project-zonal-metadata + (ALPHA) Describe and update project zonal metadata. + public-advertised-prefixes (ALPHA) Manage public advertised prefix resources. diff --git a/gcloud/alpha/compute/instance-groups/managed/create b/gcloud/alpha/compute/instance-groups/managed/create index 2ea91f117..fa1008553 100644 --- a/gcloud/alpha/compute/instance-groups/managed/create +++ b/gcloud/alpha/compute/instance-groups/managed/create @@ -150,9 +150,9 @@ OPTIONAL FLAGS Defines behaviour of using instances from standby pool to resize MIG. STANDBY_POLICY_MODE must be one of: - MANUAL + manual MIG does not automatically stop/start or suspend/resume VMs. - SCALE_OUT_POOL + scale-out-pool MIG automatically resumes and starts VMs when it scales out, and replenishes the standby pool afterwards. diff --git a/gcloud/alpha/compute/instance-groups/managed/update b/gcloud/alpha/compute/instance-groups/managed/update index 7e14ce83b..f126c9ee7 100644 --- a/gcloud/alpha/compute/instance-groups/managed/update +++ b/gcloud/alpha/compute/instance-groups/managed/update @@ -140,9 +140,9 @@ FLAGS Defines behaviour of using instances from standby pool to resize MIG. STANDBY_POLICY_MODE must be one of: - MANUAL + manual MIG does not automatically stop/start or suspend/resume VMs. - SCALE_OUT_POOL + scale-out-pool MIG automatically resumes and starts VMs when it scales out, and replenishes the standby pool afterwards. diff --git a/gcloud/alpha/compute/project-zonal-metadata/add b/gcloud/alpha/compute/project-zonal-metadata/add new file mode 100644 index 000000000..7d1812d79 --- /dev/null +++ b/gcloud/alpha/compute/project-zonal-metadata/add @@ -0,0 +1,53 @@ +NAME + gcloud alpha compute project-zonal-metadata add - add or update project + zonal metadata + +SYNOPSIS + gcloud alpha compute project-zonal-metadata add + --metadata=KEY=VALUE,[KEY=VALUE,...] --zone=ZONE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute project-zonal-metadata add is used to add or + update project zonal metadata for your VM instances. Project zonal metadata + values propagate to all VMs within the specified zone. Every VM has access + to a metadata server that you can use to query the configured project zonal + metadata values. To set metadata for individual instances, use gcloud + compute instances add-metadata. For information about metadata, see + https://cloud.google.com/compute/docs/metadata. + + Only the metadata keys that you provide in the command get mutated. All + other existing metadata entries remain the same. + +EXAMPLES + To set the project zonal metadata with key=value in the zone us-central1-a + for the project my-gcp-project, run: + + $ gcloud alpha compute project-zonal-metadata add \ + --metadata=key=value --zone=us-central1-a \ + --project=my-gcp-project + + For more information and examples for setting project zonal metadata, see + https://cloud.google.com/compute/docs/metadata/setting-custom-metadata#set-custom-project-zonal-metadata + +REQUIRED FLAGS + --metadata=KEY=VALUE,[KEY=VALUE,...] + The project zonal metadata key-value pairs that you want to add or + update + + --zone=ZONE + The zone in which you want to add or update project zonal metadata + +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/compute/project-zonal-metadata/describe b/gcloud/alpha/compute/project-zonal-metadata/describe new file mode 100644 index 000000000..e19e38087 --- /dev/null +++ b/gcloud/alpha/compute/project-zonal-metadata/describe @@ -0,0 +1,36 @@ +NAME + gcloud alpha compute project-zonal-metadata describe - describe project + zonal metadata + +SYNOPSIS + gcloud alpha compute project-zonal-metadata describe --zone=ZONE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe project zonal metadata. + +EXAMPLES + To describe the project zonal metadata in the zone us-central1-a for the + project my-gcp-project, run: + + $ gcloud alpha compute project-zonal-metadata describe \ + --zone=us-central1-a --project=my-gcp-project + +REQUIRED FLAGS + --zone=ZONE + Zone for project zonal metadata + +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/compute/project-zonal-metadata/help b/gcloud/alpha/compute/project-zonal-metadata/help new file mode 100644 index 000000000..9d30923d8 --- /dev/null +++ b/gcloud/alpha/compute/project-zonal-metadata/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha compute project-zonal-metadata - describe and update project + zonal metadata + +SYNOPSIS + gcloud alpha compute project-zonal-metadata COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe and update Compute Engine project zonal metadata. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add + (ALPHA) Add or update project zonal metadata. + + describe + (ALPHA) Describe project zonal metadata. + + remove + (ALPHA) Remove project zonal metadata. + +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/compute/project-zonal-metadata/remove b/gcloud/alpha/compute/project-zonal-metadata/remove new file mode 100644 index 000000000..33be8d52b --- /dev/null +++ b/gcloud/alpha/compute/project-zonal-metadata/remove @@ -0,0 +1,60 @@ +NAME + gcloud alpha compute project-zonal-metadata remove - remove project zonal + metadata + +SYNOPSIS + gcloud alpha compute project-zonal-metadata remove --zone=ZONE + [--all | --keys=KEY,[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute project-zonal-metadata remove is used to + remove project zonal metadata from all VMs within the specified zone. For + information about metadata, see + https://cloud.google.com/compute/docs/metadata. + + Only the metadata keys that you provide in the command get removed. All + other existing metadata entries remain the same. + + After you remove a specific project zonal metadata entry, if that metadata + key has any project-wide value configured, then the VMs in the zone + automatically inherit that project-wide value. + +EXAMPLES + To remove the project zonal metadata with key=value in the zone + us-central1-a for the project my-gcp-project, run: + + $ gcloud alpha compute project-zonal-metadata remove --keys=key \ + --zone=us-central1-a --project=my-gcp-project + + For more information and examples about how to remove project zonal + metadata, see + https://cloud.google.com/compute/docs/metadata/setting-custom-metadata#remove-custom-project-zonal-metadata + +REQUIRED FLAGS + --zone=ZONE + The zone in which you want to remove project zonal metadata + +OPTIONAL FLAGS + At most one of these can be specified: + + --all + If provided, all project zonal metadata entries are removed from VM + instances in the zone. + + --keys=KEY,[KEY,...] + The keys for which you want to remove project zonal metadata + +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/compute/security-policies/rules/create b/gcloud/alpha/compute/security-policies/rules/create index 06529f81a..19624b900 100644 --- a/gcloud/alpha/compute/security-policies/rules/create +++ b/gcloud/alpha/compute/security-policies/rules/create @@ -71,7 +71,7 @@ REQUIRED FLAGS response status code of 404. deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP - response status code of 503. + response status code of 502. fairshare When traffic reaches the threshold limit, requests from the clients matching this rule begin to be rate-limited using the Fair Share diff --git a/gcloud/alpha/compute/security-policies/rules/update b/gcloud/alpha/compute/security-policies/rules/update index 3f6cb1d5d..7a8fac946 100644 --- a/gcloud/alpha/compute/security-policies/rules/update +++ b/gcloud/alpha/compute/security-policies/rules/update @@ -70,7 +70,7 @@ FLAGS response status code of 404. deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP - response status code of 503. + response status code of 502. fairshare When traffic reaches the threshold limit, requests from the clients matching this rule begin to be rate-limited using the Fair Share diff --git a/gcloud/alpha/compute/start-iap-tunnel b/gcloud/alpha/compute/start-iap-tunnel index 2672d5e7a..de70c176e 100644 --- a/gcloud/alpha/compute/start-iap-tunnel +++ b/gcloud/alpha/compute/start-iap-tunnel @@ -6,7 +6,7 @@ SYNOPSIS [--iap-tunnel-disable-connection-check] [--local-host-port=LOCAL_HOST_PORT; default="localhost:0"] [--zone=ZONE] - [--network=NETWORK --region=REGION : --dest-group=DEST_GROUP] + [--region=REGION : [--network=NETWORK : --dest-group=DEST_GROUP]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -85,13 +85,13 @@ FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. + --region=REGION + Configures the region to use when connecting via IP address or FQDN. + --network=NETWORK Configures the VPC network to use when connecting via IP address or FQDN. - --region=REGION - Configures the region to use when connecting via IP address or FQDN. - --dest-group=DEST_GROUP Configures the destination group to use when connecting via IP address or FQDN. diff --git a/gcloud/alpha/container/bare-metal/admin-clusters/create b/gcloud/alpha/container/bare-metal/admin-clusters/create index 036f381fd..4f6774c4f 100644 --- a/gcloud/alpha/container/bare-metal/admin-clusters/create +++ b/gcloud/alpha/container/bare-metal/admin-clusters/create @@ -257,7 +257,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 bare-metal admin-clusters create $ gcloud beta container bare-metal admin-clusters create diff --git a/gcloud/alpha/container/bare-metal/admin-clusters/describe b/gcloud/alpha/container/bare-metal/admin-clusters/describe index 2463a4e03..c55e8ab5d 100644 --- a/gcloud/alpha/container/bare-metal/admin-clusters/describe +++ b/gcloud/alpha/container/bare-metal/admin-clusters/describe @@ -61,7 +61,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 bare-metal admin-clusters describe $ gcloud beta container bare-metal admin-clusters describe diff --git a/gcloud/alpha/container/bare-metal/admin-clusters/enroll b/gcloud/alpha/container/bare-metal/admin-clusters/enroll index 8ea0b3d9c..c44c87c74 100644 --- a/gcloud/alpha/container/bare-metal/admin-clusters/enroll +++ b/gcloud/alpha/container/bare-metal/admin-clusters/enroll @@ -108,7 +108,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 bare-metal admin-clusters enroll $ gcloud beta container bare-metal admin-clusters enroll diff --git a/gcloud/alpha/container/bare-metal/admin-clusters/help b/gcloud/alpha/container/bare-metal/admin-clusters/help index 884e4b608..da4d2fd6c 100644 --- a/gcloud/alpha/container/bare-metal/admin-clusters/help +++ b/gcloud/alpha/container/bare-metal/admin-clusters/help @@ -44,7 +44,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 bare-metal admin-clusters $ gcloud beta container bare-metal admin-clusters diff --git a/gcloud/alpha/container/bare-metal/admin-clusters/list b/gcloud/alpha/container/bare-metal/admin-clusters/list index a111ea75e..ad223ed5c 100644 --- a/gcloud/alpha/container/bare-metal/admin-clusters/list +++ b/gcloud/alpha/container/bare-metal/admin-clusters/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 container bare-metal admin-clusters list $ gcloud beta container bare-metal admin-clusters list diff --git a/gcloud/alpha/container/bare-metal/admin-clusters/query-version-config b/gcloud/alpha/container/bare-metal/admin-clusters/query-version-config index f020367ce..6beebec9d 100644 --- a/gcloud/alpha/container/bare-metal/admin-clusters/query-version-config +++ b/gcloud/alpha/container/bare-metal/admin-clusters/query-version-config @@ -84,7 +84,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 bare-metal admin-clusters query-version-config $ gcloud beta container bare-metal admin-clusters \ query-version-config diff --git a/gcloud/alpha/container/bare-metal/admin-clusters/unenroll b/gcloud/alpha/container/bare-metal/admin-clusters/unenroll index aaaaad237..3f44abb65 100644 --- a/gcloud/alpha/container/bare-metal/admin-clusters/unenroll +++ b/gcloud/alpha/container/bare-metal/admin-clusters/unenroll @@ -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 container bare-metal admin-clusters unenroll $ gcloud beta container bare-metal admin-clusters unenroll diff --git a/gcloud/alpha/container/bare-metal/admin-clusters/update b/gcloud/alpha/container/bare-metal/admin-clusters/update index f1e9aba40..029d17d83 100644 --- a/gcloud/alpha/container/bare-metal/admin-clusters/update +++ b/gcloud/alpha/container/bare-metal/admin-clusters/update @@ -152,7 +152,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 bare-metal admin-clusters update $ gcloud beta container bare-metal admin-clusters update diff --git a/gcloud/alpha/container/bare-metal/clusters/create b/gcloud/alpha/container/bare-metal/clusters/create index 6fd5e7a71..2cea768d1 100644 --- a/gcloud/alpha/container/bare-metal/clusters/create +++ b/gcloud/alpha/container/bare-metal/clusters/create @@ -532,7 +532,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 bare-metal clusters create $ gcloud beta container bare-metal clusters create diff --git a/gcloud/alpha/container/bare-metal/clusters/delete b/gcloud/alpha/container/bare-metal/clusters/delete index 90ca8b291..2cd52fd54 100644 --- a/gcloud/alpha/container/bare-metal/clusters/delete +++ b/gcloud/alpha/container/bare-metal/clusters/delete @@ -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 container bare-metal clusters delete $ gcloud beta container bare-metal clusters delete diff --git a/gcloud/alpha/container/bare-metal/clusters/describe b/gcloud/alpha/container/bare-metal/clusters/describe index 2d364272b..0ef21f4a7 100644 --- a/gcloud/alpha/container/bare-metal/clusters/describe +++ b/gcloud/alpha/container/bare-metal/clusters/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 container bare-metal clusters describe $ gcloud beta container bare-metal clusters describe diff --git a/gcloud/alpha/container/bare-metal/clusters/enroll b/gcloud/alpha/container/bare-metal/clusters/enroll index 961bf5fa3..2e3a38747 100644 --- a/gcloud/alpha/container/bare-metal/clusters/enroll +++ b/gcloud/alpha/container/bare-metal/clusters/enroll @@ -120,7 +120,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 bare-metal clusters enroll $ gcloud beta container bare-metal clusters enroll diff --git a/gcloud/alpha/container/bare-metal/clusters/help b/gcloud/alpha/container/bare-metal/clusters/help index 4335753bc..adde0435f 100644 --- a/gcloud/alpha/container/bare-metal/clusters/help +++ b/gcloud/alpha/container/bare-metal/clusters/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 container bare-metal clusters $ gcloud beta container bare-metal clusters diff --git a/gcloud/alpha/container/bare-metal/clusters/list b/gcloud/alpha/container/bare-metal/clusters/list index c384075b4..bf5eacfd9 100644 --- a/gcloud/alpha/container/bare-metal/clusters/list +++ b/gcloud/alpha/container/bare-metal/clusters/list @@ -79,7 +79,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 bare-metal clusters list $ gcloud beta container bare-metal clusters list diff --git a/gcloud/alpha/container/bare-metal/clusters/query-version-config b/gcloud/alpha/container/bare-metal/clusters/query-version-config index 8f905986c..2f911b82d 100644 --- a/gcloud/alpha/container/bare-metal/clusters/query-version-config +++ b/gcloud/alpha/container/bare-metal/clusters/query-version-config @@ -147,7 +147,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 bare-metal clusters query-version-config $ gcloud beta container bare-metal clusters query-version-config diff --git a/gcloud/alpha/container/bare-metal/clusters/update b/gcloud/alpha/container/bare-metal/clusters/update index 2198b0fae..372d4abc1 100644 --- a/gcloud/alpha/container/bare-metal/clusters/update +++ b/gcloud/alpha/container/bare-metal/clusters/update @@ -375,7 +375,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 bare-metal clusters update $ gcloud beta container bare-metal clusters update diff --git a/gcloud/alpha/container/bare-metal/help b/gcloud/alpha/container/bare-metal/help index 42ab566d4..5392f170a 100644 --- a/gcloud/alpha/container/bare-metal/help +++ b/gcloud/alpha/container/bare-metal/help @@ -37,7 +37,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 bare-metal $ gcloud beta container bare-metal diff --git a/gcloud/alpha/container/bare-metal/node-pools/create b/gcloud/alpha/container/bare-metal/node-pools/create index ea5e5358e..25391bf57 100644 --- a/gcloud/alpha/container/bare-metal/node-pools/create +++ b/gcloud/alpha/container/bare-metal/node-pools/create @@ -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 container bare-metal node-pools create $ gcloud beta container bare-metal node-pools create diff --git a/gcloud/alpha/container/bare-metal/node-pools/delete b/gcloud/alpha/container/bare-metal/node-pools/delete index 16a663352..12f62d7cc 100644 --- a/gcloud/alpha/container/bare-metal/node-pools/delete +++ b/gcloud/alpha/container/bare-metal/node-pools/delete @@ -85,7 +85,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 bare-metal node-pools delete $ gcloud beta container bare-metal node-pools delete diff --git a/gcloud/alpha/container/bare-metal/node-pools/describe b/gcloud/alpha/container/bare-metal/node-pools/describe index c24681c99..95587215f 100644 --- a/gcloud/alpha/container/bare-metal/node-pools/describe +++ b/gcloud/alpha/container/bare-metal/node-pools/describe @@ -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 container bare-metal node-pools describe $ gcloud beta container bare-metal node-pools describe diff --git a/gcloud/alpha/container/bare-metal/node-pools/enroll b/gcloud/alpha/container/bare-metal/node-pools/enroll index 00efe209f..27919b5d9 100644 --- a/gcloud/alpha/container/bare-metal/node-pools/enroll +++ b/gcloud/alpha/container/bare-metal/node-pools/enroll @@ -77,7 +77,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 bare-metal node-pools enroll $ gcloud beta container bare-metal node-pools enroll diff --git a/gcloud/alpha/container/bare-metal/node-pools/help b/gcloud/alpha/container/bare-metal/node-pools/help index b363eff69..382fcb7db 100644 --- a/gcloud/alpha/container/bare-metal/node-pools/help +++ b/gcloud/alpha/container/bare-metal/node-pools/help @@ -38,7 +38,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 bare-metal node-pools $ gcloud beta container bare-metal node-pools diff --git a/gcloud/alpha/container/bare-metal/node-pools/list b/gcloud/alpha/container/bare-metal/node-pools/list index 63073141f..d92ae9531 100644 --- a/gcloud/alpha/container/bare-metal/node-pools/list +++ b/gcloud/alpha/container/bare-metal/node-pools/list @@ -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 container bare-metal node-pools list $ gcloud beta container bare-metal node-pools list diff --git a/gcloud/alpha/container/bare-metal/node-pools/update b/gcloud/alpha/container/bare-metal/node-pools/update index 9ab18da7f..be7ebb78f 100644 --- a/gcloud/alpha/container/bare-metal/node-pools/update +++ b/gcloud/alpha/container/bare-metal/node-pools/update @@ -127,7 +127,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 bare-metal node-pools update $ gcloud beta container bare-metal node-pools update diff --git a/gcloud/alpha/container/bare-metal/operations/describe b/gcloud/alpha/container/bare-metal/operations/describe index 35089d6f9..7694f3c81 100644 --- a/gcloud/alpha/container/bare-metal/operations/describe +++ b/gcloud/alpha/container/bare-metal/operations/describe @@ -59,7 +59,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 bare-metal operations describe $ gcloud beta container bare-metal operations describe diff --git a/gcloud/alpha/container/bare-metal/operations/help b/gcloud/alpha/container/bare-metal/operations/help index 4314214e9..7c39171a4 100644 --- a/gcloud/alpha/container/bare-metal/operations/help +++ b/gcloud/alpha/container/bare-metal/operations/help @@ -29,7 +29,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 bare-metal operations $ gcloud beta container bare-metal operations diff --git a/gcloud/alpha/container/bare-metal/operations/list b/gcloud/alpha/container/bare-metal/operations/list index d280b26b2..2bbe91d2a 100644 --- a/gcloud/alpha/container/bare-metal/operations/list +++ b/gcloud/alpha/container/bare-metal/operations/list @@ -79,7 +79,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 bare-metal operations list $ gcloud beta container bare-metal operations list diff --git a/gcloud/alpha/container/bare-metal/operations/wait b/gcloud/alpha/container/bare-metal/operations/wait index fa41338ad..e8eac9aa9 100644 --- a/gcloud/alpha/container/bare-metal/operations/wait +++ b/gcloud/alpha/container/bare-metal/operations/wait @@ -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 container bare-metal operations wait $ gcloud beta container bare-metal operations wait diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 8514e2908..0ba90dcc2 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -163,10 +163,10 @@ FLAGS `latest`: Install the latest available driver version. Available only for nodes that use Container-Optimized OS. - `disabled`: Skip automatic driver installation. You must [manually install a - driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) - after you create the cluster. If you omit the flag `gpu-driver-version`, - this is the default option. + `disabled`: Skip automatic driver installation. You must manually install a + driver after you create the cluster. If you omit the flag `gpu-driver-version`, + this is the default option. To learn how to manually install the GPU driver, + refer to: https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers gpu-partition-size (Optional) The GPU partition size used when running multi-instance diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index 63f648efd..149e86b43 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -113,10 +113,10 @@ FLAGS `latest`: Install the latest available driver version. Available only for nodes that use Container-Optimized OS. - `disabled`: Skip automatic driver installation. You must [manually install a - driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) - after you create the cluster. If you omit the flag `gpu-driver-version`, - this is the default option. + `disabled`: Skip automatic driver installation. You must manually install a + driver after you create the cluster. If you omit the flag `gpu-driver-version`, + this is the default option. To learn how to manually install the GPU driver, + refer to: https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers gpu-partition-size (Optional) The GPU partition size used when running multi-instance diff --git a/gcloud/alpha/container/vmware/admin-clusters/describe b/gcloud/alpha/container/vmware/admin-clusters/describe index b6f2af74d..0f65a6516 100644 --- a/gcloud/alpha/container/vmware/admin-clusters/describe +++ b/gcloud/alpha/container/vmware/admin-clusters/describe @@ -61,7 +61,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 vmware admin-clusters describe $ gcloud beta container vmware admin-clusters describe diff --git a/gcloud/alpha/container/vmware/admin-clusters/enroll b/gcloud/alpha/container/vmware/admin-clusters/enroll index f77efabe3..f84083fe3 100644 --- a/gcloud/alpha/container/vmware/admin-clusters/enroll +++ b/gcloud/alpha/container/vmware/admin-clusters/enroll @@ -108,7 +108,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 vmware admin-clusters enroll $ gcloud beta container vmware admin-clusters enroll diff --git a/gcloud/alpha/container/vmware/admin-clusters/help b/gcloud/alpha/container/vmware/admin-clusters/help index 8f75f839f..9d4b0f34f 100644 --- a/gcloud/alpha/container/vmware/admin-clusters/help +++ b/gcloud/alpha/container/vmware/admin-clusters/help @@ -35,7 +35,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 vmware admin-clusters $ gcloud beta container vmware admin-clusters diff --git a/gcloud/alpha/container/vmware/admin-clusters/list b/gcloud/alpha/container/vmware/admin-clusters/list index c346c63bc..cfc2cad44 100644 --- a/gcloud/alpha/container/vmware/admin-clusters/list +++ b/gcloud/alpha/container/vmware/admin-clusters/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 container vmware admin-clusters list $ gcloud beta container vmware admin-clusters list diff --git a/gcloud/alpha/container/vmware/admin-clusters/unenroll b/gcloud/alpha/container/vmware/admin-clusters/unenroll index a7b73bb3b..d0a590ad7 100644 --- a/gcloud/alpha/container/vmware/admin-clusters/unenroll +++ b/gcloud/alpha/container/vmware/admin-clusters/unenroll @@ -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 container vmware admin-clusters unenroll $ gcloud beta container vmware admin-clusters unenroll diff --git a/gcloud/alpha/container/vmware/admin-clusters/update b/gcloud/alpha/container/vmware/admin-clusters/update index 4d7276706..4c09a868b 100644 --- a/gcloud/alpha/container/vmware/admin-clusters/update +++ b/gcloud/alpha/container/vmware/admin-clusters/update @@ -73,7 +73,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 vmware admin-clusters update $ gcloud beta container vmware admin-clusters update diff --git a/gcloud/alpha/container/vmware/clusters/create b/gcloud/alpha/container/vmware/clusters/create index 7b9b8f008..44934ecbc 100644 --- a/gcloud/alpha/container/vmware/clusters/create +++ b/gcloud/alpha/container/vmware/clusters/create @@ -420,7 +420,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 vmware clusters create $ gcloud beta container vmware clusters create diff --git a/gcloud/alpha/container/vmware/clusters/delete b/gcloud/alpha/container/vmware/clusters/delete index ae298e492..73be719ed 100644 --- a/gcloud/alpha/container/vmware/clusters/delete +++ b/gcloud/alpha/container/vmware/clusters/delete @@ -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 container vmware clusters delete $ gcloud beta container vmware clusters delete diff --git a/gcloud/alpha/container/vmware/clusters/describe b/gcloud/alpha/container/vmware/clusters/describe index defc88b63..9eca6b693 100644 --- a/gcloud/alpha/container/vmware/clusters/describe +++ b/gcloud/alpha/container/vmware/clusters/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 container vmware clusters describe $ gcloud beta container vmware clusters describe diff --git a/gcloud/alpha/container/vmware/clusters/enroll b/gcloud/alpha/container/vmware/clusters/enroll index 97f899ddc..3cb23c185 100644 --- a/gcloud/alpha/container/vmware/clusters/enroll +++ b/gcloud/alpha/container/vmware/clusters/enroll @@ -134,7 +134,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 vmware clusters enroll $ gcloud beta container vmware clusters enroll diff --git a/gcloud/alpha/container/vmware/clusters/help b/gcloud/alpha/container/vmware/clusters/help index 027919a9b..f6011d718 100644 --- a/gcloud/alpha/container/vmware/clusters/help +++ b/gcloud/alpha/container/vmware/clusters/help @@ -45,7 +45,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 vmware clusters $ gcloud beta container vmware clusters diff --git a/gcloud/alpha/container/vmware/clusters/list b/gcloud/alpha/container/vmware/clusters/list index 97bed7be4..3e41367fa 100644 --- a/gcloud/alpha/container/vmware/clusters/list +++ b/gcloud/alpha/container/vmware/clusters/list @@ -79,7 +79,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 vmware clusters list $ gcloud beta container vmware clusters list diff --git a/gcloud/alpha/container/vmware/clusters/query-version-config b/gcloud/alpha/container/vmware/clusters/query-version-config index 407d84a86..9a6dd4f15 100644 --- a/gcloud/alpha/container/vmware/clusters/query-version-config +++ b/gcloud/alpha/container/vmware/clusters/query-version-config @@ -134,7 +134,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 vmware clusters query-version-config $ gcloud beta container vmware clusters query-version-config diff --git a/gcloud/alpha/container/vmware/clusters/update b/gcloud/alpha/container/vmware/clusters/update index 0c3c81031..be3e9ffd6 100644 --- a/gcloud/alpha/container/vmware/clusters/update +++ b/gcloud/alpha/container/vmware/clusters/update @@ -232,7 +232,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 vmware clusters update $ gcloud beta container vmware clusters update diff --git a/gcloud/alpha/container/vmware/clusters/upgrade b/gcloud/alpha/container/vmware/clusters/upgrade index 68aa2e5c6..3017b897d 100644 --- a/gcloud/alpha/container/vmware/clusters/upgrade +++ b/gcloud/alpha/container/vmware/clusters/upgrade @@ -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 container vmware clusters upgrade $ gcloud beta container vmware clusters upgrade diff --git a/gcloud/alpha/container/vmware/help b/gcloud/alpha/container/vmware/help index 95fe88eac..7382b397b 100644 --- a/gcloud/alpha/container/vmware/help +++ b/gcloud/alpha/container/vmware/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 container vmware $ gcloud beta container vmware diff --git a/gcloud/alpha/container/vmware/node-pools/create b/gcloud/alpha/container/vmware/node-pools/create index 500a8b936..816c352bb 100644 --- a/gcloud/alpha/container/vmware/node-pools/create +++ b/gcloud/alpha/container/vmware/node-pools/create @@ -149,7 +149,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 vmware node-pools create $ gcloud beta container vmware node-pools create diff --git a/gcloud/alpha/container/vmware/node-pools/delete b/gcloud/alpha/container/vmware/node-pools/delete index 075d996ce..ca4e6f84b 100644 --- a/gcloud/alpha/container/vmware/node-pools/delete +++ b/gcloud/alpha/container/vmware/node-pools/delete @@ -85,7 +85,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 vmware node-pools delete $ gcloud beta container vmware node-pools delete diff --git a/gcloud/alpha/container/vmware/node-pools/describe b/gcloud/alpha/container/vmware/node-pools/describe index b29e58d7a..95c5b8595 100644 --- a/gcloud/alpha/container/vmware/node-pools/describe +++ b/gcloud/alpha/container/vmware/node-pools/describe @@ -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 container vmware node-pools describe $ gcloud beta container vmware node-pools describe diff --git a/gcloud/alpha/container/vmware/node-pools/enroll b/gcloud/alpha/container/vmware/node-pools/enroll index c0560a42e..8cee5a2f9 100644 --- a/gcloud/alpha/container/vmware/node-pools/enroll +++ b/gcloud/alpha/container/vmware/node-pools/enroll @@ -73,7 +73,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 vmware node-pools enroll $ gcloud beta container vmware node-pools enroll diff --git a/gcloud/alpha/container/vmware/node-pools/help b/gcloud/alpha/container/vmware/node-pools/help index ff66bdd32..c7749f7c6 100644 --- a/gcloud/alpha/container/vmware/node-pools/help +++ b/gcloud/alpha/container/vmware/node-pools/help @@ -38,7 +38,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 vmware node-pools $ gcloud beta container vmware node-pools diff --git a/gcloud/alpha/container/vmware/node-pools/list b/gcloud/alpha/container/vmware/node-pools/list index ea059db08..e62325a7b 100644 --- a/gcloud/alpha/container/vmware/node-pools/list +++ b/gcloud/alpha/container/vmware/node-pools/list @@ -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 container vmware node-pools list $ gcloud beta container vmware node-pools list diff --git a/gcloud/alpha/container/vmware/node-pools/update b/gcloud/alpha/container/vmware/node-pools/update index ca5bb6b55..c0a8faae5 100644 --- a/gcloud/alpha/container/vmware/node-pools/update +++ b/gcloud/alpha/container/vmware/node-pools/update @@ -139,7 +139,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 vmware node-pools update $ gcloud beta container vmware node-pools update diff --git a/gcloud/alpha/container/vmware/operations/describe b/gcloud/alpha/container/vmware/operations/describe index 3ee82f50a..73a6b16e0 100644 --- a/gcloud/alpha/container/vmware/operations/describe +++ b/gcloud/alpha/container/vmware/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 container vmware operations describe $ gcloud beta container vmware operations describe diff --git a/gcloud/alpha/container/vmware/operations/help b/gcloud/alpha/container/vmware/operations/help index 5f42f9c0b..3d7168417 100644 --- a/gcloud/alpha/container/vmware/operations/help +++ b/gcloud/alpha/container/vmware/operations/help @@ -29,7 +29,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 vmware operations $ gcloud beta container vmware operations diff --git a/gcloud/alpha/container/vmware/operations/list b/gcloud/alpha/container/vmware/operations/list index 2d3bac4e7..24dd184ed 100644 --- a/gcloud/alpha/container/vmware/operations/list +++ b/gcloud/alpha/container/vmware/operations/list @@ -78,7 +78,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 vmware operations list $ gcloud beta container vmware operations list diff --git a/gcloud/alpha/container/vmware/operations/wait b/gcloud/alpha/container/vmware/operations/wait index 826baf7b9..cfe5c7b07 100644 --- a/gcloud/alpha/container/vmware/operations/wait +++ b/gcloud/alpha/container/vmware/operations/wait @@ -59,7 +59,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 vmware operations wait $ gcloud beta container vmware operations wait diff --git a/gcloud/alpha/edge-cloud/container/clusters/create b/gcloud/alpha/edge-cloud/container/clusters/create index 624f240f2..9b1c03636 100644 --- a/gcloud/alpha/edge-cloud/container/clusters/create +++ b/gcloud/alpha/edge-cloud/container/clusters/create @@ -7,6 +7,7 @@ SYNOPSIS (CLUSTER : --location=LOCATION) [--admin-users=ADMIN_USERS] [--async] [--cluster-ipv4-cidr=CLUSTER_IPV4_CIDR; default="10.0.0.0/17"] [--cluster-ipv6-cidr=CLUSTER_IPV6_CIDR] + [--control-plane-kms-key=CONTROL_PLANE_KMS_KEY] [--control-plane-machine-filter=CONTROL_PLANE_MACHINE_FILTER] [--control-plane-node-count=CONTROL_PLANE_NODE_COUNT] [--control-plane-node-location=CONTROL_PLANE_NODE_LOCATION] @@ -84,6 +85,14 @@ FLAGS If specified, all pods in the cluster are assigned an RFC4193 IPv6 address from this block. This field cannot be changed after creation. + --control-plane-kms-key=CONTROL_PLANE_KMS_KEY + Google Cloud KMS key that will be used to secure persistent disks of + the control plane VMs of a remote control plane cluster. The Edge + Container service account for this project must have + roles/cloudkms.cryptoKeyEncrypterDecrypter on the key. + + If not provided, a Google-managed key will be used by default. + --control-plane-machine-filter=CONTROL_PLANE_MACHINE_FILTER Only machines matching this filter will be allowed to host local control plane nodes. The filtering language accepts strings like diff --git a/gcloud/alpha/healthcare/hl7v2-stores/create b/gcloud/alpha/healthcare/hl7v2-stores/create index 3e4d63acb..dd34127e2 100644 --- a/gcloud/alpha/healthcare/hl7v2-stores/create +++ b/gcloud/alpha/healthcare/hl7v2-stores/create @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha healthcare hl7v2-stores create (HL7V2_STORE : --dataset=DATASET --location=LOCATION) - [--pubsub-topic=PUBSUB_TOPIC] [GCLOUD_WIDE_FLAG ...] + [--parser-version=PARSER_VERSION] [--pubsub-topic=PUBSUB_TOPIC] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a Cloud Healthcare API HL7v2 store. @@ -65,6 +66,32 @@ POSITIONAL ARGUMENTS ▸ set the property healthcare/location. FLAGS + --parser-version=PARSER_VERSION + Immutable. Determines the version of both the default parser to be used + when schema + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig.FIELDS.schema) + is not given, as well as the schematized parser used when schema + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig.FIELDS.schema) + is specified. This field is immutable after HL7v2 store creation. + PARSER_VERSION must be one of: + + v1 + The parsedData includes every given non-empty message field except + the Field Separator (MSH-1) field. As a result, the parsed MSH + segment starts with the MSH-2 field and the field numbers are + off-by-one with respect to the HL7 standard. + v2 + The parsedData includes every given non-empty message field. + + v3 + This version is the same as V2, with the following change. The + parsedData contains unescaped escaped field separators, component + separators, sub-component separators, repetition separators, escape + characters, and truncation characters. If schema + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig.FIELDS.schema) + is specified, the schematized parser uses improved parsing + heuristics compared to previous versions. + --pubsub-topic=PUBSUB_TOPIC A Google Cloud Pub/Sub topic name for notifications. diff --git a/gcloud/alpha/iam/policies/lint-condition b/gcloud/alpha/iam/policies/lint-condition index 875a11d89..f4295167a 100644 --- a/gcloud/alpha/iam/policies/lint-condition +++ b/gcloud/alpha/iam/policies/lint-condition @@ -39,7 +39,8 @@ REQUIRED FLAGS https://cloud.google.com/iam/docs/conditions-overview for schema of the condition. - condition to lint. + The condition to lint. It must have an expression property and a title + property. The description property is optional. --expression=EXPRESSION The expression of the condition which evaluates to True or False. diff --git a/gcloud/alpha/infra-manager/deployments/apply b/gcloud/alpha/infra-manager/deployments/apply index 4e74bd73e..301494eff 100644 --- a/gcloud/alpha/infra-manager/deployments/apply +++ b/gcloud/alpha/infra-manager/deployments/apply @@ -11,8 +11,8 @@ SYNOPSIS [--worker-pool=WORKER_POOL] [--gcs-source=GCS_SOURCE | --git-source-directory=GIT_SOURCE_DIRECTORY --git-source-ref=GIT_SOURCE_REF --git-source-repo=GIT_SOURCE_REPO - | --ignore-file=IGNORE_FILE --local-source=LOCAL_SOURCE - --stage-bucket=STAGE_BUCKET --input-values=[KEY=VALUE,...] + | --ignore-file=IGNORE_FILE + --local-source=LOCAL_SOURCE --input-values=[KEY=VALUE,...] | --inputs-file=INPUTS_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -205,26 +205,6 @@ FLAGS projects/p1/location/us-central1/deployments/my-deployment \ --local-source="./path/to/blueprint" - --stage-bucket=STAGE_BUCKET - Use in conjunction with --local-source to specify a destination - storage bucket for uploading local files. - - If unspecified, the bucket defaults to gs://PROJECT_NAME_blueprints. - Uploaded content will appear in the source object under a name - comprised of the timestamp and a UUID. The final output destination - looks like this: - gs://BUCKET/source/1615850562.234312-044e784992744951b0cd71c0b011edce/ - - Examples: - - Create a deployment from a local storage path ./path/to/blueprint and - stage-bucket gs://my-bucket: - - $ gcloud alpha infra-manager deployments apply \ - projects/p1/location/us-central1/deployments/my-deployment \ - --local-source="./path/to/blueprint" \ - --stage-bucket="gs://my-bucket" - At most one of these can be specified: --input-values=[KEY=VALUE,...] @@ -265,5 +245,7 @@ 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. This variant is also available: + + $ gcloud infra-manager deployments apply diff --git a/gcloud/alpha/infra-manager/deployments/delete b/gcloud/alpha/infra-manager/deployments/delete index 66b107e95..776d35203 100644 --- a/gcloud/alpha/infra-manager/deployments/delete +++ b/gcloud/alpha/infra-manager/deployments/delete @@ -68,12 +68,14 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the config/v1alpha2 API. The full documentation for this - API can be found at: https://cloud.google.com/ + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ 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. This variant is also available: + + $ gcloud infra-manager deployments delete diff --git a/gcloud/alpha/infra-manager/deployments/describe b/gcloud/alpha/infra-manager/deployments/describe index ebf8897e9..f35eb6498 100644 --- a/gcloud/alpha/infra-manager/deployments/describe +++ b/gcloud/alpha/infra-manager/deployments/describe @@ -56,12 +56,14 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the config/v1alpha2 API. The full documentation for this - API can be found at: https://cloud.google.com/ + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ 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. This variant is also available: + + $ gcloud infra-manager deployments describe diff --git a/gcloud/alpha/infra-manager/deployments/export-lock b/gcloud/alpha/infra-manager/deployments/export-lock index 67fd4bca2..a5e449444 100644 --- a/gcloud/alpha/infra-manager/deployments/export-lock +++ b/gcloud/alpha/infra-manager/deployments/export-lock @@ -61,5 +61,7 @@ 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. This variant is also available: + + $ gcloud infra-manager deployments export-lock diff --git a/gcloud/alpha/infra-manager/deployments/export-statefile b/gcloud/alpha/infra-manager/deployments/export-statefile index 0934df230..ae03facb5 100644 --- a/gcloud/alpha/infra-manager/deployments/export-statefile +++ b/gcloud/alpha/infra-manager/deployments/export-statefile @@ -66,5 +66,7 @@ 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. This variant is also available: + + $ gcloud infra-manager deployments export-statefile diff --git a/gcloud/alpha/infra-manager/deployments/help b/gcloud/alpha/infra-manager/deployments/help index 217d88401..13b31e99b 100644 --- a/gcloud/alpha/infra-manager/deployments/help +++ b/gcloud/alpha/infra-manager/deployments/help @@ -46,5 +46,7 @@ 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. This variant is also available: + + $ gcloud infra-manager deployments diff --git a/gcloud/alpha/infra-manager/deployments/import-statefile b/gcloud/alpha/infra-manager/deployments/import-statefile index 5ab4e332d..12a2ccd86 100644 --- a/gcloud/alpha/infra-manager/deployments/import-statefile +++ b/gcloud/alpha/infra-manager/deployments/import-statefile @@ -67,5 +67,7 @@ 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. This variant is also available: + + $ gcloud infra-manager deployments import-statefile diff --git a/gcloud/alpha/infra-manager/deployments/list b/gcloud/alpha/infra-manager/deployments/list index 59ea60b2f..d383eeda7 100644 --- a/gcloud/alpha/infra-manager/deployments/list +++ b/gcloud/alpha/infra-manager/deployments/list @@ -74,12 +74,14 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the config/v1alpha2 API. The full documentation for this - API can be found at: https://cloud.google.com/ + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ 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. This variant is also available: + + $ gcloud infra-manager deployments list diff --git a/gcloud/alpha/infra-manager/deployments/lock b/gcloud/alpha/infra-manager/deployments/lock index b14bd913e..d33bdd8ee 100644 --- a/gcloud/alpha/infra-manager/deployments/lock +++ b/gcloud/alpha/infra-manager/deployments/lock @@ -64,5 +64,7 @@ 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. This variant is also available: + + $ gcloud infra-manager deployments lock diff --git a/gcloud/alpha/infra-manager/deployments/unlock b/gcloud/alpha/infra-manager/deployments/unlock index 0ff4593cc..6ea5cf78d 100644 --- a/gcloud/alpha/infra-manager/deployments/unlock +++ b/gcloud/alpha/infra-manager/deployments/unlock @@ -71,5 +71,7 @@ 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. This variant is also available: + + $ gcloud infra-manager deployments unlock diff --git a/gcloud/alpha/infra-manager/help b/gcloud/alpha/infra-manager/help index 869ecfa77..7001d1e66 100644 --- a/gcloud/alpha/infra-manager/help +++ b/gcloud/alpha/infra-manager/help @@ -28,5 +28,7 @@ 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. This variant is also available: + + $ gcloud infra-manager diff --git a/gcloud/alpha/infra-manager/resources/describe b/gcloud/alpha/infra-manager/resources/describe index c95e97fbb..8a757df12 100644 --- a/gcloud/alpha/infra-manager/resources/describe +++ b/gcloud/alpha/infra-manager/resources/describe @@ -75,12 +75,14 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the config/v1alpha2 API. The full documentation for this - API can be found at: https://cloud.google.com/ + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ 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. This variant is also available: + + $ gcloud infra-manager resources describe diff --git a/gcloud/alpha/infra-manager/resources/help b/gcloud/alpha/infra-manager/resources/help index e9e31b23c..031385b6e 100644 --- a/gcloud/alpha/infra-manager/resources/help +++ b/gcloud/alpha/infra-manager/resources/help @@ -26,5 +26,7 @@ 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. This variant is also available: + + $ gcloud infra-manager resources diff --git a/gcloud/alpha/infra-manager/resources/list b/gcloud/alpha/infra-manager/resources/list index 02bf2ba6a..f885b6525 100644 --- a/gcloud/alpha/infra-manager/resources/list +++ b/gcloud/alpha/infra-manager/resources/list @@ -97,12 +97,14 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the config/v1alpha2 API. The full documentation for this - API can be found at: https://cloud.google.com/ + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ 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. This variant is also available: + + $ gcloud infra-manager resources list diff --git a/gcloud/alpha/infra-manager/revisions/describe b/gcloud/alpha/infra-manager/revisions/describe index 05c178095..35d640954 100644 --- a/gcloud/alpha/infra-manager/revisions/describe +++ b/gcloud/alpha/infra-manager/revisions/describe @@ -65,12 +65,14 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the config/v1alpha2 API. The full documentation for this - API can be found at: https://cloud.google.com/ + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ 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. This variant is also available: + + $ gcloud infra-manager revisions describe diff --git a/gcloud/alpha/infra-manager/revisions/export-statefile b/gcloud/alpha/infra-manager/revisions/export-statefile index 83efce417..d54bf7cf5 100644 --- a/gcloud/alpha/infra-manager/revisions/export-statefile +++ b/gcloud/alpha/infra-manager/revisions/export-statefile @@ -70,5 +70,7 @@ 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. This variant is also available: + + $ gcloud infra-manager revisions export-statefile diff --git a/gcloud/alpha/infra-manager/revisions/help b/gcloud/alpha/infra-manager/revisions/help index 91c5c6c1a..9890d2947 100644 --- a/gcloud/alpha/infra-manager/revisions/help +++ b/gcloud/alpha/infra-manager/revisions/help @@ -28,5 +28,7 @@ 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. This variant is also available: + + $ gcloud infra-manager revisions diff --git a/gcloud/alpha/infra-manager/revisions/list b/gcloud/alpha/infra-manager/revisions/list index d8fd12571..6069f1bde 100644 --- a/gcloud/alpha/infra-manager/revisions/list +++ b/gcloud/alpha/infra-manager/revisions/list @@ -90,12 +90,14 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the config/v1alpha2 API. The full documentation for this - API can be found at: https://cloud.google.com/ + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ 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. This variant is also available: + + $ gcloud infra-manager revisions list diff --git a/gcloud/alpha/netapp/volumes/create b/gcloud/alpha/netapp/volumes/create index e7bcd1a06..860cf915a 100644 --- a/gcloud/alpha/netapp/volumes/create +++ b/gcloud/alpha/netapp/volumes/create @@ -90,10 +90,8 @@ REQUIRED FLAGS unit is specified, GiB is assumed. --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files VolumeValid - component values are: NFSV3, NFSV4, SMB - - For more information, look athttps://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#protocols. + Type of File System protocols for the Cloud NetApp Files Volume. Valid + component values are: NFSV3, NFSV4, SMB. --share-name=SHARE_NAME Share name of the Mount path clients will use. @@ -156,11 +154,8 @@ OPTIONAL FLAGS numbers. --restricted-actions=RESTRICTED_ACTION,[...] - Actions to be restricted for a volume.Valid restricted action options - are: 'DELETE' - - For more information, look at - https://cloud.google.com/netapp/volumes/docs/reference/rest/v1/projects.locations.volumes#restrictedaction. + Actions to be restricted for a volume. Valid restricted action options + are: 'DELETE'. --security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED" The security style of the Volume. This can either be UNIX or NTFS. @@ -173,13 +168,11 @@ OPTIONAL FLAGS UNIX security style for Volume --smb-settings=SMB_SETTING,[SMB_SETTING,...] - List of settings specific to SMB protocolfor a Cloud NetApp Files - VolumeValid component values are: ENCRYPT_DATA, BROWSABLE, + List of settings specific to SMB protocol for a Cloud NetApp Files + Volume. Valid component values are: ENCRYPT_DATA, BROWSABLE, CHANGE_NOTIFY, NON_BROWSABLE, OPLOCKS, SHOW_SNAPSHOT, SHOW_PREVIOUS_VERSIONS, ACCESS_BASED_ENUMERATION, - CONTINUOUSLY_AVAILABLE - - For more information, look at https://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#smbsettings. + CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE The percentage of volume storage reserved for snapshot storage. The @@ -230,7 +223,7 @@ OPTIONAL FLAGS ▸ provide the argument --source-snapshot on the command line. --unix-permissions=UNIX_PERMISSIONS - Unix permissions the mount point will be created with.Unix permissions + Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only GCLOUD WIDE FLAGS diff --git a/gcloud/alpha/netapp/volumes/update b/gcloud/alpha/netapp/volumes/update index f34764347..4f4000b17 100644 --- a/gcloud/alpha/netapp/volumes/update +++ b/gcloud/alpha/netapp/volumes/update @@ -104,17 +104,12 @@ FLAGS kerberos-5p-read-write=KERBEROS_5P_READ_WRITE --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files VolumeValid - component values are: NFSV3, NFSV4, SMB - - For more information, look athttps://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#protocols. + Type of File System protocols for the Cloud NetApp Files Volume. Valid + component values are: NFSV3, NFSV4, SMB. --restricted-actions=RESTRICTED_ACTION,[...] - Actions to be restricted for a volume.Valid restricted action options - are: 'DELETE' - - For more information, look at - https://cloud.google.com/netapp/volumes/docs/reference/rest/v1/projects.locations.volumes#restrictedaction. + Actions to be restricted for a volume. Valid restricted action options + are: 'DELETE'. --security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED" The security style of the Volume. This can either be UNIX or NTFS. @@ -130,13 +125,11 @@ FLAGS Share name of the Mount path clients will use. --smb-settings=SMB_SETTING,[SMB_SETTING,...] - List of settings specific to SMB protocolfor a Cloud NetApp Files - VolumeValid component values are: ENCRYPT_DATA, BROWSABLE, + List of settings specific to SMB protocol for a Cloud NetApp Files + Volume. Valid component values are: ENCRYPT_DATA, BROWSABLE, CHANGE_NOTIFY, NON_BROWSABLE, OPLOCKS, SHOW_SNAPSHOT, SHOW_PREVIOUS_VERSIONS, ACCESS_BASED_ENUMERATION, - CONTINUOUSLY_AVAILABLE - - For more information, look at https://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#smbsettings. + CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE The percentage of volume storage reserved for snapshot storage. The @@ -211,7 +204,7 @@ FLAGS ▸ provide the argument --storage-pool on the command line. --unix-permissions=UNIX_PERMISSIONS - Unix permissions the mount point will be created with.Unix permissions + Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only --update-labels=[KEY=VALUE,...] diff --git a/gcloud/alpha/network-security/firewall-endpoints/create b/gcloud/alpha/network-security/firewall-endpoints/create index 5448335ca..93dd654fd 100644 --- a/gcloud/alpha/network-security/firewall-endpoints/create +++ b/gcloud/alpha/network-security/firewall-endpoints/create @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud alpha network-security firewall-endpoints create (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async] - [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="60m"] - [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a firewall endpoint. Successful creation of an endpoint @@ -60,6 +60,9 @@ FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/network-security/firewall-endpoints/update b/gcloud/alpha/network-security/firewall-endpoints/update index 7298764c9..936cf2955 100644 --- a/gcloud/alpha/network-security/firewall-endpoints/update +++ b/gcloud/alpha/network-security/firewall-endpoints/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha network-security firewall-endpoints update (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async] - [--max-wait=MAX_WAIT; default="60m"] [--update-labels=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--max-wait=MAX_WAIT; default="60m"] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -71,6 +72,9 @@ FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --max-wait=MAX_WAIT; default="60m" Time to synchronously wait for the operation to complete, after which the operation continues asynchronously. Ignored if --no-async isn't diff --git a/gcloud/alpha/run/deploy b/gcloud/alpha/run/deploy index 829b87be2..951be1f68 100644 --- a/gcloud/alpha/run/deploy +++ b/gcloud/alpha/run/deploy @@ -27,7 +27,7 @@ SYNOPSIS | --clear-custom-audiences | --remove-custom-audiences=[CUSTOM-AUDIENCES,...] | --set-custom-audiences=[CUSTOM-AUDIENCES,...] --args=[ARG,...] - --command=[COMMAND,...] --cpu=CPU + --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --memory=MEMORY --port=PORT --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] @@ -35,7 +35,7 @@ SYNOPSIS | --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...] --image=IMAGE | --source=SOURCE | --container=CONTAINER - --remove-containers=[CONTAINERS,...] --binary-authorization=POLICY + --remove-containers=[CONTAINER,...] --binary-authorization=POLICY | --clear-binary-authorization --clear-encryption-key-shutdown-hours | --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS --clear-key | --key=KEY --clear-network @@ -415,6 +415,9 @@ FLAGS Cloud Run for Anthos and Knative-compatible Kubernetes clusters support fractional values. Examples .5, 500m, 2 + --depends-on=[CONTAINER,...] + List of container dependencies to add to the current container. + --memory=MEMORY Set a memory limit. Ex: 1024Mi, 4Gi. @@ -513,7 +516,7 @@ FLAGS Specifies a container by name. The following container flags apply to the specified container. - --remove-containers=[CONTAINERS,...] + --remove-containers=[CONTAINER,...] List of containers to remove. At most one of these can be specified: diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index 141528467..ae82496c6 100644 --- a/gcloud/alpha/run/services/update +++ b/gcloud/alpha/run/services/update @@ -23,7 +23,8 @@ SYNOPSIS | --clear-custom-audiences | --remove-custom-audiences=[CUSTOM-AUDIENCES,...] | --set-custom-audiences=[CUSTOM-AUDIENCES,...] --args=[ARG,...] - --command=[COMMAND,...] --cpu=CPU --image=IMAGE + --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] + --image=IMAGE --memory=MEMORY --port=PORT --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] @@ -31,7 +32,7 @@ SYNOPSIS | --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...] | --container=CONTAINER - --remove-containers=[CONTAINERS,...] --binary-authorization=POLICY + --remove-containers=[CONTAINER,...] --binary-authorization=POLICY | --clear-binary-authorization --clear-encryption-key-shutdown-hours | --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS --clear-key | --key=KEY --clear-network @@ -320,6 +321,9 @@ FLAGS Cloud Run for Anthos and Knative-compatible Kubernetes clusters support fractional values. Examples .5, 500m, 2 + --depends-on=[CONTAINER,...] + List of container dependencies to add to the current container. + --image=IMAGE Name of the container image to deploy (e.g. gcr.io/cloudrun/hello:latest). @@ -399,7 +403,7 @@ FLAGS Specifies a container by name. The following container flags apply to the specified container. - --remove-containers=[CONTAINERS,...] + --remove-containers=[CONTAINER,...] List of containers to remove. At most one of these can be specified: diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index be1a9796c..dc862e3cb 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -445,14 +445,14 @@ FLAGS unlimited. --allowed-psc-projects=PROJECT,[PROJECT,...] - A comma-separated list of projects. Each project in this list may be - represented by a project number (numeric) or by a project id - (alphanumeric). This will allow PSC connections to be established from - specified consumer projects. This can be set only when PSC is enabled. + A comma-separated list of projects. Each project in this list might be + represented by a project number (numeric) or by a project ID + (alphanumeric). This allows Private Service Connect connections to be + established from specified consumer projects. --enable-private-service-connect - When the flag is set, a Cloud SQL instance will be created with PSC - enabled. + When the flag is set, a Cloud SQL instance will be created with Private + Service Connect enabled. Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the instance. The 'Compute Engine Service Agent' diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index 0bc52252c..c419301e8 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -378,15 +378,15 @@ FLAGS At most one of these can be specified: --allowed-psc-projects=PROJECT,[PROJECT,...] - A comma-separated list of projects. Each project in this list may be - represented by a project number (numeric) or by a project id - (alphanumeric). This will allow PSC connections to be established - from specified consumer projects. This can be set only when PSC is - enabled. + A comma-separated list of projects. Each project in this list might + be represented by a project number (numeric) or by a project ID + (alphanumeric). This allows Private Service Connect connections to be + established from specified consumer projects. --clear-allowed-psc-projects - This will clear the project allowlist of PSC, disallowing all - projects from creating new PSC bindings to the instance. + This will clear the project allowlist of Private Service Connect, + disallowing all projects from creating new Private Service Connect + bindings to the instance. At most one of these can be specified: diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index 5348be73c..928294d17 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -19,7 +19,7 @@ SYNOPSIS [--pd-disk-size=PD_DISK_SIZE; default=200] [--pd-disk-type=PD_DISK_TYPE; default="pd-standard"] [--pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"] - [--pool-size=POOL_SIZE] + [--pool-size=POOL_SIZE] [--replica-zones=[REPLICA_ZONES,...]] [--running-timeout=RUNNING_TIMEOUT; default=7200] [--service-account=SERVICE_ACCOUNT] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] @@ -191,6 +191,16 @@ FLAGS --pool-size=POOL_SIZE Number of instances to pool for faster Workstation starup. + --replica-zones=[REPLICA_ZONES,...] + Specifies the zones the VM and disk resources will be replicated within + the region. If set, exactly two zones within the workstation cluster's + region must be specified. + + Example: + + $ gcloud alpha workstations configs create \ + --replica-zones=us-central1-a,us-central1-f + --running-timeout=RUNNING_TIMEOUT; default=7200 How long (in seconds) to wait before automatically stopping a workstation after it started. A value of 0 indicates that workstations diff --git a/gcloud/beta/compute/security-policies/rules/create b/gcloud/beta/compute/security-policies/rules/create index a7120cfac..ff5033945 100644 --- a/gcloud/beta/compute/security-policies/rules/create +++ b/gcloud/beta/compute/security-policies/rules/create @@ -68,7 +68,7 @@ REQUIRED FLAGS response status code of 404. deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP - response status code of 503. + response status code of 502. rate-based-ban Enforces rate-based ban action from HTTP(S) Load Balancing, based on rate limit options. diff --git a/gcloud/beta/compute/security-policies/rules/update b/gcloud/beta/compute/security-policies/rules/update index 3a6724565..098b5876b 100644 --- a/gcloud/beta/compute/security-policies/rules/update +++ b/gcloud/beta/compute/security-policies/rules/update @@ -68,7 +68,7 @@ FLAGS response status code of 404. deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP - response status code of 503. + response status code of 502. rate-based-ban Enforces rate-based ban action from HTTP(S) Load Balancing, based on rate limit options. diff --git a/gcloud/beta/container/bare-metal/admin-clusters/create b/gcloud/beta/container/bare-metal/admin-clusters/create index 45656f5d6..a8e443e14 100644 --- a/gcloud/beta/container/bare-metal/admin-clusters/create +++ b/gcloud/beta/container/bare-metal/admin-clusters/create @@ -254,8 +254,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 bare-metal admin-clusters create $ gcloud alpha container bare-metal admin-clusters create diff --git a/gcloud/beta/container/bare-metal/admin-clusters/describe b/gcloud/beta/container/bare-metal/admin-clusters/describe index f91d79cf8..b963930be 100644 --- a/gcloud/beta/container/bare-metal/admin-clusters/describe +++ b/gcloud/beta/container/bare-metal/admin-clusters/describe @@ -58,8 +58,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 bare-metal admin-clusters describe $ gcloud alpha container bare-metal admin-clusters describe diff --git a/gcloud/beta/container/bare-metal/admin-clusters/enroll b/gcloud/beta/container/bare-metal/admin-clusters/enroll index ba198fc1b..46dff6077 100644 --- a/gcloud/beta/container/bare-metal/admin-clusters/enroll +++ b/gcloud/beta/container/bare-metal/admin-clusters/enroll @@ -105,8 +105,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 bare-metal admin-clusters enroll $ gcloud alpha container bare-metal admin-clusters enroll diff --git a/gcloud/beta/container/bare-metal/admin-clusters/help b/gcloud/beta/container/bare-metal/admin-clusters/help index 4d048d7f8..028d17ead 100644 --- a/gcloud/beta/container/bare-metal/admin-clusters/help +++ b/gcloud/beta/container/bare-metal/admin-clusters/help @@ -41,8 +41,10 @@ COMMANDS (BETA) Update an Anthos on bare metal admin cluster. 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 bare-metal admin-clusters $ gcloud alpha container bare-metal admin-clusters diff --git a/gcloud/beta/container/bare-metal/admin-clusters/list b/gcloud/beta/container/bare-metal/admin-clusters/list index 4f3321335..95ee6659c 100644 --- a/gcloud/beta/container/bare-metal/admin-clusters/list +++ b/gcloud/beta/container/bare-metal/admin-clusters/list @@ -77,8 +77,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 bare-metal admin-clusters list $ gcloud alpha container bare-metal admin-clusters list diff --git a/gcloud/beta/container/bare-metal/admin-clusters/query-version-config b/gcloud/beta/container/bare-metal/admin-clusters/query-version-config index 4ba90446f..a22a929ca 100644 --- a/gcloud/beta/container/bare-metal/admin-clusters/query-version-config +++ b/gcloud/beta/container/bare-metal/admin-clusters/query-version-config @@ -81,8 +81,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 bare-metal admin-clusters query-version-config $ gcloud alpha container bare-metal admin-clusters \ query-version-config diff --git a/gcloud/beta/container/bare-metal/admin-clusters/unenroll b/gcloud/beta/container/bare-metal/admin-clusters/unenroll index 1bb10e487..d570c5d82 100644 --- a/gcloud/beta/container/bare-metal/admin-clusters/unenroll +++ b/gcloud/beta/container/bare-metal/admin-clusters/unenroll @@ -78,8 +78,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 bare-metal admin-clusters unenroll $ gcloud alpha container bare-metal admin-clusters unenroll diff --git a/gcloud/beta/container/bare-metal/admin-clusters/update b/gcloud/beta/container/bare-metal/admin-clusters/update index 6e67ea5d8..016fbfa4e 100644 --- a/gcloud/beta/container/bare-metal/admin-clusters/update +++ b/gcloud/beta/container/bare-metal/admin-clusters/update @@ -149,8 +149,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 bare-metal admin-clusters update $ gcloud alpha container bare-metal admin-clusters update diff --git a/gcloud/beta/container/bare-metal/clusters/create b/gcloud/beta/container/bare-metal/clusters/create index 0a3d58ad0..94f9a5b4d 100644 --- a/gcloud/beta/container/bare-metal/clusters/create +++ b/gcloud/beta/container/bare-metal/clusters/create @@ -510,8 +510,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 bare-metal clusters create $ gcloud alpha container bare-metal clusters create diff --git a/gcloud/beta/container/bare-metal/clusters/delete b/gcloud/beta/container/bare-metal/clusters/delete index 58399b026..a5eb9e504 100644 --- a/gcloud/beta/container/bare-metal/clusters/delete +++ b/gcloud/beta/container/bare-metal/clusters/delete @@ -77,8 +77,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 bare-metal clusters delete $ gcloud alpha container bare-metal clusters delete diff --git a/gcloud/beta/container/bare-metal/clusters/describe b/gcloud/beta/container/bare-metal/clusters/describe index aec42aed4..8e2eacb9d 100644 --- a/gcloud/beta/container/bare-metal/clusters/describe +++ b/gcloud/beta/container/bare-metal/clusters/describe @@ -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 container bare-metal clusters describe $ gcloud alpha container bare-metal clusters describe diff --git a/gcloud/beta/container/bare-metal/clusters/enroll b/gcloud/beta/container/bare-metal/clusters/enroll index ee2c77df4..37c50ec87 100644 --- a/gcloud/beta/container/bare-metal/clusters/enroll +++ b/gcloud/beta/container/bare-metal/clusters/enroll @@ -117,8 +117,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 bare-metal clusters enroll $ gcloud alpha container bare-metal clusters enroll diff --git a/gcloud/beta/container/bare-metal/clusters/help b/gcloud/beta/container/bare-metal/clusters/help index 02dff61b9..a63da2b13 100644 --- a/gcloud/beta/container/bare-metal/clusters/help +++ b/gcloud/beta/container/bare-metal/clusters/help @@ -39,8 +39,10 @@ COMMANDS (BETA) Update an Anthos cluster on bare metal. 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 bare-metal clusters $ gcloud alpha container bare-metal clusters diff --git a/gcloud/beta/container/bare-metal/clusters/list b/gcloud/beta/container/bare-metal/clusters/list index 8543687f7..0b9d0aa51 100644 --- a/gcloud/beta/container/bare-metal/clusters/list +++ b/gcloud/beta/container/bare-metal/clusters/list @@ -76,8 +76,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 bare-metal clusters list $ gcloud alpha container bare-metal clusters list diff --git a/gcloud/beta/container/bare-metal/clusters/query-version-config b/gcloud/beta/container/bare-metal/clusters/query-version-config index 7d1d0a993..2122eec53 100644 --- a/gcloud/beta/container/bare-metal/clusters/query-version-config +++ b/gcloud/beta/container/bare-metal/clusters/query-version-config @@ -144,8 +144,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 bare-metal clusters query-version-config $ gcloud alpha container bare-metal clusters query-version-config diff --git a/gcloud/beta/container/bare-metal/clusters/update b/gcloud/beta/container/bare-metal/clusters/update index b1a38677e..dd656f06b 100644 --- a/gcloud/beta/container/bare-metal/clusters/update +++ b/gcloud/beta/container/bare-metal/clusters/update @@ -353,8 +353,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 bare-metal clusters update $ gcloud alpha container bare-metal clusters update diff --git a/gcloud/beta/container/bare-metal/help b/gcloud/beta/container/bare-metal/help index f7eba6258..f546eb2fa 100644 --- a/gcloud/beta/container/bare-metal/help +++ b/gcloud/beta/container/bare-metal/help @@ -30,8 +30,10 @@ GROUPS (BETA) Manage Anthos on bare metal 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 container bare-metal $ gcloud alpha container bare-metal diff --git a/gcloud/beta/container/bare-metal/node-pools/create b/gcloud/beta/container/bare-metal/node-pools/create index bb44ae461..0ec9b5e17 100644 --- a/gcloud/beta/container/bare-metal/node-pools/create +++ b/gcloud/beta/container/bare-metal/node-pools/create @@ -115,8 +115,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 bare-metal node-pools create $ gcloud alpha container bare-metal node-pools create diff --git a/gcloud/beta/container/bare-metal/node-pools/delete b/gcloud/beta/container/bare-metal/node-pools/delete index 003eca5e5..f49ac3b97 100644 --- a/gcloud/beta/container/bare-metal/node-pools/delete +++ b/gcloud/beta/container/bare-metal/node-pools/delete @@ -82,8 +82,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 bare-metal node-pools delete $ gcloud alpha container bare-metal node-pools delete diff --git a/gcloud/beta/container/bare-metal/node-pools/describe b/gcloud/beta/container/bare-metal/node-pools/describe index 100b550ac..b83cfb5d9 100644 --- a/gcloud/beta/container/bare-metal/node-pools/describe +++ b/gcloud/beta/container/bare-metal/node-pools/describe @@ -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 container bare-metal node-pools describe $ gcloud alpha container bare-metal node-pools describe diff --git a/gcloud/beta/container/bare-metal/node-pools/enroll b/gcloud/beta/container/bare-metal/node-pools/enroll index 5a744968c..1fea6b882 100644 --- a/gcloud/beta/container/bare-metal/node-pools/enroll +++ b/gcloud/beta/container/bare-metal/node-pools/enroll @@ -74,8 +74,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 bare-metal node-pools enroll $ gcloud alpha container bare-metal node-pools enroll diff --git a/gcloud/beta/container/bare-metal/node-pools/help b/gcloud/beta/container/bare-metal/node-pools/help index c7087523b..daffe2b8f 100644 --- a/gcloud/beta/container/bare-metal/node-pools/help +++ b/gcloud/beta/container/bare-metal/node-pools/help @@ -35,8 +35,10 @@ COMMANDS (BETA) Update a node pool in an Anthos cluster on bare metal. 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 bare-metal node-pools $ gcloud alpha container bare-metal node-pools diff --git a/gcloud/beta/container/bare-metal/node-pools/list b/gcloud/beta/container/bare-metal/node-pools/list index 5af1f5cc0..9e3f0db3d 100644 --- a/gcloud/beta/container/bare-metal/node-pools/list +++ b/gcloud/beta/container/bare-metal/node-pools/list @@ -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 container bare-metal node-pools list $ gcloud alpha container bare-metal node-pools list diff --git a/gcloud/beta/container/bare-metal/node-pools/update b/gcloud/beta/container/bare-metal/node-pools/update index 7e526d3a2..e976da24f 100644 --- a/gcloud/beta/container/bare-metal/node-pools/update +++ b/gcloud/beta/container/bare-metal/node-pools/update @@ -120,8 +120,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 bare-metal node-pools update $ gcloud alpha container bare-metal node-pools update diff --git a/gcloud/beta/container/bare-metal/operations/describe b/gcloud/beta/container/bare-metal/operations/describe index d7717a359..9b1af7cc8 100644 --- a/gcloud/beta/container/bare-metal/operations/describe +++ b/gcloud/beta/container/bare-metal/operations/describe @@ -56,8 +56,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 bare-metal operations describe $ gcloud alpha container bare-metal operations describe diff --git a/gcloud/beta/container/bare-metal/operations/help b/gcloud/beta/container/bare-metal/operations/help index 2ea65e23f..1f83e32ec 100644 --- a/gcloud/beta/container/bare-metal/operations/help +++ b/gcloud/beta/container/bare-metal/operations/help @@ -26,8 +26,10 @@ COMMANDS (BETA) Poll an operation for completion. 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 bare-metal operations $ gcloud alpha container bare-metal operations diff --git a/gcloud/beta/container/bare-metal/operations/list b/gcloud/beta/container/bare-metal/operations/list index 1a71503fb..4a45d57b5 100644 --- a/gcloud/beta/container/bare-metal/operations/list +++ b/gcloud/beta/container/bare-metal/operations/list @@ -76,8 +76,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 bare-metal operations list $ gcloud alpha container bare-metal operations list diff --git a/gcloud/beta/container/bare-metal/operations/wait b/gcloud/beta/container/bare-metal/operations/wait index 42ae3f398..f8ce9196d 100644 --- a/gcloud/beta/container/bare-metal/operations/wait +++ b/gcloud/beta/container/bare-metal/operations/wait @@ -56,8 +56,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 bare-metal operations wait $ gcloud alpha container bare-metal operations wait diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 9b3d75fee..80cb6bc4a 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -159,10 +159,10 @@ FLAGS `latest`: Install the latest available driver version. Available only for nodes that use Container-Optimized OS. - `disabled`: Skip automatic driver installation. You must [manually install a - driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) - after you create the cluster. If you omit the flag `gpu-driver-version`, - this is the default option. + `disabled`: Skip automatic driver installation. You must manually install a + driver after you create the cluster. If you omit the flag `gpu-driver-version`, + this is the default option. To learn how to manually install the GPU driver, + refer to: https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers gpu-partition-size (Optional) The GPU partition size used when running multi-instance diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index 73e881a65..90b469bb2 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -110,10 +110,10 @@ FLAGS `latest`: Install the latest available driver version. Available only for nodes that use Container-Optimized OS. - `disabled`: Skip automatic driver installation. You must [manually install a - driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) - after you create the cluster. If you omit the flag `gpu-driver-version`, - this is the default option. + `disabled`: Skip automatic driver installation. You must manually install a + driver after you create the cluster. If you omit the flag `gpu-driver-version`, + this is the default option. To learn how to manually install the GPU driver, + refer to: https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers gpu-partition-size (Optional) The GPU partition size used when running multi-instance diff --git a/gcloud/beta/container/vmware/admin-clusters/describe b/gcloud/beta/container/vmware/admin-clusters/describe index 2f5ba8eba..2b8fd5114 100644 --- a/gcloud/beta/container/vmware/admin-clusters/describe +++ b/gcloud/beta/container/vmware/admin-clusters/describe @@ -58,8 +58,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 vmware admin-clusters describe $ gcloud alpha container vmware admin-clusters describe diff --git a/gcloud/beta/container/vmware/admin-clusters/enroll b/gcloud/beta/container/vmware/admin-clusters/enroll index e88dbf583..a11623e25 100644 --- a/gcloud/beta/container/vmware/admin-clusters/enroll +++ b/gcloud/beta/container/vmware/admin-clusters/enroll @@ -105,8 +105,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 vmware admin-clusters enroll $ gcloud alpha container vmware admin-clusters enroll diff --git a/gcloud/beta/container/vmware/admin-clusters/help b/gcloud/beta/container/vmware/admin-clusters/help index b5420a4fc..6ee1eb73c 100644 --- a/gcloud/beta/container/vmware/admin-clusters/help +++ b/gcloud/beta/container/vmware/admin-clusters/help @@ -32,8 +32,10 @@ COMMANDS (BETA) Update an Anthos on VMware admin cluster. 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 vmware admin-clusters $ gcloud alpha container vmware admin-clusters diff --git a/gcloud/beta/container/vmware/admin-clusters/list b/gcloud/beta/container/vmware/admin-clusters/list index ccc3470e3..645d83409 100644 --- a/gcloud/beta/container/vmware/admin-clusters/list +++ b/gcloud/beta/container/vmware/admin-clusters/list @@ -77,8 +77,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 vmware admin-clusters list $ gcloud alpha container vmware admin-clusters list diff --git a/gcloud/beta/container/vmware/admin-clusters/unenroll b/gcloud/beta/container/vmware/admin-clusters/unenroll index 7497d0698..cfb71612c 100644 --- a/gcloud/beta/container/vmware/admin-clusters/unenroll +++ b/gcloud/beta/container/vmware/admin-clusters/unenroll @@ -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 container vmware admin-clusters unenroll $ gcloud alpha container vmware admin-clusters unenroll diff --git a/gcloud/beta/container/vmware/admin-clusters/update b/gcloud/beta/container/vmware/admin-clusters/update index 1ebdb7e3f..7a68c6e52 100644 --- a/gcloud/beta/container/vmware/admin-clusters/update +++ b/gcloud/beta/container/vmware/admin-clusters/update @@ -70,8 +70,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 vmware admin-clusters update $ gcloud alpha container vmware admin-clusters update diff --git a/gcloud/beta/container/vmware/clusters/create b/gcloud/beta/container/vmware/clusters/create index 5dc1e3151..b475954a0 100644 --- a/gcloud/beta/container/vmware/clusters/create +++ b/gcloud/beta/container/vmware/clusters/create @@ -398,8 +398,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 vmware clusters create $ gcloud alpha container vmware clusters create diff --git a/gcloud/beta/container/vmware/clusters/delete b/gcloud/beta/container/vmware/clusters/delete index 230c862f8..730b915d6 100644 --- a/gcloud/beta/container/vmware/clusters/delete +++ b/gcloud/beta/container/vmware/clusters/delete @@ -77,8 +77,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 vmware clusters delete $ gcloud alpha container vmware clusters delete diff --git a/gcloud/beta/container/vmware/clusters/describe b/gcloud/beta/container/vmware/clusters/describe index 162aaf77c..4c701577e 100644 --- a/gcloud/beta/container/vmware/clusters/describe +++ b/gcloud/beta/container/vmware/clusters/describe @@ -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 container vmware clusters describe $ gcloud alpha container vmware clusters describe diff --git a/gcloud/beta/container/vmware/clusters/enroll b/gcloud/beta/container/vmware/clusters/enroll index 64471a706..b5cd56519 100644 --- a/gcloud/beta/container/vmware/clusters/enroll +++ b/gcloud/beta/container/vmware/clusters/enroll @@ -131,8 +131,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 vmware clusters enroll $ gcloud alpha container vmware clusters enroll diff --git a/gcloud/beta/container/vmware/clusters/help b/gcloud/beta/container/vmware/clusters/help index 87e2da3f5..ba4e1ca08 100644 --- a/gcloud/beta/container/vmware/clusters/help +++ b/gcloud/beta/container/vmware/clusters/help @@ -42,8 +42,10 @@ COMMANDS (BETA) Centrally upgrade an Anthos cluster on VMware. 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 vmware clusters $ gcloud alpha container vmware clusters diff --git a/gcloud/beta/container/vmware/clusters/list b/gcloud/beta/container/vmware/clusters/list index a70bb511a..b716f7908 100644 --- a/gcloud/beta/container/vmware/clusters/list +++ b/gcloud/beta/container/vmware/clusters/list @@ -75,8 +75,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 vmware clusters list $ gcloud alpha container vmware clusters list diff --git a/gcloud/beta/container/vmware/clusters/query-version-config b/gcloud/beta/container/vmware/clusters/query-version-config index 80ff5097d..79211eefb 100644 --- a/gcloud/beta/container/vmware/clusters/query-version-config +++ b/gcloud/beta/container/vmware/clusters/query-version-config @@ -131,8 +131,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 vmware clusters query-version-config $ gcloud alpha container vmware clusters query-version-config diff --git a/gcloud/beta/container/vmware/clusters/update b/gcloud/beta/container/vmware/clusters/update index 6841839e9..8e92166b6 100644 --- a/gcloud/beta/container/vmware/clusters/update +++ b/gcloud/beta/container/vmware/clusters/update @@ -209,8 +209,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 vmware clusters update $ gcloud alpha container vmware clusters update diff --git a/gcloud/beta/container/vmware/clusters/upgrade b/gcloud/beta/container/vmware/clusters/upgrade index abec46efd..a9dd0edc9 100644 --- a/gcloud/beta/container/vmware/clusters/upgrade +++ b/gcloud/beta/container/vmware/clusters/upgrade @@ -61,8 +61,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 vmware clusters upgrade $ gcloud alpha container vmware clusters upgrade diff --git a/gcloud/beta/container/vmware/help b/gcloud/beta/container/vmware/help index 9f28065f2..270760331 100644 --- a/gcloud/beta/container/vmware/help +++ b/gcloud/beta/container/vmware/help @@ -29,8 +29,10 @@ GROUPS (BETA) Manage Anthos on VMware 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 container vmware $ gcloud alpha container vmware diff --git a/gcloud/beta/container/vmware/node-pools/create b/gcloud/beta/container/vmware/node-pools/create index 81a150e35..c9b973b54 100644 --- a/gcloud/beta/container/vmware/node-pools/create +++ b/gcloud/beta/container/vmware/node-pools/create @@ -146,8 +146,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 vmware node-pools create $ gcloud alpha container vmware node-pools create diff --git a/gcloud/beta/container/vmware/node-pools/delete b/gcloud/beta/container/vmware/node-pools/delete index 4ca9f8f48..008b91478 100644 --- a/gcloud/beta/container/vmware/node-pools/delete +++ b/gcloud/beta/container/vmware/node-pools/delete @@ -82,8 +82,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 vmware node-pools delete $ gcloud alpha container vmware node-pools delete diff --git a/gcloud/beta/container/vmware/node-pools/describe b/gcloud/beta/container/vmware/node-pools/describe index 3c3723896..73237c66a 100644 --- a/gcloud/beta/container/vmware/node-pools/describe +++ b/gcloud/beta/container/vmware/node-pools/describe @@ -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 container vmware node-pools describe $ gcloud alpha container vmware node-pools describe diff --git a/gcloud/beta/container/vmware/node-pools/enroll b/gcloud/beta/container/vmware/node-pools/enroll index a85ee844f..7dbba38f9 100644 --- a/gcloud/beta/container/vmware/node-pools/enroll +++ b/gcloud/beta/container/vmware/node-pools/enroll @@ -70,8 +70,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 vmware node-pools enroll $ gcloud alpha container vmware node-pools enroll diff --git a/gcloud/beta/container/vmware/node-pools/help b/gcloud/beta/container/vmware/node-pools/help index 30b02d43a..3e1feb39d 100644 --- a/gcloud/beta/container/vmware/node-pools/help +++ b/gcloud/beta/container/vmware/node-pools/help @@ -35,8 +35,10 @@ COMMANDS (BETA) Update a node pool in an Anthos cluster on VMware. 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 vmware node-pools $ gcloud alpha container vmware node-pools diff --git a/gcloud/beta/container/vmware/node-pools/list b/gcloud/beta/container/vmware/node-pools/list index 1c6764737..4f73c0eb5 100644 --- a/gcloud/beta/container/vmware/node-pools/list +++ b/gcloud/beta/container/vmware/node-pools/list @@ -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 container vmware node-pools list $ gcloud alpha container vmware node-pools list diff --git a/gcloud/beta/container/vmware/node-pools/update b/gcloud/beta/container/vmware/node-pools/update index b2e1bc08c..a6ea5b179 100644 --- a/gcloud/beta/container/vmware/node-pools/update +++ b/gcloud/beta/container/vmware/node-pools/update @@ -136,8 +136,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 vmware node-pools update $ gcloud alpha container vmware node-pools update diff --git a/gcloud/beta/container/vmware/operations/describe b/gcloud/beta/container/vmware/operations/describe index 6e829e165..9424204ad 100644 --- a/gcloud/beta/container/vmware/operations/describe +++ b/gcloud/beta/container/vmware/operations/describe @@ -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 container vmware operations describe $ gcloud alpha container vmware operations describe diff --git a/gcloud/beta/container/vmware/operations/help b/gcloud/beta/container/vmware/operations/help index a5025ba2c..5abb10f9f 100644 --- a/gcloud/beta/container/vmware/operations/help +++ b/gcloud/beta/container/vmware/operations/help @@ -26,8 +26,10 @@ COMMANDS (BETA) Poll an operation for completion. 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 vmware operations $ gcloud alpha container vmware operations diff --git a/gcloud/beta/container/vmware/operations/list b/gcloud/beta/container/vmware/operations/list index 9b11bcc75..3b1e49174 100644 --- a/gcloud/beta/container/vmware/operations/list +++ b/gcloud/beta/container/vmware/operations/list @@ -75,8 +75,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 vmware operations list $ gcloud alpha container vmware operations list diff --git a/gcloud/beta/container/vmware/operations/wait b/gcloud/beta/container/vmware/operations/wait index b89b9cb37..17bc4810c 100644 --- a/gcloud/beta/container/vmware/operations/wait +++ b/gcloud/beta/container/vmware/operations/wait @@ -56,8 +56,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 vmware operations wait $ gcloud alpha container vmware operations wait diff --git a/gcloud/beta/dataproc/sessions/create/help b/gcloud/beta/dataproc/sessions/create/help index 4157a3c0b..e3542867f 100644 --- a/gcloud/beta/dataproc/sessions/create/help +++ b/gcloud/beta/dataproc/sessions/create/help @@ -10,7 +10,7 @@ SYNOPSIS [--property=[PROPERTY=VALUE,...]] [--request-id=REQUEST_ID] [--service-account=SERVICE_ACCOUNT] [--session_template=SESSION_TEMPLATE] [--staging-bucket=STAGING_BUCKET] - [--tags=[TAGS,...]] [--ttl=TTL] [--user=USER] [--version=VERSION] + [--tags=[TAGS,...]] [--ttl=TTL] [--version=VERSION] [--network=NETWORK | --subnet=SUBNET] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -102,10 +102,6 @@ FLAGS (https://cloud.google.com/sdk/gcloud/reference/topic/datetimes) for information on duration formats. - --user=USER - The email address of the user who owns the session. The session will be - authenticated as this user if credentials injection is enabled. - --version=VERSION Optional runtime version. If not specified, a default version will be used. diff --git a/gcloud/beta/dataproc/sessions/create/spark b/gcloud/beta/dataproc/sessions/create/spark index 7d700bdc7..88990428c 100644 --- a/gcloud/beta/dataproc/sessions/create/spark +++ b/gcloud/beta/dataproc/sessions/create/spark @@ -10,7 +10,7 @@ SYNOPSIS [--property=[PROPERTY=VALUE,...]] [--request-id=REQUEST_ID] [--service-account=SERVICE_ACCOUNT] [--session_template=SESSION_TEMPLATE] [--staging-bucket=STAGING_BUCKET] - [--tags=[TAGS,...]] [--ttl=TTL] [--user=USER] [--version=VERSION] + [--tags=[TAGS,...]] [--ttl=TTL] [--version=VERSION] [--network=NETWORK | --subnet=SUBNET] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -137,10 +137,6 @@ FLAGS (https://cloud.google.com/sdk/gcloud/reference/topic/datetimes) for information on duration formats. - --user=USER - The email address of the user who owns the session. The session will be - authenticated as this user if credentials injection is enabled. - --version=VERSION Optional runtime version. If not specified, a default version will be used. diff --git a/gcloud/beta/healthcare/hl7v2-stores/create b/gcloud/beta/healthcare/hl7v2-stores/create index 593316e80..b34f9c139 100644 --- a/gcloud/beta/healthcare/hl7v2-stores/create +++ b/gcloud/beta/healthcare/hl7v2-stores/create @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta healthcare hl7v2-stores create (HL7V2_STORE : --dataset=DATASET --location=LOCATION) - [--pubsub-topic=PUBSUB_TOPIC] [GCLOUD_WIDE_FLAG ...] + [--parser-version=PARSER_VERSION] [--pubsub-topic=PUBSUB_TOPIC] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a Cloud Healthcare API HL7v2 store. @@ -65,6 +66,32 @@ POSITIONAL ARGUMENTS ▸ set the property healthcare/location. FLAGS + --parser-version=PARSER_VERSION + Immutable. Determines the version of both the default parser to be used + when schema + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig.FIELDS.schema) + is not given, as well as the schematized parser used when schema + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig.FIELDS.schema) + is specified. This field is immutable after HL7v2 store creation. + PARSER_VERSION must be one of: + + v1 + The parsedData includes every given non-empty message field except + the Field Separator (MSH-1) field. As a result, the parsed MSH + segment starts with the MSH-2 field and the field numbers are + off-by-one with respect to the HL7 standard. + v2 + The parsedData includes every given non-empty message field. + + v3 + This version is the same as V2, with the following change. The + parsedData contains unescaped escaped field separators, component + separators, sub-component separators, repetition separators, escape + characters, and truncation characters. If schema + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig.FIELDS.schema) + is specified, the schematized parser uses improved parsing + heuristics compared to previous versions. + --pubsub-topic=PUBSUB_TOPIC A Google Cloud Pub/Sub topic name for notifications. diff --git a/gcloud/beta/netapp/volumes/create b/gcloud/beta/netapp/volumes/create index 1fb745ad9..8bb0ee0b4 100644 --- a/gcloud/beta/netapp/volumes/create +++ b/gcloud/beta/netapp/volumes/create @@ -90,10 +90,8 @@ REQUIRED FLAGS unit is specified, GiB is assumed. --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files VolumeValid - component values are: NFSV3, NFSV4, SMB - - For more information, look athttps://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#protocols. + Type of File System protocols for the Cloud NetApp Files Volume. Valid + component values are: NFSV3, NFSV4, SMB. --share-name=SHARE_NAME Share name of the Mount path clients will use. @@ -156,11 +154,8 @@ OPTIONAL FLAGS numbers. --restricted-actions=RESTRICTED_ACTION,[...] - Actions to be restricted for a volume.Valid restricted action options - are: 'DELETE' - - For more information, look at - https://cloud.google.com/netapp/volumes/docs/reference/rest/v1/projects.locations.volumes#restrictedaction. + Actions to be restricted for a volume. Valid restricted action options + are: 'DELETE'. --security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED" The security style of the Volume. This can either be UNIX or NTFS. @@ -173,13 +168,11 @@ OPTIONAL FLAGS UNIX security style for Volume --smb-settings=SMB_SETTING,[SMB_SETTING,...] - List of settings specific to SMB protocolfor a Cloud NetApp Files - VolumeValid component values are: ENCRYPT_DATA, BROWSABLE, + List of settings specific to SMB protocol for a Cloud NetApp Files + Volume. Valid component values are: ENCRYPT_DATA, BROWSABLE, CHANGE_NOTIFY, NON_BROWSABLE, OPLOCKS, SHOW_SNAPSHOT, SHOW_PREVIOUS_VERSIONS, ACCESS_BASED_ENUMERATION, - CONTINUOUSLY_AVAILABLE - - For more information, look at https://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#smbsettings. + CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE The percentage of volume storage reserved for snapshot storage. The @@ -230,7 +223,7 @@ OPTIONAL FLAGS ▸ provide the argument --source-snapshot on the command line. --unix-permissions=UNIX_PERMISSIONS - Unix permissions the mount point will be created with.Unix permissions + Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only GCLOUD WIDE FLAGS diff --git a/gcloud/beta/netapp/volumes/update b/gcloud/beta/netapp/volumes/update index 5ade21f2a..05c0f2ccb 100644 --- a/gcloud/beta/netapp/volumes/update +++ b/gcloud/beta/netapp/volumes/update @@ -104,17 +104,12 @@ FLAGS kerberos-5p-read-write=KERBEROS_5P_READ_WRITE --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files VolumeValid - component values are: NFSV3, NFSV4, SMB - - For more information, look athttps://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#protocols. + Type of File System protocols for the Cloud NetApp Files Volume. Valid + component values are: NFSV3, NFSV4, SMB. --restricted-actions=RESTRICTED_ACTION,[...] - Actions to be restricted for a volume.Valid restricted action options - are: 'DELETE' - - For more information, look at - https://cloud.google.com/netapp/volumes/docs/reference/rest/v1/projects.locations.volumes#restrictedaction. + Actions to be restricted for a volume. Valid restricted action options + are: 'DELETE'. --security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED" The security style of the Volume. This can either be UNIX or NTFS. @@ -130,13 +125,11 @@ FLAGS Share name of the Mount path clients will use. --smb-settings=SMB_SETTING,[SMB_SETTING,...] - List of settings specific to SMB protocolfor a Cloud NetApp Files - VolumeValid component values are: ENCRYPT_DATA, BROWSABLE, + List of settings specific to SMB protocol for a Cloud NetApp Files + Volume. Valid component values are: ENCRYPT_DATA, BROWSABLE, CHANGE_NOTIFY, NON_BROWSABLE, OPLOCKS, SHOW_SNAPSHOT, SHOW_PREVIOUS_VERSIONS, ACCESS_BASED_ENUMERATION, - CONTINUOUSLY_AVAILABLE - - For more information, look at https://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#smbsettings. + CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE The percentage of volume storage reserved for snapshot storage. The @@ -211,7 +204,7 @@ FLAGS ▸ provide the argument --storage-pool on the command line. --unix-permissions=UNIX_PERMISSIONS - Unix permissions the mount point will be created with.Unix permissions + Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only --update-labels=[KEY=VALUE,...] diff --git a/gcloud/beta/network-security/firewall-endpoints/create b/gcloud/beta/network-security/firewall-endpoints/create index 45d87bcca..0ce491316 100644 --- a/gcloud/beta/network-security/firewall-endpoints/create +++ b/gcloud/beta/network-security/firewall-endpoints/create @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud beta network-security firewall-endpoints create (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async] - [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="60m"] - [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a firewall endpoint. Successful creation of an endpoint @@ -60,6 +60,9 @@ FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/network-security/firewall-endpoints/update b/gcloud/beta/network-security/firewall-endpoints/update index 3d6deb492..f24ee394e 100644 --- a/gcloud/beta/network-security/firewall-endpoints/update +++ b/gcloud/beta/network-security/firewall-endpoints/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta network-security firewall-endpoints update (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async] - [--max-wait=MAX_WAIT; default="60m"] [--update-labels=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--max-wait=MAX_WAIT; default="60m"] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -71,6 +72,9 @@ FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --max-wait=MAX_WAIT; default="60m" Time to synchronously wait for the operation to complete, after which the operation continues asynchronously. Ignored if --no-async isn't diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 664b53ca0..bea18e616 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -445,14 +445,14 @@ FLAGS unlimited. --allowed-psc-projects=PROJECT,[PROJECT,...] - A comma-separated list of projects. Each project in this list may be - represented by a project number (numeric) or by a project id - (alphanumeric). This will allow PSC connections to be established from - specified consumer projects. This can be set only when PSC is enabled. + A comma-separated list of projects. Each project in this list might be + represented by a project number (numeric) or by a project ID + (alphanumeric). This allows Private Service Connect connections to be + established from specified consumer projects. --enable-private-service-connect - When the flag is set, a Cloud SQL instance will be created with PSC - enabled. + When the flag is set, a Cloud SQL instance will be created with Private + Service Connect enabled. Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the instance. The 'Compute Engine Service Agent' diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index aba27717a..84d6c0dd0 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -378,15 +378,15 @@ FLAGS At most one of these can be specified: --allowed-psc-projects=PROJECT,[PROJECT,...] - A comma-separated list of projects. Each project in this list may be - represented by a project number (numeric) or by a project id - (alphanumeric). This will allow PSC connections to be established - from specified consumer projects. This can be set only when PSC is - enabled. + A comma-separated list of projects. Each project in this list might + be represented by a project number (numeric) or by a project ID + (alphanumeric). This allows Private Service Connect connections to be + established from specified consumer projects. --clear-allowed-psc-projects - This will clear the project allowlist of PSC, disallowing all - projects from creating new PSC bindings to the instance. + This will clear the project allowlist of Private Service Connect, + disallowing all projects from creating new Private Service Connect + bindings to the instance. At most one of these can be specified: diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index d572dc14e..446afefff 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -19,7 +19,7 @@ SYNOPSIS [--pd-disk-size=PD_DISK_SIZE; default=200] [--pd-disk-type=PD_DISK_TYPE; default="pd-standard"] [--pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"] - [--pool-size=POOL_SIZE] + [--pool-size=POOL_SIZE] [--replica-zones=[REPLICA_ZONES,...]] [--running-timeout=RUNNING_TIMEOUT; default=7200] [--service-account=SERVICE_ACCOUNT] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] @@ -191,6 +191,16 @@ FLAGS --pool-size=POOL_SIZE Number of instances to pool for faster Workstation starup. + --replica-zones=[REPLICA_ZONES,...] + Specifies the zones the VM and disk resources will be replicated within + the region. If set, exactly two zones within the workstation cluster's + region must be specified. + + Example: + + $ gcloud beta workstations configs create \ + --replica-zones=us-central1-a,us-central1-f + --running-timeout=RUNNING_TIMEOUT; default=7200 How long (in seconds) to wait before automatically stopping a workstation after it started. A value of 0 indicates that workstations diff --git a/gcloud/compute/security-policies/rules/create b/gcloud/compute/security-policies/rules/create index c8d6f3401..02f1514d1 100644 --- a/gcloud/compute/security-policies/rules/create +++ b/gcloud/compute/security-policies/rules/create @@ -57,7 +57,7 @@ REQUIRED FLAGS response status code of 404. deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP - response status code of 503. + response status code of 502. rate-based-ban Enforces rate-based ban action from HTTP(S) Load Balancing, based on rate limit options. diff --git a/gcloud/compute/security-policies/rules/update b/gcloud/compute/security-policies/rules/update index 1cf399698..3945df14e 100644 --- a/gcloud/compute/security-policies/rules/update +++ b/gcloud/compute/security-policies/rules/update @@ -58,7 +58,7 @@ FLAGS response status code of 404. deny-502 Denies the request from HTTP(S) Load Balancing, with an HTTP - response status code of 503. + response status code of 502. rate-based-ban Enforces rate-based ban action from HTTP(S) Load Balancing, based on rate limit options. diff --git a/gcloud/container/bare-metal/admin-clusters/create b/gcloud/container/bare-metal/admin-clusters/create new file mode 100644 index 000000000..8420d4427 --- /dev/null +++ b/gcloud/container/bare-metal/admin-clusters/create @@ -0,0 +1,262 @@ +NAME + gcloud container bare-metal admin-clusters create - create an Anthos on + bare metal admin cluster + +SYNOPSIS + gcloud container bare-metal admin-clusters create + (ADMIN_CLUSTER : --location=LOCATION) --version=VERSION + (--control-plane-load-balancer-port=CONTROL_PLANE_LOAD_BALANCER_PORT + --control-plane-vip=CONTROL_PLANE_VIP : --enable-manual-lb) + ((((--control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + : --control-plane-node-labels=[KEY=VALUE,...] + --control-plane-node-taints=[KEY=VALUE:EFFECT,...]))) + : --api-server-args=[KEY=VALUE,...]) + (--island-mode-pod-address-cidr-blocks=POD_ADDRESS,[POD_ADDRESS,...] + --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...]) + ((--lvp-node-mounts-config-path=LVP_NODE_MOUNTS_CONFIG_PATH + --lvp-node-mounts-config-storage-class=LVP_NODE_MOUNTS_CONFIG_STORAGE_CLASS) ((--lvp-share-path=LVP_SHARE_PATH --lvp-share-storage-class=LVP_SHARE_STORAGE_CLASS) : --shared-path-pv-count=SHARED_PATH_PV_COUNT)) + [--admin-users=ADMIN_USERS] [--annotations=[KEY=VALUE,...]] [--async] + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] + [--description=DESCRIPTION] [--enable-application-logs] + [--login-user=LOGIN_USER] + [--maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS, + ...]] [--max-pods-per-node=MAX_PODS_PER_NODE] [--validate-only] + [--uri=URI : --no-proxy=[NO_PROXY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an Anthos on bare metal admin cluster. + +EXAMPLES + To create a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container bare-metal admin-clusters create my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Admin cluster resource - admin cluster 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 admin_cluster 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. + + ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ▸ provide the argument admin_cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the admin_cluster. + + To set the location attribute: + ▸ provide the argument admin_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +REQUIRED FLAGS + --version=VERSION + Anthos cluster on bare metal version for the admin cluster resource. + + Anthos on bare metal admin cluster load balancer configuration. + + This must be specified. + + Control plane load balancer port configuration. + + This must be specified. + + --control-plane-load-balancer-port=CONTROL_PLANE_LOAD_BALANCER_PORT + Control plane load balancer port configuration. + + VIPs used by the load balancer. + + This must be specified. + + --control-plane-vip=CONTROL_PLANE_VIP + VIP for the Kubernetes API of this cluster. + + Manual load balancer configuration. + + --enable-manual-lb + ManualLB typed load balancers configuration. + + Anthos on bare metal cluster control plane configuration. + + At least one of these must be specified: + + --api-server-args=[KEY=VALUE,...] + API Server argument configuration. + + Anthos on bare metal cluster control plane node pool configuration. + + This must be specified. + + Anthos on bare metal node pool configuration for control plane nodes. + + This must be specified. + + Anthos on bare metal node configuration for control plane nodes. + + This must be specified. + + Populate control plane node config. + + Exactly one of these must be specified: + + --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + Control plane node configuration. + + --control-plane-node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a node pool. + + --control-plane-node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every Kubernetes node in a node pool. + + Populate one of the network configs. + + This must be specified. + + Island mode CIDR network configuration. + + --island-mode-pod-address-cidr-blocks=POD_ADDRESS,[POD_ADDRESS,...] + IPv4 address range for all pods in the cluster. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] + IPv4 address range for all services in the cluster. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Anthos on bare metal cluster storage configuration. + + This must be specified. + + LVP node mounts class and path used by the storage. + + This must be specified. + + --lvp-node-mounts-config-path=LVP_NODE_MOUNTS_CONFIG_PATH + Path for the LVP node mounts class. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --lvp-node-mounts-config-storage-class=LVP_NODE_MOUNTS_CONFIG_STORAGE_CLASS + Storage class for LVP node mounts. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + LVP share configuration. + + At least one of these must be specified: + + --shared-path-pv-count=SHARED_PATH_PV_COUNT + Number of subdirectories to create under path. + + LVP share class and path used by the storage. + + This must be specified. + + --lvp-share-path=LVP_SHARE_PATH + Path for the LVP share class. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --lvp-share-storage-class=LVP_SHARE_STORAGE_CLASS + Storage class for LVP share. + + This flag argument must be specified if any of the other + arguments in this group are specified. + +OPTIONAL FLAGS + Anthos on bare metal admin cluster security configuration. + + Admin cluster authorization configurations + + --admin-users=ADMIN_USERS + Users that will be granted the view role on the admin cluster, + providing view only access to the cluster. + + --annotations=[KEY=VALUE,...] + Annotations on the Anthos on bare metal resource. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Set Binary Authorization evaluation mode for this cluster. + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, + PROJECT_SINGLETON_POLICY_ENFORCE. + + --description=DESCRIPTION + Description for the resource. + + Anthos on bare metal cluster operations configuration. + + --enable-application-logs + Whether collection of application logs/metrics should be enabled (in + addition to system logs/metrics). + + Anthos on bare metal node access related settings for the admin cluster. + + --login-user=LOGIN_USER + User name used to access node machines. + + Anthos on bare metal cluster maintenance configuration. + + --maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS,...] + IPv4 addresses to be placed into maintenance mode. + + Anthos on bare metal admin cluster workload node configuration. + + --max-pods-per-node=MAX_PODS_PER_NODE + Maximum number of pods a node can run. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + + Anthos on bare metal cluster proxy configuration. + + --uri=URI + Address of the proxy server. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --no-proxy=[NO_PROXY,...] + List of IPs, hostnames, and domains that should skip the proxy. + +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 bare-metal admin-clusters create + + $ gcloud beta container bare-metal admin-clusters create + diff --git a/gcloud/container/bare-metal/admin-clusters/describe b/gcloud/container/bare-metal/admin-clusters/describe new file mode 100644 index 000000000..572684f81 --- /dev/null +++ b/gcloud/container/bare-metal/admin-clusters/describe @@ -0,0 +1,66 @@ +NAME + gcloud container bare-metal admin-clusters describe - describe an Anthos on + bare metal admin cluster + +SYNOPSIS + gcloud container bare-metal admin-clusters describe + (ADMIN_CLUSTER : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an Anthos on bare metal admin cluster. + +EXAMPLES + To describe an admin cluster named my-cluster managed in location us-west1, + run: + + $ gcloud container bare-metal admin-clusters describe my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Admin cluster resource - admin cluster 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 admin_cluster 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. + + ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ▸ provide the argument admin_cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the admin_cluster. + + To set the location attribute: + ▸ provide the argument admin_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/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. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal admin-clusters describe + + $ gcloud beta container bare-metal admin-clusters describe + diff --git a/gcloud/container/bare-metal/admin-clusters/enroll b/gcloud/container/bare-metal/admin-clusters/enroll new file mode 100644 index 000000000..7d328367a --- /dev/null +++ b/gcloud/container/bare-metal/admin-clusters/enroll @@ -0,0 +1,113 @@ +NAME + gcloud container bare-metal admin-clusters enroll - enroll an Anthos on + bare metal admin cluster + +SYNOPSIS + gcloud container bare-metal admin-clusters enroll + (ADMIN_CLUSTER : --location=LOCATION) + (--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global") + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Enroll an Anthos on bare metal admin cluster. + +EXAMPLES + To enroll a cluster named my-cluster managed in location us-west1 with + admin cluster membership of + projects/my-project/locations/us-west1/memberships/my-admin-cluster-membership, + run: + + $ gcloud container bare-metal admin-clusters enroll my-cluster \ + --location=us-west1 \ + --admin-cluster-membership=projects/my-project/locations/\ + us-west1/memberships/my-admin-cluster-membership + +POSITIONAL ARGUMENTS + Admin cluster resource - admin cluster to enroll 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 admin_cluster 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. + + ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ▸ provide the argument admin_cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the admin_cluster. + + To set the location attribute: + ▸ provide the argument admin_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +REQUIRED FLAGS + Admin cluster membership resource - membership of the admin cluster. + Membership can be the membership ID or the full resource name. 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 --admin-cluster-membership 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. + + --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + ID of the admin_cluster_membership or fully qualified identifier for + the admin_cluster_membership. + + To set the admin_cluster_membership attribute: + ▸ provide the argument --admin-cluster-membership on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" + Google Cloud location for the admin_cluster_membership. + + To set the location attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-location 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 + These variants are also available: + + $ gcloud alpha container bare-metal admin-clusters enroll + + $ gcloud beta container bare-metal admin-clusters enroll + diff --git a/gcloud/container/bare-metal/admin-clusters/help b/gcloud/container/bare-metal/admin-clusters/help new file mode 100644 index 000000000..6c9894f5a --- /dev/null +++ b/gcloud/container/bare-metal/admin-clusters/help @@ -0,0 +1,48 @@ +NAME + gcloud container bare-metal admin-clusters - create and manage admin + clusters in Anthos on bare metal + +SYNOPSIS + gcloud container bare-metal admin-clusters COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage admin clusters in Anthos on bare metal. + +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 an Anthos on bare metal admin cluster. + + describe + Describe an Anthos on bare metal admin cluster. + + enroll + Enroll an Anthos on bare metal admin cluster. + + list + List Anthos on bare metal admin clusters. + + query-version-config + Query versions for creating or upgrading an Anthos on bare metal admin + cluster. + + unenroll + Unenroll an Anthos on bare metal admin cluster so that it is no longer + managed by the Anthos On-Prem API. + + update + Update an Anthos on bare metal admin cluster. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal admin-clusters + + $ gcloud beta container bare-metal admin-clusters + diff --git a/gcloud/container/bare-metal/admin-clusters/list b/gcloud/container/bare-metal/admin-clusters/list new file mode 100644 index 000000000..cb27076f6 --- /dev/null +++ b/gcloud/container/bare-metal/admin-clusters/list @@ -0,0 +1,84 @@ +NAME + gcloud container bare-metal admin-clusters list - list Anthos on bare metal + admin clusters + +SYNOPSIS + gcloud container bare-metal admin-clusters list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Anthos on bare metal admin clusters. + +EXAMPLES + To list all admin clusters managed in location us-west1, run: + + $ gcloud container bare-metal admin-clusters list --location=us-west1 + +FLAGS + Location resource - Google Cloud location to list Anthos on bare metal + admin clusters. 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 container_bare_metal/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 container_bare_metal/location. + +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 container bare-metal admin-clusters list + + $ gcloud beta container bare-metal admin-clusters list + diff --git a/gcloud/container/bare-metal/admin-clusters/query-version-config b/gcloud/container/bare-metal/admin-clusters/query-version-config new file mode 100644 index 000000000..ceb031444 --- /dev/null +++ b/gcloud/container/bare-metal/admin-clusters/query-version-config @@ -0,0 +1,90 @@ +NAME + gcloud container bare-metal admin-clusters query-version-config - query + versions for creating or upgrading an Anthos on bare metal admin + cluster + +SYNOPSIS + gcloud container bare-metal admin-clusters query-version-config + [--admin-cluster=ADMIN_CLUSTER] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Query versions for creating or upgrading an Anthos on bare metal admin + cluster. + +EXAMPLES + To query versions for creating an admin cluster in location us-west1, run: + + $ gcloud container bare-metal admin-clusters query-version-config \ + --location=us-west1 + + To query versions for upgrading an admin cluster named my-admin-cluster in + location us-west1, run: + + $ gcloud container bare-metal admin-clusters query-version-config \ + --location=us-west1 --admin-cluster=my-admin-cluster + +FLAGS + Use cases for querying versions. + + Upgrade an Anthos on bare metal admin cluster use case. + + Admin cluster resource - Admin cluster to query versions for upgrade. + 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 --admin-cluster 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 --admin-cluster on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property container_bare_metal/location. + + --admin-cluster=ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ◇ provide the argument --admin-cluster on the command line. + + Location resource - Google Cloud location to query versions. 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 container_bare_metal/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 container_bare_metal/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. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal admin-clusters \ + query-version-config + + $ gcloud beta container bare-metal admin-clusters \ + query-version-config + diff --git a/gcloud/container/bare-metal/admin-clusters/unenroll b/gcloud/container/bare-metal/admin-clusters/unenroll new file mode 100644 index 000000000..69908b2de --- /dev/null +++ b/gcloud/container/bare-metal/admin-clusters/unenroll @@ -0,0 +1,86 @@ +NAME + gcloud container bare-metal admin-clusters unenroll - unenroll an Anthos on + bare metal admin cluster so that it is no longer managed by the Anthos + On-Prem API + +SYNOPSIS + gcloud container bare-metal admin-clusters unenroll + (ADMIN_CLUSTER : --location=LOCATION) [--allow-missing] [--async] + [--ignore-errors] [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Unenroll an Anthos on bare metal admin cluster so that it is no longer + managed by the Anthos On-Prem API. + +EXAMPLES + To unenroll an admin cluster named my-cluster managed in location us-west1, + run: + + $ gcloud container bare-metal admin-clusters unenroll my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Admin cluster resource - admin cluster to unenroll 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 admin_cluster 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. + + ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ▸ provide the argument admin_cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the admin_cluster. + + To set the location attribute: + ▸ provide the argument admin_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +FLAGS + --allow-missing + If set, and the Bare Metal cluster is not found, the request will + succeed but no action will be taken. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --ignore-errors + If set, the unenrollment of a bare metal admin cluster resource will + succeed even if errors occur during unenrollment. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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 bare-metal admin-clusters unenroll + + $ gcloud beta container bare-metal admin-clusters unenroll + diff --git a/gcloud/container/bare-metal/admin-clusters/update b/gcloud/container/bare-metal/admin-clusters/update new file mode 100644 index 000000000..0394ac1b1 --- /dev/null +++ b/gcloud/container/bare-metal/admin-clusters/update @@ -0,0 +1,157 @@ +NAME + gcloud container bare-metal admin-clusters update - update an Anthos on + bare metal admin cluster + +SYNOPSIS + gcloud container bare-metal admin-clusters update + (ADMIN_CLUSTER : --location=LOCATION) [--async] + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] + [--description=DESCRIPTION] [--enable-application-logs] + [--island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...]] + [--login-user=LOGIN_USER] + [--maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS, + ...]] [--max-pods-per-node=MAX_PODS_PER_NODE] [--validate-only] + [--version=VERSION] + [--api-server-args=[KEY=VALUE,...] + --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + --control-plane-node-labels=[KEY=VALUE,...] + --control-plane-node-taints=[KEY=VALUE:EFFECT,...]] + [--no-proxy=[NO_PROXY,...] --uri=URI] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update an Anthos on bare metal admin cluster. + +EXAMPLES + To update a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container bare-metal admin-clusters update my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Admin cluster resource - admin cluster 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 admin_cluster 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. + + ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ▸ provide the argument admin_cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the admin_cluster. + + To set the location attribute: + ▸ provide the argument admin_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Set Binary Authorization evaluation mode for this cluster. + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, + PROJECT_SINGLETON_POLICY_ENFORCE. + + --description=DESCRIPTION + Description for the resource. + + Anthos on bare metal cluster operations configuration. + + --enable-application-logs + Whether collection of application logs/metrics should be enabled (in + addition to system logs/metrics). + + Populate one of the network configs. + + Island mode CIDR network configuration. + + --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] + IPv4 address range for all services in the cluster. + + Anthos on bare metal node access related settings for the admin cluster. + + --login-user=LOGIN_USER + User name used to access node machines. + + Anthos on bare metal cluster maintenance configuration. + + --maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS,...] + IPv4 addresses to be placed into maintenance mode. + + Anthos on bare metal admin cluster workload node configuration. + + --max-pods-per-node=MAX_PODS_PER_NODE + Maximum number of pods a node can run. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + + --version=VERSION + Anthos cluster on bare metal version for the admin cluster resource. + + Anthos on bare metal cluster control plane configuration. + + --api-server-args=[KEY=VALUE,...] + API Server argument configuration. + + Anthos on bare metal cluster control plane node pool configuration. + + Anthos on bare metal node pool configuration for control plane nodes. + + Anthos on bare metal node configuration for control plane nodes. + + Populate control plane node config. + + At most one of these can be specified: + + --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + Control plane node configuration. + + --control-plane-node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a node pool. + + --control-plane-node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every Kubernetes node in a node pool. + + Anthos on bare metal cluster proxy configuration. + + --no-proxy=[NO_PROXY,...] + List of IPs, hostnames, and domains that should skip the proxy. + + --uri=URI + Address of the proxy server. + +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 bare-metal admin-clusters update + + $ gcloud beta container bare-metal admin-clusters update + diff --git a/gcloud/container/bare-metal/clusters/create b/gcloud/container/bare-metal/clusters/create new file mode 100644 index 000000000..59fbc2279 --- /dev/null +++ b/gcloud/container/bare-metal/clusters/create @@ -0,0 +1,518 @@ +NAME + gcloud container bare-metal clusters create - create an Anthos cluster on + bare metal + +SYNOPSIS + gcloud container bare-metal clusters create (CLUSTER : --location=LOCATION) + --version=VERSION + (--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT) + (--control-plane-load-balancer-port=CONTROL_PLANE_LOAD_BALANCER_PORT + (--control-plane-vip=CONTROL_PLANE_VIP + --ingress-vip=INGRESS_VIP) (--enable-manual-lb + | [--bgp-address-pools=[addresses=ADDRESSES], + [avoid-buggy-ips=AVOID-BUGGY-IPS], + [manual-assign=MANUAL-ASSIGN],[pool=POOL] --bgp-asn=BGP_ASN + --bgp-peer-configs=[asn=ASN, + ip=IP,control-plane-nodes=NODE_IP_1;NODE_IP_2,...] + : [--bgp-load-balancer-node-configs=[node-ip=IP, + labels=KEY1=VALUE1;KEY2=VALUE2,...] + : --bgp-load-balancer-node-labels=[KEY=VALUE,...] + --bgp-load-balancer-node-taints=[KEY=VALUE:EFFECT,...] + --bgp-load-balancer-registry-burst=BGP_LOAD_BALANCER_REGISTRY_BURST + --bgp-load-balancer-registry-pull-qps=BGP_LOAD_BALANCER_REGISTRY_PULL_QPS --disable-bgp-load-balancer-serialize-image-pulls]] | [--metal-lb-address-pools=[addresses=ADDRESSES], + [avoid-buggy-ips=AVOID-BUGGY-IPS], + [manual-assign=MANUAL-ASSIGN],[pool=POOL] + : --metal-lb-load-balancer-node-configs=[labels=LABELS], + [node-ip=NODE-IP] + --metal-lb-load-balancer-node-labels=[KEY=VALUE,...] + --metal-lb-load-balancer-node-taints=[KEY=VALUE:EFFECT,...] + --disable-metal-lb-load-balancer-serialize-image-pulls + --metal-lb-load-balancer-registry-burst=METAL_LB_LOAD_BALANCER_REGISTRY_BURST --metal-lb-load-balancer-registry-pull-qps=METAL_LB_LOAD_BALANCER_REGISTRY_PULL_QPS])) + ((((--control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + : --control-plane-node-labels=[KEY=VALUE,...] + --control-plane-node-taints=[KEY=VALUE:EFFECT,...] + --control-plane-registry-burst=CONTROL_PLANE_REGISTRY_BURST + --control-plane-registry-pull-qps=CONTROL_PLANE_REGISTRY_PULL_QPS + --disable-control-plane-serialize-image-pulls))) + : --api-server-args=[KEY=VALUE,...]) + ((--lvp-node-mounts-config-path=LVP_NODE_MOUNTS_CONFIG_PATH + --lvp-node-mounts-config-storage-class=LVP_NODE_MOUNTS_CONFIG_STORAGE_CLASS) ((--lvp-share-path=LVP_SHARE_PATH --lvp-share-storage-class=LVP_SHARE_STORAGE_CLASS) : --shared-path-pv-count=SHARED_PATH_PV_COUNT)) + [--admin-users=ADMIN_USERS] [--annotations=[KEY=VALUE,...]] [--async] + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] + [--description=DESCRIPTION] [--enable-application-logs] + [--login-user=LOGIN_USER] + [--maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS, + ...]] [--validate-only] + [--container-runtime=CONTAINER_RUNTIME + --max-pods-per-node=MAX_PODS_PER_NODE] + [[(--island-mode-pod-address-cidr-blocks=POD_ADDRESS,[POD_ADDRESS,...] + --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...]) + : --enable-advanced-networking + --enable-multi-nic-config --enable-sr-iov-config]] + [--uri=URI : --no-proxy=[NO_PROXY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an Anthos cluster on bare metal. + +EXAMPLES + To create a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container bare-metal clusters create my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Cluster resource - cluster 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 cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +REQUIRED FLAGS + --version=VERSION + Anthos cluster on bare metal version for the user cluster resource. + + Admin cluster membership resource - membership of the admin cluster. + Membership name is the same as the admin cluster name. + + Examples: + + $ gcloud container bare-metal clusters create + --admin-cluster-membership=projects/example-project-12345/locations/us-west1/memberships/example-admin-cluster-name + + or + + $ gcloud container bare-metal clusters create + --admin-cluster-membership-project=example-project-12345 + --admin-cluster-membership-location=us-west1 + --admin-cluster-membership=example-admin-cluster-name + + The arguments in this group can be used to specify the attributes of this resource. + + This must be specified. + + --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + ID of the admin_cluster_membership or fully qualified identifier for + the admin_cluster_membership. + + To set the admin_cluster_membership attribute: + ▸ provide the argument --admin-cluster-membership on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION + Google Cloud location for the admin_cluster_membership. + + To set the location attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-location on the + command line. + + --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT + Google Cloud project for the admin_cluster_membership. + + To set the project attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-project on the + command line. + + Anthos on bare metal cluster load balancer configuration. + + This must be specified. + + Control plane load balancer port configuration. + + This must be specified. + + --control-plane-load-balancer-port=CONTROL_PLANE_LOAD_BALANCER_PORT + Control plane load balancer port configuration. + + VIPs used by the load balancer. + + This must be specified. + + --control-plane-vip=CONTROL_PLANE_VIP + VIP for the Kubernetes API of this cluster. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --ingress-vip=INGRESS_VIP + VIP for ingress traffic into this cluster. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Populate one of the load balancers. + + Exactly one of these must be specified: + + Manual load balancer configuration. + + --enable-manual-lb + ManualLB typed load balancers configuration. + + BGP load balancer configuration. + + --bgp-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL] + BGP load balancer address pools configurations. + + Examples: + + To specify configurations for two address pools pool1 and pool2, + + $ gcloud container bare-metal clusters create example_cluster + --bgp-address-pools 'pool=pool1,avoid-buggy-ips=True,manual-assign=True,addresses=192.168.1.1/32;192.168.1.2-192.168.1.3' + --bgp-address-pools 'pool=pool2,avoid-buggy-ips=False,manual-assign=False,addresses=192.168.2.1/32;192.168.2.2-192.168.2.3' + + Use quote around the flag value to escape semicolon in the + terminal. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --bgp-asn=BGP_ASN + BGP autonomous system number (ASN) of the cluster. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --bgp-peer-configs=[asn=ASN,ip=IP,control-plane-nodes=NODE_IP_1;NODE_IP_2,...] + List of BGP peers that the cluster will connect to. At least one + peer must be configured for each control plane node. + + Examples: + + To specify configurations for two peers of BGP autonomous system + number (ASN) 10000 and 20000, + + $ gcloud container bare-metal clusters create example_cluster + --bgp-peer-configs 'asn=10000,ip=192.168.1.1,control-plane-nodes=192.168.1.2;192.168.1.3' + --bgp-peer-configs 'asn=20000,ip=192.168.2.1,control-plane-nodes=192.168.2.2;192.168.2.3' + + Use quote around the flag value to escape semicolon in the + terminal. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --bgp-load-balancer-node-configs=[node-ip=IP,labels=KEY1=VALUE1;KEY2=VALUE2,...] + BGP load balancer data plane node configurations. + + Examples: + + To specify configurations for two nodes of IP 192.168.0.1 and + 192.168.1.1, + + $ gcloud container bare-metal clusters create example_cluster + --bgp-load-balancer-node-configs 'node-ip=192.168.0.1,labels=KEY1=VALUE1;KEY2=VALUE2' + --bgp-load-balancer-node-configs 'node-ip=192.168.1.1,labels=KEY3=VALUE3' + + Use quote around the flag value to escape semicolon in the + terminal. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --bgp-load-balancer-node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a BGP node pool. + + --bgp-load-balancer-node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every Kubernetes node in a node pool. + + Modifiable kubelet configurations for bare metal machines. + + --bgp-load-balancer-registry-burst=BGP_LOAD_BALANCER_REGISTRY_BURST + Maximum size of bursty pulls, temporarily allow pulls to burst + to this number, while still not exceeding registry_pull_qps. + + --bgp-load-balancer-registry-pull-qps=BGP_LOAD_BALANCER_REGISTRY_PULL_QPS + Limit of registry pulls per second. + + --disable-bgp-load-balancer-serialize-image-pulls + If set, prevent the Kubelet from pulling multiple images at a + time. + + MetalLB load balancer configuration. + + MetalLB address pools configuration. + + Exactly one of these must be specified: + + --metal-lb-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL] + MetalLB load balancer configurations. + + Examples: + + To specify MetalLB load balancer configurations for two address + pools pool1 and pool2, + + $ gcloud container bare-metal clusters create example_cluster + --metal-lb-address-pools 'pool=pool1,avoid-buggy-ips=True,manual-assign=True,addresses=192.168.1.1/32;192.168.1.2-192.168.1.3' + --metal-lb-address-pools 'pool=pool2,avoid-buggy-ips=False,manual-assign=False,addresses=192.168.2.1/32;192.168.2.2-192.168.2.3' + + Use quote around the flag value to escape semicolon in the + terminal. + + Anthos on bare metal node pool configuration for MetalLB load + balancer nodes. + + MetalLB Node Pool configuration. + + Populate MetalLB load balancer node config. + + At most one of these can be specified: + + --metal-lb-load-balancer-node-configs=[labels=LABELS],[node-ip=NODE-IP] + MetalLB load balancer node configuration. + + --metal-lb-load-balancer-node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a MetalLB node pool. + + --metal-lb-load-balancer-node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every node in a MetalLB node pool. + + Modifiable kubelet configurations for bare metal machines. + + --disable-metal-lb-load-balancer-serialize-image-pulls + If set, prevent the Kubelet from pulling multiple images at + a time. + + --metal-lb-load-balancer-registry-burst=METAL_LB_LOAD_BALANCER_REGISTRY_BURST + Maximum size of bursty pulls, temporarily allow pulls to + burst to this number, while still not exceeding + registry_pull_qps. + + --metal-lb-load-balancer-registry-pull-qps=METAL_LB_LOAD_BALANCER_REGISTRY_PULL_QPS + Limit of registry pulls per second. + + Anthos on bare metal cluster control plane configuration. + + At least one of these must be specified: + + --api-server-args=[KEY=VALUE,...] + API Server argument configuration. + + Anthos on bare metal cluster control plane node pool configuration. + + This must be specified. + + Anthos on bare metal node pool configuration for control plane nodes. + + This must be specified. + + Anthos on bare metal node configuration for control plane nodes. + + This must be specified. + + Populate control plane node config. + + Exactly one of these must be specified: + + --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + Control plane node configuration. + + --control-plane-node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a node pool. + + --control-plane-node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every Kubernetes node in a node pool. + + Modifiable kubelet configurations for bare metal machines. + + --control-plane-registry-burst=CONTROL_PLANE_REGISTRY_BURST + Maximum size of bursty pulls, temporarily allow pulls to + burst to this number, while still not exceeding + registry_pull_qps. + + --control-plane-registry-pull-qps=CONTROL_PLANE_REGISTRY_PULL_QPS + Limit of registry pulls per second. + + --disable-control-plane-serialize-image-pulls + If set, prevent the Kubelet from pulling multiple images at a + time. + + Anthos on bare metal cluster storage configuration. + + This must be specified. + + LVP node mounts class and path used by the storage. + + This must be specified. + + --lvp-node-mounts-config-path=LVP_NODE_MOUNTS_CONFIG_PATH + Path for the LVP node mounts class. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --lvp-node-mounts-config-storage-class=LVP_NODE_MOUNTS_CONFIG_STORAGE_CLASS + Storage class for LVP node mounts. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + LVP share configuration. + + At least one of these must be specified: + + --shared-path-pv-count=SHARED_PATH_PV_COUNT + Number of subdirectories to create under path. + + LVP share class and path used by the storage. + + This must be specified. + + --lvp-share-path=LVP_SHARE_PATH + Path for the LVP share class. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --lvp-share-storage-class=LVP_SHARE_STORAGE_CLASS + Storage class for LVP share. + + This flag argument must be specified if any of the other + arguments in this group are specified. + +OPTIONAL FLAGS + Anthos on bare metal cluster security configuration. + + User cluster authorization configurations to bootstrap onto the admin + cluster + + --admin-users=ADMIN_USERS + Users that will be granted the cluster-admin role on the cluster, + providing full access to the cluster. + + --annotations=[KEY=VALUE,...] + Annotations on the Anthos on bare metal resource. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Set Binary Authorization evaluation mode for this cluster. + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, + PROJECT_SINGLETON_POLICY_ENFORCE. + + --description=DESCRIPTION + Description for the resource. + + Anthos on bare metal cluster operations configuration. + + --enable-application-logs + Whether collection of application logs/metrics should be enabled (in + addition to system logs/metrics). + + Anthos on bare metal node access related settings for the user cluster. + + --login-user=LOGIN_USER + User name used to access node machines. + + Anthos on bare metal cluster maintenance configuration. + + --maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS,...] + IPv4 addresses to be placed into maintenance mode. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + + Anthos on bare metal cluster workload node configuration. + + --container-runtime=CONTAINER_RUNTIME + Container runtime which will be used in the bare metal user cluster. + + --max-pods-per-node=MAX_PODS_PER_NODE + Maximum number of pods a node can run. + + Anthos on bare metal cluster network configurations. + + --enable-advanced-networking + Enables the use of advanced Anthos networking features, such as + Bundled Load Balancing with BGP or the egress NAT gateway. + + Multiple networking interfaces cluster configurations. + + --enable-multi-nic-config + If set, enable multiple network interfaces for your pods. + + SR-IOV networking operator configurations. + + --enable-sr-iov-config + If set, install the SR-IOV operator. + + Populate one of the network configs. + + This must be specified. + + Island mode CIDR network configuration. + + --island-mode-pod-address-cidr-blocks=POD_ADDRESS,[POD_ADDRESS,...] + IPv4 address range for all pods in the cluster. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] + IPv4 address range for all services in the cluster. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + Anthos on bare metal cluster proxy configuration. + + --uri=URI + Address of the proxy server. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --no-proxy=[NO_PROXY,...] + List of IPs, hostnames, and domains that should skip the proxy. + +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 bare-metal clusters create + + $ gcloud beta container bare-metal clusters create + diff --git a/gcloud/container/bare-metal/clusters/delete b/gcloud/container/bare-metal/clusters/delete new file mode 100644 index 000000000..c0445c2aa --- /dev/null +++ b/gcloud/container/bare-metal/clusters/delete @@ -0,0 +1,85 @@ +NAME + gcloud container bare-metal clusters delete - delete an Anthos cluster on + bare metal + +SYNOPSIS + gcloud container bare-metal clusters delete (CLUSTER : --location=LOCATION) + [--allow-missing] [--async] [--force] [--ignore-errors] + [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an Anthos cluster on bare metal. + +EXAMPLES + To delete a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container bare-metal clusters delete my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Cluster resource - cluster 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 cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +FLAGS + --allow-missing + If set, and the Bare Metal cluster is not found, the request will + succeed but no action will be taken. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --force + If set, the operation will also apply to the child node pools. This + flag is required if the cluster has any associated node pools. + + --ignore-errors + If set, the deletion of a bare metal user cluster resource will succeed + even if errors occur during deletion. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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 bare-metal clusters delete + + $ gcloud beta container bare-metal clusters delete + diff --git a/gcloud/container/bare-metal/clusters/describe b/gcloud/container/bare-metal/clusters/describe new file mode 100644 index 000000000..b575ba3e1 --- /dev/null +++ b/gcloud/container/bare-metal/clusters/describe @@ -0,0 +1,63 @@ +NAME + gcloud container bare-metal clusters describe - describe an Anthos cluster + on bare metal + +SYNOPSIS + gcloud container bare-metal clusters describe + (CLUSTER : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an Anthos cluster on bare metal. + +EXAMPLES + To describe a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container bare-metal clusters describe my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Cluster resource - cluster 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 cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/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. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal clusters describe + + $ gcloud beta container bare-metal clusters describe + diff --git a/gcloud/container/bare-metal/clusters/enroll b/gcloud/container/bare-metal/clusters/enroll new file mode 100644 index 000000000..1d222b526 --- /dev/null +++ b/gcloud/container/bare-metal/clusters/enroll @@ -0,0 +1,124 @@ +NAME + gcloud container bare-metal clusters enroll - enroll an Anthos cluster on + bare metal + +SYNOPSIS + gcloud container bare-metal clusters enroll (CLUSTER : --location=LOCATION) + (--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Enroll an Anthos cluster on bare metal. + +EXAMPLES + To enroll a cluster named my-cluster managed in location us-west1 with + admin cluster membership of + projects/my-project/locations/us-west1/memberships/my-admin-cluster-membership, + run: + + $ gcloud container bare-metal clusters enroll my-cluster \ + --location=us-west1 \ + --admin-cluster-membership=projects/my-project/locations/\ + us-west1/memberships/my-admin-cluster-membership + +POSITIONAL ARGUMENTS + Cluster resource - cluster to enroll 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +REQUIRED FLAGS + Admin cluster membership resource - membership of the admin cluster. + Membership name is the same as the admin cluster name. + + Examples: + + $ gcloud container bare-metal clusters enroll + --admin-cluster-membership=projects/example-project-12345/locations/us-west1/memberships/example-admin-cluster-name + + or + + $ gcloud container bare-metal clusters enroll + --admin-cluster-membership-project=example-project-12345 + --admin-cluster-membership-location=us-west1 + --admin-cluster-membership=example-admin-cluster-name + + The arguments in this group can be used to specify the attributes of this resource. + + This must be specified. + + --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + ID of the admin_cluster_membership or fully qualified identifier for + the admin_cluster_membership. + + To set the admin_cluster_membership attribute: + ▸ provide the argument --admin-cluster-membership on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION + Google Cloud location for the admin_cluster_membership. + + To set the location attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-location on the + command line. + + --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT + Google Cloud project for the admin_cluster_membership. + + To set the project attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-project 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 + These variants are also available: + + $ gcloud alpha container bare-metal clusters enroll + + $ gcloud beta container bare-metal clusters enroll + diff --git a/gcloud/container/bare-metal/clusters/help b/gcloud/container/bare-metal/clusters/help new file mode 100644 index 000000000..d526ace2c --- /dev/null +++ b/gcloud/container/bare-metal/clusters/help @@ -0,0 +1,47 @@ +NAME + gcloud container bare-metal clusters - create and manage Anthos clusters on + bare metal + +SYNOPSIS + gcloud container bare-metal clusters COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage Anthos clusters on bare metal. + +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 an Anthos cluster on bare metal. + + delete + Delete an Anthos cluster on bare metal. + + describe + Describe an Anthos cluster on bare metal. + + enroll + Enroll an Anthos cluster on bare metal. + + list + List Anthos clusters on bare metal. + + query-version-config + Query versions for creating or upgrading an Anthos on bare metal user + cluster. + + update + Update an Anthos cluster on bare metal. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal clusters + + $ gcloud beta container bare-metal clusters + diff --git a/gcloud/container/bare-metal/clusters/list b/gcloud/container/bare-metal/clusters/list new file mode 100644 index 000000000..82c910b53 --- /dev/null +++ b/gcloud/container/bare-metal/clusters/list @@ -0,0 +1,84 @@ +NAME + gcloud container bare-metal clusters list - list Anthos clusters on bare + metal + +SYNOPSIS + gcloud container bare-metal clusters list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Anthos clusters on bare metal. + +EXAMPLES + To lists all clusters managed in location us-west1, run: + + $ gcloud container bare-metal clusters list --location=us-west1 + +FLAGS + Location resource - Google Cloud location to list. 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 container_bare_metal/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 container_bare_metal/location. + +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 container bare-metal clusters list + + $ gcloud beta container bare-metal clusters list + diff --git a/gcloud/container/bare-metal/clusters/query-version-config b/gcloud/container/bare-metal/clusters/query-version-config new file mode 100644 index 000000000..e68dec072 --- /dev/null +++ b/gcloud/container/bare-metal/clusters/query-version-config @@ -0,0 +1,152 @@ +NAME + gcloud container bare-metal clusters query-version-config - query versions + for creating or upgrading an Anthos on bare metal user cluster + +SYNOPSIS + gcloud container bare-metal clusters query-version-config + [--location=LOCATION] + [--cluster=CLUSTER + | [--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Query versions for creating or upgrading an Anthos on bare metal user + cluster. + +EXAMPLES + To query all available versions in location us-west1, run: + + $ gcloud container bare-metal clusters query-version-config \ + --location=us-west1 + + To query versions for creating a cluster with an admin cluster membership + named my-admin-cluster-membership managed in project + my-admin-cluster-project and location us-west, run: + + $ gcloud container bare-metal clusters query-version-config \ + --location=us-west1 \ + --admin-cluster-membership=my-admin-cluster-membership \ + --admin-cluster-membership-project=my-admin-cluster-project + + To query versions for upgrading a user cluster named my-user-cluster in + location us-west1, run: + + $ gcloud container bare-metal clusters query-version-config \ + --location=us-west1 --cluster=my-user-cluster + +FLAGS + Location resource - Google Cloud location to query versions. 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 container_bare_metal/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 container_bare_metal/location. + + Use cases for querying versions. + + At most one of these can be specified: + + Upgrade an Anthos on bare metal user cluster use case. + + Cluster resource - Cluster to query versions for upgrade. 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 --cluster 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 --cluster on the command line with a fully + specified name; + ▫ provide the argument --location on the command line; + ▫ set the property container_bare_metal/location. + + --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. + + Create an Anthos on bare metal user cluster use case. + + Admin cluster membership resource - membership of the admin cluster to + query versions for create. Membership name is the same as the admin + cluster name. + + Examples: + + $ gcloud container bare-metal clusters query-version-config + --admin-cluster-membership=projects/example-project-12345/locations/us-west1/memberships/example-admin-cluster-name + + or + + $ gcloud container bare-metal clusters query-version-config + --admin-cluster-membership-project=example-project-12345 + --admin-cluster-membership-location=us-west1 + --admin-cluster-membership=example-admin-cluster-name + + The arguments in this group can be used to specify the attributes of this resource. + + --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + ID of the admin_cluster_membership or fully qualified identifier + for the admin_cluster_membership. + + To set the admin_cluster_membership attribute: + ◇ provide the argument --admin-cluster-membership on the + command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" + Google Cloud location for the admin_cluster_membership. + + To set the location attribute: + ◇ provide the argument --admin-cluster-membership on the + command line with a fully specified name; + ◇ provide the argument --admin-cluster-membership-location on + the command line. + + --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT + Project ID of the Google Cloud project for the + admin_cluster_membership. + + To set the project attribute: + ◇ provide the argument --admin-cluster-membership on the + command line with a fully specified name; + ◇ provide the argument --admin-cluster-membership-project on + the command line; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. + +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 bare-metal clusters query-version-config + + $ gcloud beta container bare-metal clusters query-version-config + diff --git a/gcloud/container/bare-metal/clusters/update b/gcloud/container/bare-metal/clusters/update new file mode 100644 index 000000000..b4028ad77 --- /dev/null +++ b/gcloud/container/bare-metal/clusters/update @@ -0,0 +1,360 @@ +NAME + gcloud container bare-metal clusters update - update an Anthos cluster on + bare metal + +SYNOPSIS + gcloud container bare-metal clusters update (CLUSTER : --location=LOCATION) + [--admin-users=ADMIN_USERS] [--allow-missing] [--async] + [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] + [--description=DESCRIPTION] [--enable-application-logs] + [--login-user=LOGIN_USER] + [--maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS, + ...]] [--validate-only] [--version=VERSION] + [--add-annotations=[KEY1=VALUE1,KEY2=VALUE2,...] + | --remove-annotations=[KEY1,KEY2,...]] + [--api-server-args=[KEY=VALUE,...] + --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + --control-plane-node-labels=[KEY=VALUE,...] + --control-plane-node-taints=[KEY=VALUE:EFFECT,...] + --control-plane-registry-burst=CONTROL_PLANE_REGISTRY_BURST + --control-plane-registry-pull-qps=CONTROL_PLANE_REGISTRY_PULL_QPS + --disable-control-plane-serialize-image-pulls + | --enable-control-plane-serialize-image-pulls] + [--bgp-address-pools=[addresses=ADDRESSES], + [avoid-buggy-ips=AVOID-BUGGY-IPS], + [manual-assign=MANUAL-ASSIGN],[pool=POOL] --bgp-asn=BGP_ASN + --bgp-peer-configs=[asn=ASN, + ip=IP,control-plane-nodes=NODE_IP_1;NODE_IP_2,...] + --bgp-load-balancer-node-configs=[node-ip=IP, + labels=KEY1=VALUE1;KEY2=VALUE2,...] + --bgp-load-balancer-node-labels=[KEY=VALUE,...] + --bgp-load-balancer-node-taints=[KEY=VALUE:EFFECT,...] + --bgp-load-balancer-registry-burst=BGP_LOAD_BALANCER_REGISTRY_BURST + --bgp-load-balancer-registry-pull-qps=BGP_LOAD_BALANCER_REGISTRY_PULL_QPS --disable-bgp-load-balancer-serialize-image-pulls | --enable-bgp-load-balancer-serialize-image-pulls | --metal-lb-address-pools=[addresses=ADDRESSES], + [avoid-buggy-ips=AVOID-BUGGY-IPS], + [manual-assign=MANUAL-ASSIGN],[pool=POOL] + --metal-lb-load-balancer-node-configs=[labels=LABELS], + [node-ip=NODE-IP] + --metal-lb-load-balancer-node-labels=[KEY=VALUE,...] + --metal-lb-load-balancer-node-taints=[KEY=VALUE:EFFECT,...] + --metal-lb-load-balancer-registry-burst=METAL_LB_LOAD_BALANCER_REGISTRY_BURST --metal-lb-load-balancer-registry-pull-qps=METAL_LB_LOAD_BALANCER_REGISTRY_PULL_QPS --disable-metal-lb-load-balancer-serialize-image-pulls | --enable-metal-lb-load-balancer-serialize-image-pulls] + [--island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] + --disable-sr-iov-config | --enable-sr-iov-config] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update an Anthos cluster on bare metal. + +EXAMPLES + To update a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container bare-metal clusters update my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Cluster resource - cluster 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 cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +FLAGS + Anthos on bare metal cluster security configuration. + + User cluster authorization configurations to bootstrap onto the admin + cluster + + --admin-users=ADMIN_USERS + Users that will be granted the cluster-admin role on the cluster, + providing full access to the cluster. + + --allow-missing + If set, and the Anthos cluster on bare metal is not found, the update + request will try to create a new cluster with the provided + configuration. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE + Set Binary Authorization evaluation mode for this cluster. + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, + PROJECT_SINGLETON_POLICY_ENFORCE. + + --description=DESCRIPTION + Description for the resource. + + Anthos on bare metal cluster operations configuration. + + --enable-application-logs + Whether collection of application logs/metrics should be enabled (in + addition to system logs/metrics). + + Anthos on bare metal node access related settings for the user cluster. + + --login-user=LOGIN_USER + User name used to access node machines. + + Anthos on bare metal cluster maintenance configuration. + + --maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS,...] + IPv4 addresses to be placed into maintenance mode. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + + --version=VERSION + Anthos cluster on bare metal version for the user cluster resource. + + At most one of these can be specified: + + --add-annotations=[KEY1=VALUE1,KEY2=VALUE2,...] + Add the given key-value pairs to the current annotations, or update + its value if the key already exists. + + --remove-annotations=[KEY1,KEY2,...] + Remove annotations of the given keys. + + Anthos on bare metal cluster control plane configuration. + + --api-server-args=[KEY=VALUE,...] + API Server argument configuration. + + Anthos on bare metal cluster control plane node pool configuration. + + Anthos on bare metal node pool configuration for control plane nodes. + + Anthos on bare metal node configuration for control plane nodes. + + Populate control plane node config. + + At most one of these can be specified: + + --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] + Control plane node configuration. + + --control-plane-node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a node pool. + + --control-plane-node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every Kubernetes node in a node pool. + + Modifiable kubelet configurations for bare metal machines. + + --control-plane-registry-burst=CONTROL_PLANE_REGISTRY_BURST + Maximum size of bursty pulls, temporarily allow pulls to + burst to this number, while still not exceeding + registry_pull_qps. + + --control-plane-registry-pull-qps=CONTROL_PLANE_REGISTRY_PULL_QPS + Limit of registry pulls per second. + + At most one of these can be specified: + + --disable-control-plane-serialize-image-pulls + If set, prevent the Kubelet from pulling multiple images at + a time. + + --enable-control-plane-serialize-image-pulls + If set, enable the Kubelet to pull multiple images at a + time. + + Anthos on bare metal cluster load balancer configuration. + + Populate one of the load balancers. + + At most one of these can be specified: + + BGP load balancer configuration. + + --bgp-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL] + BGP load balancer address pools configurations. + + Examples: + + To specify configurations for two address pools pool1 and pool2, + + $ gcloud container bare-metal clusters update example_cluster + --bgp-address-pools 'pool=pool1,avoid-buggy-ips=True,manual-assign=True,addresses=192.168.1.1/32;192.168.1.2-192.168.1.3' + --bgp-address-pools 'pool=pool2,avoid-buggy-ips=False,manual-assign=False,addresses=192.168.2.1/32;192.168.2.2-192.168.2.3' + + Use quote around the flag value to escape semicolon in the + terminal. + + --bgp-asn=BGP_ASN + BGP autonomous system number (ASN) of the cluster. + + --bgp-peer-configs=[asn=ASN,ip=IP,control-plane-nodes=NODE_IP_1;NODE_IP_2,...] + List of BGP peers that the cluster will connect to. At least one + peer must be configured for each control plane node. + + Examples: + + To specify configurations for two peers of BGP autonomous system + number (ASN) 10000 and 20000, + + $ gcloud container bare-metal clusters update example_cluster + --bgp-peer-configs 'asn=10000,ip=192.168.1.1,control-plane-nodes=192.168.1.2;192.168.1.3' + --bgp-peer-configs 'asn=20000,ip=192.168.2.1,control-plane-nodes=192.168.2.2;192.168.2.3' + + Use quote around the flag value to escape semicolon in the + terminal. + + --bgp-load-balancer-node-configs=[node-ip=IP,labels=KEY1=VALUE1;KEY2=VALUE2,...] + BGP load balancer data plane node configurations. + + Examples: + + To specify configurations for two nodes of IP 192.168.0.1 and + 192.168.1.1, + + $ gcloud container bare-metal clusters update example_cluster + --bgp-load-balancer-node-configs 'node-ip=192.168.0.1,labels=KEY1=VALUE1;KEY2=VALUE2' + --bgp-load-balancer-node-configs 'node-ip=192.168.1.1,labels=KEY3=VALUE3' + + Use quote around the flag value to escape semicolon in the + terminal. + + --bgp-load-balancer-node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a BGP node pool. + + --bgp-load-balancer-node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every Kubernetes node in a node pool. + + Modifiable kubelet configurations for bare metal machines. + + --bgp-load-balancer-registry-burst=BGP_LOAD_BALANCER_REGISTRY_BURST + Maximum size of bursty pulls, temporarily allow pulls to burst + to this number, while still not exceeding registry_pull_qps. + + --bgp-load-balancer-registry-pull-qps=BGP_LOAD_BALANCER_REGISTRY_PULL_QPS + Limit of registry pulls per second. + + At most one of these can be specified: + + --disable-bgp-load-balancer-serialize-image-pulls + If set, prevent the Kubelet from pulling multiple images at a + time. + + --enable-bgp-load-balancer-serialize-image-pulls + If set, enable the Kubelet to pull multiple images at a time. + + MetalLB load balancer configuration. + + MetalLB address pools configuration. + + At most one of these can be specified: + + --metal-lb-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL] + MetalLB load balancer configurations. + + Examples: + + To specify MetalLB load balancer configurations for two address + pools pool1 and pool2, + + $ gcloud container bare-metal clusters update example_cluster + --metal-lb-address-pools 'pool=pool1,avoid-buggy-ips=True,manual-assign=True,addresses=192.168.1.1/32;192.168.1.2-192.168.1.3' + --metal-lb-address-pools 'pool=pool2,avoid-buggy-ips=False,manual-assign=False,addresses=192.168.2.1/32;192.168.2.2-192.168.2.3' + + Use quote around the flag value to escape semicolon in the + terminal. + + Anthos on bare metal node pool configuration for MetalLB load + balancer nodes. + + MetalLB Node Pool configuration. + + Populate MetalLB load balancer node config. + + At most one of these can be specified: + + --metal-lb-load-balancer-node-configs=[labels=LABELS],[node-ip=NODE-IP] + MetalLB load balancer node configuration. + + --metal-lb-load-balancer-node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a MetalLB node pool. + + --metal-lb-load-balancer-node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every node in a MetalLB node pool. + + Modifiable kubelet configurations for bare metal machines. + + --metal-lb-load-balancer-registry-burst=METAL_LB_LOAD_BALANCER_REGISTRY_BURST + Maximum size of bursty pulls, temporarily allow pulls to + burst to this number, while still not exceeding + registry_pull_qps. + + --metal-lb-load-balancer-registry-pull-qps=METAL_LB_LOAD_BALANCER_REGISTRY_PULL_QPS + Limit of registry pulls per second. + + At most one of these can be specified: + + --disable-metal-lb-load-balancer-serialize-image-pulls + If set, prevent the Kubelet from pulling multiple images + at a time. + + --enable-metal-lb-load-balancer-serialize-image-pulls + If set, enable the Kubelet to pull multiple images at a + time. + + Anthos on bare metal cluster network configurations. + + Populate one of the network configs. + + Island mode CIDR network configuration. + + --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] + IPv4 address range for all services in the cluster. + + SR-IOV networking operator configurations. + + At most one of these can be specified: + + --disable-sr-iov-config + If set, the SR-IOV operator won't be installed. + + --enable-sr-iov-config + If set, install the SR-IOV operator. + +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 bare-metal clusters update + + $ gcloud beta container bare-metal clusters update + diff --git a/gcloud/container/bare-metal/help b/gcloud/container/bare-metal/help new file mode 100644 index 000000000..3ec72e733 --- /dev/null +++ b/gcloud/container/bare-metal/help @@ -0,0 +1,37 @@ +NAME + gcloud container bare-metal - deploy and manage Anthos clusters on bare + metal for running containers + +SYNOPSIS + gcloud container bare-metal GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Deploy and manage Anthos clusters on bare metal for running containers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + admin-clusters + Create and manage admin clusters in Anthos on bare metal. + + clusters + Create and manage Anthos clusters on bare metal. + + node-pools + Create and manage node pools in an Anthos cluster on bare metal. + + operations + Manage Anthos on bare metal long running operations. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal + + $ gcloud beta container bare-metal + diff --git a/gcloud/container/bare-metal/node-pools/create b/gcloud/container/bare-metal/node-pools/create new file mode 100644 index 000000000..243b4f52a --- /dev/null +++ b/gcloud/container/bare-metal/node-pools/create @@ -0,0 +1,123 @@ +NAME + gcloud container bare-metal node-pools create - create a node pool in an + Anthos cluster on bare metal + +SYNOPSIS + gcloud container bare-metal node-pools create + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) + (--node-configs=[labels=LABELS],[node-ip=NODE-IP] + : --node-labels=[KEY=VALUE,...] --node-taints=[KEY=VALUE:EFFECT,...] + --disable-serialize-image-pulls --registry-burst=REGISTRY_BURST + --registry-pull-qps=REGISTRY_PULL_QPS) + [--annotations=[KEY=VALUE,...]] [--async] [--display-name=DISPLAY_NAME] + [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a node pool in an Anthos cluster on bare metal. + +EXAMPLES + To create a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container bare-metal node-pools create my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +REQUIRED FLAGS + Anthos on bare metal node pool configuration. + + This must be specified. + + Populate Bare Metal Node Pool node config. + + Exactly one of these must be specified: + + --node-configs=[labels=LABELS],[node-ip=NODE-IP] + Bare Metal Node Pool node configuration. + + --node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a node pool. + + --node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every Kubernetes node in a node pool. + + Modifiable kubelet configurations for bare metal machines. + + --disable-serialize-image-pulls + If set, prevent the Kubelet from pulling multiple images at a time. + + --registry-burst=REGISTRY_BURST + Maximum size of bursty pulls, temporarily allow pulls to burst to + this number, while still not exceeding registry_pull_qps. + + --registry-pull-qps=REGISTRY_PULL_QPS + Limit of registry pulls per second. + +OPTIONAL FLAGS + --annotations=[KEY=VALUE,...] + Annotations on the node pool. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --display-name=DISPLAY_NAME + Display name for the resource. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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 bare-metal node-pools create + + $ gcloud beta container bare-metal node-pools create + diff --git a/gcloud/container/bare-metal/node-pools/delete b/gcloud/container/bare-metal/node-pools/delete new file mode 100644 index 000000000..098dd334a --- /dev/null +++ b/gcloud/container/bare-metal/node-pools/delete @@ -0,0 +1,90 @@ +NAME + gcloud container bare-metal node-pools delete - delete a node pool in an + Anthos cluster on bare metal + +SYNOPSIS + gcloud container bare-metal node-pools delete + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--allow-missing] + [--async] [--ignore-errors] [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a node pool in an Anthos cluster on bare metal. + +EXAMPLES + To delete a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container bare-metal node-pools delete my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +FLAGS + --allow-missing + If set, and the Bare Metal Node Pool is not found, the request will + succeed but no action will be taken. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --ignore-errors + If set, the deletion of a Bare Metal Node Pool resource will succeed + even if errors occur during deletion. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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 bare-metal node-pools delete + + $ gcloud beta container bare-metal node-pools delete + diff --git a/gcloud/container/bare-metal/node-pools/describe b/gcloud/container/bare-metal/node-pools/describe new file mode 100644 index 000000000..0cce8a304 --- /dev/null +++ b/gcloud/container/bare-metal/node-pools/describe @@ -0,0 +1,73 @@ +NAME + gcloud container bare-metal node-pools describe - describe a node pool in + an Anthos cluster on bare metal + +SYNOPSIS + gcloud container bare-metal node-pools describe + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a node pool in an Anthos cluster on bare metal. + +EXAMPLES + To describe a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container bare-metal node-pools describe my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/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. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal node-pools describe + + $ gcloud beta container bare-metal node-pools describe + diff --git a/gcloud/container/bare-metal/node-pools/enroll b/gcloud/container/bare-metal/node-pools/enroll new file mode 100644 index 000000000..e747536bb --- /dev/null +++ b/gcloud/container/bare-metal/node-pools/enroll @@ -0,0 +1,82 @@ +NAME + gcloud container bare-metal node-pools enroll - enroll a node pool of a + user cluster in Anthos on bare metal + +SYNOPSIS + gcloud container bare-metal node-pools enroll + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] + [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Enroll a node pool of a user cluster in Anthos on bare metal. + +EXAMPLES + To enroll a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container bare-metal node-pools enroll my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool to enroll 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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 bare-metal node-pools enroll + + $ gcloud beta container bare-metal node-pools enroll + diff --git a/gcloud/container/bare-metal/node-pools/help b/gcloud/container/bare-metal/node-pools/help new file mode 100644 index 000000000..ebd1029a9 --- /dev/null +++ b/gcloud/container/bare-metal/node-pools/help @@ -0,0 +1,43 @@ +NAME + gcloud container bare-metal node-pools - create and manage node pools in an + Anthos cluster on bare metal + +SYNOPSIS + gcloud container bare-metal node-pools COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage node pools in an Anthos cluster on bare metal. + +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 node pool in an Anthos cluster on bare metal. + + delete + Delete a node pool in an Anthos cluster on bare metal. + + describe + Describe a node pool in an Anthos cluster on bare metal. + + enroll + Enroll a node pool of a user cluster in Anthos on bare metal. + + list + List node pools in an Anthos cluster on bare metal. + + update + Update a node pool in an Anthos cluster on bare metal. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal node-pools + + $ gcloud beta container bare-metal node-pools + diff --git a/gcloud/container/bare-metal/node-pools/list b/gcloud/container/bare-metal/node-pools/list new file mode 100644 index 000000000..6f3b5d3cf --- /dev/null +++ b/gcloud/container/bare-metal/node-pools/list @@ -0,0 +1,98 @@ +NAME + gcloud container bare-metal node-pools list - list node pools in an Anthos + cluster on bare metal + +SYNOPSIS + gcloud container bare-metal node-pools list + (--cluster=CLUSTER : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List node pools in an Anthos cluster on bare metal. + +EXAMPLES + To list all node pools in a cluster named my-cluster managed in location + us-west1, run: + + $ gcloud container bare-metal node-pools list --cluster=my-cluster \ + --location=us-west1 + +REQUIRED FLAGS + Cluster resource - cluster to list 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --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. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument --cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +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 container bare-metal node-pools list + + $ gcloud beta container bare-metal node-pools list + diff --git a/gcloud/container/bare-metal/node-pools/update b/gcloud/container/bare-metal/node-pools/update new file mode 100644 index 000000000..c4ade99f1 --- /dev/null +++ b/gcloud/container/bare-metal/node-pools/update @@ -0,0 +1,128 @@ +NAME + gcloud container bare-metal node-pools update - update a node pool in an + Anthos cluster on bare metal + +SYNOPSIS + gcloud container bare-metal node-pools update + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--allow-missing] + [--async] [--display-name=DISPLAY_NAME] [--validate-only] + [--node-configs=[labels=LABELS],[node-ip=NODE-IP] + --node-labels=[KEY=VALUE,...] --node-taints=[KEY=VALUE:EFFECT,...] + --registry-burst=REGISTRY_BURST + --registry-pull-qps=REGISTRY_PULL_QPS --disable-serialize-image-pulls + | --enable-serialize-image-pulls] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a node pool in an Anthos cluster on bare metal. + +EXAMPLES + To update a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container bare-metal node-pools update my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +FLAGS + --allow-missing + If set, and the Anthos cluster on bare metal is not found, the update + request will try to create a new cluster with the provided + configuration. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --display-name=DISPLAY_NAME + Display name for the resource. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + + Anthos on bare metal node pool configuration. + + Populate Bare Metal Node Pool node config. + + At most one of these can be specified: + + --node-configs=[labels=LABELS],[node-ip=NODE-IP] + Bare Metal Node Pool node configuration. + + --node-labels=[KEY=VALUE,...] + Labels assigned to nodes of a node pool. + + --node-taints=[KEY=VALUE:EFFECT,...] + Node taint applied to every Kubernetes node in a node pool. + + Modifiable kubelet configurations for bare metal machines. + + --registry-burst=REGISTRY_BURST + Maximum size of bursty pulls, temporarily allow pulls to burst to + this number, while still not exceeding registry_pull_qps. + + --registry-pull-qps=REGISTRY_PULL_QPS + Limit of registry pulls per second. + + At most one of these can be specified: + + --disable-serialize-image-pulls + If set, prevent the Kubelet from pulling multiple images at a + time. + + --enable-serialize-image-pulls + If set, enable the Kubelet to pull multiple images at a time. + +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 bare-metal node-pools update + + $ gcloud beta container bare-metal node-pools update + diff --git a/gcloud/container/bare-metal/operations/describe b/gcloud/container/bare-metal/operations/describe new file mode 100644 index 000000000..e3afb36aa --- /dev/null +++ b/gcloud/container/bare-metal/operations/describe @@ -0,0 +1,63 @@ +NAME + gcloud container bare-metal operations describe - describe an operation + +SYNOPSIS + gcloud container bare-metal operations describe + (OPERATION_ID : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an operation. + +EXAMPLES + To describe an operation in location us-west1, run: + + $ gcloud container bare-metal operations describe OPERATION_ID \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Operation resource - 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_id 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. + + OPERATION_ID + ID of the operation or fully qualified identifier for the operation. + + To set the name attribute: + ▸ provide the argument operation_id on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the operation. + + To set the location attribute: + ▸ provide the argument operation_id on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/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. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal operations describe + + $ gcloud beta container bare-metal operations describe + diff --git a/gcloud/container/bare-metal/operations/help b/gcloud/container/bare-metal/operations/help new file mode 100644 index 000000000..69a645368 --- /dev/null +++ b/gcloud/container/bare-metal/operations/help @@ -0,0 +1,34 @@ +NAME + gcloud container bare-metal operations - manage Anthos on bare metal long + running operations + +SYNOPSIS + gcloud container bare-metal operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Anthos on bare metal 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 an operation. + + list + List operations. + + wait + Poll an operation for completion. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal operations + + $ gcloud beta container bare-metal operations + diff --git a/gcloud/container/bare-metal/operations/list b/gcloud/container/bare-metal/operations/list new file mode 100644 index 000000000..08cbe1212 --- /dev/null +++ b/gcloud/container/bare-metal/operations/list @@ -0,0 +1,83 @@ +NAME + gcloud container bare-metal operations list - list operations + +SYNOPSIS + gcloud container bare-metal operations list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List operations. + +EXAMPLES + To list all operations in location us-west1, run: + + $ gcloud container bare-metal operations list --location=us-west1 + +FLAGS + Location resource - Google Cloud location to list 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; + ◆ set the property container_bare_metal/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 container_bare_metal/location. + +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 container bare-metal operations list + + $ gcloud beta container bare-metal operations list + diff --git a/gcloud/container/bare-metal/operations/wait b/gcloud/container/bare-metal/operations/wait new file mode 100644 index 000000000..006e6a1f2 --- /dev/null +++ b/gcloud/container/bare-metal/operations/wait @@ -0,0 +1,64 @@ +NAME + gcloud container bare-metal operations wait - poll an operation for + completion + +SYNOPSIS + gcloud container bare-metal operations wait + (OPERATION_ID : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Poll an operation for completion. + +EXAMPLES + To wait for an operation in location us-west1 to complete, run: + + $ gcloud container bare-metal operations wait OPERATION_ID \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Operation resource - operation to wait for completion. 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_id 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. + + OPERATION_ID + ID of the operation or fully qualified identifier for the operation. + + To set the name attribute: + ▸ provide the argument operation_id on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the operation. + + To set the location attribute: + ▸ provide the argument operation_id on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/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. + +NOTES + These variants are also available: + + $ gcloud alpha container bare-metal operations wait + + $ gcloud beta container bare-metal operations wait + diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 712496e9d..118e8e1bc 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -152,10 +152,10 @@ FLAGS `latest`: Install the latest available driver version. Available only for nodes that use Container-Optimized OS. - `disabled`: Skip automatic driver installation. You must [manually install a - driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) - after you create the cluster. If you omit the flag `gpu-driver-version`, - this is the default option. + `disabled`: Skip automatic driver installation. You must manually install a + driver after you create the cluster. If you omit the flag `gpu-driver-version`, + this is the default option. To learn how to manually install the GPU driver, + refer to: https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers gpu-partition-size (Optional) The GPU partition size used when running multi-instance diff --git a/gcloud/container/help b/gcloud/container/help index 028ca7eeb..b311b655b 100644 --- a/gcloud/container/help +++ b/gcloud/container/help @@ -35,6 +35,9 @@ GROUPS azure Deploy and manage clusters of machines on Azure for running containers. + bare-metal + Deploy and manage Anthos clusters on bare metal for running containers. + binauthz Manage attestations for Binary Authorization on Google Cloud Platform. @@ -61,6 +64,9 @@ GROUPS subnets Manage subnets to be used by Google Kubernetes Engine clusters. + vmware + Deploy and manage Anthos clusters on VMware for running containers. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/container/node-pools/create b/gcloud/container/node-pools/create index a4d856e73..94c168029 100644 --- a/gcloud/container/node-pools/create +++ b/gcloud/container/node-pools/create @@ -109,10 +109,10 @@ FLAGS `latest`: Install the latest available driver version. Available only for nodes that use Container-Optimized OS. - `disabled`: Skip automatic driver installation. You must [manually install a - driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) - after you create the cluster. If you omit the flag `gpu-driver-version`, - this is the default option. + `disabled`: Skip automatic driver installation. You must manually install a + driver after you create the cluster. If you omit the flag `gpu-driver-version`, + this is the default option. To learn how to manually install the GPU driver, + refer to: https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers gpu-partition-size (Optional) The GPU partition size used when running multi-instance diff --git a/gcloud/container/vmware/admin-clusters/describe b/gcloud/container/vmware/admin-clusters/describe new file mode 100644 index 000000000..951c30c5a --- /dev/null +++ b/gcloud/container/vmware/admin-clusters/describe @@ -0,0 +1,66 @@ +NAME + gcloud container vmware admin-clusters describe - describe an Anthos on + VMware admin cluster + +SYNOPSIS + gcloud container vmware admin-clusters describe + (ADMIN_CLUSTER : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an Anthos on VMware admin cluster. + +EXAMPLES + To describe an admin cluster named my-cluster managed in location us-west1, + run: + + $ gcloud container vmware admin-clusters describe my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Admin cluster resource - admin cluster 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 admin_cluster 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. + + ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ▸ provide the argument admin_cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the admin_cluster. + + To set the location attribute: + ▸ provide the argument admin_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/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. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware admin-clusters describe + + $ gcloud beta container vmware admin-clusters describe + diff --git a/gcloud/container/vmware/admin-clusters/enroll b/gcloud/container/vmware/admin-clusters/enroll new file mode 100644 index 000000000..56c73ed56 --- /dev/null +++ b/gcloud/container/vmware/admin-clusters/enroll @@ -0,0 +1,113 @@ +NAME + gcloud container vmware admin-clusters enroll - enroll an Anthos on VMware + admin cluster + +SYNOPSIS + gcloud container vmware admin-clusters enroll + (ADMIN_CLUSTER : --location=LOCATION) + (--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global") + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Enroll an Anthos on VMware admin cluster. + +EXAMPLES + To enroll a cluster named my-cluster managed in location us-west1 with + admin cluster membership of + projects/my-project/locations/us-west1/memberships/my-admin-cluster-membership, + run: + + $ gcloud container vmware admin-clusters enroll my-cluster \ + --location=us-west1 \ + --admin-cluster-membership=projects/my-project/locations/\ + us-west1/memberships/my-admin-cluster-membership + +POSITIONAL ARGUMENTS + Admin cluster resource - admin cluster to enroll 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 admin_cluster 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. + + ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ▸ provide the argument admin_cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the admin_cluster. + + To set the location attribute: + ▸ provide the argument admin_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +REQUIRED FLAGS + Admin cluster membership resource - membership of the admin cluster. + Membership can be the membership ID or the full resource name. 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 --admin-cluster-membership 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. + + --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + ID of the admin_cluster_membership or fully qualified identifier for + the admin_cluster_membership. + + To set the admin_cluster_membership attribute: + ▸ provide the argument --admin-cluster-membership on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" + Google Cloud location for the admin_cluster_membership. + + To set the location attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-location 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 + These variants are also available: + + $ gcloud alpha container vmware admin-clusters enroll + + $ gcloud beta container vmware admin-clusters enroll + diff --git a/gcloud/container/vmware/admin-clusters/help b/gcloud/container/vmware/admin-clusters/help new file mode 100644 index 000000000..16de4cb0b --- /dev/null +++ b/gcloud/container/vmware/admin-clusters/help @@ -0,0 +1,40 @@ +NAME + gcloud container vmware admin-clusters - create and manage admin clusters + in Anthos on VMware + +SYNOPSIS + gcloud container vmware admin-clusters COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage admin clusters in Anthos on VMware. + +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 an Anthos on VMware admin cluster. + + enroll + Enroll an Anthos on VMware admin cluster. + + list + List Anthos on VMware admin clusters. + + unenroll + Unenroll an Anthos on VMware admin cluster. + + update + Update an Anthos on VMware admin cluster. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware admin-clusters + + $ gcloud beta container vmware admin-clusters + diff --git a/gcloud/container/vmware/admin-clusters/list b/gcloud/container/vmware/admin-clusters/list new file mode 100644 index 000000000..812d8afb0 --- /dev/null +++ b/gcloud/container/vmware/admin-clusters/list @@ -0,0 +1,84 @@ +NAME + gcloud container vmware admin-clusters list - list Anthos on VMware admin + clusters + +SYNOPSIS + gcloud container vmware admin-clusters list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Anthos on VMware admin clusters. + +EXAMPLES + To list all admin clusters managed in location us-west1, run: + + $ gcloud container vmware admin-clusters list --location=us-west1 + +FLAGS + Location resource - Google Cloud location to list Anthos on VMware admin + clusters. 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 container_vmware/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 container_vmware/location. + +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 container vmware admin-clusters list + + $ gcloud beta container vmware admin-clusters list + diff --git a/gcloud/container/vmware/admin-clusters/unenroll b/gcloud/container/vmware/admin-clusters/unenroll new file mode 100644 index 000000000..2dea24e95 --- /dev/null +++ b/gcloud/container/vmware/admin-clusters/unenroll @@ -0,0 +1,80 @@ +NAME + gcloud container vmware admin-clusters unenroll - unenroll an Anthos on + VMware admin cluster + +SYNOPSIS + gcloud container vmware admin-clusters unenroll + (ADMIN_CLUSTER : --location=LOCATION) [--allow-missing] [--async] + [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Unenroll an Anthos on VMware admin cluster. + +EXAMPLES + To unenroll an admin cluster named my-cluster managed in location us-west1, + run: + + $ gcloud container vmware admin-clusters unenroll my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Admin cluster resource - admin cluster to unenroll 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 admin_cluster 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. + + ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ▸ provide the argument admin_cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the admin_cluster. + + To set the location attribute: + ▸ provide the argument admin_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +FLAGS + --allow-missing + If set, and the VMware Cluster is not found, the request will succeed + but no action will be taken on the server and return a completed LRO. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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 vmware admin-clusters unenroll + + $ gcloud beta container vmware admin-clusters unenroll + diff --git a/gcloud/container/vmware/admin-clusters/update b/gcloud/container/vmware/admin-clusters/update new file mode 100644 index 000000000..1118044c9 --- /dev/null +++ b/gcloud/container/vmware/admin-clusters/update @@ -0,0 +1,78 @@ +NAME + gcloud container vmware admin-clusters update - update an Anthos on VMware + admin cluster + +SYNOPSIS + gcloud container vmware admin-clusters update + (ADMIN_CLUSTER : --location=LOCATION) [--async] + [--required-platform-version=REQUIRED_PLATFORM_VERSION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update an Anthos on VMware admin cluster. + +EXAMPLES + To update a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container vmware admin-clusters update my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Admin cluster resource - admin cluster 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 admin_cluster 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. + + ADMIN_CLUSTER + ID of the admin_cluster or fully qualified identifier for the + admin_cluster. + + To set the admin_cluster attribute: + ▸ provide the argument admin_cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the admin_cluster. + + To set the location attribute: + ▸ provide the argument admin_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --required-platform-version=REQUIRED_PLATFORM_VERSION + Platform version required for upgrading a user cluster. If the current + platform version is lower than the required version, the platform + version will be updated to the required version. If it is not installed + in the platform, download the required version bundle. + +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 vmware admin-clusters update + + $ gcloud beta container vmware admin-clusters update + diff --git a/gcloud/container/vmware/clusters/create b/gcloud/container/vmware/clusters/create new file mode 100644 index 000000000..7ab64bb12 --- /dev/null +++ b/gcloud/container/vmware/clusters/create @@ -0,0 +1,406 @@ +NAME + gcloud container vmware clusters create - create an Anthos cluster on + VMware + +SYNOPSIS + gcloud container vmware clusters create (CLUSTER : --location=LOCATION) + --version=VERSION + (--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT) + ((--control-plane-vip=CONTROL_PLANE_VIP --ingress-vip=INGRESS_VIP) + (--metal-lb-config-address-pools=[addresses=ADDRESSES], + [avoid-buggy-ips=AVOID-BUGGY-IPS], + [manual-assign=MANUAL-ASSIGN],[pool=POOL] + | --control-plane-node-port=CONTROL_PLANE_NODE_PORT + --ingress-http-node-port=INGRESS_HTTP_NODE_PORT + --ingress-https-node-port=INGRESS_HTTPS_NODE_PORT + --konnectivity-server-node-port=KONNECTIVITY_SERVER_NODE_PORT + | [--f5-config-address=F5_CONFIG_ADDRESS + --f5-config-partition=F5_CONFIG_PARTITION + : --f5-config-snat-pool=F5_CONFIG_SNAT_POOL])) + (--pod-address-cidr-blocks=POD_ADDRESS + --service-address-cidr-blocks=SERVICE_ADDRESS + : --control-plane-ip-block=[gateway=GATEWAY], + [ips=IPS],[netmask=NETMASK] + --dns-search-domains=[DNS_SEARCH_DOMAINS,...] + --dns-servers=[DNS_SERVERS,...] + --ntp-servers=[NTP_SERVERS,...] --enable-dhcp + | --static-ip-config-ip-blocks=[gateway=GATEWAY], + [ips=IPS],[netmask=NETMASK]) [--admin-users=ADMIN_USERS] + [--annotations=[KEY=VALUE,...]] [--async] [--description=DESCRIPTION] + [--disable-aag-config] [--disable-vsphere-csi] [--enable-auto-repair] + [--enable-vm-tracking] [--validate-only] + [--cpus=CPUS --enable-auto-resize --memory=MEMORY --replicas=REPLICAS] + [--disable-control-plane-v2 | --enable-control-plane-v2] + [--enable-advanced-networking --enable-dataplane-v2] + [--vcenter-ca-cert-data=VCENTER_CA_CERT_DATA + --vcenter-cluster=VCENTER_CLUSTER + --vcenter-datacenter=VCENTER_DATACENTER + --vcenter-datastore=VCENTER_DATASTORE --vcenter-folder=VCENTER_FOLDER + --vcenter-resource-pool=VCENTER_RESOURCE_POOL + --vcenter-storage-policy-name=VCENTER_STORAGE_POLICY_NAME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an Anthos cluster on VMware. + +EXAMPLES + To create a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container vmware clusters create my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Cluster resource - cluster 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 cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +REQUIRED FLAGS + --version=VERSION + Anthos Cluster on VMware version for the user cluster resource + + Admin cluster membership resource - membership of the admin cluster. + Membership name is the same as the admin cluster name. + + Examples: + + $ gcloud container vmware clusters create + --admin-cluster-membership=projects/example-project-12345/locations/us-west1/memberships/example-admin-cluster-name + + or + + $ gcloud container vmware clusters create + --admin-cluster-membership-project=example-project-12345 + --admin-cluster-membership-location=us-west1 + --admin-cluster-membership=example-admin-cluster-name + + The arguments in this group can be used to specify the attributes of this resource. + + This must be specified. + + --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + ID of the admin_cluster_membership or fully qualified identifier for + the admin_cluster_membership. + + To set the admin_cluster_membership attribute: + ▸ provide the argument --admin-cluster-membership on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION + Google Cloud location for the admin_cluster_membership. + + To set the location attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-location on the + command line. + + --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT + Google Cloud project for the admin_cluster_membership. + + To set the project attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-project on the + command line. + + Anthos on VMware cluster load balancer configurations + + This must be specified. + + VIPs used by the load balancer + + This must be specified. + + --control-plane-vip=CONTROL_PLANE_VIP + VIP for the Kubernetes API of this cluster. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --ingress-vip=INGRESS_VIP + VIP for ingress traffic into this cluster. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Populate one of the load balancers. + + Exactly one of these must be specified: + + MetalLB Configuration + + At most one of these can be specified: + + --metal-lb-config-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL] + MetalLB load balancer configurations. + + Examples: + + To specify MetalLB load balancer configurations for two address + pools pool1 and pool2, + + $ gcloud gcloud container vmware clusters create + --metal-lb-config-address-pools 'pool=pool1,avoid-buggy-ips=True,manual-assign=True,addresses=192.168.1.1/32;192.168.1.2-192.168.1.3' + --metal-lb-config-address-pools 'pool=pool2,avoid-buggy-ips=False,manual-assign=False,addresses=192.168.2.1/32;192.168.2.2-192.168.2.3' + + Use quote around the flag value to escape semicolon in the + terminal. + + Manual load balancer configuration + + --control-plane-node-port=CONTROL_PLANE_NODE_PORT + NodePort for control plane service. + + --ingress-http-node-port=INGRESS_HTTP_NODE_PORT + NodePort for ingress service's http. + + --ingress-https-node-port=INGRESS_HTTPS_NODE_PORT + NodePort for ingress service's https. + + --konnectivity-server-node-port=KONNECTIVITY_SERVER_NODE_PORT + NodePort for konnectivity service running as a sidecar in each + kube-apiserver pod. + + F5 Big IP Configuration + + --f5-config-address=F5_CONFIG_ADDRESS + F5 Big IP load balancer address. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --f5-config-partition=F5_CONFIG_PARTITION + F5 Big IP load balancer partition. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --f5-config-snat-pool=F5_CONFIG_SNAT_POOL + F5 Big IP load balancer pool name if using SNAT. + + VMware User Cluster network configurations + + This must be specified. + + --pod-address-cidr-blocks=POD_ADDRESS + IPv4 address range for all pods in the cluster. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --service-address-cidr-blocks=SERVICE_ADDRESS + IPv4 address range for all services in the cluster. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + Control plane v2 mode configurations. + + --control-plane-ip-block=[gateway=GATEWAY],[ips=IPS],[netmask=NETMASK] + Static IP addresses for the control plane nodes. The number of IP + addresses should match the number of replicas for the control plane + nodes, specified by --replicas. + + To specify the control plane IP block, + + $ gcloud gcloud container vmware clusters create + --control-plane-ip-block 'gateway=192.168.0.1,netmask=255.255.255.0,ips=192.168.1.1;0.0.0.0 localhost;' + + Common parameters for all hosts irrespective of their IP address + + --dns-search-domains=[DNS_SEARCH_DOMAINS,...] + DNS search domains. + + --dns-servers=[DNS_SERVERS,...] + DNS server IP address. + + --ntp-servers=[NTP_SERVERS,...] + NTP server IP address. + + IP configuration used by the VMware User Cluster + + At most one of these can be specified: + + DHCP configuration group. + + --enable-dhcp + Enable DHCP IP allocation for VMware user clusters. + + Static IP configuration group + + At most one of these can be specified: + + --static-ip-config-ip-blocks=[gateway=GATEWAY],[ips=IPS],[netmask=NETMASK] + Static IP configurations. + + Expect an individual IP address, an individual IP address with an + optional hostname, or a CIDR block. + + Example: + + To specify two Static IP blocks, + + $ gcloud gcloud container vmware clusters create + --static-ip-config-ip-blocks 'gateway=192.168.0.1,netmask=255.255.255.0,ips=192.168.1.1;0.0.0.0 localhost;192.168.1.2/16' + --static-ip-config-ip-blocks 'gateway=192.168.1.1,netmask=255.255.0.0,ips=8.8.8.8;4.4.4.4' + + Use quote around the flag value to escape semicolon in the + terminal. + +OPTIONAL FLAGS + User cluster authorization configurations to bootstrap onto the admin + cluster + + --admin-users=ADMIN_USERS + Users that will be granted the cluster-admin role on the cluster, + providing full access to the cluster. + + To add multiple users, specify one in each flag. When updating, the + update command overwrites the whole grant list. Specify all existing + and new users that you want to be cluster administrators. + + Examples: + + $ gcloud container vmware clusters create + --admin-users alice@example.com + --admin-users bob@example.com + + --annotations=[KEY=VALUE,...] + Annotations on the VMware user cluster. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description for the resource. + + Anti-affinity group configurations + + --disable-aag-config + If set, spread nodes across at least three physical hosts (requires + at least three hosts). Enabled by default. + + Storage configurations + + --disable-vsphere-csi + If set, vSphere CSI components are not deployed in the VMware User + Cluster. Enabled by default. + + Auto-repair configurations + + --enable-auto-repair + If set, deploy the cluster-health-controller. + + --enable-vm-tracking + If set, enable VM tracking. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + + Control plane node configurations + + --cpus=CPUS + Number of CPUs for each admin cluster node that serve as control + planes for this VMware user cluster. (default: 4 CPUs) + + Auto resize configurations + + --enable-auto-resize + Enable controle plane node auto resize. + + --memory=MEMORY + Megabytes of memory for each admin cluster node that serves as a + control plane for this VMware User Cluster (default: 8192 MB memory). + + --replicas=REPLICAS + Number of control plane nodes for this VMware user cluster. (default: + 1 replica). + + At most one of these can be specified: + + --disable-control-plane-v2 + If set, disable control plane v2. + + --enable-control-plane-v2 + If set, enable control plane v2. + + Dataplane V2 configurations + + --enable-advanced-networking + If set, enable advanced networking. Requires dataplane_v2_enabled to + be set true. + + --enable-dataplane-v2 + If set, enables Dataplane V2. + + vCenter configurations for the cluster. If not specified, it is inherited + from the admin cluster. + + --vcenter-ca-cert-data=VCENTER_CA_CERT_DATA + Name of the vCenter CA certificate public key for SSL verification. + + --vcenter-cluster=VCENTER_CLUSTER + Name of the vCenter cluster for the user cluster. + + --vcenter-datacenter=VCENTER_DATACENTER + Name of the vCenter datacenter for the user cluster. + + --vcenter-datastore=VCENTER_DATASTORE + Name of the vCenter datastore for the user cluster. + + --vcenter-folder=VCENTER_FOLDER + Name of the vCenter folder for the user cluster. + + --vcenter-resource-pool=VCENTER_RESOURCE_POOL + Name of the vCenter resource pool for the user cluster. + + --vcenter-storage-policy-name=VCENTER_STORAGE_POLICY_NAME + Name of the vCenter storage policy for the user cluster. + +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 vmware clusters create + + $ gcloud beta container vmware clusters create + diff --git a/gcloud/container/vmware/clusters/delete b/gcloud/container/vmware/clusters/delete new file mode 100644 index 000000000..60e9694e9 --- /dev/null +++ b/gcloud/container/vmware/clusters/delete @@ -0,0 +1,85 @@ +NAME + gcloud container vmware clusters delete - delete an Anthos cluster on + VMware + +SYNOPSIS + gcloud container vmware clusters delete (CLUSTER : --location=LOCATION) + [--allow-missing] [--async] [--force] [--ignore-errors] + [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an Anthos cluster on VMware. + +EXAMPLES + To delete a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container vmware clusters delete my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Cluster resource - cluster 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 cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +FLAGS + --allow-missing + If set, and the Anthos cluster on VMware is not found, the request will + succeed but no action will be taken. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --force + If set, any node pools from the cluster will also be deleted. This flag + is required if the cluster has any associated node pools. + + --ignore-errors + If set, the deletion of a VMware user cluster resource will succeed + even if errors occur during deletion. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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 vmware clusters delete + + $ gcloud beta container vmware clusters delete + diff --git a/gcloud/container/vmware/clusters/describe b/gcloud/container/vmware/clusters/describe new file mode 100644 index 000000000..69b8df959 --- /dev/null +++ b/gcloud/container/vmware/clusters/describe @@ -0,0 +1,63 @@ +NAME + gcloud container vmware clusters describe - describe an Anthos cluster on + VMware + +SYNOPSIS + gcloud container vmware clusters describe (CLUSTER : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an Anthos cluster on VMware. + +EXAMPLES + To describe a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container vmware clusters describe my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Cluster resource - cluster 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 cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/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. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware clusters describe + + $ gcloud beta container vmware clusters describe + diff --git a/gcloud/container/vmware/clusters/enroll b/gcloud/container/vmware/clusters/enroll new file mode 100644 index 000000000..e05c2d723 --- /dev/null +++ b/gcloud/container/vmware/clusters/enroll @@ -0,0 +1,138 @@ +NAME + gcloud container vmware clusters enroll - enroll an Anthos cluster on + VMware + +SYNOPSIS + gcloud container vmware clusters enroll (CLUSTER : --location=LOCATION) + (--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT) + [--async] [--local-name=LOCAL_NAME] [--validate-only] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Enroll an Anthos cluster on VMware. + +EXAMPLES + To enroll a cluster named my-cluster managed in location us-west1 with + admin cluster membership of + projects/my-project/locations/us-west1/memberships/my-admin-cluster-membership, + run: + + $ gcloud container vmware clusters enroll my-cluster \ + --location=us-west1 \ + --admin-cluster-membership=projects/my-project/locations/\ + us-west1/memberships/my-admin-cluster-membership + +POSITIONAL ARGUMENTS + Cluster resource - cluster to enroll 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +REQUIRED FLAGS + Admin cluster membership resource - membership of the admin cluster. + Membership name is the same as the admin cluster name. + + Examples: + + $ gcloud container vmware clusters enroll + --admin-cluster-membership=projects/example-project-12345/locations/us-west1/memberships/example-admin-cluster-name + + or + + $ gcloud container vmware clusters enroll + --admin-cluster-membership-project=example-project-12345 + --admin-cluster-membership-location=us-west1 + --admin-cluster-membership=example-admin-cluster-name + + The arguments in this group can be used to specify the attributes of this resource. + + This must be specified. + + --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + ID of the admin_cluster_membership or fully qualified identifier for + the admin_cluster_membership. + + To set the admin_cluster_membership attribute: + ▸ provide the argument --admin-cluster-membership on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION + Google Cloud location for the admin_cluster_membership. + + To set the location attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-location on the + command line. + + --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT + Google Cloud project for the admin_cluster_membership. + + To set the project attribute: + ▸ provide the argument --admin-cluster-membership on the command + line with a fully specified name; + ▸ provide the argument --admin-cluster-membership-project on the + command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --local-name=LOCAL_NAME + The object name of the VMware OnPremUserCluster custom resource on the + associated admin cluster. This field is used to support conflicting + resource names when enrolling existing clusters to the API. When not + provided, this field will resolve to the vmware_cluster_id. Otherwise, + it must match the object name of the VMware OnPremUserCluster custom + resource. It is not modifiable outside / beyond the enrollment + operation. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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 vmware clusters enroll + + $ gcloud beta container vmware clusters enroll + diff --git a/gcloud/container/vmware/clusters/help b/gcloud/container/vmware/clusters/help new file mode 100644 index 000000000..1821ae575 --- /dev/null +++ b/gcloud/container/vmware/clusters/help @@ -0,0 +1,50 @@ +NAME + gcloud container vmware clusters - create and manage Anthos clusters on + VMware + +SYNOPSIS + gcloud container vmware clusters COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage Anthos clusters on VMware. + +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 an Anthos cluster on VMware. + + delete + Delete an Anthos cluster on VMware. + + describe + Describe an Anthos cluster on VMware. + + enroll + Enroll an Anthos cluster on VMware. + + list + List Anthos clusters on VMware. + + query-version-config + Query versions for creating or upgrading an Anthos on VMware user + cluster. + + update + Update an Anthos cluster on VMware. + + upgrade + Centrally upgrade an Anthos cluster on VMware. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware clusters + + $ gcloud beta container vmware clusters + diff --git a/gcloud/container/vmware/clusters/list b/gcloud/container/vmware/clusters/list new file mode 100644 index 000000000..4f187f85f --- /dev/null +++ b/gcloud/container/vmware/clusters/list @@ -0,0 +1,83 @@ +NAME + gcloud container vmware clusters list - list Anthos clusters on VMware + +SYNOPSIS + gcloud container vmware clusters list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Anthos clusters on VMware. + +EXAMPLES + To lists all clusters managed in location us-west1, run: + + $ gcloud container vmware clusters list --location=us-west1 + +FLAGS + Location resource - Google Cloud location to list Anthos on VMware + clusters. 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 container_vmware/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 container_vmware/location. + +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 container vmware clusters list + + $ gcloud beta container vmware clusters list + diff --git a/gcloud/container/vmware/clusters/query-version-config b/gcloud/container/vmware/clusters/query-version-config new file mode 100644 index 000000000..8d1e78c2c --- /dev/null +++ b/gcloud/container/vmware/clusters/query-version-config @@ -0,0 +1,137 @@ +NAME + gcloud container vmware clusters query-version-config - query versions for + creating or upgrading an Anthos on VMware user cluster + +SYNOPSIS + gcloud container vmware clusters query-version-config [--location=LOCATION] + [--cluster=CLUSTER + | [--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Query versions for creating or upgrading an Anthos on VMware user cluster. + +EXAMPLES + To query all available versions in location us-west1, run: + + $ gcloud container vmware clusters query-version-config \ + --location=us-west1 + + To query versions for creating a cluster with an admin cluster membership + named my-admin-cluster-membership managed in project + my-admin-cluster-project and location us-west, run: + + $ gcloud container vmware clusters query-version-config \ + --location=us-west1 \ + --admin-cluster-membership=my-admin-cluster-membership \ + --admin-cluster-membership-project=my-admin-cluster-project + + To query versions for upgrading a user cluster named my-user-cluster in + location us-west1, run: + + $ gcloud container vmware clusters query-version-config \ + --location=us-west1 --cluster=my-user-cluster + +FLAGS + Location resource - Google Cloud location to query versions. 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 container_vmware/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 container_vmware/location. + + Use cases for querying versions. + + At most one of these can be specified: + + Upgrade an Anthos on VMware user cluster use case. + + Cluster resource - Cluster to query versions for upgrade. 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 --cluster 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 --cluster on the command line with a fully + specified name; + ▫ provide the argument --location on the command line; + ▫ set the property container_vmware/location. + + --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. + + Create an Anthos on VMware user cluster use case. + + Admin cluster membership resource - Membership of the admin cluster to + query versions for create. Membership can be the membership ID or the + full resource name. The arguments in this group can be used to specify + the attributes of this resource. + + --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP + ID of the admin_cluster_membership or fully qualified identifier + for the admin_cluster_membership. + + To set the admin_cluster_membership attribute: + ◇ provide the argument --admin-cluster-membership on the + command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION; default="global" + Google Cloud location for the admin_cluster_membership. + + To set the location attribute: + ◇ provide the argument --admin-cluster-membership on the + command line with a fully specified name; + ◇ provide the argument --admin-cluster-membership-location on + the command line. + + --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT + Project ID of the Google Cloud project for the + admin_cluster_membership. + + To set the project attribute: + ◇ provide the argument --admin-cluster-membership on the + command line with a fully specified name; + ◇ provide the argument --admin-cluster-membership-project on + the command line; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. + +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 vmware clusters query-version-config + + $ gcloud beta container vmware clusters query-version-config + diff --git a/gcloud/container/vmware/clusters/update b/gcloud/container/vmware/clusters/update new file mode 100644 index 000000000..0b0efea39 --- /dev/null +++ b/gcloud/container/vmware/clusters/update @@ -0,0 +1,216 @@ +NAME + gcloud container vmware clusters update - update an Anthos cluster on + VMware + +SYNOPSIS + gcloud container vmware clusters update (CLUSTER : --location=LOCATION) + [--admin-users=ADMIN_USERS] [--async] [--description=DESCRIPTION] + [--metal-lb-config-address-pools=[addresses=ADDRESSES], + [avoid-buggy-ips=AVOID-BUGGY-IPS], + [manual-assign=MANUAL-ASSIGN],[pool=POOL]] + [--static-ip-config-ip-blocks=[gateway=GATEWAY], + [ips=IPS],[netmask=NETMASK]] [--validate-only] [--version=VERSION] + [--add-annotations=[KEY1=VALUE1,KEY2=VALUE2,...] + | --remove-annotations=[KEY1,KEY2,...]] + [--cpus=CPUS --memory=MEMORY --disable-auto-resize + | --enable-auto-resize] [--disable-aag-config | --enable-aag-config] + [--disable-auto-repair | --enable-auto-repair] + [--disable-vsphere-csi | --enable-vsphere-csi] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update an Anthos cluster on VMware. + +EXAMPLES + To update a cluster named my-cluster managed in location us-west1, run: + + $ gcloud container vmware clusters update my-cluster \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Cluster resource - cluster 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 cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +FLAGS + User cluster authorization configurations to bootstrap onto the admin + cluster + + --admin-users=ADMIN_USERS + Users that will be granted the cluster-admin role on the cluster, + providing full access to the cluster. + + To add multiple users, specify one in each flag. When updating, the + update command overwrites the whole grant list. Specify all existing + and new users that you want to be cluster administrators. + + Examples: + + $ gcloud container vmware clusters update + --admin-users alice@example.com + --admin-users bob@example.com + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description for the resource. + + Anthos on VMware cluster load balancer configurations + + Populate one of the load balancers. + + MetalLB Configuration + + At most one of these can be specified: + + --metal-lb-config-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL] + MetalLB load balancer configurations. + + Examples: + + To specify MetalLB load balancer configurations for two address + pools pool1 and pool2, + + $ gcloud gcloud container vmware clusters update + --metal-lb-config-address-pools 'pool=pool1,avoid-buggy-ips=True,manual-assign=True,addresses=192.168.1.1/32;192.168.1.2-192.168.1.3' + --metal-lb-config-address-pools 'pool=pool2,avoid-buggy-ips=False,manual-assign=False,addresses=192.168.2.1/32;192.168.2.2-192.168.2.3' + + Use quote around the flag value to escape semicolon in the + terminal. + + VMware User Cluster network configurations + + IP configuration used by the VMware User Cluster + + Static IP configuration group + + At most one of these can be specified: + + --static-ip-config-ip-blocks=[gateway=GATEWAY],[ips=IPS],[netmask=NETMASK] + Static IP configurations. + + Expect an individual IP address, an individual IP address with an + optional hostname, or a CIDR block. + + Example: + + To specify two Static IP blocks, + + $ gcloud gcloud container vmware clusters update + --static-ip-config-ip-blocks 'gateway=192.168.0.1,netmask=255.255.255.0,ips=192.168.1.1;0.0.0.0 localhost;192.168.1.2/16' + --static-ip-config-ip-blocks 'gateway=192.168.1.1,netmask=255.255.0.0,ips=8.8.8.8;4.4.4.4' + + Use quote around the flag value to escape semicolon in the + terminal. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + + --version=VERSION + Anthos Cluster on VMware version for the user cluster resource + + At most one of these can be specified: + + --add-annotations=[KEY1=VALUE1,KEY2=VALUE2,...] + Add the given key-value pairs to the current annotations, or update + its value if the key already exists. + + --remove-annotations=[KEY1,KEY2,...] + Remove annotations of the given keys. + + Control plane node configurations + + --cpus=CPUS + Number of CPUs for each admin cluster node that serve as control + planes for this VMware user cluster. (default: 4 CPUs) + + --memory=MEMORY + Megabytes of memory for each admin cluster node that serves as a + control plane for this VMware User Cluster (default: 8192 MB memory). + + Auto resize configurations + + At most one of these can be specified: + + --disable-auto-resize + Disable controle plane node auto resize. + + --enable-auto-resize + Enable controle plane node auto resize. + + Anti-affinity group configurations + + At most one of these can be specified: + + --disable-aag-config + If set, spread nodes across at least three physical hosts (requires + at least three hosts). Enabled by default. + + --enable-aag-config + If set, enable anti-affinity group config. + + Auto-repair configurations + + At most one of these can be specified: + + --disable-auto-repair + If set, disables auto repair. + + --enable-auto-repair + If set, deploy the cluster-health-controller. + + Storage configurations + + At most one of these can be specified: + + --disable-vsphere-csi + If set, vSphere CSI components are not deployed in the VMware User + Cluster. Enabled by default. + + --enable-vsphere-csi + If set, vSphere CSI components are deployed in the VMware User + Cluster. + +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 vmware clusters update + + $ gcloud beta container vmware clusters update + diff --git a/gcloud/container/vmware/clusters/upgrade b/gcloud/container/vmware/clusters/upgrade new file mode 100644 index 000000000..d1fe5f1a9 --- /dev/null +++ b/gcloud/container/vmware/clusters/upgrade @@ -0,0 +1,68 @@ +NAME + gcloud container vmware clusters upgrade - centrally upgrade an Anthos + cluster on VMware + +SYNOPSIS + gcloud container vmware clusters upgrade (CLUSTER : --location=LOCATION) + --version=VERSION [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Centrally upgrade an Anthos cluster on VMware. + +EXAMPLES + To upgrade a cluster named my-cluster managed in location us-west1 to + version 1.13.0-gke.1000, run: + + $ gcloud container vmware clusters upgrade my-cluster \ + --location=us-west1 --version=1.13.0-gke.1000 + +POSITIONAL ARGUMENTS + Cluster resource - cluster to upgrade 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +REQUIRED FLAGS + --version=VERSION + Anthos Cluster on VMware version for the user cluster resource + +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 vmware clusters upgrade + + $ gcloud beta container vmware clusters upgrade + diff --git a/gcloud/container/vmware/help b/gcloud/container/vmware/help new file mode 100644 index 000000000..fcbdc54a5 --- /dev/null +++ b/gcloud/container/vmware/help @@ -0,0 +1,37 @@ +NAME + gcloud container vmware - deploy and manage Anthos clusters on VMware for + running containers + +SYNOPSIS + gcloud container vmware GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Deploy and manage Anthos clusters on VMware for running containers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + admin-clusters + Create and manage admin clusters in Anthos on VMware. + + clusters + Create and manage Anthos clusters on VMware. + + node-pools + Create and manage node pools in an Anthos cluster on VMware. + + operations + Manage Anthos on VMware long running operations. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware + + $ gcloud beta container vmware + diff --git a/gcloud/container/vmware/node-pools/create b/gcloud/container/vmware/node-pools/create new file mode 100644 index 000000000..95746ee17 --- /dev/null +++ b/gcloud/container/vmware/node-pools/create @@ -0,0 +1,154 @@ +NAME + gcloud container vmware node-pools create - create a node pool in an Anthos + cluster on VMware + +SYNOPSIS + gcloud container vmware node-pools create + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) + (--image-type=IMAGE_TYPE : --boot-disk-size=BOOT_DISK_SIZE --cpus=CPUS + --enable-load-balancer --image=IMAGE --memory=MEMORY + --node-labels=[KEY=VALUE,...] + --node-taints=[KEY=VALUE:EFFECT,...] --replicas=REPLICAS) + [--annotations=[KEY=VALUE,...]] [--async] [--display-name=DISPLAY_NAME] + [--validate-only] + [--max-replicas=MAX_REPLICAS --min-replicas=MIN_REPLICAS] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a node pool in an Anthos cluster on VMware. + +EXAMPLES + To create a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container vmware node-pools create my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +REQUIRED FLAGS + Configuration of the node pool + + This must be specified. + + --image-type=IMAGE_TYPE + OS image type to use on node pool instances. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --boot-disk-size=BOOT_DISK_SIZE + Size of VMware disk to be used during creation in GB. + + --cpus=CPUS + Number of CPUs for each node in the node pool. + + --enable-load-balancer + If set, enable the use of load balancer on the node pool instances. + + --image=IMAGE + OS image name in vCenter. + + --memory=MEMORY + Size of memory for each node in the node pool in MB. + + --node-labels=[KEY=VALUE,...] + Kubernetes labels (key/value pairs) to be applied to each node. + + --node-taints=[KEY=VALUE:EFFECT,...] + Applies the given kubernetes taints on all nodes in the new node + pool, which can be used with tolerations for pod scheduling. + + Taint effect must be one of the following: NoSchedule, + PreferNoSchedule, or NoExecute. + + Examples: + + $ gcloud container vmware node-pools create node-pool-1 \ + --cluster=example-cluster \ + --node-taints=key1=val1:NoSchedule,key2=val2:PreferNoSchedule + + --replicas=REPLICAS + Number of replicas to use on node pool instances. + +OPTIONAL FLAGS + --annotations=[KEY=VALUE,...] + Annotations on the node pool. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --display-name=DISPLAY_NAME + Display name for the resource. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + + Node pool autoscaling + + --max-replicas=MAX_REPLICAS + Maximum number of replicas in the node pool. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --min-replicas=MIN_REPLICAS + Minimum number of replicas in the node pool. + + This flag argument must be specified if any of the other arguments in + this group are specified. + +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 vmware node-pools create + + $ gcloud beta container vmware node-pools create + diff --git a/gcloud/container/vmware/node-pools/delete b/gcloud/container/vmware/node-pools/delete new file mode 100644 index 000000000..6f61bd9a9 --- /dev/null +++ b/gcloud/container/vmware/node-pools/delete @@ -0,0 +1,90 @@ +NAME + gcloud container vmware node-pools delete - delete a node pool in an Anthos + cluster on VMware + +SYNOPSIS + gcloud container vmware node-pools delete + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--allow-missing] + [--async] [--ignore-errors] [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a node pool in an Anthos cluster on VMware. + +EXAMPLES + To delete a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container vmware node-pools delete my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +FLAGS + --allow-missing + If set, and the Vmware Node Pool is not found, the request will succeed + but no action will be taken. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --ignore-errors + If set, the deletion of a VMware node pool resource will succeed even + if errors occur during deletion. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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 vmware node-pools delete + + $ gcloud beta container vmware node-pools delete + diff --git a/gcloud/container/vmware/node-pools/describe b/gcloud/container/vmware/node-pools/describe new file mode 100644 index 000000000..170c138cd --- /dev/null +++ b/gcloud/container/vmware/node-pools/describe @@ -0,0 +1,73 @@ +NAME + gcloud container vmware node-pools describe - describe a node pool in an + Anthos cluster on VMware + +SYNOPSIS + gcloud container vmware node-pools describe + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a node pool in an Anthos cluster on VMware. + +EXAMPLES + To describe a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container vmware node-pools describe my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/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. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware node-pools describe + + $ gcloud beta container vmware node-pools describe + diff --git a/gcloud/container/vmware/node-pools/enroll b/gcloud/container/vmware/node-pools/enroll new file mode 100644 index 000000000..064af23cf --- /dev/null +++ b/gcloud/container/vmware/node-pools/enroll @@ -0,0 +1,78 @@ +NAME + gcloud container vmware node-pools enroll - enroll a node pool in an Anthos + cluster on VMware + +SYNOPSIS + gcloud container vmware node-pools enroll + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Enroll a node pool in an Anthos cluster on VMware. + +EXAMPLES + To enroll a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container vmware node-pools enroll my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool to enroll 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +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 container vmware node-pools enroll + + $ gcloud beta container vmware node-pools enroll + diff --git a/gcloud/container/vmware/node-pools/help b/gcloud/container/vmware/node-pools/help new file mode 100644 index 000000000..fae82201f --- /dev/null +++ b/gcloud/container/vmware/node-pools/help @@ -0,0 +1,43 @@ +NAME + gcloud container vmware node-pools - create and manage node pools in an + Anthos cluster on VMware + +SYNOPSIS + gcloud container vmware node-pools COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage node pools in an Anthos cluster on VMware. + +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 node pool in an Anthos cluster on VMware. + + delete + Delete a node pool in an Anthos cluster on VMware. + + describe + Describe a node pool in an Anthos cluster on VMware. + + enroll + Enroll a node pool in an Anthos cluster on VMware. + + list + List node pools in an Anthos cluster on VMware. + + update + Update a node pool in an Anthos cluster on VMware. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware node-pools + + $ gcloud beta container vmware node-pools + diff --git a/gcloud/container/vmware/node-pools/list b/gcloud/container/vmware/node-pools/list new file mode 100644 index 000000000..4fd8195a5 --- /dev/null +++ b/gcloud/container/vmware/node-pools/list @@ -0,0 +1,98 @@ +NAME + gcloud container vmware node-pools list - list node pools in an Anthos + cluster on VMware + +SYNOPSIS + gcloud container vmware node-pools list + (--cluster=CLUSTER : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List node pools in an Anthos cluster on VMware. + +EXAMPLES + To list all node pools in a cluster named my-cluster managed in location + us-west1, run: + + $ gcloud container vmware node-pools list --cluster=my-cluster \ + --location=us-west1 + +REQUIRED FLAGS + Cluster resource - cluster to list 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --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. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Google Cloud location for the cluster. + + To set the location attribute: + ▸ provide the argument --cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +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 container vmware node-pools list + + $ gcloud beta container vmware node-pools list + diff --git a/gcloud/container/vmware/node-pools/update b/gcloud/container/vmware/node-pools/update new file mode 100644 index 000000000..d4c267eec --- /dev/null +++ b/gcloud/container/vmware/node-pools/update @@ -0,0 +1,144 @@ +NAME + gcloud container vmware node-pools update - update a node pool in an Anthos + cluster on VMware + +SYNOPSIS + gcloud container vmware node-pools update + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] + [--display-name=DISPLAY_NAME] [--validate-only] + [--boot-disk-size=BOOT_DISK_SIZE --cpus=CPUS --image=IMAGE + --image-type=IMAGE_TYPE --memory=MEMORY --node-labels=[KEY=VALUE,...] + --node-taints=[KEY=VALUE:EFFECT,...] + --replicas=REPLICAS --disable-load-balancer | --enable-load-balancer] + [--max-replicas=MAX_REPLICAS --min-replicas=MIN_REPLICAS] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a node pool in an Anthos cluster on VMware. + +EXAMPLES + To update a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud container vmware node-pools update my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. + + To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. + + To set the location attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --display-name=DISPLAY_NAME + Display name for the resource. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + + Configuration of the node pool + + --boot-disk-size=BOOT_DISK_SIZE + Size of VMware disk to be used during creation in GB. + + --cpus=CPUS + Number of CPUs for each node in the node pool. + + --image=IMAGE + OS image name in vCenter. + + --image-type=IMAGE_TYPE + OS image type to use on node pool instances. + + --memory=MEMORY + Size of memory for each node in the node pool in MB. + + --node-labels=[KEY=VALUE,...] + Kubernetes labels (key/value pairs) to be applied to each node. + + --node-taints=[KEY=VALUE:EFFECT,...] + Applies the given kubernetes taints on all nodes in the new node + pool, which can be used with tolerations for pod scheduling. + + Taint effect must be one of the following: NoSchedule, + PreferNoSchedule, or NoExecute. + + Examples: + + $ gcloud container vmware node-pools update node-pool-1 \ + --cluster=example-cluster \ + --node-taints=key1=val1:NoSchedule,key2=val2:PreferNoSchedule + + --replicas=REPLICAS + Number of replicas to use on node pool instances. + + At most one of these can be specified: + + --disable-load-balancer + If set, disable the use of load balancer on the node pool + instances. + + --enable-load-balancer + If set, enable the use of load balancer on the node pool instances. + + Node pool autoscaling + + --max-replicas=MAX_REPLICAS + Maximum number of replicas in the node pool. + + --min-replicas=MIN_REPLICAS + Minimum number of replicas in the node pool. + +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 vmware node-pools update + + $ gcloud beta container vmware node-pools update + diff --git a/gcloud/container/vmware/operations/describe b/gcloud/container/vmware/operations/describe new file mode 100644 index 000000000..9a0dd0393 --- /dev/null +++ b/gcloud/container/vmware/operations/describe @@ -0,0 +1,63 @@ +NAME + gcloud container vmware operations describe - describe an operation + +SYNOPSIS + gcloud container vmware operations describe + (OPERATION_ID : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an operation. + +EXAMPLES + To describe an operation in location us-west1, run: + + $ gcloud container vmware operations describe OPERATION_ID \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Operation resource - 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_id 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. + + OPERATION_ID + ID of the operation or fully qualified identifier for the operation. + + To set the name attribute: + ▸ provide the argument operation_id on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the operation. + + To set the location attribute: + ▸ provide the argument operation_id on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/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. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware operations describe + + $ gcloud beta container vmware operations describe + diff --git a/gcloud/container/vmware/operations/help b/gcloud/container/vmware/operations/help new file mode 100644 index 000000000..32c3a7139 --- /dev/null +++ b/gcloud/container/vmware/operations/help @@ -0,0 +1,34 @@ +NAME + gcloud container vmware operations - manage Anthos on VMware long running + operations + +SYNOPSIS + gcloud container vmware operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Anthos on VMware 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 an operation. + + list + List operations. + + wait + Poll an operation for completion. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware operations + + $ gcloud beta container vmware operations + diff --git a/gcloud/container/vmware/operations/list b/gcloud/container/vmware/operations/list new file mode 100644 index 000000000..aec6685b0 --- /dev/null +++ b/gcloud/container/vmware/operations/list @@ -0,0 +1,83 @@ +NAME + gcloud container vmware operations list - list operations + +SYNOPSIS + gcloud container vmware operations list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List operations. + +EXAMPLES + To list all operations in location us-west1, run: + + $ gcloud container vmware operations list --location=us-west1 + +FLAGS + Location resource - Google Cloud location to list 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; + ◆ set the property container_vmware/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 container_vmware/location. + +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 container vmware operations list + + $ gcloud beta container vmware operations list + diff --git a/gcloud/container/vmware/operations/wait b/gcloud/container/vmware/operations/wait new file mode 100644 index 000000000..33c44723d --- /dev/null +++ b/gcloud/container/vmware/operations/wait @@ -0,0 +1,63 @@ +NAME + gcloud container vmware operations wait - poll an operation for completion + +SYNOPSIS + gcloud container vmware operations wait + (OPERATION_ID : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Poll an operation for completion. + +EXAMPLES + To wait for an operation in location us-west1 to complete, run: + + $ gcloud container vmware operations wait OPERATION_ID \ + --location=us-west1 + +POSITIONAL ARGUMENTS + Operation resource - operation to wait for completion. 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_id 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. + + OPERATION_ID + ID of the operation or fully qualified identifier for the operation. + + To set the name attribute: + ▸ provide the argument operation_id on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the operation. + + To set the location attribute: + ▸ provide the argument operation_id on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_vmware/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. + +NOTES + These variants are also available: + + $ gcloud alpha container vmware operations wait + + $ gcloud beta container vmware operations wait + diff --git a/gcloud/edge-cloud/container/clusters/create b/gcloud/edge-cloud/container/clusters/create index 47fe3f181..b59c31a77 100644 --- a/gcloud/edge-cloud/container/clusters/create +++ b/gcloud/edge-cloud/container/clusters/create @@ -6,6 +6,7 @@ SYNOPSIS gcloud edge-cloud container clusters create (CLUSTER : --location=LOCATION) [--admin-users=ADMIN_USERS] [--async] [--cluster-ipv4-cidr=CLUSTER_IPV4_CIDR; default="10.0.0.0/17"] + [--control-plane-kms-key=CONTROL_PLANE_KMS_KEY] [--control-plane-machine-filter=CONTROL_PLANE_MACHINE_FILTER] [--control-plane-node-count=CONTROL_PLANE_NODE_COUNT] [--control-plane-node-location=CONTROL_PLANE_NODE_LOCATION] @@ -78,6 +79,14 @@ FLAGS All pods in the cluster are assigned an RFC1918 IPv4 address from this block. This field cannot be changed after creation. + --control-plane-kms-key=CONTROL_PLANE_KMS_KEY + Google Cloud KMS key that will be used to secure persistent disks of + the control plane VMs of a remote control plane cluster. The Edge + Container service account for this project must have + roles/cloudkms.cryptoKeyEncrypterDecrypter on the key. + + If not provided, a Google-managed key will be used by default. + --control-plane-machine-filter=CONTROL_PLANE_MACHINE_FILTER Only machines matching this filter will be allowed to host local control plane nodes. The filtering language accepts strings like diff --git a/gcloud/eventarc/triggers/create b/gcloud/eventarc/triggers/create index 9b0f235fe..4504973c2 100644 --- a/gcloud/eventarc/triggers/create +++ b/gcloud/eventarc/triggers/create @@ -9,6 +9,8 @@ SYNOPSIS : --destination-gke-location=DESTINATION_GKE_LOCATION --destination-gke-namespace=DESTINATION_GKE_NAMESPACE --destination-gke-path=DESTINATION_GKE_PATH] + | [--destination-http-endpoint-uri=DESTINATION_HTTP_ENDPOINT_URI + : --network-attachment=NETWORK_ATTACHMENT] | [--destination-run-service=DESTINATION_RUN_SERVICE : --destination-run-path=DESTINATION_RUN_PATH --destination-run-region=DESTINATION_RUN_REGION]) [--async] @@ -104,6 +106,20 @@ REQUIRED FLAGS for the trigger should be sent. Examples: /route, route, route/subroute. + Flags for specifying a HTTP Endpoint destination. + + --destination-http-endpoint-uri=DESTINATION_HTTP_ENDPOINT_URI + URI that the destination HTTP Endpoint is connecting to. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Flags for specifying a Network Config for the destination. + + --network-attachment=NETWORK_ATTACHMENT + The network attachment associated with the trigger that allows + access to the destination VPC. + Flags for specifying a Cloud Run fully-managed resource destination. --destination-run-service=DESTINATION_RUN_SERVICE diff --git a/gcloud/healthcare/hl7v2-stores/create b/gcloud/healthcare/hl7v2-stores/create index b0feab65e..19d55ff04 100644 --- a/gcloud/healthcare/hl7v2-stores/create +++ b/gcloud/healthcare/hl7v2-stores/create @@ -6,7 +6,7 @@ SYNOPSIS gcloud healthcare hl7v2-stores create (HL7V2_STORE : --dataset=DATASET --location=LOCATION) [--notification-config=[filter=FILTER],[pubsub-topic=PUBSUB-TOPIC]] - [GCLOUD_WIDE_FLAG ...] + [--parser-version=PARSER_VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Cloud Healthcare API HL7v2 store. @@ -83,6 +83,32 @@ FLAGS For instructions on creating topics, refer to: https://cloud.google.com/pubsub/docs/admin#create_a_topic + --parser-version=PARSER_VERSION + Immutable. Determines the version of both the default parser to be used + when schema + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig.FIELDS.schema) + is not given, as well as the schematized parser used when schema + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig.FIELDS.schema) + is specified. This field is immutable after HL7v2 store creation. + PARSER_VERSION must be one of: + + v1 + The parsedData includes every given non-empty message field except + the Field Separator (MSH-1) field. As a result, the parsed MSH + segment starts with the MSH-2 field and the field numbers are + off-by-one with respect to the HL7 standard. + v2 + The parsedData includes every given non-empty message field. + + v3 + This version is the same as V2, with the following change. The + parsedData contains unescaped escaped field separators, component + separators, sub-component separators, repetition separators, escape + characters, and truncation characters. If schema + (https://cloud.google.com/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig.FIELDS.schema) + is specified, the schematized parser uses improved parsing + heuristics compared to previous versions. + 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/healthcare/hl7v2-stores/help b/gcloud/healthcare/hl7v2-stores/help index fffb83808..147db1886 100644 --- a/gcloud/healthcare/hl7v2-stores/help +++ b/gcloud/healthcare/hl7v2-stores/help @@ -49,7 +49,7 @@ COMMANDS Set the IAM policy for a Cloud Healthcare API HL7v2 store. update - Create a Cloud Healthcare API HL7v2 store. + Update a Cloud Healthcare API HL7v2 store. NOTES These variants are also available: diff --git a/gcloud/healthcare/hl7v2-stores/update b/gcloud/healthcare/hl7v2-stores/update index 08f6b96a8..9e7b2701c 100644 --- a/gcloud/healthcare/hl7v2-stores/update +++ b/gcloud/healthcare/hl7v2-stores/update @@ -1,5 +1,5 @@ NAME - gcloud healthcare hl7v2-stores update - create a Cloud Healthcare API HL7v2 + gcloud healthcare hl7v2-stores update - update a Cloud Healthcare API HL7v2 store SYNOPSIS @@ -9,7 +9,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Create a Cloud Healthcare API HL7v2 store. + Update a Cloud Healthcare API HL7v2 store. EXAMPLES To update the Cloud Pub/Sub topics on a HL7v2 store test-hl7v2-store, run: @@ -21,7 +21,7 @@ EXAMPLES test-pubsub-topic2 POSITIONAL ARGUMENTS - Hl7v2Store resource - Cloud Healthcare API HL7v2 store to create. The + Hl7v2Store resource - Cloud Healthcare API HL7v2 store 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. diff --git a/gcloud/infra-manager/deployments/apply b/gcloud/infra-manager/deployments/apply new file mode 100644 index 000000000..ef129d2c8 --- /dev/null +++ b/gcloud/infra-manager/deployments/apply @@ -0,0 +1,246 @@ +NAME + gcloud infra-manager deployments apply - create or update a deployment + +SYNOPSIS + gcloud infra-manager deployments apply (DEPLOYMENT : --location=LOCATION) + [--artifacts-gcs-bucket=ARTIFACTS_GCS_BUCKET] [--async] + [--import-existing-resources=IMPORT_EXISTING_RESOURCES] + [--labels=[KEY=VALUE,...]] [--service-account=SERVICE_ACCOUNT] + [--worker-pool=WORKER_POOL] + [--gcs-source=GCS_SOURCE | --git-source-directory=GIT_SOURCE_DIRECTORY + --git-source-ref=GIT_SOURCE_REF --git-source-repo=GIT_SOURCE_REPO + | --ignore-file=IGNORE_FILE + --local-source=LOCAL_SOURCE --input-values=[KEY=VALUE,...] + | --inputs-file=INPUTS_FILE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command updates a deployment when it already exists, otherwise the + deployment will be created. + +EXAMPLES + Create a deployment named my-deployment from a storage my-bucket: + + $ gcloud infra-manager deployments apply \ + projects/p1/locations/us-central1/deployments/my-deployment \ + --gcs-source="gs://my-bucket" \ + --input-values="project=p1,region=us-central1" + + Create a deployment named my-deployment from git repo + "https://github.com/examples/repository.git", "staging/compute" folder, + "mainline" branch: + + $ gcloud infra-manager deployments apply \ + projects/p1/locations/us-central1/deployments/my-deployment \ + --git-source-repo="https://github.com/examples/repository.git" \ + --git-source-directory="staging/compute" \ + --git-source-ref="mainline" + + Update a deployment's labels: + + $ gcloud infra-manager deployments apply \ + projects/p1/locations/us-central1/deployments/my-deployment \ + --git-source-repo="https://github.com/examples/repository.git" \ + --git-source-directory="staging/compute" \ + --git-source-ref="mainline" --labels="env=prod,team=finance" + +POSITIONAL ARGUMENTS + Deployment resource - the deployment to create or 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 DEPLOYMENT 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. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the deployment. + + To set the location attribute: + ▸ provide the argument DEPLOYMENT on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property blueprints/location. + +FLAGS + --artifacts-gcs-bucket=ARTIFACTS_GCS_BUCKET + user-defined location of Cloud Build logs, artifacts, and Terraform + state files in Google Cloud Storage. Format: gs://{bucket}/{folder} A + default bucket will be bootstrapped if the field is not set or empty + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --import-existing-resources=IMPORT_EXISTING_RESOURCES + By default, Infrastructure Manager will return a failure when Terraform + encounters a 409 code (resource conflict error) during actuation. If + this flag is set to true, Infrastructure Manager will instead attempt + to automatically import the resource into the Terraform state (for + supported resource types) and continue actuation. + + --labels=[KEY=VALUE,...] + Labels to apply to the deployment. Existing values are overwritten. To + retain the existing labels on a deployment, do not specify this flag. + + Examples: + + Update labels for an existing deployment: + + $ gcloud infra-manager deployments apply \ + projects/p1/location/us-central1/deployments/my-deployment \ + --gcs-source="gs://my-bucket" --labels="env=prod,team=finance" + + Clear labels for an existing deployment: + + $ gcloud infra-manager deployments apply \ + projects/p1/location/us-central1/deployments/my-deployment \ + --gcs-source="gs://my-bucket" --labels="" + + Add a label to an existing deployment: + + First, fetch the current labels using the `describe` command, then follow the + preceding example for updating labels. + + --service-account=SERVICE_ACCOUNT + User-specified Service Account (SA) to be used as credential to manage + resources. Format: + projects/{projectID}/serviceAccounts/{serviceAccount} + + --worker-pool=WORKER_POOL + User-specified Worker Pool resource in which the Cloud Build jobwill + execute. Format: + projects/{project}/locations/{location}/workerPools/{workerPoolId} + + At most one of these can be specified: + + --gcs-source=GCS_SOURCE + URI of an object in Google Cloud Storage. e.g. gs://{bucket}/{object} + + Examples: + + Create a deployment from a storage my-bucket: + + $ gcloud infra-manager deployments apply \ + projects/p1/location/us-central1/deployments/my-deployment \ + --gcs-source="gs://my-bucket" + + --git-source-directory=GIT_SOURCE_DIRECTORY + Subdirectory inside the repository. Example: 'staging/my-package' + + Use in conjunction with --git-source-repo and --git-source-ref + + Examples: + + Create a deployment from the + "https://github.com/examples/repository.git" repo, "staging/compute" + folder, "mainline" branch: + + $ gcloud infra-manager deployments apply \ + projects/p1/location/us-central1/deployments/my-deployment \ + --git-source-repo="https://github.com/examples/repository.git" + --git-source-directory="staging/compute" --git-source-ref="mainline" + + --git-source-ref=GIT_SOURCE_REF + Subdirectory inside the repository. Example: 'staging/my-package' + + Use in conjunction with --git-source-repo and --git-source-directory + + Examples: + + Create a deployment from the + "https://github.com/examples/repository.git" repo, "staging/compute" + folder, "mainline" branch: + + $ gcloud infra-manager deployments apply \ + projects/p1/location/us-central1/deployments/my-deployment \ + --git-source-repo="https://github.com/examples/repository.git" + --git-source-directory="staging/compute" --git-source-ref="mainline" + + --git-source-repo=GIT_SOURCE_REPO + Repository URL. Example: 'https://github.com/examples/repository.git' + + Use in conjunction with --git-source-directory and --git-source_ref + + Examples: + + Create a deployment from the + "https://github.com/examples/repository.git" repo, "staging/compute" + folder, "mainline" branch: + + $ gcloud infra-manager deployments apply \ + projects/p1/location/us-central1/deployments/my-deployment \ + --git-source-repo="https://github.com/examples/repository.git" + --git-source-directory="staging/compute" --git-source-ref="mainline" + + --ignore-file=IGNORE_FILE + Override the .gcloudignore file and use the specified file instead. + See gcloud topic gcloudignore for more information. + + --local-source=LOCAL_SOURCE + Local storage path where config files are stored. e.g. + ./path/to/blueprint + + Examples: + + Create a deployment from a local storage path ./path/to/blueprint: + + $ gcloud infra-manager deployments apply \ + projects/p1/location/us-central1/deployments/my-deployment \ + --local-source="./path/to/blueprint" + + At most one of these can be specified: + + --input-values=[KEY=VALUE,...] + Input variable values for the Terraform blueprint. It only accepts + (key, value) pairs where value is a scalar value. + + Examples: + + Pass input values on command line: + + $ gcloud infra-manager deployments apply \ + projects/p1/location/us-central1/deployments/my-deployment \ + --gcs-source="gs://my-bucket" \ + --input-values=projects=p1,region=r + + --inputs-file=INPUTS_FILE + A .tfvars file containing terraform variable values. --inputs-file + flag is supported for python version 3.6 and above. + + Examples: + + Pass input values on the command line: + + $ gcloud infra-manager deployments apply \ + projects/p1/location/us-central1/deployments/my-deployment \ + --gcs-source="gs://my-bucket" \ + --inputs-file=path-to-tfvar-file.tfvar + +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 variant is also available: + + $ gcloud alpha infra-manager deployments apply + diff --git a/gcloud/infra-manager/deployments/delete b/gcloud/infra-manager/deployments/delete new file mode 100644 index 000000000..d772c1215 --- /dev/null +++ b/gcloud/infra-manager/deployments/delete @@ -0,0 +1,77 @@ +NAME + gcloud infra-manager deployments delete - delete deployments + +SYNOPSIS + gcloud infra-manager deployments delete (DEPLOYMENT : --location=LOCATION) + [--async] [--delete-policy=DELETE_POLICY] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a deployment + +EXAMPLES + To delete the deployment example-deployment at location us-central1, run: + + $ gcloud infra-manager deployments delete \ + projects/example-project/locations/us-central1/deployments/\ + example-deployment + +POSITIONAL ARGUMENTS + Deployment resource - deployments TBD 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 deployment 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. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument deployment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument deployment on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --delete-policy=DELETE_POLICY + Policy on how resources actuated by the deployment should be deleted. + The accepted values are DELETE, ABANDON. DELETE = Delete resources + actuated by the deployment. ABANDON = Abandon resources and only delete + deployment metadata. DELETE_POLICY must be one of: abandon, delete, + delete-policy-unspecified. + +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 config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager deployments delete + diff --git a/gcloud/infra-manager/deployments/describe b/gcloud/infra-manager/deployments/describe new file mode 100644 index 000000000..80db36358 --- /dev/null +++ b/gcloud/infra-manager/deployments/describe @@ -0,0 +1,66 @@ +NAME + gcloud infra-manager deployments describe - describe deployments + +SYNOPSIS + gcloud infra-manager deployments describe + (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a deployment + +EXAMPLES + To describe a deployment example-deployment in project p1 at location + us-central1, run: + + $ gcloud infra-manager deployments describe \ + projects/p1/locations/us-central1/deployments/example-deployment + +POSITIONAL ARGUMENTS + Deployment resource - The deployment 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 deployment 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. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument deployment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument deployment on the command line with a fully + specified name; + ▸ provide the argument --location 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. + +API REFERENCE + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager deployments describe + diff --git a/gcloud/infra-manager/deployments/export-lock b/gcloud/infra-manager/deployments/export-lock new file mode 100644 index 000000000..56aa92dd2 --- /dev/null +++ b/gcloud/infra-manager/deployments/export-lock @@ -0,0 +1,64 @@ +NAME + gcloud infra-manager deployments export-lock - exports lock info of a + deployment + +SYNOPSIS + gcloud infra-manager deployments export-lock + (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command exports lock info of a deployment. + +EXAMPLES + Export lock info for deployment + projects/p1/locations/us-central1/deployments/my-deployment: + + $ gcloud infra-manager deployments export-lock \ + projects/p1/locations/us-central1/deployments/my-deployment + +POSITIONAL ARGUMENTS + Deployment resource - the deployment to be used as parent. 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 DEPLOYMENT 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. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the deployment. + + To set the location attribute: + ▸ provide the argument DEPLOYMENT on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property blueprints/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. + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager deployments export-lock + diff --git a/gcloud/infra-manager/deployments/export-statefile b/gcloud/infra-manager/deployments/export-statefile new file mode 100644 index 000000000..d376b3c5e --- /dev/null +++ b/gcloud/infra-manager/deployments/export-statefile @@ -0,0 +1,68 @@ +NAME + gcloud infra-manager deployments export-statefile - export a terraform + state file + +SYNOPSIS + gcloud infra-manager deployments export-statefile + (DEPLOYMENT : --location=LOCATION) [--draft] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command generates a signed url to download a terraform state file. + +EXAMPLES + Export state file for my-deployment: + + $ gcloud infra-manager deployments export-statefile \ + projects/p1/locations/us-central1/deployments/my-deployment + +POSITIONAL ARGUMENTS + Deployment resource - the deployment to be used as parent. 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 DEPLOYMENT 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. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the deployment. + + To set the location attribute: + ▸ provide the argument DEPLOYMENT on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property blueprints/location. + +FLAGS + --draft + If this flag is set to true, the exported deployment state file will be + the draft state + +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 variant is also available: + + $ gcloud alpha infra-manager deployments export-statefile + diff --git a/gcloud/infra-manager/deployments/help b/gcloud/infra-manager/deployments/help new file mode 100644 index 000000000..017dde740 --- /dev/null +++ b/gcloud/infra-manager/deployments/help @@ -0,0 +1,49 @@ +NAME + gcloud infra-manager deployments - manage Deployment resources + +SYNOPSIS + gcloud infra-manager deployments COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Deployment resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + apply + Create or update a deployment. + + delete + Delete deployments. + + describe + Describe deployments. + + export-lock + Exports lock info of a deployment. + + export-statefile + Export a terraform state file. + + import-statefile + Import a terraform state file. + + list + List deployments. + + lock + Locks the deployment. + + unlock + Unlocks the deployment. + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager deployments + diff --git a/gcloud/infra-manager/deployments/import-statefile b/gcloud/infra-manager/deployments/import-statefile new file mode 100644 index 000000000..69c3e1b22 --- /dev/null +++ b/gcloud/infra-manager/deployments/import-statefile @@ -0,0 +1,69 @@ +NAME + gcloud infra-manager deployments import-statefile - import a terraform + state file + +SYNOPSIS + gcloud infra-manager deployments import-statefile + (DEPLOYMENT : --location=LOCATION) --lock-id=LOCK_ID + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command generates a signed url to upload a terraform state file. + +EXAMPLES + Import state file for my-deployment with lock-id 1658343229583347: + + $ gcloud infra-manager deployments import-statefile \ + projects/p1/locations/us-central1/deployments/my-deployment \ + --lock-id=1658343229583347 + +POSITIONAL ARGUMENTS + Deployment resource - the deployment to be used as parent. 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 DEPLOYMENT 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. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the deployment. + + To set the location attribute: + ▸ provide the argument DEPLOYMENT on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property blueprints/location. + +REQUIRED FLAGS + --lock-id=LOCK_ID + Lock ID of the lock file to verify person importing owns lock. + +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 variant is also available: + + $ gcloud alpha infra-manager deployments import-statefile + diff --git a/gcloud/infra-manager/deployments/list b/gcloud/infra-manager/deployments/list new file mode 100644 index 000000000..e2cf89cf7 --- /dev/null +++ b/gcloud/infra-manager/deployments/list @@ -0,0 +1,84 @@ +NAME + gcloud infra-manager deployments list - list deployments + +SYNOPSIS + gcloud infra-manager deployments list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List deployments + +EXAMPLES + To list all deployments at location us-central1, run: + + $ gcloud infra-manager deployments list --location=us-central1 + +REQUIRED FLAGS + Location resource - Location to list deployments 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 core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + --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. + +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 config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager deployments list + diff --git a/gcloud/infra-manager/deployments/lock b/gcloud/infra-manager/deployments/lock new file mode 100644 index 000000000..c80546099 --- /dev/null +++ b/gcloud/infra-manager/deployments/lock @@ -0,0 +1,67 @@ +NAME + gcloud infra-manager deployments lock - locks the deployment + +SYNOPSIS + gcloud infra-manager deployments lock (DEPLOYMENT : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command locks the deployment and generates a lockId. + +EXAMPLES + Lock deployment my-deployment under project p1 and location us-central1: + + $ gcloud infra-manager deployments lock \ + projects/p1/locations/us-central1/deployments/my-deployment + +POSITIONAL ARGUMENTS + Deployment resource - the deployment to be used as parent. 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 DEPLOYMENT 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. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the deployment. + + To set the location attribute: + ▸ provide the argument DEPLOYMENT on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property blueprints/location. + +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 variant is also available: + + $ gcloud alpha infra-manager deployments lock + diff --git a/gcloud/infra-manager/deployments/unlock b/gcloud/infra-manager/deployments/unlock new file mode 100644 index 000000000..079ad09e6 --- /dev/null +++ b/gcloud/infra-manager/deployments/unlock @@ -0,0 +1,73 @@ +NAME + gcloud infra-manager deployments unlock - unlocks the deployment + +SYNOPSIS + gcloud infra-manager deployments unlock (DEPLOYMENT : --location=LOCATION) + --lock-id=LOCK_ID [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command releases the lock on deployment. + +EXAMPLES + Unlock deployment my-deployment under project p1 and location us-central1 + with lock-id 1234: + + $ gcloud infra-manager deployments unlock \ + projects/p1/locations/us-central1/deployments/my-deployment \ + --lock-id=1234 + +POSITIONAL ARGUMENTS + Deployment resource - the deployment to be used as parent. 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 DEPLOYMENT 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. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the deployment. + + To set the location attribute: + ▸ provide the argument DEPLOYMENT on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property blueprints/location. + +REQUIRED FLAGS + --lock-id=LOCK_ID + Lock ID of the lock file to verify person importing owns lock. + +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 variant is also available: + + $ gcloud alpha infra-manager deployments unlock + diff --git a/gcloud/infra-manager/help b/gcloud/infra-manager/help new file mode 100644 index 000000000..545b9bd70 --- /dev/null +++ b/gcloud/infra-manager/help @@ -0,0 +1,31 @@ +NAME + gcloud infra-manager - manage Infra Manager resources + +SYNOPSIS + gcloud infra-manager GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Infra Manager resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + deployments + Manage Deployment resources. + + resources + List or describe resources under a Revision. + + revisions + Manage Revision resources. + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager + diff --git a/gcloud/infra-manager/resources/describe b/gcloud/infra-manager/resources/describe new file mode 100644 index 000000000..a66ff4415 --- /dev/null +++ b/gcloud/infra-manager/resources/describe @@ -0,0 +1,85 @@ +NAME + gcloud infra-manager resources describe - describe resources + +SYNOPSIS + gcloud infra-manager resources describe + (RESOURCE + : --deployment=DEPLOYMENT --location=LOCATION --revision=REVISION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a resource + +EXAMPLES + To describe a resource compute-resource under revision + projects/p1/locations/us-central1/deployments/example-deployment/revisions/r-0, + run: + + $ gcloud infra-manager resources describe \ + projects/p1/locations/us-central1/deployments/\ + example-deployment/revisions/r-0/resources/compute-resource + +POSITIONAL ARGUMENTS + Resource resource - The resource 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 resource 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. + + RESOURCE + ID of the resource or fully qualified identifier for the resource. + + To set the resource attribute: + ▸ provide the argument resource on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --deployment=DEPLOYMENT + deployments TBD + + To set the deployment attribute: + ▸ provide the argument resource on the command line with a fully + specified name; + ▸ provide the argument --deployment on the command line. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument resource on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --revision=REVISION + revisions TBD + + To set the revision attribute: + ▸ provide the argument resource on the command line with a fully + specified name; + ▸ provide the argument --revision 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. + +API REFERENCE + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager resources describe + diff --git a/gcloud/infra-manager/resources/help b/gcloud/infra-manager/resources/help new file mode 100644 index 000000000..e824edcb2 --- /dev/null +++ b/gcloud/infra-manager/resources/help @@ -0,0 +1,29 @@ +NAME + gcloud infra-manager resources - list or describe resources under a + Revision + +SYNOPSIS + gcloud infra-manager resources COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List or describe resources under a Revision. + +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 resources. + + list + List resources. + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager resources + diff --git a/gcloud/infra-manager/resources/list b/gcloud/infra-manager/resources/list new file mode 100644 index 000000000..59c945cd2 --- /dev/null +++ b/gcloud/infra-manager/resources/list @@ -0,0 +1,107 @@ +NAME + gcloud infra-manager resources list - list resources + +SYNOPSIS + gcloud infra-manager resources list + (--revision=REVISION : --deployment=DEPLOYMENT --location=LOCATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List resources for a deployment revision + +EXAMPLES + To list all resources for a deployment revision, + projects/p1/locations/l1/deployments/d1/revisions/r-0, run: + + $ gcloud infra-manager resources list \ + --revision=projects/p1/locations/l1/deployments/d1/revisions/r-0 + +REQUIRED FLAGS + Revision resource - The deployment revision for which we want to list all + resources. 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 --revision 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. + + --revision=REVISION + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument --revision on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --deployment=DEPLOYMENT + deployments TBD + + To set the deployment attribute: + ▸ provide the argument --revision on the command line with a fully + specified name; + ▸ provide the argument --deployment on the command line. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument --revision on the command line with a fully + specified name; + ▸ provide the argument --location 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. + +API REFERENCE + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager resources list + diff --git a/gcloud/infra-manager/revisions/describe b/gcloud/infra-manager/revisions/describe new file mode 100644 index 000000000..e76403de1 --- /dev/null +++ b/gcloud/infra-manager/revisions/describe @@ -0,0 +1,75 @@ +NAME + gcloud infra-manager revisions describe - describe revisions + +SYNOPSIS + gcloud infra-manager revisions describe + (REVISION : --deployment=DEPLOYMENT --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a revision + +EXAMPLES + To describe the revision r-0 under deployment example-deployment at + location us-central1, run: + + $ gcloud infra-manager revisions describe \ + projects/p1/locations/us-central1/deployments/\ + example-deployment/revisions/r-0 + +POSITIONAL ARGUMENTS + Revision resource - The revision 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 revision 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. + + REVISION + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument revision on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --deployment=DEPLOYMENT + deployments TBD + + To set the deployment attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --deployment on the command line. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --location 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. + +API REFERENCE + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager revisions describe + diff --git a/gcloud/infra-manager/revisions/export-statefile b/gcloud/infra-manager/revisions/export-statefile new file mode 100644 index 000000000..ad68668c8 --- /dev/null +++ b/gcloud/infra-manager/revisions/export-statefile @@ -0,0 +1,72 @@ +NAME + gcloud infra-manager revisions export-statefile - export a terraform state + file + +SYNOPSIS + gcloud infra-manager revisions export-statefile + (REVISION : --deployment=DEPLOYMENT --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command generates a signed url to download a terraform state file. + +EXAMPLES + Export state file for revision + projects/p1/locations/l1/deployments/d1/revisions/r-0: + + $ gcloud infra-manager revisions export-statefile \ + projects/p1/locations/l1/deployments/d1/revisions/r-0 + +POSITIONAL ARGUMENTS + Revision resource - the revision to be used as parent. 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 REVISION 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. + + REVISION + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument REVISION on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --deployment=DEPLOYMENT + The deployment for the revision. + + To set the deployment attribute: + ▸ provide the argument REVISION on the command line with a fully + specified name; + ▸ provide the argument --deployment on the command line. + + --location=LOCATION + The Cloud location for the revision. + + To set the location attribute: + ▸ provide the argument REVISION on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property blueprints/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. + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager revisions export-statefile + diff --git a/gcloud/infra-manager/revisions/help b/gcloud/infra-manager/revisions/help new file mode 100644 index 000000000..ed06f21f4 --- /dev/null +++ b/gcloud/infra-manager/revisions/help @@ -0,0 +1,31 @@ +NAME + gcloud infra-manager revisions - manage Revision resources + +SYNOPSIS + gcloud infra-manager revisions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Revision resources. + +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 revisions. + + export-statefile + Export a terraform state file. + + list + List revisions. + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager revisions + diff --git a/gcloud/infra-manager/revisions/list b/gcloud/infra-manager/revisions/list new file mode 100644 index 000000000..0638ac75a --- /dev/null +++ b/gcloud/infra-manager/revisions/list @@ -0,0 +1,100 @@ +NAME + gcloud infra-manager revisions list - list revisions + +SYNOPSIS + gcloud infra-manager revisions list + (--deployment=DEPLOYMENT : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List revisions for a deployment + +EXAMPLES + To list all revisions for deployment + projects/p1/locations/l1/deployments/d1, run: + + $ gcloud infra-manager revisions list \ + --deployment=projects/p1/locations/l1/deployments/d1 + +REQUIRED FLAGS + Deployment resource - The deployment for which we want to list all + revisions. 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 --deployment 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. + + --deployment=DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument --deployment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument --deployment on the command line with a + fully specified name; + ▸ provide the argument --location 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. + +API REFERENCE + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/ + +NOTES + This variant is also available: + + $ gcloud alpha infra-manager revisions list + diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index 964d76bc1..9981b0b61 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -90,10 +90,8 @@ REQUIRED FLAGS unit is specified, GiB is assumed. --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files VolumeValid - component values are: NFSV3, NFSV4, SMB - - For more information, look athttps://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#protocols. + Type of File System protocols for the Cloud NetApp Files Volume. Valid + component values are: NFSV3, NFSV4, SMB. --share-name=SHARE_NAME Share name of the Mount path clients will use. @@ -156,11 +154,8 @@ OPTIONAL FLAGS numbers. --restricted-actions=RESTRICTED_ACTION,[...] - Actions to be restricted for a volume.Valid restricted action options - are: 'DELETE' - - For more information, look at - https://cloud.google.com/netapp/volumes/docs/reference/rest/v1/projects.locations.volumes#restrictedaction. + Actions to be restricted for a volume. Valid restricted action options + are: 'DELETE'. --security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED" The security style of the Volume. This can either be UNIX or NTFS. @@ -173,13 +168,11 @@ OPTIONAL FLAGS UNIX security style for Volume --smb-settings=SMB_SETTING,[SMB_SETTING,...] - List of settings specific to SMB protocolfor a Cloud NetApp Files - VolumeValid component values are: ENCRYPT_DATA, BROWSABLE, + List of settings specific to SMB protocol for a Cloud NetApp Files + Volume. Valid component values are: ENCRYPT_DATA, BROWSABLE, CHANGE_NOTIFY, NON_BROWSABLE, OPLOCKS, SHOW_SNAPSHOT, SHOW_PREVIOUS_VERSIONS, ACCESS_BASED_ENUMERATION, - CONTINUOUSLY_AVAILABLE - - For more information, look at https://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#smbsettings. + CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE The percentage of volume storage reserved for snapshot storage. The @@ -230,7 +223,7 @@ OPTIONAL FLAGS ▸ provide the argument --source-snapshot on the command line. --unix-permissions=UNIX_PERMISSIONS - Unix permissions the mount point will be created with.Unix permissions + Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only GCLOUD WIDE FLAGS diff --git a/gcloud/netapp/volumes/update b/gcloud/netapp/volumes/update index e937167a2..846cb8130 100644 --- a/gcloud/netapp/volumes/update +++ b/gcloud/netapp/volumes/update @@ -104,17 +104,12 @@ FLAGS kerberos-5p-read-write=KERBEROS_5P_READ_WRITE --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files VolumeValid - component values are: NFSV3, NFSV4, SMB - - For more information, look athttps://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#protocols. + Type of File System protocols for the Cloud NetApp Files Volume. Valid + component values are: NFSV3, NFSV4, SMB. --restricted-actions=RESTRICTED_ACTION,[...] - Actions to be restricted for a volume.Valid restricted action options - are: 'DELETE' - - For more information, look at - https://cloud.google.com/netapp/volumes/docs/reference/rest/v1/projects.locations.volumes#restrictedaction. + Actions to be restricted for a volume. Valid restricted action options + are: 'DELETE'. --security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED" The security style of the Volume. This can either be UNIX or NTFS. @@ -130,13 +125,11 @@ FLAGS Share name of the Mount path clients will use. --smb-settings=SMB_SETTING,[SMB_SETTING,...] - List of settings specific to SMB protocolfor a Cloud NetApp Files - VolumeValid component values are: ENCRYPT_DATA, BROWSABLE, + List of settings specific to SMB protocol for a Cloud NetApp Files + Volume. Valid component values are: ENCRYPT_DATA, BROWSABLE, CHANGE_NOTIFY, NON_BROWSABLE, OPLOCKS, SHOW_SNAPSHOT, SHOW_PREVIOUS_VERSIONS, ACCESS_BASED_ENUMERATION, - CONTINUOUSLY_AVAILABLE - - For more information, look at https://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#smbsettings. + CONTINUOUSLY_AVAILABLE. --snap-reserve=SNAP_RESERVE The percentage of volume storage reserved for snapshot storage. The @@ -211,7 +204,7 @@ FLAGS ▸ provide the argument --storage-pool on the command line. --unix-permissions=UNIX_PERMISSIONS - Unix permissions the mount point will be created with.Unix permissions + Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only --update-labels=[KEY=VALUE,...] diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index ac88063ee..1df43f71e 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -424,14 +424,14 @@ FLAGS unlimited. --allowed-psc-projects=PROJECT,[PROJECT,...] - A comma-separated list of projects. Each project in this list may be - represented by a project number (numeric) or by a project id - (alphanumeric). This will allow PSC connections to be established from - specified consumer projects. This can be set only when PSC is enabled. + A comma-separated list of projects. Each project in this list might be + represented by a project number (numeric) or by a project ID + (alphanumeric). This allows Private Service Connect connections to be + established from specified consumer projects. --enable-private-service-connect - When the flag is set, a Cloud SQL instance will be created with PSC - enabled. + When the flag is set, a Cloud SQL instance will be created with Private + Service Connect enabled. Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the instance. The 'Compute Engine Service Agent' diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 20e6cbbd3..94651e051 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -362,15 +362,15 @@ FLAGS At most one of these can be specified: --allowed-psc-projects=PROJECT,[PROJECT,...] - A comma-separated list of projects. Each project in this list may be - represented by a project number (numeric) or by a project id - (alphanumeric). This will allow PSC connections to be established - from specified consumer projects. This can be set only when PSC is - enabled. + A comma-separated list of projects. Each project in this list might + be represented by a project number (numeric) or by a project ID + (alphanumeric). This allows Private Service Connect connections to be + established from specified consumer projects. --clear-allowed-psc-projects - This will clear the project allowlist of PSC, disallowing all - projects from creating new PSC bindings to the instance. + This will clear the project allowlist of Private Service Connect, + disallowing all projects from creating new Private Service Connect + bindings to the instance. At most one of these can be specified: diff --git a/gcloud/vmware/private-clouds/clusters/update b/gcloud/vmware/private-clouds/clusters/update index 358d81390..f6a0a65f3 100644 --- a/gcloud/vmware/private-clouds/clusters/update +++ b/gcloud/vmware/private-clouds/clusters/update @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud vmware private-clouds clusters update - (CLUSTER : --location=LOCATION --private-cloud=PRIVATE_CLOUD) - --node-type-config=[count=COUNT], - [custom-core-count=CUSTOM-CORE-COUNT],[type=TYPE] [--async] + (CLUSTER : --location=LOCATION --private-cloud=PRIVATE_CLOUD) [--async] + [--node-type-config=[[count=COUNT],[type=TYPE],...]] + [--remove-nodes-config=TYPE] + [--update-nodes-config=[count=COUNT],[type=TYPE]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -16,18 +17,18 @@ DESCRIPTION EXAMPLES To resize a cluster called my-cluster in private cloud my-private-cloud and - zone us-west2-a to have 3 nodes, run: + zone us-west2-a to have 3 nodes of type standard-72, run: $ gcloud vmware private-clouds clusters update my-cluster \ --location=us-west2-a --project=my-project \ --private-cloud=my-private-cloud \ - --node-type-config=type=standard-72,count=3 + --update-nodes-config=type=standard-72,count=3 Or: $ gcloud vmware private-clouds clusters update my-cluster \ --private-cloud=my-private-cloud \ - --node-type-config=type=standard-72,count=3 + --update-nodes-config=type=standard-72,count=3 In the second example, the project and location are taken from gcloud properties core/project and compute/zone. @@ -70,8 +71,29 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --private-cloud on the command line. -REQUIRED FLAGS - --node-type-config=[count=COUNT],[custom-core-count=CUSTOM-CORE-COUNT],[type=TYPE] +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --node-type-config=[[count=COUNT],[type=TYPE],...] + (DEPRECATED) Information about the type and number of nodes associated + with the cluster. + + type (required): canonical identifier of the node type. + + count (required): number of nodes of this type in the cluster. + + custom_core_count: can be passed, but the value will be ignored. Updating custom core count is not supported. + + The --node-type-config option is deprecated; please use + --update-nodes-config and --remove-nodes-config instead. + + --remove-nodes-config=TYPE + Type of node that should be removed from the cluster + + --update-nodes-config=[count=COUNT],[type=TYPE] Information about the type and number of nodes associated with the cluster. @@ -79,17 +101,6 @@ REQUIRED FLAGS count (required): number of nodes of this type in the cluster. - custom-core-count (optional): customized number of cores available to - each node of the type. To get a list of valid values for your node - type, run the gcloud vmware node-types describe command and reference - the availableCustomCoreCounts field in the output. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. The default is True. Enabled by default, use --no-async to - disable. - 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/workstations/configs/create b/gcloud/workstations/configs/create index fd645900a..9874567a8 100644 --- a/gcloud/workstations/configs/create +++ b/gcloud/workstations/configs/create @@ -18,7 +18,7 @@ SYNOPSIS [--pd-disk-size=PD_DISK_SIZE; default=200] [--pd-disk-type=PD_DISK_TYPE; default="pd-standard"] [--pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"] - [--pool-size=POOL_SIZE] + [--pool-size=POOL_SIZE] [--replica-zones=[REPLICA_ZONES,...]] [--running-timeout=RUNNING_TIMEOUT; default=7200] [--service-account=SERVICE_ACCOUNT] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] @@ -187,6 +187,16 @@ FLAGS --pool-size=POOL_SIZE Number of instances to pool for faster Workstation starup. + --replica-zones=[REPLICA_ZONES,...] + Specifies the zones the VM and disk resources will be replicated within + the region. If set, exactly two zones within the workstation cluster's + region must be specified. + + Example: + + $ gcloud workstations configs create \ + --replica-zones=us-central1-a,us-central1-f + --running-timeout=RUNNING_TIMEOUT; default=7200 How long (in seconds) to wait before automatically stopping a workstation after it started. A value of 0 indicates that workstations