Anthos clusters on VMware ora è Google Distributed Cloud (solo software) per VMware. Per ulteriori informazioni, consulta la panoramica del prodotto.

Questa pagina è stata tradotta dall'API Cloud Translation.

File di configurazione del cluster di amministrazione 1.29

Questo documento descrive i campi del file di configurazione del cluster di amministrazione per versione 1.29 di Google Distributed Cloud.

Generare un modello per il file di configurazione

Se hai utilizzato gkeadm per creare la workstation di amministrazione, gkeadm ha generato un modello per il file di configurazione del cluster di amministrazione. Inoltre, gkeadm ha compilato alcuni campi.

Se non hai utilizzato gkeadm per creare la tua workstation di amministrazione, puoi utilizzare gkectl per generare un modello per il file di configurazione del cluster di amministrazione.

Per generare un modello per il file di configurazione del cluster di amministrazione:

gkectl create-config admin --config=OUTPUT_FILENAME --gke-on-prem-version=VERSION

Sostituisci OUTPUT_FILENAME con il percorso che preferisci per il modello generato. Se ometti questo flag, gkectl assegna al file il nome admin-cluster.yaml e lo inserisce nella directory corrente.

Sostituisci VERSION con la versione completa di una patch 1.29 . Ad esempio: gkectl create-config admin --gke-on-prem-version=1.29.600-gke.109. Questa versione deve essere uguale o precedente alla versione di gkectl. Se ometti questo flag, il modello di configurazione generato viene compilato con valori basati l'ultima patch 1.29.

Modello

Fai clic per vedere il modello generato.

apiVersion: v1
kind: AdminCluster
# (Optional) A unique name for this admin cluster. This will default to a random name
# prefixed with 'gke-admin-'
name: ""
# (Required) Absolute path to a GKE bundle on disk
bundlePath: ""
# # (Optional/Preview) Specify the prepared secret configuration which can be added
# # or edited only during cluster creation
# preparedSecrets:
#   # enable prepared credentials for the admin cluster; it is immutable
#   enabled: false
# (Required) vCenter configuration
vCenter:
  address: ""
  datacenter: ""
  cluster: ""
  # Resource pool to use. Specify [VSPHERE_CLUSTER_NAME]/Resources to use the default
  # resource pool
  resourcePool: ""
  # Storage policy to use for cluster VM storage and default StorageClass. Do not
  # specify it together with datastore
  storagePolicyName: ""
  # # Datastore to use for cluster VM storage and default StorageClass. Do not specify
  # # it together with storagePolicyName
  # datastore: ""
  # Provide the path to vCenter CA certificate pub key for SSL verification
  caCertPath: ""
  # The credentials to connect to vCenter
  credentials:
    # reference to external credentials file
    fileRef:
      # read credentials from this file
      path: ""
      # entry in the credential file
      entry: ""
  # (Optional) vSphere folder where cluster VMs will be located. Defaults to the
  # datacenter wide folder if unspecified.
  folder: ""
  # # (Only used in 1.16 and older versions for non-HA admin cluster) Provide the name
  # # for the persistent disk to be used by the deployment (ending in .vmdk). Any directory
  # # in the supplied path must be created before deployment. Required for non-HA admin
  # # cluster. Invalid for HA admin cluster as the path is generated automatically under
  # # the root directory "anthos" in the specified datastore.
  # dataDisk: ""
# (Required) Network configuration
network:
  # (Required when using "static" ipMode.type; or "Seesaw" loadBalancer.kind; or using
  # amdin cluster HA mode) This section overrides ipMode.ipBlockFilePath values when
  # ipMode.type=static. It's also used for seesaw nodes
  hostConfig:
    # List of DNS servers
    dnsServers:
    - ""
    # List of NTP servers
    ntpServers:
    - ""
    # # List of DNS search domains
    # searchDomainsForDNS:
    # - ""
  ipMode:
    # (Required) Define what IP mode to use ("dhcp" or "static")
    type: static
    # (Required when using "static" mode) The absolute or relative path to the yaml
    # file to use for static IP allocation. Hostconfig part will be overwritten by
    # network.hostconfig if specified
    ipBlockFilePath: ""
  # (Required) The Kubernetes service CIDR range for the cluster. Must not overlap
  # with the pod CIDR range
  serviceCIDR: 10.96.232.0/24
  # (Required) The Kubernetes pod CIDR range for the cluster. Must not overlap with
  # the service CIDR range
  podCIDR: 192.168.0.0/16
  vCenter:
    # vSphere network name
    networkName: ""
  # (Required for HA admin cluster) Specify the IPs to use for control plane machines
  # for HA admin cluster.
  controlPlaneIPBlock:
    netmask: ""
    gateway: ""
    ips:
    - ip: ""
      hostname: ""
    - ip: ""
      hostname: ""
    - ip: ""
      hostname: ""
# (Required) Load balancer configuration
loadBalancer:
  # (Required) The VIPs to use for load balancing
  vips:
    # Used to connect to the Kubernetes API
    controlPlaneVIP: ""
  # (Required) Which load balancer to use "F5BigIP" "Seesaw" "ManualLB" or "MetalLB".
  # Uncomment the corresponding field below to provide the detailed spec
  kind: MetalLB
  # # (Required when using "ManualLB" kind) Specify pre-defined nodeports
  # manualLB:
  #   # NodePort for ingress service's http (only needed for user cluster)
  #   ingressHTTPNodePort: 0
  #   # NodePort for ingress service's https (only needed for user cluster)
  #   ingressHTTPSNodePort: 0
  #   # NodePort for konnectivity server service (only needed for controlplane v1 user
  #   # cluster)
  #   konnectivityServerNodePort: 0
  #   # NodePort for control plane service (not needed for HA admin cluster or controlplane
  #   # V2 user cluster)
  #   controlPlaneNodePort: 30968
  # # (Required when using "F5BigIP" kind) Specify the already-existing partition and
  # # credentials
  # f5BigIP:
  #   address: ""
  #   credentials:
  #     # reference to external credentials file
  #     fileRef:
  #       # read credentials from this file
  #       path: ""
  #       # entry in the credential file
  #       entry: ""
  #   partition: ""
  #   # # (Optional) Specify a pool name if using SNAT
  #   # snatPoolName: ""
  # # (Only used in 1.16 and older versions for using "Seesaw" kind) Specify the Seesaw
  # # configs
  # seesaw:
  #   # (Required) The absolute or relative path to the yaml file to use for IP allocation
  #   # for LB VMs. Must contain one or two IPs. Hostconfig part will be overwritten by
  #   # network.hostconfig if specified.
  #   ipBlockFilePath: ""
  #   # (Required) The Virtual Router IDentifier of VRRP for the Seesaw group. Must be
  #   # between 1-255 and unique in a VLAN.
  #   vrid: 0
  #   # (Required) The IP announced by the master of Seesaw group
  #   masterIP: ""
  #   # (Required) The number CPUs per machine
  #   cpus: 2
  #   # (Required) Memory size in MB per machine
  #   memoryMB: 3072
  #   # (Optional) Network that the LB interface of Seesaw runs in (default: cluster network)
  #   vCenter:
  #     # vSphere network name
  #     networkName: ""
  #   # (Optional) Run two LB VMs to achieve high availability (default: false)
  #   enableHA: false
  #   # (Optional) Avoid using VRRP MAC and rely on gratuitous ARP to do failover. In
  #   # this mode MAC learning is not needed but the gateway must refresh arp table based
  #   # on gratuitous ARP. It's recommended to turn this on to avoid MAC learning configuration.
  #   # In vsphere 7+ it must be true to enable HA. It is supported in GKE on-prem version
  #   # 1.7+. (default: false)
  #   disableVRRPMAC: true
# Spread admin addon nodes and user masters across different physical hosts (requires
# at least three hosts)
antiAffinityGroups:
  # Set to false to disable DRS rule creation
  enabled: true
# Specify the admin master node configuration (default: 4 CPUs; 16384 MB memory; 3
# replicas). The replicas field has to be 3 for new admin cluster creation
adminMaster:
  cpus: 4
  memoryMB: 16384
  # How many machines of this type to deploy
  replicas: 3
# # (Only used in 1.16 and older versions) Specify the addon node configuration which
# # can be added or edited only during cluster creation
# addonNode:
#   # Enable auto resize for addon node
#   autoResize:
#     # Whether to enable auto resize for master. Defaults to false.
#     enabled: false
# (Optional) Specify the proxy configuration
proxy:
  # The URL of the proxy
  url: ""
  # The domains and IP addresses excluded from proxying
  noProxy: ""
# # (Optional) Use a private registry to host GKE images
# privateRegistry:
#   # Do not include the scheme with your registry address
#   address: ""
#   credentials:
#     # reference to external credentials file
#     fileRef:
#       # read credentials from this file
#       path: ""
#       # entry in the credential file
#       entry: ""
#   # The absolute or relative path to the CA certificate for this registry
#   caCertPath: ""
# (Required): The absolute or relative path to the GCP service account key for pulling
# GKE images
componentAccessServiceAccountKeyPath: ""
# (Required) Specify which GCP project to register your GKE OnPrem cluster to
gkeConnect:
  projectID: ""
  # # (Optional) The location of the GKE Hub and Connect service where the cluster is
  # # registered to. It can be any GCP region or "global". Default to "global" when unspecified.
  # location: us-central1
  # The absolute or relative path to the key file for a GCP service account used to
  # register the cluster
  registerServiceAccountKeyPath: ""
# # (Optional) Specify if you wish to explicitly enable/disable the cloud hosted gkeonprem
# # API to enable/disable cluster lifecycle management from gcloud UI and Terraform.
# gkeOnPremAPI:
#   enabled: false
# (Required) Specify which GCP project to connect your logs and metrics to
stackdriver:
  # The project ID for logs and metrics. It should be the same with gkeconnect.projectID.
  projectID: ""
  # A GCP region where you would like to store logs and metrics for this cluster.
  clusterLocation: us-central1
  enableVPC: false
  # The absolute or relative path to the key file for a GCP service account used to
  # send logs and metrics from the cluster
  serviceAccountKeyPath: ""
  # (Optional) Disable vsphere resource metrics collection from vcenter.  False by
  # default
  disableVsphereResourceMetrics: false
# (Optional) Configure kubernetes apiserver audit logging
cloudAuditLogging:
  # The project ID for logs and metrics. It should be the same with gkeconnect.projectID.
  projectID: ""
  # A GCP region where you would like to store audit logs for this cluster.
  clusterLocation: us-central1
  # The absolute or relative path to the key file for a GCP service account used to
  # send audit logs from the cluster
  serviceAccountKeyPath: ""
# # (Optional/Preview) Configure backups for admin cluster. Backups will be stored under
# # /anthos-backups/.
# clusterBackup:
#   # # datastore where admin cluster backups are desired
#   # datastore: ""
# Enable auto repair for the cluster
autoRepair:
  # Whether to enable auto repair feature. Set false to disable.
  enabled: true
# # Encrypt Kubernetes secrets at rest
# secretsEncryption:
#   # Secrets Encryption Mode. Possible values are: GeneratedKey
#   mode: GeneratedKey
#   # GeneratedKey Secrets Encryption config
#   generatedKey:
#     # # key version
#     # keyVersion: 1
#     # # disable secrets encryption
#     # disabled: false
# (Optional) Specify the type of OS image; available options can be set to "ubuntu_containerd"
# "cos" "ubuntu_cgv2" or "cos_cgv2". Default is "ubuntu_containerd".
osImageType: ubuntu_cgv2

Compilazione del file di configurazione in corso...

Nel file di configurazione, inserisci i valori dei campi come descritto di seguito sezioni.

`name`

(Facoltativo)
Stringa
Valore predefinito: un nome casuale con prefisso "gke-admin-"

Un nome a tua scelta per il cluster.

Esempio:

name: "my-admin-cluster"

`bundlePath`

Stringa

mutabile obbligatoria

Il percorso del file del bundle di Google Distributed Cloud.

Il file del bundle completo di Google Distributed Cloud contiene tutti i componenti in una particolare release di Google Distributed Cloud. Quando crei un amministratore workstation, viene fornito con un pacchetto completo da:

/var/lib/gke/bundles/gke-onprem-vsphere-VERSION-full.tgz

Esempio:

bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.10.0-gke.8.full.tgz"

`preparedSecrets.enabled`

Anteprima
Facoltativo
Immutabile
Valore booleano
Precompilato: false
Valore predefinito: false

Imposta questo elemento su true se vuoi usare credenziali preparate nel cluster di amministrazione. In caso contrario, impostalo su false.

Esempio:

preparedSecrets:
  enabled: true

`vCenter`

Obbligatorio
Immutabile

Questa sezione contiene informazioni sul tuo ambiente vSphere e sulla connessione a vCenter Server.

`vCenter.address`

Obbligatorio
Immutabile
Stringa

L'indirizzo IP o il nome host del tuo server vCenter.

Per ulteriori informazioni, vedi Ricerca dell'indirizzo del server vCenter.

Esempi:

vCenter:
  address: "203.0.113.100"

vCenter:
  address: "my-vcenter-server.my-domain.example"

`vCenter.datacenter`

Obbligatorio
Immutabile
Stringa

Il percorso relativo di un Data center vSphere.

Il valore specificato è relativo alla cartella principale denominata /.

Se il tuo data center si trova nella cartella principale, il valore è il nome del data center.

Esempio:

vCenter:
  datacenter: "my-data-center"

In caso contrario, il valore è un percorso relativo che include una o più cartelle insieme con il nome del data center.

Esempio:

vCenter:
  datacenter: "data-centers/data-center-1"

`vCenter.cluster`

Stringa
obbligatoria
non modificabile

Il percorso relativo di un cluster vSphere che rappresenta gli host ESXi su cui verranno eseguite le VM del cluster di amministrazione. Questa vSphere rappresenta un sottoinsieme degli host ESXi fisici nel data center vCenter.

Il valore specificato è relativo a /.../DATA_CENTER/vm/.

Se il cluster vSphere si trova in /.../DATA_CENTER/vm/ , il valore è il nome del cluster vSphere.

Esempio:

vCenter:
  cluster: "my-vsphere-cluster"

In caso contrario, il valore è un percorso relativo che include una o più cartelle insieme al nome del cluster vSphere.

Esempio:

vCenter:
  cluster: "clusters/vsphere-cluster-1"

`vCenter.resourcePool`

Stringa
obbligatoria
non modificabile

Un pool di risorse vCenter per le VM del cluster di amministrazione.

Se vuoi utilizzare il pool di risorse predefinito, impostalo su VSPHERE_CLUSTER/Resources.

Esempio:

vCenter:
  resourcePool: "my-vsphere-cluster/Resources"

Se vuoi utilizzare un pool di risorse che hai già creato, impostalo su e il percorso relativo del pool di risorse.

Il valore specificato è relativo a /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/

Se il pool di risorse è un elemento figlio diretto di /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/ il valore è il nome del pool di risorse.

Esempio:

vCenter:
  resourcePool: "my-resource-pool"

In caso contrario, il valore è un percorso relativo con due o più pool di risorse.

Esempio:

vCenter:
  resourcePool: "resource-pool-1/resource-pool-2"

`vCenter.datastore`

Obbligatorio se vCenter.storagePolicyName non è specificato
Immutabile
Stringa

Il nome di un Datastore vSphere per il cluster di amministrazione.

Il valore specificato deve essere un nome, non un percorso. Non includere cartelle nel valore.

Esempio:

vCenter:
  datastore: "my-datastore"

Devi specificare un valore per vCenter.datastore o vCenter.storagePolicyName, ma non per entrambi. Se specifichi un valore per questo non specificare un valore per vCenter.storagePolicyName. Il vCenter.datastore campo è immutabile, tranne quando lo imposti su una stringa vuota quando esegui la migrazione di un datastore a Storage Policy Based Management (SPBM).

`vCenter.storagePolicyName`

Obbligatorio se vCenter.datastore non è specificato
Stringa
invariabile

Il nome di un criterio di archiviazione VM per i nodi del cluster.

Il cluster di amministrazione deve essere ad alta disponibilità (HA) per funzionare con il criterio di archiviazione.

Per ulteriori informazioni, consulta Configurare un criterio di archiviazione.

Devi specificare un valore per vCenter.datastore o vCenter.storagePolicyName, ma non per entrambi. Se specifichi un valore per questo campo, non specificare un valore per vCenter.datastore.

`vCenter.caCertPath`

Stringa

mutabile obbligatoria

Il percorso del certificato CA per il server vCenter.

Per ulteriori informazioni, vedi Recupero del certificato CA vCenter.

Per informazioni sull'aggiornamento di questo campo per un cluster esistente, consulta Aggiorna i riferimenti dei certificati vCenter.

Esempio:

vCenter:
  caCertPath: "/usr/local/google/home/me/certs/vcenter-ca-cert.pem"

`vCenter.credentials.fileRef.path`

obbligatoria
Stringa

Il percorso di un file di configurazione credenziali che contiene nome utente e password del tuo account utente vCenter. L'account utente deve avere il ruolo Amministratore o privilegi equivalenti. Consulta i requisiti di vSphere.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali di vCenter, consulta Aggiornamento delle credenziali del cluster.

Esempio:

vCenter:
  credentials:
    fileRef:
      path: "my-config-folder/admin-creds.yaml"

`vCenter.credentials.fileRef.entry`

Obbligatorio
Stringa

Il nome del blocco delle credenziali, nel tuo file di configurazione credenziali, che contiene il nome utente e la password del tuo account utente vCenter.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali vCenter, vedi Aggiornare le credenziali del cluster.

Esempio:

vCenter:
  credentials:
    fileRef:
      entry: "vcenter-creds"

`vCenter.folder`

Facoltativo
Immutabile
Stringa
Impostazione predefinita: la cartella a livello di data center

Il percorso relativo di una cartella vSphere che hai già creato. Questa cartella conterrà le VM del cluster amministrativo.

Se non specifichi un valore, le VM del cluster di amministrazione verranno inserite /.../DATA_CENTER/vm/.

Se specifichi un valore, questo è relativo a /.../DATA_CENTER/vm/.

Il valore può essere il nome di una cartella.

Esempio:

vCenter:
  folder: "my-folder"

In alternativa, il valore può essere un percorso relativo che include più di una cartella.

Esempio:

vCenter:
  folder: "folders/folder-1"

`vCenter.dataDisk`

Non fornire un valore per questo campo. Elimina il campo o lascialo commentato.

`network`

Obbligatorio
Immutabile

Questa sezione contiene informazioni sulla rete del cluster di amministrazione.

`network.hostConfig`

Obbligatorio
Immutabile

Questa sezione contiene informazioni su server NTP, server DNS e domini di ricerca DNS utilizzati dalle VM corrispondenti ai nodi del cluster.

`network.hostConfig.dnsServers`

Obbligatorio se la sezione network.hostConfig è compilata.
Immutabile
Array di stringhe.
Il numero massimo di elementi nell'array è tre.

Gli indirizzi dei server DNS delle VM.

Esempio:

network:
  hostConfig:
    dnsServers:
    - "172.16.255.1"
    - "172.16.255.2"

`network.hostConfig.ntpServers`

Obbligatorio se la sezione network.hostConfig è compilata.
Immutabile
Array di stringhe

Gli indirizzi dei server di tempo che le VM devono utilizzare.

Esempio:

network:
  hostConfig:
    ntpServers:
    - "216.239.35.0"

`network.hostConfig.searchDomainsForDNS`

Facoltativo
Immutabile
Array di stringhe

Domini di ricerca DNS che le VM possono utilizzare. Questi domini sono utilizzata in un elenco di ricerca di domini.

Esempio:

network:
  hostConfig:
    searchDomainsForDNS:
    - "my.local.com"

`network.ipMode.type`

Obbligatorio
Immutabile
Stringa
Precompilato: "static"
Valore predefinito: "dhcp"

Se vuoi che i nodi del cluster ricevano l'indirizzo IP da un server DHCP, imposta questo valore su "dhcp". Se vuoi che i nodi del cluster abbiano un IP statico indirizzi scelti da un elenco da te fornito, impostalo su "static".

Esempio:

network:
  ipMode:
    type: "static"

`network.ipMode.ipBlockFilePath`

Obbligatorio se network.ipMode.type = static
Immutabile
Stringa

Il percorso del file del blocco IP per il cluster.

Esempio:

network:
  ipMode:
    ipBlockFilePath: "/my-config-folder/admin-cluster-ipblock.yaml"

`network.serviceCIDR`

Obbligatorio
Impossibile modificare
Stringa
Intervallo minimo possibile: /24
Intervallo massimo possibile: /12
Precompilato: "10.96.232.0/24"
Valore predefinito: "10.96.232.0/24"

Un intervallo di indirizzi IP, in formato CIDR, da utilizzare per i servizi nel cluster.

Esempio:

network:
  serviceCIDR: "10.96.232.0/24"

`network.podCIDR`

Obbligatorio
Immutabile
Stringa
Intervallo minimo possibile: /18
Intervallo più ampio possibile: /8
Precompilato: "192.168.0.0/16"
Valore predefinito: "192.168.0.0/16"

Un intervallo di indirizzi IP, in formato CIDR, da utilizzare per i pod nel tuo in un cluster Kubernetes.

Esempio:

network:
  podCIDR: "192.168.0.0/16"

L'intervallo di servizi non deve sovrapporsi all'intervallo di pod.

Gli intervalli di servizi e pod non devono sovrapporsi a nessun indirizzo esterno al cluster che vuoi raggiungere dall'interno del cluster.

Ad esempio, supponiamo che l'intervallo di servizi sia 10.96.232.0/24 e che l'intervallo di pod sia 192.168.0.0/16. Il traffico inviato da un pod a un indirizzo in uno di questi verranno trattati come nel cluster e non raggiungeranno nessuna destinazione all'esterno nel cluster.

In particolare, gli intervalli di servizi e pod non devono sovrapporsi a:

Indirizzi IP dei nodi in qualsiasi cluster
Indirizzi IP utilizzati dalle macchine del bilanciatore del carico
VIP utilizzati dai nodi del piano di controllo e dai bilanciatori del carico
Indirizzo IP di server vCenter, server DNS e server NTP

Ti consigliamo di inserire gli intervalli di servizi e pod nello spazio di indirizzi RFC 1918.

Ecco un motivo per cui consigliamo di utilizzare gli indirizzi RFC 1918. Supponiamo che se il pod o l'intervallo di servizi contiene indirizzi IP esterni. Qualsiasi traffico inviato da un pod a uno di questi indirizzi esterni verrà trattato come traffico nel cluster e non raggiungerà la destinazione esterna.

`network.vCenter.networkName`

Stringa
obbligatoria
non modificabile

Il nome della rete vSphere per i nodi del cluster.

Esempio:

network:
  vCenter:
    networkName: "my-network"

Se il nome contiene un carattere speciale, devi utilizzare una sequenza di escape.

Caratteri speciali	Sequenza di escape
Barra (`/`)	`%2f`
Barra rovesciata (`\`)	`%5c`
Simbolo di percentuale (`%`)	`%25`

Se il nome della rete non è univoco nel tuo data center, puoi specificare un percorso completo.

Esempio:

network:
  vCenter:
    networkName: "/data-centers/data-center-1/network/my-network"

`network.controlPlaneIPBlock`

Obbligatorio

`network.controlPlaneIPBlock.netmask`

Stringa
obbligatoria
non modificabile

La maschera di rete per la rete che contiene i nodi del piano di controllo.

Esempio:

network:
  controlPlaneIPBlock:
    netmask: "255.255.255.0"

`network.controlPlaneIPBlock.gateway`

Obbligatorio
Immutabile
Stringa

L'indirizzo IP del gateway predefinito per i nodi del piano di controllo.

Esempio:

network:
  controlPlaneIPBlock:
    gateway: "172.16.22.1"

`network.controlPlaneIPBlock.ips`

Obbligatorio
Immutabile
Matrice di tre oggetti, ognuno dei quali ha un indirizzo IP e un oggetto dell'host.

Questi sono gli indirizzi IP che verranno assegnati ai nodi del piano di controllo.

Esempio:

network:
  controlPlaneIPBlock:
    ips:
    - ip: "172.16.22.6"
      hostname: "admin-cp-vm-1"
    - ip: "172.16.22.7"
      hostname: "admin-cp-vm-2"
    - ip: "172.16.22.8"
      hostname: "admin-cp-vm-3"

`loadBalancer`

Questa sezione contiene informazioni sul bilanciatore del carico per il cluster di amministrazione.

`loadBalancer.vips.controlPlaneVIP`

Obbligatorio
Immutabile
Stringa

L'indirizzo IP che hai scelto di configurare sul bilanciatore del carico per il server API Kubernetes del cluster di amministrazione.

Esempio:

loadBalancer:
  vips:
    controlplaneVIP: "203.0.113.3"

`loadBalancer.kind`

Obbligatoria
Stringa
non mutabile
Precompilata: "MetalLB"

Stringa. Imposta questo valore su "ManualLB", "F5BigIP" o "MetalLB"

Per attivare le funzionalità nuove e avanzate, ti consigliamo di utilizzare "ManualLB" se disponi di un bilanciatore del carico di terze parti (come F5 BIG-IP o Citrix) oppure "MetalLB" per la nostra soluzione in bundle.

Esempio:

loadBalancer:
  kind: "MetalLB"

`loadBalancer.manualLB`

Se imposti loadbalancer.kind su "ManualLB", compila questa sezione. In caso contrario,rimuovi questa sezione.
Immutabile

`loadBalancer.manualLB.ingressHTTPNodePort`

Rimuovi questo campo dal file di configurazione. Non viene utilizzato in un cluster dell'amministratore.

`loadBalancer.manualLB.ingressHTTPSNodePort`

Rimuovi questo campo dal file di configurazione. Non viene utilizzato in un cluster dell'amministratore.

`loadBalancer.manualLB.konnectivityServerNodePort`

Rimuovi questo campo dal file di configurazione. Non viene utilizzato in un cluster dell'amministratore.

`loadBalancer.f5BigIP`

Se imposti loadbalancer.kind su "f5BigIP", compila questa sezione. In caso contrario,rimuovi questa sezione.

Per attivare funzionalità nuove e avanzate, ti consigliamo di configurare manualmente per il tuo bilanciatore del carico F5 BIG-IP. Per attivare il caricamento manuale imposta loadbalancer.kind su "ManualLB" e compila loadBalancer.manualLB. Per maggiori informazioni le informazioni, vedi Attivazione della modalità di bilanciamento del carico manuale.

Se hai già un bilanciatore del carico F5-BIG-IP e la configurazione del cluster questa sezione; dopo aver eseguito l'upgrade alla versione 1.29 o successive, ti consigliamo esegui la migrazione al bilanciamento del carico manuale.

`loadBalancer.f5BigIP.address`

Obbligatorio se loadBalancer.kind = "f5BigIp"
Immutabile
Stringa

L'indirizzo del bilanciatore del carico F5 BIG-IP. Ad esempio:

loadBalancer:
  f5BigIP:
    address: "203.0.113.2"

`loadBalancer.f5BigIP.credentials.fileRef.path`

Obbligatorio se loadBalancer.kind = "f5BigIp"

Stringa
mutabile

Il percorso di un file di configurazione delle credenziali che contiene il nome utente e la password di un account che Google Distributed Cloud può utilizzare per connettersi al bilanciatore del carico F5 BIG-IP.

L'account utente deve avere un ruolo utente che disponga di autorizzazioni sufficienti per configurare e gestire il bilanciatore del carico. È sufficiente il ruolo Amministratore o Amministratore risorse.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali F5 BIG-IP, consulta Aggiornare le credenziali del cluster.

Esempio:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        path: ""my-config-folder/admin-creds.yaml"

`loadBalancer.f5BigIP.credentialsfileRef.entry`

Obbligatorio se loadBalancer.kind = "f5BigIp"

Stringa
mutabile

Il nome del blocco delle credenziali, nel tuo file di configurazione credenziali, che contiene il nome utente e la password del tuo account F5 BIG-IP.

Puoi utilizzare gkectl update per aggiornare questo campo in un cluster esistente.

Per informazioni su come aggiornare le credenziali F5 BIG-IP, consulta Aggiornare le credenziali del cluster.

Esempio:

loadBalancer:
  f5BigIP:
    credentials:
      fileRef:
        entry: "f5-creds"

`loadBalancer.f5BigIP.partition`

Obbligatorio se loadBalancer.kind = "f5BigIp"
Immutabile
Stringa

Il nome di una partizione BIG-IP che hai creato per il cluster di amministrazione.

Esempio:

loadBalancer:
  f5BigIP:
    partition: "my-f5-admin-partition"

`loadBalancer.f5BigIP.snatPoolName`

Facoltativo
Pertinente se loadBalancer.kind = "f5BigIp"
Immutabile
Stringa

Se utilizzi SNAT, il nome del pool SNAT. Se non utilizzi SNAT, rimuovi questo campo.

Esempio:

loadBalancer:
  f5BigIP:
    snatPoolName: "my-snat-pool"

`loadBalancer.seesaw`

Non utilizzare questa sezione. Il bilanciatore del carico Seesaw non è supportato per le nuove di amministrazione di Google Cloud nella versione 1.28 e successive. Ti consigliamo invece di configurare il bilanciatore del carico MetalLB per i nuovi cluster di amministrazione. Per maggiori informazioni sulla configurazione di MetalLB, consulta Bilanciamento del carico in bundle con MetalLB.

Anche se supportiamo ancora Seesaw per i cluster di amministrazione non ad alta disponibilità che sono aggiornato, ti consigliamo eseguire la migrazione a MetalLB.

`antiAffinityGroups.enabled`

Facoltativo
Mutabile
Booleano
Precompilato: true

Imposta questo valore su true per attivare la creazione di regole DRS. In caso contrario, impostalo su false.

Esempio:

antiAffinityGroups:
  enabled: true

Se questo campo è true, Google Distributed Cloud crea VMware Strumento di pianificazione delle risorse distribuite (DRS) regole di anti-affinità per i nodi del cluster di amministrazione, che vengono quindi visualizzate distribuiti su almeno tre host ESXi fisici nel tuo data center.

Questa funzionalità richiede che l'ambiente vSphere soddisfi i seguenti requisiti condizioni:

VMware DRS è abilitato. VMware DRS richiede la versione della licenza vSphere Enterprise Plus.
Il tuo account utente vSphere ha la Host.Inventory.Modify cluster di accesso.
Sono disponibili almeno quattro host ESXi.

Anche se la regola richiede che i nodi del cluster siano distribuiti tra Host ESXi, consigliamo vivamente di avere almeno 4 host ESXi disponibili. In questo modo, non perderai il piano di controllo del cluster di amministrazione. Per Ad esempio, supponiamo che tu abbia solo tre host ESXi e il tuo cluster di amministrazione il nodo del piano di controllo si trova su un host ESXi in cui si verifica un errore. La regola DRS impedirà di essere posizionato su uno dei restanti due host ESXi.

Ricorda che se disponi di licenza vSphere Standard, non puoi abilitare VMware DRS.

Se non hai attivato DRS o se non hai almeno quattro host su cui pianificare le VM vSphere, imposta antiAffinityGroups.enabled su false.

`adminMaster`

Immutabile

Impostazioni di configurazione per i nodi del piano di controllo nel cluster di amministrazione.

`adminMaster.cpus`

Anteprima
Facoltativo
Invariabile
Numero
Precompilato: 4
Valore predefinito: 4

Il numero di vCPU per ogni nodo del control plane nel cluster di amministrazione.

Esempio:

adminMaster:
  cpus: 4

`adminMaster.memoryMB`

Anteprima
Facoltativo
Immutabile
Numero intero
Precompilato: 16384
Valore predefinito: 16384

Il numero di mebibyte di memoria per ogni nodo del control plane nel cluster di amministrazione.

Esempio:

adminMaster:
  memoryMB: 16384

`adminMaster.replicas`

Obbligatorio per i nuovi cluster
Immutabile
Numero intero
Valori possibili: 3

Il numero di nodi del piano di controllo nel cluster di amministrazione. Durante la creazione di un nuovo imposta questo campo su 3 per creare un amministratore ad alta disponibilità in un cluster Kubernetes.

Esempio:

adminMaster:
  replicas: 3

`proxy`

Se la tua rete si trova dietro un server proxy, compila questa sezione. Altrimenti, rimuovi questa sezione o abbandona i commenti. Il server proxy specificato che viene utilizzato dai cluster utente gestiti da questo cluster di amministrazione.
Immutabile

`proxy.url`

Obbligatorio se viene compilata la sezione proxy.
Stringa
invariabile

L'indirizzo HTTP del server proxy. Includi il numero di porta anche se si tratta uguale alla porta predefinita dello schema.

Esempio:

proxy:
  url: "http://my-proxy.example.local:80"

Il server proxy specificato qui viene utilizzato dai tuoi cluster Google Distributed Cloud. Inoltre, la workstation di amministrazione viene configurata automaticamente per l'utilizzo lo stesso server proxy, a meno che non imposti la variabile di ambiente HTTPS_PROXY sul tuo la workstation di amministrazione.

Se specifichi proxy.url, devi specificare anche proxy.noProxy.

Una volta impostata la configurazione del proxy per il cluster di amministrazione, non è possibile modificato o eliminato, a meno che il cluster non venga ricreato.

`proxy.noProxy`

Facoltativo
Immutabile
Stringa

Un elenco separato da virgole di indirizzi IP, intervalli di indirizzi IP, nomi host e nomi di dominio che non devono passare attraverso il server proxy. Quando Google Distributed Cloud invia una richiesta a uno di questi indirizzi, host o domini, la richiesta viene inviata direttamente.

Esempio:

proxy:
  noProxy: "10.151.222.0/24,my-host.example.local,10.151.2.1"

`privateRegistry`

Se hai un Container Registry privato, compila questa sezione. Altrimenti, rimuovi questa sezione o lasciarla senza commenti.

`privateRegistry.address`

Obbligatorio per il registry privato
Stringa
invariabile

L'indirizzo IP o il nome di dominio completo (FQDN) della macchina che esegue del tuo registro privato.

Esempi:

privateRegistry:
  address: "203.0.113.10"

privateRegistry:
  address: "fqdn.example.com"

`privateRegistry.credentials.fileRef.path`

Obbligatorio per il registry privato

Stringa mutabile

Il percorso di un file di configurazione delle credenziali che contiene il nome utente e la password di un account che Google Distributed Cloud può utilizzare per accedere al tuo registry privato.

Esempio:

privateRegistry:
  credentials:
    fileRef:
      path: "my-config-folder/admin-creds.yaml"

`privateRegistry.credentials.fileRef.entry`

Obbligatorio per il registry privato

Stringa mutabile

Il nome del blocco delle credenziali, nel tuo file di configurazione credenziali, che contiene il nome utente e la password del tuo account di registro privato.

privateRegistry:
  credentials:
    fileRef:
      entry: "private-registry-creds"

`privateRegistry.caCertPath`

Obbligatorio per il registro privato
Modificabile
Stringa

Quando il runtime del container estrae un'immagine dal tuo registro privato, deve dimostrare la propria identità presentando un certificato. Il certificato del registry è firmato da un'autorità di certificazione (CA). Il runtime del contenitore utilizza il certificato della CA per convalidare il certificato del registry.

Imposta questo campo sul percorso del certificato della CA.

Esempio:

privateRegistry:
  caCertPath: "my-cert-folder/registry-ca.crt"

`componentAccessServiceAccountKeyPath`

Obbligatorio
Modificabile
Stringa

Il percorso del file della chiave JSON per l'account di servizio di accesso del componente.

Esempio:

componentAccessServiceAccountKeyPath: "my-key-folder/access-key.json"

`gkeConnect`

Obbligatorio
Modificabile

Quando compili la sezione gkeConnect, il cluster amministrativo viene registrato automaticamente in un parco risorse dopo la sua creazione. Questa sezione contiene informazioni sul progetto e sull'account di servizio Google Cloud necessari per registrare il cluster.

Durante la creazione o l'aggiornamento del cluster, nel cluster di amministrazione vengono configurati diversi criteri RBAC. Questi criteri RBAC sono necessari per poter e creare cluster utente nella console Google Cloud.

`gkeConnect.projectID`

Stringa
obbligatoria
non modificabile

L'ID del tuo progetto host del parco risorse. Per i nuovi cluster, questo ID progetto deve essere uguale a quello impostato in stackdriver.projectID e cloudAuditLogging.projectID. Se gli ID progetto non sono uguali, la creazione del cluster non va a buon fine. Questo requisito non si applica a per i cluster esistenti.

Esempio:

gkeConnect:
  projectID: "my-fleet-host-project"

`gkeConnect.location`

Facoltativo
Immutabile
Stringa
Valore predefinito: globale

L'appartenenza al parco risorse di ogni cluster è gestita dal servizio Fleet (gkehub.googleapis.com) e dal servizio Connect (gkeconnect.googleapis.com). La posizione dei servizi può essere globale o regionale. In 1.28 e versioni successive, puoi specificare facoltativamente la regione Google Cloud in cui vengono eseguiti i servizi Fleet e Connect. Se non specificato, vengono utilizzate le istanze globali dei servizi. Tieni presente quanto segue:

I cluster di amministrazione creati prima della versione 1.28 sono gestiti dai servizi globali Fleet e Connect.
Per i nuovi cluster, se includi questo campo, la regione specificata deve essere uguale a quella configurata in cloudAuditLogging.clusterLocation, stackdriver.clusterLocation e gkeOnPremAPI.location. Se le regioni non corrispondono, la creazione del cluster ha esito negativo.

Esempio:

gkeConnect:
  location: "us-central1"

`gkeConnect.registerServiceAccountKeyPath`

Stringa

mutabile obbligatoria

Il percorso del file chiave JSON per il tuo connect-register service account.

Esempio:

gkeConnect:
  registerServiceAccountKeyPath: "my-key-folder/connect-register-key.json"

`gkeOnPremAPI`

In 1.16 e versioni successive, se l'API GKE On-Prem è abilitata nel progetto Google Cloud, tutti i cluster del progetto vengono registrati nell'API GKE On-Prem automaticamente nella regione configurata in stackdriver.clusterLocation.

Se vuoi registrare tutti i cluster del progetto nell'API GKE On-Prem, assicurati di svolgere i passaggi descritti in Prima di iniziare per attivare e utilizzare l'API GKE On-Prem nel progetto.
Se non vuoi registrare il cluster nell'API GKE On-Prem, includi questa sezione e imposta gkeOnPremAPI.enabled su false. In caso contrario registrare eventuali cluster nel progetto, disabilita gkeonprem.googleapis.com (il nome del servizio per l'API GKE On-Prem) nel progetto. Per le istruzioni, vedi Disattivare i servizi.

La registrazione del cluster di amministrazione all'API GKE On-Prem ti consente di utilizzare strumenti standard, come la console Google Cloud, Google Cloud CLI o Terraform, per eseguire l'upgrade dei cluster utente gestiti dal cluster di amministrazione. La registrazione del cluster consente anche esegui i comandi gcloud per ottenere informazioni sui cluster.

Dopo aver aggiunto questa sezione e creato o aggiornato il cluster di amministrazione, se in seguito rimuovi la sezione e aggiorni il cluster, l'aggiornamento non riuscito.

`gkeOnPremAPI.enabled`

Obbligatorio se è inclusa la sezione gkeOnPremAPI.
Modificabile
Valore booleano
Predefinita: true

Per impostazione predefinita, il cluster è registrato nell'API GKE On-Prem se l'API GKE On-Prem è abilitata nel progetto. Imposta su false se non vuoi registrare il cluster.

Dopo che il cluster è stato registrato nell'API GKE On-Prem, se devi annulla la registrazione del cluster, apporta la modifica seguente e aggiorna il cluster:

gkeOnPremAPI:
  enabled: false

`gkeOnPremAPI.location`

Immutabile
Stringa
Predefinito:stackdriver.clusterLocation

La regione Google Cloud in cui viene eseguita e archivia l'API GKE On-Prem nei metadati del cluster. Scegli una delle regioni supportate. Devi utilizzare la stessa regione configurata in cloudAuditLogging.clusterLocation, gkeConnect.location, e stackdriver.clusterLocation. Se gkeOnPremAPI.enabled è false, non includere questo campo.

`stackdriver`

Obbligatorio per impostazione predefinita
Modificabile

Se vuoi abilitare Cloud Logging e Cloud Monitoring per il cluster, compila questa sezione. In caso contrario, rimuovi questa sezione.

Questa sezione è obbligatoria per impostazione predefinita. In altre parole, se non includi questa sezione, devi includere il flag --skip-validation-stackdriver quando esegui gkectl create admin.

Questa sezione è obbligatoria nel cluster di amministrazione se vuoi gestire del ciclo di vita cluster utente con i client dell'API GKE On-Prem.

`stackdriver.projectID`

Obbligatorio per Logging e Monitoring
Stringa
non modificabile

L'ID del tuo progetto host del parco risorse. Per i nuovi cluster, questo ID progetto deve essere uguale all'ID impostato in gkeConnect.projectID e cloudAuditLogging.projectID. Se gli ID progetto non corrispondono, la creazione del cluster ha esito negativo. Questo requisito non si applica a per i cluster esistenti.

Se necessario, puoi configurare un router dei log in questo progetto per instradare i log a in un altro progetto. Per informazioni su come configurare il log router, vedi Destinazioni supportate.

Esempio:

stackdriver:
  projectID: "my-fleet-host-project"

`stackdriver.clusterLocation`

Obbligatorio per il logging e il monitoraggio
Stringa
non modificabile
Precompilato: "us-central1"

La regione Google Cloud in cui vuoi archiviare i log. È buona idea scegliere una regione vicina al tuo data center on-premise.

Per i nuovi cluster, se includi gkeOnPremAPI e cloudAuditLogging sezioni del file di configurazione, la regione impostata qui deve essere la stessa regione impostata in cloudAuditLogging.clusterLocation, gkeConnect.location e gkeOnPremAPI.location. Se le regioni non sono la creazione del cluster ha esito negativo.

Esempio:

stackdriver:
  clusterLocation: "us-central1"

`stackdriver.enableVPC`

Facoltativo
Immutabile
Valore booleano
Precompilato: false

Se la rete del cluster è controllata da un VPC, imposta questo valore su true. Ciò garantisce che tutta la telemetria passi attraverso gli indirizzi IP limitati di Google. In caso contrario, imposta questo valore su false.

Esempio:

stackdriver:
  enableVPC: false

`stackdriver.serviceAccountKeyPath`

Obbligatorio per il logging e il monitoraggio
Modificabile
Stringa

Il percorso del file della chiave JSON per l'account di servizio di monitoraggio e generazione di log.

Per informazioni su come aggiornare questo campo in un cluster esistente, consulta la sezione Gestire la rotazione delle chiavi degli account di servizio.

Esempio:

stackdriver:
  serviceAccountKeyPath: "my-key-folder/log-mon-key.json"

`stackdriver.disableVsphereResourceMetrics`

Facoltativo
Modificabile
Pertinente per il logging e il monitoraggio
Valore booleano
Precompilato: false
Valore predefinito: false

Impostalo su true per disattivare la raccolta di metriche da vSphere. In caso contrario, impostalo su false.

Questa sezione è obbligatoria nel cluster di amministrazione se vuoi gestire il ciclo di vita dei cluster utente nella console Google Cloud.

Esempio:

stackdriver:
  disableVsphereResourceMetrics: true

`cloudAuditLogging`

Se vuoi integrare gli audit log del server API Kubernetes del tuo cluster con gli audit log di Cloud, compila questa sezione. In caso contrario, rimuovi questo o lasciarla senza commenti.
Mutabile

Questa sezione è obbligatoria nel cluster di amministrazione se vuoi gestire il ciclo di vita dei cluster utente nell'utilizzo dei client dell'API GKE On-Prem.

`cloudAuditLogging.projectID`

Obbligatorio per Cloud Audit Logs
Immutabile
Stringa

L'ID del progetto host del parco risorse. Per i nuovi cluster, questo ID progetto deve essere uguale all'ID impostato in gkeConnect.projecID e stackdriver.projectID. Se gli ID progetto non corrispondono, la creazione del cluster ha esito negativo. Questo requisito non si applica ai cluster esistenti.

Se necessario, puoi configurare un router dei log in questo progetto per instradare i log a in un altro progetto. Per informazioni su come configurare il log router, vedi Destinazioni supportate.

Esempio:

cloudAuditLogging:
  projectID: "my-fleet-host-project"

`cloudAuditLogging.clusterLocation`

Obbligatorio per Cloud Audit Logs
Immutabile
Stringa

La regione Google Cloud in cui vuoi archiviare gli audit log. È una buona idea scegliere una regione vicina al tuo data center on-premise

Per i nuovi cluster, se includi gkeOnPremAPI e stackdriver sezioni del file di configurazione, la regione impostata qui deve essere la stessa regione impostata in gkeConnect.location, gkeOnPremAPI.location, e stackdriver.clusterLocation. Se le regioni non sono le stesse, la creazione non riesce.

Esempio:

cloudAuditLogging:
  clusterLocation: "us-central1"

`cloudAuditLogging.serviceAccountKeyPath`

Obbligatorio per Cloud Audit Logs
Modificabile
Stringa

Il percorso del file della chiave JSON per l'account di servizio di registrazione degli audit.

Per informazioni su come aggiornare questo campo in un cluster esistente, consulta la sezione Gestire la rotazione delle chiavi degli account di servizio.

Esempio:

cloudAuditLogging:
  serviceAccountKeyPath: "my-key-folder/audit-log-key.json"

`clusterBackup.datastore`

Anteprima
Facoltativo
Stringa
mutabile

Se vuoi attivare il backup del cluster di amministrazione, impostalo sul datastore vSphere in cui vuoi salvare i backup del cluster.

Esempio:

clusterBackup:
  datastore: "my-datastore"

`autoRepair.enabled`

Facoltativo
Mutabile
Booleano
Precompilato: true

Imposta questo elemento su true per attivare riparazione automatica dei nodi. In caso contrario, imposta questo valore su false.

Per aggiornare il valore di questo campo, utilizza gkectl update admin.

Esempio:

autoRepair:
  enabled: true

`secretsEncryption`

Se vuoi criptare i secret senza la necessità di un KMS esterno (Key Management Service) o qualsiasi altra dipendenza, compila questa sezione. In caso contrario, rimuovi questa sezione o lasciala commentata.
Immutabile

`secretsEncryption.mode`

Obbligatorio per la crittografia dei secret
Stringa
non modificabile
Valore possibile: "GeneratedKey"
Precompilato: "GeneratedKey"

La modalità di crittografia dei secret.

secretsEncryption:
  mode: "GeneratedKey"

`secretsEncryption.generatedKey.keyVersion`

Obbligatorio per la crittografia dei secret
Mutabile
Intero
Precompilato: 1

Un numero intero di tua scelta da utilizzare per il numero di versione della chiave. Ti consigliamo di iniziare con 1.

Esempio:

secretsEncryption:
  generatedKey:
    keyVersion: 1

`secretsEncryption.generatedKey.disabled`

Facoltativo per la crittografia dei secret
Modificabile
Valore booleano
Precompilato: false

Imposta questo valore su true per disattivare la crittografia dei secret. In caso contrario, impostala su false.

Esempio:

secretsEncryption:
  generatedKey:
    disabled: false

`osImageType`

Facoltativo
Modificabile
Stringa
Valori possibili: "ubuntu_containerd", "cos", "ubuntu_cgv2", "cos_cgv2"
Precompilato: "ubuntu_cgv2"
Valore predefinito: "ubuntu_containerd"

Il tipo di immagine del sistema operativo da eseguire sui nodi del cluster amministrativo.

Esempio:

osImageType: "cos"