NAME

gcloud edge-cloud container clusters create - create an Edge Container cluster

SYNOPSIS

gcloud edge-cloud container clusters create (CLUSTER : --location=LOCATION) [--admin-users=ADMIN_USERS] [--async] [--cluster-ipv4-cidr=CLUSTER_IPV4_CIDR; default="10.0.0.0/17"] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] [--fleet-project=FLEET_PROJECT] [--labels=[KEY=VALUE,...]] [--maintenance-window-end=MAINTENANCE_WINDOW_END] [--maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE] [--maintenance-window-start=MAINTENANCE_WINDOW_START] [--services-ipv4-cidr=SERVICES_IPV4_CIDR; default="10.96.0.0/12"] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

Create an Edge Container cluster.

EXAMPLES

To create a cluster called 'my-cluster' in region us-central1, run:

$ gcloud edge-cloud container clusters create my-cluster \ --location=us-central1

POSITIONAL ARGUMENTS

Cluster resource - Edge Container cluster 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 cluster on the command line with a fully specified name;

set the property core/project;

provide the argument --project on the command line.

This must be specified.

CLUSTER

ID of the cluster or fully qualified identifier for the cluster. To set the cluster attribute:

  • provide the argument cluster on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION

The global location name. To set the location attribute:

  • provide the argument cluster on the command line with a fully specified name;

  • provide the argument --location on the command line;

  • set the property edge_container/location.

FLAGS

--admin-users=ADMIN_USERS

Username (Google email address) of the user who should be granted cluster-admin initially. This currently supports exactly one admin. If not set, the account issuing the creation request will be used by default.

--async

Return immediately, without waiting for the operation in progress to complete.

--cluster-ipv4-cidr=CLUSTER_IPV4_CIDR; default="10.0.0.0/17"

All pods in the cluster are assigned an RFC1918 IPv4 address from this block. This field cannot be changed after creation.

--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE

The default maximum number of pods per node.

--fleet-project=FLEET_PROJECT

Name of the Fleet host project where the cluster is registered.

--labels=[KEY=VALUE,...]

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens (-), underscores (_), lowercase characters, and numbers. Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers.

--maintenance-window-end=MAINTENANCE_WINDOW_END

End time of the recurring cluster maintenance window in the RFC 3339 https://www.ietf.org/rfc/rfc3339.txt format. E.g. "2021-01-01T00:00:00Z" or "2021-01-01T00:00:00-05:00"

--maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE

An RFC 5545 https://tools.ietf.org/html/rfc5545#section-3.8.5.3 recurrence rule for how the cluster maintenance window recurs. They go on for the span of time between the start and the end time.

--maintenance-window-start=MAINTENANCE_WINDOW_START

Start time of the recurring cluster maintenance window in the RFC 3339 https://www.ietf.org/rfc/rfc3339.txt format. E.g. "2021-01-01T00:00:00Z" or "2021-01-01T00:00:00-05:00"

--services-ipv4-cidr=SERVICES_IPV4_CIDR; default="10.96.0.0/12"

All services in the cluster are assigned an RFC1918 IPv4 address from this block. This field cannot be changed after creation.

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.

API REFERENCE

This command uses the edgecontainer/v1 API. The full documentation for this API can be found at: https://cloud.google.com/edge-cloud

NOTES

This variant is also available:

$ gcloud alpha edge-cloud container clusters create