wb app create gcp

Categories:

Name

wb-app-create-gcp - Create a new Google Cloud Compute Engine app.

Synopsis

wb app create gcp --config=<appConfigName> [--description=<description>] [--format=<format>] [--idle-timeout-seconds=<idleTimeoutSeconds>] [--instance-id=<instanceId>] [--location=<location>] [--machine-type=<machineType>] [--reservation-uri=<reservationUri>] [--workspace=<id>] [-M=<String=String>[,<String=String>...]]... (--id=<id>) [[--accelerator-type=<type>] [--accelerator-core-count=<coreCount>]] [[--flex-start] [--flex-start-max-run-duration-seconds=<maxRunDurationSeconds> ] [--flex-start-request-valid-for-duration-seconds=<requestValid _ ForDurationSeconds>]] [[--data-disk-size=<sizeGb>] [--data-disk-type=<dataDiskType>] [--boot-disk-type=<bootDiskType>_]]

Description

Create a new Google Cloud Compute Engine app.

Options

  • --config, --app-config=<appConfigName>
    App config to be used for the app instance.

    Valid values: jupyter-lab, r-analysis, visual-studio-code, nemo, parabricks

  • --description=<description>
    Description of the resource.

  • --format=<format>
    Set the format for printing command output. Defaults to the config format property.

    Valid values: JSON, TEXT

    Default: null

  • --id=<id>
    ID of the resource, scoped to the workspace. Only use letters, numbers, dashes, and underscores.

  • --idle-timeout-seconds=<idleTimeoutSeconds>
    The idle timeout in seconds for the instance. If the instance is idle for this duration, it will be automatically stopped. Defaults to 4 hours.

    Default: 14400

  • --instance-id=<instanceId>
    The unique name to give to the Compute Engine cloud instance. Cannot be changed later. The name must be 1–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 Compute Engine location of the instance.

  • -M, --metadata=<String=String>[,<String=String>...]
    Custom metadata to apply to this app instance. Specify multiple metadata in the format of --metadata=key1=value1,key2=value2.

  • --machine-type=<machineType>
    The Compute Engine machine type of the instance.

    Default: n1-highmem-2

  • --reservation-uri=<reservationUri>
    GPU reservation uri, i.e. projects/<my-project/reservations/reservationName or just reservationName.

  • --workspace=<id>
    Workspace ID to use for this command only.

The hardware accelerator used on this instance.

  • --accelerator-core-count=<coreCount>
    Count of cores of this accelerator.
  • --accelerator-type=<type>
    Type of this accelerator.

Dynamic Workload Scheduler (DWS) flex-start provisioning. Cannot be combined with --reservation-uri.

  • --flex-start
    Create the VM using the DWS flex-start provisioning model, drawing from a discounted, non-preemptible capacity pool that can queue the request until in-demand resources (such as GPUs) become available. Once running, the VM runs for a fixed amount of time (see --flex-start-max-run-duration-seconds) and is then stopped, regardless of activity or idleness. Typically used for GPU machine types; see flex-start VMs.
  • --flex-start-max-run-duration-seconds=<maxRunDurationSeconds>
    Required with --flex-start. The maximum lifetime of the VM in seconds, after which the VM is stopped. Must be between 600 (10 minutes) and 604800 (7 days).
  • --flex-start-request-valid-for-duration-seconds=<requestValidForDurationSeconds>
    Optional, only used with --flex-start. How long, in seconds, the flex-start request waits in the DWS queue for capacity. When set, must be 0 (instant-only: capacity must be immediately available) or between 90 and 7200 (2 hours) for queued provisioning. If omitted, Compute Engine makes a short (~90s) best-effort attempt for capacity.

Disk configurations.

  • --boot-disk-type=<bootDiskType>
    The type of the boot disk. Defaults to the standard persistent disk.
  • --data-disk-size=<sizeGb>
    The size of the disk in GB attached to this instance.
  • --data-disk-type=<dataDiskType>
    The type of disk attached to this instance. Defaults to the standard persistent disk.

Last Modified: 10 August 2026