gcloud_alpha_compute_tpus_create (1)

NAME

gcloud alpha compute tpus create - create a new Cloud TPU

SYNOPSIS

gcloud alpha compute tpus create (TPU : --zone=ZONE) --network=NETWORK --version=VERSION (--range=RANGE | --use-service-networking) [--accelerator-type=ACCELERATOR_TYPE; default="v2-8"] [--async] [--description=DESCRIPTION] [--preemptible] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(ALPHA) Create a new Cloud TPU.

POSITIONAL ARGUMENTS

Tpu resource - The Cloud TPU you want to create. 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 [tpu] on the command line with a fully specified name; provide the argument [--project] on the command line; set the property [core/project]. This must be specified.

TPU

ID of the tpu or fully qualified identifier for the tpu. This positional must be specified if any of the other arguments in this group are specified.

--zone=ZONE

The compute/zone of the Cloud TPU.
If not specified, will use default compute/zone.

REQUIRED FLAGS

--network=NETWORK

Specifies the network that this TPU will be a part of.

--version=VERSION

TensorFlow version for the TPU, such as 1.6. For a list of available TensorFlow versions please see www.tensorflow.org/versions

Exactly one of these must be specified:

--range=RANGE

CIDR Range for the TPU.
The IP range that the TPU will select an IP address from. Must be in CIDR notation and a /29 range, for example 192.168.0.0/29. Errors will occur if the CIDR range has already been used for a currently existing TPU, the CIDR range conflicts with any networks in the user's provided network, or the provided network is peered with another network that is using that CIDR range.

--use-service-networking

If provided, the TPU will be configured via the Service Networking (SN) API instead of using a CIDR range. The Service Networking API should be enabled on the project before creating the TPU.
For more information on Service Networking see cloud.google.com/service-infrastructure/docs/service-networking/getting-started

OPTIONAL FLAGS

--accelerator-type=ACCELERATOR_TYPE; default="v2-8"

TPU accelerator type for the TPU. If not specified, this defaults to v2-8.
For a list of available accelerator types run:
gcloud alpha compute tpus accelerator-types list

--async

Display information about the operation in progress, without waiting for the operation to complete.

--description=DESCRIPTION

Specifies a text description of the TPU.

--preemptible

If provided, the TPU will be preemptible and time-limited. It may be preempted to free up resources for standard TPUs, and will only be able to run for a limited amount of time.
Preemptible TPUs cannot be restarted.

GCLOUD WIDE FLAGS

These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.

API REFERENCE

This command uses the tpu/v1alpha1 API. The full documentation for this API can be found at: cloud.google.com/tpu

EXAMPLES

The following command creates a TPU with ID my-tpu and CIDR range 10.240.0.0/29 in the default user project, network and compute/region (with other defaults supplied by API):

$ gcloud alpha compute tpus create my-tpu --range 10.240.0.0/29 \
    --network default

The following command creates a TPU with ID my-tpu with explicit values for all required and optional parameters:

$ gcloud alpha compute tpus create my-tpu \
    --zone us-central1-a \
    --range '10.240.0.0/29' \
    --accelerator-type 'v2-8' \
    --network my-tf-network \
    --description 'My TF Node' \
    --version '1.1'

NOTES

This command is currently in ALPHA and may change without notice. If this command fails with API permission errors despite specifying the right project, you will have to apply for early access and have your projects registered on the API whitelist to use it. To do so, contact Support at cloud.google.com/support These variants are also available:

$ gcloud compute tpus create $ gcloud beta compute tpus create