NAME
    gcloud alpha container vmware clusters create - create an Anthos cluster on
        VMware

SYNOPSIS
    gcloud alpha container vmware clusters create
        (CLUSTER : --location=LOCATION)
        (--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP
          : --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT)
        ((--control-plane-vip=CONTROL_PLANE_VIP --ingress-vip=INGRESS_VIP)
          (--metal-lb-config-from-file=METAL_LB_CONFIG_FROM_FILE
          : --control-plane-node-port=CONTROL_PLANE_NODE_PORT
          --ingress-http-node-port=INGRESS_HTTP_NODE_PORT
          --ingress-https-node-port=INGRESS_HTTPS_NODE_PORT
          --konnectivity-server-node-port=KONNECTIVITY_SERVER_NODE_PORT
          | [--f5-config-address=F5_CONFIG_ADDRESS
          --f5-config-partition=F5_CONFIG_PARTITION
          : --f5-config-snat-pool=F5_CONFIG_SNAT_POOL]))
        (--pod-address-cidr-blocks=POD_ADDRESS
          --service-address-cidr-blocks=SERVICE_ADDRESS
          : --dns-search-domains=[DNS_SEARCH_DOMAINS,...]
          --dns-servers=[DNS_SERVERS,...]
          --ntp-servers=[NTP_SERVERS,...] --enable-dhcp
          | --static-ip-config-from-file=STATIC_IP_CONFIG_FROM_FILE)
        [--admin-users=ADMIN_USERS] [--annotations=[KEY=VALUE,...]] [--async]
        [--description=DESCRIPTION] [--disable-aag-config]
        [--disable-vsphere-csi] [--enable-auto-repair] [--enable-vm-tracking]
        [--validate-only] [--version=VERSION]
        [--cpus=CPUS --enable-auto-resize --memory=MEMORY --replicas=REPLICAS]
        [--enable-advanced-networking --enable-dataplane-v2]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create an Anthos cluster on VMware.

EXAMPLES
    To create a cluster named my-cluster managed in location us-west1, run:

        $ gcloud alpha container vmware clusters create my-cluster \
            --location=us-west1

POSITIONAL ARGUMENTS
     Cluster resource - 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;
          ▸ set the property container_vmware/location.

REQUIRED FLAGS
     Admin cluster membership resource - membership of the admin cluster.
     Membership can be the membership ID or the full resource name. The
     arguments in this group can be used to specify the attributes of this
     resource.

     This must be specified.

       --admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP
          ID of the admin_cluster_membership or fully qualified identifier for
          the admin_cluster_membership. To set the admin_cluster_membership
          attribute:
          ▸ provide the argument --admin-cluster-membership on the command
            line.

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

       --admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION
          Google Cloud location for the admin_cluster_membership. To set the
          location attribute:
          ▸ provide the argument --admin-cluster-membership on the command
            line with a fully specified name;
          ▸ provide the argument --admin-cluster-membership-location on the
            command line.

       --admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT
          Google Cloud project for the admin_cluster_membership. To set the
          project attribute:
          ▸ provide the argument --admin-cluster-membership on the command
            line with a fully specified name;
          ▸ provide the argument --admin-cluster-membership-project on the
            command line.

     Anthos on VMware cluster load balancer configurations

     This must be specified.

       VIPs used by the load balancer

       This must be specified.

         --control-plane-vip=CONTROL_PLANE_VIP
            VIP for the Kubernetes API of this cluster.

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

         --ingress-vip=INGRESS_VIP
            VIP for ingress traffic into this cluster.

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

       Populate one of the load balancers.

       Exactly one of these must be specified:

         MetalLB Configuration

           --metal-lb-config-from-file=METAL_LB_CONFIG_FROM_FILE
              Path of the YAML/JSON file that contains the MetalLB
              configurations.

              Examples:

                  metalLBConfig:
                    addressPools:
                    - pool: lb-test-ip
                      addresses:
                      - 10.251.133.79/32
                      - 10.251.133.80/32
                      avoidBuggyIPs: True
                      manualAssign: False
                    - pool: ingress-ip
                      addresses:
                      - 10.251.133.70/32
                      avoidBuggyIPs: False
                      manualAssign: True

              List of supported fields in metalLBConfig

                KEY             VALUE                        NOTE
                addressPools    one or more addressPools     required, mutable

              List of supported fields in addressPools

                KEY             VALUE                    NOTE
                pool            string                   required, mutable
                addresses       one or more IP ranges    required, mutable
                avoidBuggyIPs   bool                     optional, mutable,
                                                         defaults to False
                manualAssign    bool                     optional, mutable,
                                                         defaults to False

         Manual load balancer configuration

           --control-plane-node-port=CONTROL_PLANE_NODE_PORT
              NodePort for control plane service.

           --ingress-http-node-port=INGRESS_HTTP_NODE_PORT
              NodePort for ingress service's http.

           --ingress-https-node-port=INGRESS_HTTPS_NODE_PORT
              NodePort for ingress service's https.

           --konnectivity-server-node-port=KONNECTIVITY_SERVER_NODE_PORT
              NodePort for konnectivity service running as a sidecar in each
              kube-apiserver pod.

         F5 Big IP Configuration

           --f5-config-address=F5_CONFIG_ADDRESS
              F5 Big IP load balancer address.

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

           --f5-config-partition=F5_CONFIG_PARTITION
              F5 Big IP load balancer partition.

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

           --f5-config-snat-pool=F5_CONFIG_SNAT_POOL
              F5 Big IP load balancer pool name if using SNAT.

     VMware User Cluster network configurations

     This must be specified.

       --pod-address-cidr-blocks=POD_ADDRESS
          IPv4 address range for all pods in the cluster.

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

       --service-address-cidr-blocks=SERVICE_ADDRESS
          IPv4 address range for all services in the cluster.

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

       Common parameters for all hosts irrespective of their IP address

         --dns-search-domains=[DNS_SEARCH_DOMAINS,...]
            DNS search domains.

         --dns-servers=[DNS_SERVERS,...]
            DNS server IP address.

         --ntp-servers=[NTP_SERVERS,...]
            NTP server IP address.

       IP configuration used by the VMware User Cluster

       At most one of these can be specified:

         DHCP configuration group.

           --enable-dhcp
              Enable DHCP IP allocation for VMware user clusters.

         Static IP configuration group

           --static-ip-config-from-file=STATIC_IP_CONFIG_FROM_FILE
              Path of the YAML/JSON file that contains the static IP
              configurations, used by Anthos on VMware user cluster node pools.

              Examples:

                  staticIPConfig:
                    ipBlocks:
                    - gateway: 10.251.31.254
                      netmask: 255.255.252.0
                      ips:
                      - hostname: hostname-1
                        ip: 1.1.1.1
                      - hostname: hostname-2
                        ip: 2.2.2.2
                      - hostname: hostname-3
                        ip: 3.3.3.3
                      - hostname: hostname-4
                        ip: 4.4.4.4

              List of supported fields in staticIPConfig

                KEY        VALUE                 NOTE
                ipBlocks   one or more ipBlocks  required, mutable

              List of supported fields in ipBlocks

                KEY      VALUE            NOTE
                gateway  IP address       required, immutable
                netmask  IP address       required, immutable
                ips      one or more ips  required, mutable

              List of supported fields in ips

                KEY        VALUE        NOTE
                hostname   string       optional, immutable
                ip         IP address   required, immutable

              New ips fields can be added, existing ips fields cannot be
              removed or updated.

OPTIONAL FLAGS
     User cluster authorization configurations to bootstrap onto the admin
     cluster

       --admin-users=ADMIN_USERS
          Users that will be granted the cluster-admin role on the cluster,
          providing full access to the cluster.

     --annotations=[KEY=VALUE,...]
        Annotations on the VMware user cluster.

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

     --description=DESCRIPTION
        Description for the resource.

     Anti-affinity group configurations

       --disable-aag-config
          If set, spread nodes across at least three physical hosts (requires
          at least three hosts). Enabled by default.

     Storage configurations

       --disable-vsphere-csi
          If set, vSphere CSI components are not deployed in the VMware User
          Cluster. Enabled by default.

     Auto-repair configurations

       --enable-auto-repair
          If set, deploy the cluster-health-controller.

     --enable-vm-tracking
        If set, enable VM tracking.

     --validate-only
        If set, only validate the request, but do not actually perform the
        operation.

     --version=VERSION
        Anthos Cluster on VMware version for the user cluster resource

     Control plane node configurations

       --cpus=CPUS
          Number of CPUs for each admin cluster node that serve as control
          planes for this VMware user cluster. (default: 4 CPUs)

       Auto resize configurations

         --enable-auto-resize
            Enable controle plane node auto resize.

       --memory=MEMORY
          Megabytes of memory for each admin cluster node that serves as a
          control plane for this VMware User Cluster (default: 8192 MB memory).

       --replicas=REPLICAS
          Number of control plane nodes for this VMware user cluster. (default:
          1 replica).

     Dataplane V2 configurations

       --enable-advanced-networking
          If set, enable advanced networking. Requires dataplane_v2_enabled to
          be set true.

       --enable-dataplane-v2
          If set, enables Dataplane V2.

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.

