gcloud-help/gcloud/alpha/edge-cloud/container/clusters/create

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

SYNOPSIS
    gcloud alpha 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"]
        [--cluster-ipv6-cidr=CLUSTER_IPV6_CIDR]
        [--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"]
        [--services-ipv6-cidr=SERVICES_IPV6_CIDR] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create an Edge Container cluster.

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

        $ gcloud alpha 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;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     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
          Google Cloud location for the cluster. 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.

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.

     --cluster-ipv6-cidr=CLUSTER_IPV6_CIDR
        If specified, all pods in the cluster are assigned an RFC4193 IPv6
        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.

     --services-ipv6-cidr=SERVICES_IPV6_CIDR
        If specified, all services in the cluster are assigned an RFC4193 IPv6
        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/v1alpha API. The full documentation for
    this API can be found at: https://cloud.google.com/edge-cloud

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. This variant is also available:

        $ gcloud edge-cloud container clusters create