1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-18 23:08:48 +00:00

gcloud: Wed Mar 12 10:54:38 UTC 2025

This commit is contained in:
Automated 2025-03-12 10:54:38 +00:00
parent 6dc93282df
commit a459a88a5f
152 changed files with 2634 additions and 1748 deletions

View file

@ -11,10 +11,12 @@ SYNOPSIS
[--autocheckpoint-enabled] [--best-effort]
[--boot-disk=[KEY=VALUE,...]] [--data-disk=[mode=MODE],[source=SOURCE]]
[--description=DESCRIPTION] [--guaranteed] [--labels=[KEY=VALUE,...]]
[--metadata=[KEY=VALUE,...]] [--metadata-from-file=[KEY=VALUE,...]]
[--range=RANGE] [--reserved] [--scopes=[SCOPES,...]]
[--service-account=SERVICE_ACCOUNT] [--shielded-secure-boot] [--spot]
[--tags=[TAGS,...]] [--valid-after-duration=VALID_AFTER_DURATION]
[--max-run-duration=MAX_RUN_DURATION] [--metadata=[KEY=VALUE,...]]
[--metadata-from-file=[KEY=VALUE,...]]
[--provisioning-model=PROVISIONING_MODEL] [--range=RANGE] [--reserved]
[--scopes=[SCOPES,...]] [--service-account=SERVICE_ACCOUNT]
[--shielded-secure-boot] [--spot] [--tags=[TAGS,...]]
[--valid-after-duration=VALID_AFTER_DURATION]
[--valid-after-time=VALID_AFTER_TIME]
[--valid-until-duration=VALID_UNTIL_DURATION]
[--valid-until-time=VALID_UNTIL_TIME]
@ -206,6 +208,11 @@ OPTIONAL FLAGS
Resource labels to represent user-provided metadata. See
https://cloud.google.com/compute/docs/labeling-resources for details.
--max-run-duration=MAX_RUN_DURATION
A duration after which the resource will be terminated. Used with
flex-start. See $ gcloud topic datetimes for information on duration
formats.
--metadata=[KEY=VALUE,...]
List of comma-separated metadata key-value pairs for the Cloud TPU VM
node. Example: --metadata='key1=value1,key2=value2'
@ -214,6 +221,10 @@ OPTIONAL FLAGS
Same as --metadata except the value for the entry will be read from a
local file. Example: --metadata-from-file='key1=value1.txt'
--provisioning-model=PROVISIONING_MODEL
If provided, the resource will be provisioned with the specified
provisioning model.
--range=RANGE
CIDR range for the TPU.

View file

@ -8,10 +8,10 @@ SYNOPSIS
[--description=DESCRIPTION] [--internal-ips] [--labels=[KEY=VALUE,...]]
[--metadata=[KEY=VALUE,...]] [--metadata-from-file=[KEY=VALUE,...]]
[--network=NETWORK; default="default"] [--preemptible]
[--queue-count=QUEUE_COUNT] [--range=RANGE] [--reserved]
[--scopes=[SCOPES,...]] [--service-account=SERVICE_ACCOUNT]
[--shielded-secure-boot] [--spot] [--subnetwork=SUBNETWORK]
[--tags=[TAGS,...]]
[--queue-count=QUEUE_COUNT] [--range=RANGE] [--reservation=RESERVATION]
[--reserved] [--scopes=[SCOPES,...]]
[--service-account=SERVICE_ACCOUNT] [--shielded-secure-boot] [--spot]
[--subnetwork=SUBNETWORK] [--tags=[TAGS,...]]
[--accelerator-type=ACCELERATOR_TYPE; default="v2-8"
| --topology=TOPOLOGY --type=TYPE] [GCLOUD_WIDE_FLAG ...]
@ -173,6 +173,15 @@ OPTIONAL FLAGS
network, or the provided network is peered with another network that is
using that CIDR range.
--reservation=RESERVATION
The name of the reservation. This can either be the full name or just
the name. However, a full name is required if the reservation is not in
the default project.
Full reservation name format is:
projects/<project>/reservations/<reservation-name>
--reserved
When specified, will attempt to create the TPU node under reservations
made in the current project. The reservations can be made separately

View file

@ -5,12 +5,13 @@ SYNOPSIS
gcloud alpha compute tpus tpu-vm update (TPU : --zone=ZONE)
[--add-tags=[TAGS,...]] [--async] [--description=DESCRIPTION]
[--internal-ips] [--update-labels=[KEY=VALUE,...]]
[--attach-disk=[SOURCE=DATA_DISK,...] | --detach-disk=DATA_DISK]
[--clear-labels | --remove-labels=[KEY,...]]
[--clear-tags | --remove-tags=[TAG,...]]
[--metadata-from-file=[KEY=VALUE,...]
| --update-metadata=[KEY=VALUE,...] --clear-metadata
| --remove-metadata=[KEY,...]] [GCLOUD_WIDE_FLAG ...]
| --remove-metadata=[KEY,...]]
[--worker=[WORKER,...] --attach-disk=[SOURCE=DATA_DISK,...]
| --detach-disk=DATA_DISK] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Update a Cloud TPU VM node.
@ -100,45 +101,6 @@ FLAGS
See https://cloud.google.com/compute/docs/labeling-resources for
details.
At most one of these can be specified:
--attach-disk=[SOURCE=DATA_DISK,...]
Attach a data disk to the TPU VM. For example,
$ gcloud alpha compute tpus tpu-vm update example-tpu \
--attach-disk \
source=projects/my-project/zones/us-central1-c/disks/my-disk,\
mode=read-only --zone=us-central1-c
attaches the disk named
'projects/my-project/zones/us-central1-c/disks/my-disk' to a TPU VM
named 'example-tpu' in read-only mode in zone us-central1-c.
The following keys are allowed:
source
Specify the full path to an existing disk. Required. The disk
must be in the same zone.
mode
Specify the mode in which to attach this disk. Valid options are
'read-write', 'read-only'. If not specified, the default is
'read-write'.
--detach-disk=DATA_DISK
Detach a data disk from the TPU VM. For example,
This flag must be repeated to provide multiple data disks. For
example:
$ gcloud alpha compute tpus tpu-vm update example-tpu \
--detach-disk=projects/my-project/zones/us-central1-c/disks/\
my-disk --zone=us-central1-c
detaches the disk named
'projects/my-project/zones/us-central1-c/disks/my-disk' from a TPU VM
named 'example-tpu' in zone us-central1-c.
At most one of these can be specified:
--clear-labels
@ -212,6 +174,79 @@ FLAGS
exist it is silently ignored. If --update-metadata is also
specified then --update-metadata is applied first.
--worker=[WORKER,...]
List of worker IDs to apply attach/detach disk to. If not specified,
the update is applied to all workers. Only numeric values are allowed.
The only exception is 'all'.
--attach-disk and --worker can be used to specify which workers to
attach the disk to. For example:
$ gcloud alpha compute tpus tpu-vm update example-tpu \
--attach-disk \
source=projects/my-project/zones/us-central1-c/disks/my-disk,\
mode=read-only --zone=us-central1-c
--worker=0,1
attaches the disk named
'projects/my-project/zones/us-central1-c/disks/my-disk' to worker 0 and
1 of a TPU VM named 'example-tpu' in read-only mode in zone
us-central1-c. if --worker is not specified or --worker=all is
specified, the disk is attached to all workers.
--detach-disk and --worker can be used to specify which workers to
detach the disk from. For example:
$ gcloud alpha compute tpus tpu-vm update example-tpu \
--detach-disk=projects/my-project/zones/us-central1-c/disks/\
my-disk --zone=us-central1-c
--worker=0,1
detaches the disk named
'projects/my-project/zones/us-central1-c/disks/my-disk' from worker 0
and 1 of a TPU VM named 'example-tpu' in zone us-central1-c. if
--worker is not specified or --worker=all is specified, the disk is
attached to all workers.
At most one of these can be specified:
--attach-disk=[SOURCE=DATA_DISK,...]
Attach a data disk to the TPU VM. For example,
$ gcloud alpha compute tpus tpu-vm update example-tpu \
--attach-disk \
source=projects/my-project/zones/us-central1-c/disks/my-disk,\
mode=read-only --zone=us-central1-c
attaches the disk named
'projects/my-project/zones/us-central1-c/disks/my-disk' to a TPU VM
named 'example-tpu' in read-only mode in zone us-central1-c.
The following keys are allowed:
source
Specify the full path to an existing disk. Required. The disk
must be in the same zone.
mode
Specify the mode in which to attach this disk. Valid options are
'read-write', 'read-only'. If not specified, the default is
'read-write'.
--detach-disk=DATA_DISK
Detach a data disk from the TPU VM. For example,
This flag must be repeated to provide multiple data disks. For
example:
$ gcloud alpha compute tpus tpu-vm update example-tpu \
--detach-disk=projects/my-project/zones/us-central1-c/disks/\
my-disk --zone=us-central1-c
detaches the disk named
'projects/my-project/zones/us-central1-c/disks/my-disk' from a TPU VM
named 'example-tpu' in zone us-central1-c.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,