Name

wb-resource-create-gcp-notebook - Add a controlled GCP notebook instance. For a detailed explanation of some parameters, see https://cloud.google.com/vertex-ai/docs/workbench/reference/rest/v1/projects.locations.instances#Instance.

Synopsis

wb resource create gcp-notebook [--description=<description>] [--format=<format>] [--instance-id=<instanceId>] [--location=<location>] [--machine-type=<machineType>] [--post-startup-script=<postStartupScript>] [--user-startup-script=<userStartupScript>] [--workspace=<id>] [-M=<String=String>[, <String=String>…​]]…​ (--id=<id>) [(--vm-image-project=<project> (--vm-image-family=<family> | --vm-image-name=<name>)) | (--container-repository=<repository> [--container-tag=<tag>])] [[--accelerator-type=<type>] [--accelerator-core-count=<coreCount>]] [[--install-gpu-driver] [--custom-gpu-driver-path=<customGpuDriverPath>] ] [[--boot-disk-size=<sizeGb>] [--boot-disk-type=<type>]] [[--data-disk-size=<sizeGb>] [--data-disk-type=<type>]]

Description

Add a controlled GCP notebook instance. For a detailed explanation of some parameters, see https://cloud.google.com/vertex-ai/docs/workbench/reference/rest/v1/projects.locations.instances#Instance.

Options

--id=<id>

ID of the resource, scoped to the workspace. Only use letters, numbers, dashes, and underscores.

--description=<description>

Description of the resource.

--workspace=<id>

Workspace id to use for this command only.

--format=<format>

Set the format for printing command output: JSON, TEXT. Defaults to the config format property.

Default: null
--instance-id=<instanceId>

The unique name to give to the cloud environment. Cannot be changed later. The instance name must be 1 to 63 characters long and contain only lowercase letters, numeric characters, and dashes. The first character must be a lowercase letter and the last character cannot be a dash. If not specified, a value will be auto-generated for you.

--location=<location>

The Google Cloud location of the instance (https://cloud.google.com/vertex-ai/docs/general/locations#user-managed-notebooks-locations).

Default: us-central1-a
--machine-type=<machineType>

The Compute Engine machine type of this instance (https://cloud.google.com/compute/docs/general-purpose-machines).

Default: n1-highmem-2
--post-startup-script=<postStartupScript>

Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a public URL or Cloud Storage path, e.g. 'gs://path-to-file/file-name'. Overrides the default post-startup script.

--user-startup-script=<userStartupScript>

Path to a Bash script that automatically runs after the post startup script. The path must be a URL or Cloud Storage path, e.g. 'gs://path-to-file/file-name'.

-M, --metadata=<String=String>[,<String=String>…​]

Custom metadata to apply to this instance.

specify multiple metadata in the format of --metadata="key1=value1" -Mkey2=value2.

It allows multiple metadata entries split by "," like --metadata=key1=value1,key2=value2

By default set Workbench CLI server terra-cli-server=[CLI_SERVER_ID]

and the Workbench workspace id (terra-workspace-id=[WORKSPACE_ID]).

Definition of a custom Compute Engine virtual machine image for starting a notebook instance with the environment installed directly on the VM.

If neither this nor --container-* are specified, default to '--vm-image-project=deeplearning-platform-release --vm-image-family=r-latest-cpu-experimental'.

--vm-image-project=<project>

The ID of the Google Cloud project that this VM image belongs to.

--vm-image-family=<family>

Use this VM image family to find the image; the newest image in this family will be used.

--vm-image-name=<name>

Use this VM image name to find the image.

Definition of a container image for starting a notebook instance with the environment installed in a container.

--container-repository=<repository>

The path to the container image repository. For example: 'gcr.io/{project_id}/{imageName}'.

--container-tag=<tag>

The tag of the container image. If not specified, this defaults to the latest tag.

The hardware accelerator used on this instance.

--accelerator-type=<type>

Type of this accelerator.

--accelerator-core-count=<coreCount>

Count of cores of this accelerator.

GPU driver configurations.

--install-gpu-driver

If true, the end user authorizes Google Cloud to install a GPU driver on this instance.

--custom-gpu-driver-path=<customGpuDriverPath>

Specify a custom Cloud Storage path where the GPU driver is stored.

Boot disk configurations.

--boot-disk-size=<sizeGb>

The size of the disk in GB attached to this instance.

--boot-disk-type=<type>

The type of disk attached to this instance, defaults to the standard persistent disk.

Data disk configurations.

--data-disk-size=<sizeGb>

The size of the disk in GB attached to this instance.

--data-disk-type=<type>

The type of disk attached to this instance, defaults to the standard persistent disk.

Last Modified: 1 January 0001