imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-10 03:16:46 +00:00
Code Activity
gcloud-help/gcloud/alpha/container/vmware/clusters/create
Automated 1248f773ec gcloud: Thu Jan 19 00:56:33 UTC 2023
2023-01-19 00:56:33 +00:00

361 lines
13 KiB
Text
Raw Blame History

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.
View git blame Copy permalink