mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-18 23:08:48 +00:00
gcloud: Wed Nov 13 10:04:10 UTC 2024
This commit is contained in:
parent
7da5872e5c
commit
a63704a3af
252 changed files with 4821 additions and 807 deletions
228
gcloud/colab/runtime-templates/create
Normal file
228
gcloud/colab/runtime-templates/create
Normal file
|
|
@ -0,0 +1,228 @@
|
|||
NAME
|
||||
gcloud colab runtime-templates create - create a runtime template
|
||||
|
||||
SYNOPSIS
|
||||
gcloud colab runtime-templates create --display-name=DISPLAY_NAME [--async]
|
||||
[--region=REGION] [--runtime-template-id=RUNTIME_TEMPLATE_ID]
|
||||
[--description=DESCRIPTION --no-enable-euc --enable-secure-boot
|
||||
--idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT; default="3h"
|
||||
--labels=[KEY=VALUE,...] --network-tags=[TAGS,...]
|
||||
--accelerator-count=ACCELERATOR_COUNT
|
||||
--accelerator-type=ACCELERATOR_TYPE --machine-type=MACHINE_TYPE;
|
||||
default="e2-standard-4" --disk-size-gb=DISK_SIZE_GB; default=100
|
||||
--disk-type=DISK_TYPE; default="PD_STANDARD" [--kms-key=KMS_KEY
|
||||
: --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION
|
||||
--kms-project=KMS_PROJECT] --no-enable-internet-access
|
||||
--network=NETWORK [--subnetwork=SUBNETWORK
|
||||
: --subnetwork-region=SUBNETWORK_REGION]] [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
Create a Colab Enterprise runtime template, a VM configuration for your
|
||||
notebook runtimes.
|
||||
|
||||
EXAMPLES
|
||||
To create a runtime template in region 'us-central1' with the display name
|
||||
'my-runtime-template', run:
|
||||
|
||||
$ gcloud colab runtime-templates create --region=us-central1 \
|
||||
--display-name=my-runtime-template
|
||||
|
||||
To create a runtime template for a VM with machine type n1-standard-2 and
|
||||
one NVIDIA_TESLA_V100 accelerator, run:
|
||||
|
||||
$ gcloud colab runtime-templates create \
|
||||
--machine-type=n1-standard-2 \
|
||||
--accelerator-type=NVIDIA_TESLA_V100 --accelerator-count=1 \
|
||||
--region=us-central1 --display-name=my-runtime-template
|
||||
|
||||
To create a runtime template that disables end user credential access, run:
|
||||
|
||||
$ gcloud colab runtime-templates create --no-enable-euc \
|
||||
--region=us-central1 --display-name=my-runtime-template
|
||||
|
||||
REQUIRED FLAGS
|
||||
--display-name=DISPLAY_NAME
|
||||
The display name of the runtime template.
|
||||
|
||||
OPTIONAL FLAGS
|
||||
--async
|
||||
Return immediately, without waiting for the operation in progress to
|
||||
complete.
|
||||
|
||||
Region resource - Cloud region to create runtime template. Please see
|
||||
https://cloud.google.com/colab/docs/locations for a list of supported
|
||||
regions. 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 --region on the command line with a fully
|
||||
specified name;
|
||||
◆ set the property colab/region with a fully specified name;
|
||||
◆ provide the argument --project on the command line;
|
||||
◆ set the property core/project.
|
||||
|
||||
--region=REGION
|
||||
ID of the region or fully qualified identifier for the region.
|
||||
|
||||
To set the region attribute:
|
||||
▸ provide the argument --region on the command line;
|
||||
▸ set the property colab/region.
|
||||
|
||||
--runtime-template-id=RUNTIME_TEMPLATE_ID
|
||||
The id of the runtime template. If not specified, a random id will be
|
||||
generated.
|
||||
|
||||
Configuration of the runtime template
|
||||
|
||||
--description=DESCRIPTION
|
||||
The description of the runtime template.
|
||||
|
||||
--enable-euc
|
||||
Enable end user credential access for the runtime. Enabled by
|
||||
default, use --no-enable-euc to disable.
|
||||
|
||||
--enable-secure-boot
|
||||
Enables secure boot for the runtime. Disabled by default.
|
||||
|
||||
--idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT; default="3h"
|
||||
The duration after which the runtime is automatically shut down. An
|
||||
input of 0s disables the idle shutdown feature, and a valid range is
|
||||
[10m, 24h]. See '$ gcloud topic datetimes' for details on formatting
|
||||
the input duration.
|
||||
|
||||
--labels=[KEY=VALUE,...]
|
||||
Add labels to identify and group the runtime template.
|
||||
|
||||
--network-tags=[TAGS,...]
|
||||
Applies the given Compute Engine tags to the runtime.
|
||||
|
||||
The machine configuration of the runtime provisioned from this template.
|
||||
|
||||
--accelerator-count=ACCELERATOR_COUNT
|
||||
The number of accelerators used by the runtime.
|
||||
|
||||
--accelerator-type=ACCELERATOR_TYPE
|
||||
The type of hardware accelerator used by the runtime. If specified,
|
||||
--accelerator-count must also be specified. ACCELERATOR_TYPE must
|
||||
be one of: NVIDIA_TESLA_V100, NVIDIA_TESLA_T4, NVIDIA_TESLA_A100,
|
||||
NVIDIA_A100_80GB, NVIDIA_L4.
|
||||
|
||||
--machine-type=MACHINE_TYPE; default="e2-standard-4"
|
||||
The Compute Engine machine type selected for the runtime.
|
||||
|
||||
The configuration for the data disk of the runtime provisioned from this
|
||||
template.
|
||||
|
||||
--disk-size-gb=DISK_SIZE_GB; default=100
|
||||
The disk size of the runtime in GB. If specified, the --disk-type
|
||||
must also be specified. The minimum size is 10GB and the maximum is
|
||||
65536GB.
|
||||
|
||||
--disk-type=DISK_TYPE; default="PD_STANDARD"
|
||||
The type of the persistent disk. DISK_TYPE must be one of:
|
||||
PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME.
|
||||
|
||||
Key resource - The Cloud KMS encryption key (customer-managed encryption
|
||||
key) used to protect the runtime. The key must be in the same region as
|
||||
the runtime. If not specified, Google-managed encryption keys will be
|
||||
used. The arguments in this group can be used to specify the attributes
|
||||
of this resource.
|
||||
|
||||
--kms-key=KMS_KEY
|
||||
ID of the key or fully qualified identifier for the key.
|
||||
|
||||
To set the kms-key attribute:
|
||||
▫ provide the argument --kms-key on the command line.
|
||||
|
||||
This flag argument must be specified if any of the other arguments
|
||||
in this group are specified.
|
||||
|
||||
--kms-keyring=KMS_KEYRING
|
||||
KMS keyring id of the key.
|
||||
|
||||
To set the kms-keyring attribute:
|
||||
▫ provide the argument --kms-key on the command line with a fully
|
||||
specified name;
|
||||
▫ provide the argument --kms-keyring on the command line.
|
||||
|
||||
--kms-location=KMS_LOCATION
|
||||
Cloud location for the key.
|
||||
|
||||
To set the kms-location attribute:
|
||||
▫ provide the argument --kms-key on the command line with a fully
|
||||
specified name;
|
||||
▫ provide the argument --kms-location on the command line.
|
||||
|
||||
--kms-project=KMS_PROJECT
|
||||
Cloud project id for the key.
|
||||
|
||||
To set the kms-project attribute:
|
||||
▫ provide the argument --kms-key on the command line with a fully
|
||||
specified name;
|
||||
▫ provide the argument --kms-project on the command line.
|
||||
|
||||
The network configuration for the runtime.
|
||||
|
||||
--enable-internet-access
|
||||
Enable public internet access for the runtime. Enabled by default,
|
||||
use --no-enable-internet-access to disable.
|
||||
|
||||
Network resource - The name of the VPC that this runtime is in. This
|
||||
represents a Cloud resource. (NOTE) Some attributes are not given
|
||||
arguments in this group but can be set in other ways.
|
||||
|
||||
To set the project attribute:
|
||||
▫ provide the argument --network on the command line with a fully
|
||||
specified name;
|
||||
▫ provide the argument --project on the command line;
|
||||
▫ set the property core/project.
|
||||
|
||||
--network=NETWORK
|
||||
ID of the network or fully qualified identifier for the network.
|
||||
|
||||
To set the network attribute:
|
||||
◇ provide the argument --network on the command line.
|
||||
|
||||
Subnetwork resource - The name of the subnetwork that this runtime is
|
||||
in. 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 --subnetwork on the command line with a
|
||||
fully specified name;
|
||||
▫ provide the argument --project on the command line;
|
||||
▫ set the property core/project.
|
||||
|
||||
--subnetwork=SUBNETWORK
|
||||
ID of the subnetwork or fully qualified identifier for the
|
||||
subnetwork.
|
||||
|
||||
To set the subnetwork attribute:
|
||||
◇ provide the argument --subnetwork on the command line.
|
||||
|
||||
This flag argument must be specified if any of the other
|
||||
arguments in this group are specified.
|
||||
|
||||
--subnetwork-region=SUBNETWORK_REGION
|
||||
Google Cloud region of this subnetwork
|
||||
https://cloud.google.com/compute/docs/regions-zones/#locations.
|
||||
|
||||
To set the subnetwork-region attribute:
|
||||
◇ provide the argument --subnetwork on the command line with a
|
||||
fully specified name;
|
||||
◇ provide the argument --subnetwork-region on the command line.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --account,
|
||||
--billing-project, --configuration, --flags-file, --flatten, --format,
|
||||
--help, --impersonate-service-account, --log-http, --project, --quiet,
|
||||
--trace-token, --user-output-enabled, --verbosity.
|
||||
|
||||
Run $ gcloud help for details.
|
||||
|
||||
NOTES
|
||||
This variant is also available:
|
||||
|
||||
$ gcloud beta colab runtime-templates create
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue