gcloud-help/gcloud/alpha/compute/tpus/execution-groups/create

NAME
    gcloud alpha compute tpus execution-groups create - create Google Compute
        TPUs along with VMs

SYNOPSIS
    gcloud alpha compute tpus execution-groups create
        [--accelerator-type=ACCELERATOR_TYPE; default="v2-8"]
        [--disk-size=DISK_SIZE; default="250GB"] [--dry-run] [--forward-ports]
        [--gce-image=GCE_IMAGE]
        [--machine-type=MACHINE_TYPE; default="n1-standard-1"] [--name=NAME]
        [--network=NETWORK; default="default"] [--preemptible]
        [--preemptible-vm] [--tf-version=TF_VERSION] [--tpu-only]
        [--use-dl-images] [--use-with-notebook] [--vm-only] [--zone=ZONE]
        [GCLOUD_WIDE_FLAG ...]

EXAMPLES
    To create both TPU and VM, run:

        $ gcloud alpha compute tpus execution-groups create \
            --name=test-execution-group --zone=test-zone \
            --project=test-project --accelerator-type=v2-8 \
            --tf-version=2.4.1

    To create both TPU and VM with additional flags, run:

        $ gcloud alpha compute tpus execution-groups create \
            --name=test-execution-group --zone=test-zone \
            --project=test-project --accelerator-type=v2-8 \
            --tf-version=2.4.1 --network=default --preemptible-vm \
            --disk-size=100 --machine-type=n1-standard-2 --use-dl-images

    To create a VM only before creating the TPU, run:

        $ gcloud alpha compute tpus execution-groups create \
            --name=test-execution-group-tpu-only --zone=test-zone \
            --project=test-project --accelerator-type=v2-8 \
            --tf-version=2.4.1 --tpu-only

    To create the TPU only after the VM has been created, run:

        $ gcloud alpha compute tpus execution-groups create \
            --name=test-execution-group-tpu-only --zone=test-zone \
            --project=test-project --accelerator-type=v2-8 \
            --tf-version=2.4.1 --vm-only

FLAGS
     --accelerator-type=ACCELERATOR_TYPE; default="v2-8"
        TPU accelerator type for the TPU. If not specified, this defaults to
        v2-8.

     --disk-size=DISK_SIZE; default="250GB"
        Configures the root volume size of your Compute Engine VM (in GB). The
        minimum size is 20GB and the maximum is 2000GB. Specified value must be
        an integer multiple of Gigabytes.

     --dry-run
        Do not make changes; print only what would have happened.

     --forward-ports
        Automatically forward useful ports from the Compute Engine VM to your
        local machine. The ports forwarded are: 6006 (tensorboard), 8888
        (jupyter notebooks), 8470 (TPU port), 8466 (TPU profiler port).

        Enabled by default, use --no-forward-ports to disable.

     --gce-image=GCE_IMAGE
        Override the automatically chosen Compute Engine Image. Use this flag
        when you're using your own custom images instead of the provided ones
        with TensorFlow pre-installed.

     --machine-type=MACHINE_TYPE; default="n1-standard-1"
        Specifies the machine type used for the Compute Engine VM. To get a
        list of available machine types, run 'gcloud compute machine-types
        list'. If unspecified, the default type is n1-standard-1.

     --name=NAME
        Override the name to use for VMs and TPUs (defaults to your username).

     --network=NETWORK; default="default"
        Specifies the network the Cloud TPU and associated VM should be created
        in. If unspecified, the network "default" is picked.

     --preemptible
        Create a preemptible Cloud TPU, instead of a normal (non-preemptible)
        Cloud TPU. A preemptible Cloud TPU costs less per hour, but the Cloud
        TPU service can stop/terminate the node at any time.

     --preemptible-vm
        Create a preemptible Compute Engine VM, instead of a normal
        (non-preemptible) VM. A preemptible VM costs less per hour, but the
        Compute Engine service can terminate the instance at any time.

     --tf-version=TF_VERSION
        Set the version of TensorFlow to use when creating the Compute Engine
        VM and the Cloud TPU. (It defaults to auto-selecting the latest stable
        release.)

     --tpu-only
        Do not allocate a VM, only allocate a TPU. To be used after the command
        has been run with a --vm-only flag and the user is ready to run on a
        TPU. Ensure that the name matches the name passed in when creating with
        the --vm-only flag.

     --use-dl-images
        Use Deep Learning VM Images (see docs -
        https://cloud.google.com/deep-learning-vm/) instead of TPU-specific
        machine images. Defaults to TPU-specific images. This value is set to
        true automatically if the --use-with-notebook flag is set to true.

     --use-with-notebook
        Allow Compute Engine VM to be recognized by Cloud AI Notebooks. This
        automatically sets the content of the flag --use-dl-images flag to be
        true.

     --vm-only
        Do not allocate a TPU, only allocate a VM (useful if you're not ready
        to run on a TPU yet).

     --zone=ZONE
        Zone of the tpu to create. If not specified and the compute/zone
        property isn't set, you might be prompted to select a zone (interactive
        mode only).

        To avoid prompting when this flag is omitted, you can set the
        compute/zone property:

            $ gcloud config set compute/zone ZONE

        A list of zones can be fetched by running:

            $ gcloud compute zones list

        To unset the property, run:

            $ gcloud config unset compute/zone

        Alternatively, the zone can be stored in the environment variable
        CLOUDSDK_COMPUTE_ZONE.

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 command is currently in alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist. These variants are also available:

        $ gcloud compute tpus execution-groups create

        $ gcloud beta compute tpus execution-groups create