gcloud beta container vmware clusters create - create an Anthos cluster on VMware

gcloud beta container vmware clusters create(CLUSTER :--location=LOCATION)--version=VERSION(--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-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL] |--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 :--control-plane-ip-block=[gateway=GATEWAY],[ips=IPS],[netmask=NETMASK]--dns-search-domains=[DNS_SEARCH_DOMAINS,…]--dns-servers=[DNS_SERVERS,…]--ntp-servers=[NTP_SERVERS,…]--enable-dhcp    |--static-ip-config-ip-blocks=[gateway=GATEWAY],[ips=IPS],[netmask=NETMASK])[--admin-users=ADMIN_USERS][--annotations=[KEY=VALUE,…]][--async][--description=DESCRIPTION][--disable-aag-config][--disable-vsphere-csi][--enable-auto-repair][--enable-vm-tracking][--upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY]][--validate-only][--cpus=CPUS--enable-auto-resize--memory=MEMORY--replicas=REPLICAS][--disable-control-plane-v2    |--enable-control-plane-v2][--enable-advanced-networking--enable-dataplane-v2][--vcenter-ca-cert-data=VCENTER_CA_CERT_DATA--vcenter-cluster=VCENTER_CLUSTER--vcenter-datacenter=VCENTER_DATACENTER--vcenter-datastore=VCENTER_DATASTORE--vcenter-folder=VCENTER_FOLDER--vcenter-resource-pool=VCENTER_RESOURCE_POOL--vcenter-storage-policy-name=VCENTER_STORAGE_POLICY_NAME][GCLOUD_WIDE_FLAG …]

Cluster resource - cluster to create The arguments in this group can be used tospecify the attributes of this resource. (NOTE) Some attributes are not givenarguments in this group but can be set in other ways.

To set theproject attribute:

• provide the argumentcluster on the command line with a fullyspecified name;
• provide the argument--project on the command line;
• set the propertycore/project.

This must be specified.

CLUSTER

ID of the cluster or fully qualified identifier for the cluster.

To set thecluster attribute:

• provide the argumentcluster on the command line.

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

--location=LOCATION

Google Cloud location for the cluster.

To set thelocation attribute:

• provide the argumentcluster on the command line with a fullyspecified name;
• provide the argument--location on the command line;
• set the propertycontainer_vmware/location.

--version=VERSION

Anthos Cluster on VMware version for the cluster resource

Admin cluster membership resource - membership of the admin cluster. Membershipname is the same as the admin cluster name.

Examples:

gcloudbetacontainervmwareclusterscreate--admin-cluster-membership=projects/example-project-12345/locations/us-west1/memberships/example-admin-cluster-name

or

gcloudbetacontainervmwareclusterscreate--admin-cluster-membership-project=example-project-12345--admin-cluster-membership-location=us-west1--admin-cluster-membership=example-admin-cluster-name

Theargumentsinthisgroupcanbeusedtospecifytheattributesofthisresource.

This must be specified.

--admin-cluster-membership=ADMIN_CLUSTER_MEMBERSHIP

ID of the admin_cluster_membership or fully qualified identifier for theadmin_cluster_membership.

To set theadmin_cluster_membership attribute:

• provide the argument--admin-cluster-membership on the commandline.

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

--admin-cluster-membership-location=ADMIN_CLUSTER_MEMBERSHIP_LOCATION

Google Cloud location for the admin_cluster_membership.

To set thelocation attribute:

• provide the argument--admin-cluster-membership on the command linewith a fully specified name;
• provide the argument--admin-cluster-membership-location on thecommand line.

--admin-cluster-membership-project=ADMIN_CLUSTER_MEMBERSHIP_PROJECT

Google Cloud project for the admin_cluster_membership.

To set theproject attribute:

• provide the argument--admin-cluster-membership on the command linewith a fully specified name;
• provide the argument--admin-cluster-membership-project on thecommand 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 groupare 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 groupare specified.

Populate one of the load balancers.

Exactly one of these must be specified:

MetalLB Configuration

At most one of these can be specified:

--metal-lb-config-address-pools=[addresses=ADDRESSES],[avoid-buggy-ips=AVOID-BUGGY-IPS],[manual-assign=MANUAL-ASSIGN],[pool=POOL]

MetalLB load balancer configurations.

Examples:

To specify MetalLB load balancer configurations for two address poolspool1 andpool2,

gcloudgcloudbetacontainervmwareclusterscreate--metal-lb-config-address-pools'pool=pool1,avoid-buggy-ips=True,manual-assign=True,addresses=192.168.1.1/32;192.168.1.2-192.168.1.3'--metal-lb-config-address-pools'pool=pool2,avoid-buggy-ips=False,manual-assign=False,addresses=192.168.2.1/32;192.168.2.2-192.168.2.3'

Use quote around the flag value to escape semicolon in the terminal.

Manual load balancer configuration.

With manual load balancing mode, DHCP is not supported. Specify static IPaddresses for cluster nodes instead. For more details, seehttps://cloud.google.com/anthos/clusters/docs/on-prem/latest/how-to/manual-load-balance#setting_aside_node_ip_addresses.

--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-apiserverpod.

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 groupare 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 groupare 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 groupare 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 groupare specified.

Control plane v2 mode configurations.

--control-plane-ip-block=[gateway=GATEWAY],[ips=IPS],[netmask=NETMASK]

Static IP addresses for the control plane nodes. The number of IP addressesshould match the number of replicas for the control plane nodes, specified by--replicas.

To specify the control plane IP block,

gcloudgcloudbetacontainervmwareclusterscreate--control-plane-ip-block'gateway=192.168.0.1,netmask=255.255.255.0,ips=192.168.1.1;0.0.0.0 localhost;'

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.

While using DHCP, manual load balancing mode is not supported. For more details,seehttps://cloud.google.com/anthos/clusters/docs/on-prem/latest/how-to/manual-load-balance#setting_aside_node_ip_addresses.

Static IP configuration group

At most one of these can be specified:

--static-ip-config-ip-blocks=[gateway=GATEWAY],[ips=IPS],[netmask=NETMASK]

Static IP configurations.

Expect an individual IP address, an individual IP address with an optionalhostname, or a CIDR block.

Example:

To specify two Static IP blocks,

gcloudgcloudbetacontainervmwareclusterscreate--static-ip-config-ip-blocks'gateway=192.168.0.1,netmask=255.255.255.0,ips=192.168.1.1;0.0.0.0 localhost;192.168.1.2/16'--static-ip-config-ip-blocks'gateway=192.168.1.1,netmask=255.255.0.0,ips=8.8.8.8;4.4.4.4'

Use quote around the flag value to escape semicolon in the terminal.

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 fullaccess to the cluster.

To add multiple users, specify one in each flag. When updating, the updatecommand overwrites the whole grant list. Specify all existing and new users thatyou want to be cluster administrators.

Examples:

gcloudbetacontainervmwareclusterscreate--admin-usersalice@example.com--admin-usersbob@example.com

--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 leastthree 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.

Upgrade policy for the cluster.

--upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY]

If not specified, control-plane-only is set to False. In the next upgradeoperation, all worker node pools will be upgraded together with the controlplane.

Example:

Toupgradethecontrolplaneonlyandkeepworkernodepoolsversionunchanged,firstspecifythepolicy:

gcloudbetacontainervmwareclusterscreateCLUSTER--upgrade-policycontrol-plane-only=True

Thentostarttheupgradeoperationusingthespecifiedpolicy,run:

gcloudbetacontainervmwareclustersupgradeCLUSTER--version=VERSION

Afterupgradingonlytheclustercontrolplane,toupgradeanindividualnodepool,run:

gcloudbetacontainervmwarenode-poolsupdateNODE_POOL--version=VERSION

Example:

Alternatively,toupgradeboththecontrolplaneandallworkernodepools,firstspecifythepolicy:

gcloudbetacontainervmwareclusterscreateCLUSTER--upgrade-policycontrol-plane-only=False

Thentostarttheupgradeoperationusingthespecifiedpolicy,run:

gcloudbetacontainervmwareclustersupgradeCLUSTER--version=VERSION

--validate-only

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

Control plane node configurations

--cpus=CPUS

Number of CPUs for each admin cluster node that serve as control planes for thisVMware 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 planefor this VMware User Cluster (default: 8192 MB memory).

--replicas=REPLICAS

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

At most one of these can be specified:

--disable-control-plane-v2

If set, disable control plane v2.

--enable-control-plane-v2

If set, enable control plane v2.

Dataplane V2 configurations

--enable-advanced-networking

If set, enable advanced networking. Requires dataplane_v2_enabled to be settrue.

--enable-dataplane-v2

If set, enables Dataplane V2.

vCenter configurations for the cluster. If not specified, it is inherited fromthe admin cluster.

--vcenter-ca-cert-data=VCENTER_CA_CERT_DATA

Name of the vCenter CA certificate public key for SSL verification.

--vcenter-cluster=VCENTER_CLUSTER

Name of the vCenter cluster for the user cluster.

--vcenter-datacenter=VCENTER_DATACENTER

Name of the vCenter datacenter for the user cluster.

--vcenter-datastore=VCENTER_DATASTORE

Name of the vCenter datastore for the user cluster.

--vcenter-folder=VCENTER_FOLDER

Name of the vCenter folder for the user cluster.

--vcenter-resource-pool=VCENTER_RESOURCE_POOL

Name of the vCenter resource pool for the user cluster.

--vcenter-storage-policy-name=VCENTER_STORAGE_POLICY_NAME

Name of the vCenter storage policy for the user cluster.

Run$gcloud help for details.