- NAME
-
- gcloud workstations configs update - updates a workstation configuration
- SYNOPSIS
-
-
gcloud workstations configs update(CONFIG:--cluster=CLUSTER--region=REGION) [--async] [--boot-disk-size=BOOT_DISK_SIZE] [--container-args=[CONTAINER_ARGS,…]] [--container-command=[CONTAINER_COMMAND,…]] [--container-env=[CONTAINER_ENV,…]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] [--disable-public-ip-addresses] [--enable-audit-agent] [--enable-confidential-compute] [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,…]] [--machine-type=MACHINE_TYPE] [--network-tags=[NETWORK_TAGS,…]] [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,…]] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] [--accelerator-count=ACCELERATOR_COUNT:--accelerator-type=ACCELERATOR_TYPE] [--container-custom-image=CONTAINER_CUSTOM_IMAGE|--container-predefined-image=CONTAINER_PREDEFINED_IMAGE] [--disable-ssh-to-vm|--enable-ssh-to-vm] [--disable-tcp-connections|--enable-tcp-connections] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
- Updates a workstation configuration.
- EXAMPLES
-
To update a configuration with the 'e2-standard-8' machine type and a IntelliJ
image, run:
gcloud workstations configs update CONFIG --machine-type=e2-standard-8 --container-predefined-image=intellijTo update a configuration to disable Secure Boot, virtual trusted platform module (vTPM) and integrity monitoring, run:
gcloud workstations configs update CONFIG --no-shielded-secure-boot --no-shielded-vtpm --no-shielded-integrity-monitoring - POSITIONAL ARGUMENTS
-
-
Config resource - The group of arguments defining a config 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
projectattribute:-
provide the argument
configon the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
This must be specified.
CONFIG-
ID of the config or fully qualified identifier for the config.
To set the
configattribute:-
provide the argument
configon the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--cluster=CLUSTER-
The cluster for the config.
To set the
clusterattribute:-
provide the argument
configon the command line with a fully specified name; -
provide the argument
--clusteron the command line; -
set the property
workstations/cluster.
-
provide the argument
--region=REGION-
The region for the config.
To set the
regionattribute:-
provide the argument
configon the command line with a fully specified name; -
provide the argument
--regionon the command line; -
set the property
workstations/region.
-
provide the argument
-
provide the argument
-
Config resource - The group of arguments defining a config 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.
- FLAGS
-
--async- Return immediately, without waiting for the operation in progress to complete.
--boot-disk-size=BOOT_DISK_SIZE- Size of the boot disk in GB.
--container-args=[CONTAINER_ARGS,…]-
Arguments passed to the entrypoint.
Example:
gcloud workstations configs update --container-args=arg_1,arg_2 --container-command=[CONTAINER_COMMAND,…]-
If set, overrides the default ENTRYPOINT specified by the image.
Example:
gcloud workstations configs update --container-command=executable,parameter_1,parameter_2 --container-env=[CONTAINER_ENV,…]-
Environment variables passed to the container.
Example:
gcloud workstations configs update --container-env=key1=value1,key2=value2 --container-run-as-user=CONTAINER_RUN_AS_USER- If set, overrides the USER specified in the image with the given uid.
--container-working-dir=CONTAINER_WORKING_DIR- If set, overrides the default DIR specified by the image.
--disable-public-ip-addresses- Default value is false. If set, instances will have no public IP address.
--enable-audit-agent-
Whether to enable Linux
auditdlogging on the workstation. When enabled, a service account must also be specified that haslogging.buckets.writepermission on the project. --enable-confidential-compute- Default value is false. If set, instances will have confidential compute enabled.
--enable-nested-virtualization- Default value is false. If set, instances will have nested virtualization enabled.
--idle-timeout=IDLE_TIMEOUT- How long (in seconds) to wait before automatically stopping an instance that hasn't received any user traffic. A value of 0 indicates that this instance should never time out due to idleness.
--labels=[LABELS,…]-
Labels that are applied to the configuration and propagated to the underlying
Compute Engine resources.
Example:
gcloud workstations configs update --labels=label1=value1,label2=value2 --machine-type=MACHINE_TYPE- Machine type determines the specifications of the Compute Engine machines that the workstations created under this configuration will run on.
-
Network tags to add to the Google Compute Engine machines backing the
Workstations.
Example:
gcloud workstations configs update --network-tags=tag_1,tag_2 --pool-size=POOL_SIZE- Number of instances to pool for faster Workstation starup.
--running-timeout=RUNNING_TIMEOUT- How long (in seconds) to wait before automatically stopping a workstation after it started. A value of 0 indicates that workstations using this config should never time out.
--service-account=SERVICE_ACCOUNT- Email address of the service account that will be used on VM instances used to support this config. This service account must have permission to pull the specified container image. If not set, VMs will run without a service account, in which case the image must be publicly accessible.
--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,…]-
Scopes to grant to the service_account. Various scopes are automatically added
based on feature usage. When specified, users of workstations under this
configuration must have iam.serviceAccounts.actAs
on the service account. --shielded-integrity-monitoring- Default value is false. If set, instances will have integrity monitoring enabled.
--shielded-secure-boot- Default value is false. If set, instances will have Secure Boot enabled.
--shielded-vtpm- Default value is false. If set, instances will have vTPM enabled.
-
Accelerator settings
--accelerator-count=ACCELERATOR_COUNT-
The number of accelerator cards exposed to the instance.
This flag argument must be specified if any of the other arguments in this group are specified.
--accelerator-type=ACCELERATOR_TYPE- The type of accelerator resource to attach to the instance, for example, "nvidia-tesla-p100".
-
At most one of these can be specified:
--container-custom-image=CONTAINER_CUSTOM_IMAGE- A docker image for the workstation. This image must be accessible by the service account configured in this configuration (--service-account). If no service account is defined, this image must be public.
--container-predefined-image=CONTAINER_PREDEFINED_IMAGE-
Code editor on base images.
CONTAINER_PREDEFINED_IMAGEmust be one of:base-image- Base image - no IDE
clion- CLion
codeoss- Code OSS
codeoss-cuda- Code OSS + CUDA toolkit
goland- GoLand
intellij- IntelliJ IDEA Ultimate
phpstorm- PhpStorm
pycharm- PyCharm Professional
rider- Rider
rubymine- RubyMine
webstorm- WebStorm
-
At most one of these can be specified:
--disable-ssh-to-vm- If set, workstations disable SSH connections to the root VM.
--enable-ssh-to-vm- If set, workstations enable SSH connections to the root VM.
-
At most one of these can be specified:
--disable-tcp-connections- If set, workstations don't allow plain TCP connections.
--enable-tcp-connections- If set, workstations allow plain TCP connections.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
-
These variants are also available:
gcloud alpha workstations configs updategcloud beta workstations configs update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-03-26 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]