Cette page décrit les champs du fichier de configuration de cluster d'utilisateur Google Distributed Cloud.
Générer un modèle pour votre fichier de configuration
Si vous avez utilisé gkeadm
pour créer le poste de travail administrateur, gkeadm
a généré un modèle pour le fichier de configuration de votre cluster d'utilisateur, et gkeadm
a rempli certains champs automatiquement.
Si vous n'avez pas utilisé gkeadm
pour créer le poste de travail administrateur, vous pouvez utiliser gkectl
pour générer un modèle pour le fichier de configuration de votre cluster d'utilisateur.
Pour générer un modèle pour le fichier de configuration de votre cluster d'utilisateur, exécutez la commande suivante :
gkectl create-config cluster --config=OUTPUT_FILENAME --gke-on-prem-version=VERSION
Remplacez les éléments suivants :
OUTPUT_FILENAME
: chemin d'accès de votre choix pour le modèle généré. Si vous omettez cette option, gkectl
nomme le fichier user-cluster.yaml
et le place dans le répertoire actuel.
VERSION
: numéro de version souhaité. Exemple : gkectl create-config cluster --gke-on-prem-version=1.10.0-gke.8
.
Modèle
Champs obligatoires et valeurs par défaut
Si un champ est marqué comme obligatoire, le fichier de configuration doit contenir une valeur pour ce champ.
Certains champs sont obligatoires de manière conditionnelle. Par exemple, loadBalancer.metalLB.addressPools
est obligatoire si loadBalancer.kind
est égal à MetalLB
.
Si une valeur par défaut est indiquée pour un champ, le cluster l'utilisera si vous ne saisissez rien pour le champ. Vous pouvez remplacer une valeur par défaut en saisissant une valeur.
Si un champ n'est pas marqué comme obligatoire et qu'aucune valeur par défaut n'est indiquée, il est facultatif. Vous pouvez le remplir si cela vous semble pertinent, mais vous n'êtes pas obligé de le faire.
Remplir votre fichier de configuration
Dans votre fichier de configuration, saisissez les valeurs des champs comme décrit dans les sections suivantes.
name
Obligatoire
Chaîne
Nom de votre choix pour le cluster d'utilisateur. Ce nom doit :
- contenir au maximum 40 caractères ;
- ne contenir que des caractères alphanumériques minuscules ou un trait d'union
-
; - commencer par un caractère alphabétique ;
- se terminer par un caractère alphanumérique.
Exemple :
name: "my-user-cluster"
gkeOnPremVersion
Obligatoire
Modifiable
Chaîne
Version de Google Distributed Cloud pour votre cluster d'utilisateur.
Exemple :
gkeOnPremVersion: "1.14.0-gke.1"
preparedSecrets.namespace
Si vous souhaitez utiliser des identifiants préparés, renseignez ce champ. Sinon, supprimez cette section ou laissez-la en commentaire.
Facultatif
Immuable
Chaîne
Valeurs possibles : chaîne commençant par "gke-onprem-secrets-"
Nom d'un espace de noms Kubernetes dans le cluster d'administrateur où les secrets préparés sont conservés pour ce cluster d'utilisateur.
Exemple :
preparedSecrets: namespace: "gke-onprem-secrets-alice"
enableControlplaneV2
Immuable
Booléen
Prérempli : vrai
Par défaut : vrai
Pour activer Controlplane V2, définissez enableControlplaneV2
sur true
ou supprimez le paramètre de votre fichier de configuration de cluster d'utilisateur. Sinon, définissez cette valeur sur false
.
Avec Controlplane V2, le plan de contrôle d'un cluster d'utilisateur s'exécute sur un ou plusieurs nœuds du cluster d'utilisateur lui-même. Lorsque Controlplane V2 n'est pas activé, le plan de contrôle du cluster d'utilisateur s'exécute dans le cluster d'administrateur.
Nous vous recommandons d'activer Controlplane V2.
Exemple :
enableControlplaneV2: true
vCenter
Cette section contient des informations sur votre environnement vSphere et sur votre connexion au serveur vCenter.
Si vous souhaitez qu'un champ de cette section soit identique à celui que vous avez spécifié pour votre cluster d'administrateur, supprimez le champ ou laissez-le en commentaire.
Si vous souhaitez qu'un champ soit différent de celui que vous avez spécifié pour votre cluster d'administrateur, renseignez-le ici. Tous les champs que vous remplissez ici dans la section vCenter
remplacent les champs correspondants dans le fichier de configuration de votre cluster d'administrateur.
vCenter.address
Facultatif
Immuable
Chaîne
Par défaut : hériter du cluster d'administrateur
Adresse IP ou nom d'hôte de l'instance vCenter Server que vous souhaitez utiliser pour ce cluster d'utilisateur.
Pour en savoir plus, consultez la section Rechercher l'adresse de votre serveur vCenter.
Si vous spécifiez une valeur différente de celle de l'instance vCenter Server utilisée par le cluster d'administrateur, Controlplane V2
doit être activé et vous devez fournir des valeurs pour network.vCenter.networkName
et tous les champs obligatoires de la section vCenter
.
Exemples :
vCenter: address: "203.0.113.101"
vCenter: address: "my-vcenter-server-2.my-domain.example"
vCenter.datacenter
Facultatif
Immuable
Chaîne
Par défaut : hériter du cluster d'administrateur
Chemin relatif d'un centre de données vSphere.
Si vous spécifiez une valeur pour ce champ, vous devez également spécifier :
vCenter.networkName
vCenter.datastore
ouvCenter.storagePolicyName
vCenter.cluster
ouvCenter.resourcePool
La valeur que vous spécifiez est relative au dossier racine nommé /
.
Si votre centre de données se trouve dans le dossier racine, la valeur correspond au nom du centre de données.
Exemple :
vCenter: datacenter: "my-uc-data-center"
Sinon, la valeur est un chemin d'accès relatif incluant un ou plusieurs dossiers ainsi que le nom du centre de données.
Exemple :
vCenter: datacenter: "data-centers/data-center-2"
vCenter.cluster
Facultatif
Immuable
Chaîne
Par défaut : hériter du cluster d'administrateur
Chemin relatif d'un cluster vSphere qui représente les hôtes ESXi sur lesquels vos VM de cluster d'utilisateur seront exécutées. Ce cluster vSphere représente un sous-ensemble des hôtes ESXi physiques de votre centre de données vCenter.
Si vous spécifiez une valeur pour ce champ, vous devez également spécifier :
vCenter.networkName
vCenter.datacenter
vCenter.datastore
ouvCenter.storagePolicyName
La valeur que vous spécifiez est associée à /.../DATA_CENTER/vm/
.
Si votre cluster vSphere se trouve dans le dossier /.../DATA_CENTER/vm/
, la valeur correspond au nom du cluster vSphere.
Exemple :
vCenter: cluster: "my-uc-vsphere-cluster"
Sinon, la valeur est un chemin d'accès relatif incluant un ou plusieurs dossiers ainsi que le nom du cluster vSphere.
Exemple :
vCenter: cluster: "clusters/vsphere-cluster-2"
vCenter.resourcePool
Facultatif
Immuable
Chaîne
Par défaut : hériter du cluster d'administrateur
Un pool de ressources vCenter pour les VM de votre cluster d'utilisateur.
Si vous souhaitez utiliser le pool de ressources par défaut, définissez cette valeur sur VSPHERE_CLUSTER/Resources
.
Exemple :
vCenter: resourcePool: "my-uc-vsphere-cluster/Resources"
La valeur que vous spécifiez est associée à /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/
.
Si votre pool de ressources est un enfant direct de /.../DATA_CENTER/host/.../VSPHERE_CLUSTER/Resources/
, la valeur est le nom du pool de ressources.
Exemple :
vCenter: resourcePool: "my-uc-resource-pool"
Sinon, la valeur est un chemin relatif comportant au moins deux pools de ressources.
Exemple :
vCenter: resourcePool: "uc-resource-pool-1/uc-resource-pool-2"
vCenter.datastore
Facultatif
Immuable
Chaîne
Par défaut : hériter du cluster d'administrateur
Nom d'un datastore vSphere pour votre cluster d'utilisateur.
La valeur que vous spécifiez doit être un nom, et non un chemin d'accès. N'incluez aucun dossier dans la valeur.
Exemple :
vCenter: datastore: "my-datastore"
Si vous spécifiez une valeur pour ce champ, ne spécifiez pas de valeur pour vCenter.storagePolicyName
. Le champ vCenter.datastore
est immuable, sauf lorsque vous définissez le champ sur une chaîne vide lorsque vous migrez un datastore vers Storage Policy Based Management (SPBM).
vCenter.storagePolicyName
Facultatif
Immuable
Chaîne
Nom d'une règle de stockage de VM pour les nœuds du cluster.
Vous pouvez également spécifier une règle de stockage de VM pour les nœuds d'un pool de nœuds particulier. Toutefois, la règle spécifiée ici s'applique à tout pool de nœuds qui ne dispose pas de sa propre règle.
Pour en savoir plus, consultez la page Configurer une règle de stockage.
Si vous spécifiez une valeur pour ce champ, ne spécifiez pas de valeur pour vCenter.datastore
.
vCenter.caCertPath
Facultatif
Modifiable
Chaîne
Par défaut : hériter du cluster d'administrateur
Chemin d'accès du certificat CA de votre serveur vCenter. Pour en savoir plus, consultez la section Obtenir votre certificat CA vCenter.
Exemple :
vCenter: caCertPath: "/usr/local/google/home/me/certs/vcenter-ca-cert-2.pem"
Pour en savoir plus sur la mise à jour de ce champ, consultez la section Mettre à jour les références de certificats vCenter.
vCenter.credentials.fileRef.path
Facultatif
Modifiable
Chaîne
Par défaut : hériter du cluster d'administrateur
Si vous spécifiez une valeur pour preparedSecrets.namespace, ne spécifiez pas de valeur pour ce champ. Indiquez plutôt une valeur pour vCenter.credentials.secretRef.version.
Chemin d'accès d'un fichier de configuration des identifiants contenant le nom d'utilisateur et le mot de passe de votre compte utilisateur vCenter. Le compte utilisateur doit disposer du rôle d'administrateur ou de privilèges équivalents. Consultez les exigences concernant vSphere.
Vous pouvez utiliser gkectl update credentials
pour mettre à jour ce champ dans un cluster existant. Pour en savoir plus, consultez la page Effectuer une rotation des clés de compte de service.
Pour en savoir plus sur la mise à jour de vos identifiants vCenter, consultez la page Mettre à jour les identifiants du cluster.
Exemple :
vCenter: credentials: fileRef: path: "my-config-directory/my-credentials-2.yaml"
vCenter.credentials.fileRef.entry
Facultatif
Modifiable
Chaîne
Par défaut : hériter du cluster d'administrateur
Nom du bloc d'identifiants, dans votre fichier de configuration des identifiants, qui contient le nom d'utilisateur et le mot de passe de votre compte utilisateur vCenter.
Exemple :
vCenter: credentials: fileRef: entry: "vcenter-credentials-2"
vCenter.credentials.secretRef.version
Obligatoire si vous avez indiqué une valeur pour
preparedSecrets.namespace
Chaîne
Valeurs possibles : chaîne d'entiers ou "latest"
Valeur par défaut : "latest"
Si vous indiquez une valeur pour preparedSecrets.namespace, renseignez ce champ. Sinon, supprimez cette section ou laissez-la en commentaire.
Version d'un secret préparé dans le cluster d'administrateur qui contient le nom d'utilisateur et le mot de passe de l'instance de vCenter Server que vous souhaitez utiliser pour ce cluster d'utilisateur.
Exemple :
vCenter: credentials: secretRef: version: "1"
vCenter.folder
Facultatif
Immuable
Chaîne
Par défaut : hériter du cluster d'administrateur
Chemin relatif d'un dossier vSphere que vous avez déjà créé. Ce dossier contiendra les VM de votre cluster d'utilisateur.
Si vous ne spécifiez pas de valeur, les VM de votre cluster d'utilisateur seront placées dans /.../DATA_CENTER/vm/
.
Si vous spécifiez une valeur, elle est liée à /.../DATA_CENTER/vm/
.
La valeur peut correspondre au nom d'un dossier.
Exemple :
vCenter: folder: "my-uc-folder"
La valeur peut également être un chemin d'accès relatif incluant plusieurs dossiers.
Exemple :
vCenter: folder: "folders/folder-2"
componentAccessServiceAccountKeyPath
Facultatif
Modifiable
Chaîne
Par défaut : hériter du cluster d'administrateur
Chemin d'accès au fichier de clé JSON de votre compte de service d'accès au composant.
Exemple :
componentAccessServiceAccountKeyPath: "my-key-folder/uc-access-key.json"
componentAccessServiceAccountKey.secretRef.version
Facultatif
Modifiable
Chaîne
Valeurs possibles : une chaîne d'entiers ou "latest"
Valeur par défaut : "latest"
Version d'un secret préparé dans le cluster d'administrateur qui contient une clé JSON pour votre compte de service d'accès au composant.
Exemple :
componentAccessServiceAccountKey: secretRef: version: "1"
privateRegistry
Ne remplissez cette section que si votre cluster d'administrateur utilise un registre privé et que vous souhaitez que votre cluster d'utilisateur utilise un autre registre privé. Sinon, supprimez cette section ou laissez-la en commentaire.
Si vous souhaitez disposer de paramètres différents de ceux du cluster d'administrateur:
Nom d'utilisateur, mot de passe et certificat différents
(Disponible uniquement pour le plan de contrôle V2) Adresse de registre privée différente
Renseignez les champs privateRegistry
ici. Les nouveaux paramètres sont récupérés lors de la création et de la mise à jour du cluster.
privateRegistry.address
Obligatoire pour le registre privé
Immuable
Chaîne
Par défaut : hériter du cluster d'administrateur
Adresse IP ou nom de domaine complet de la machine qui exécute votre registre Docker privé.
Exemples :
privateRegistry: address: "203.0.113.10"
privateRegistry: address: "fqdn.example.com"
privateRegistry.credentials.fileRef.path
Obligatoire pour le registre privé
Modifiable
Chaîne
Par défaut : hériter du cluster d'administrateur
Si vous prévoyez d'utiliser un secret préparé pour le registre privé, ne renseignez pas ce champ. Fournissez plutôt une valeur pour privateRegistry.credentials.secretRef.version.
Chemin d'accès d'un fichier de configuration des identifiants contenant le nom d'utilisateur et le mot de passe d'un compte que Google Distributed Cloud peut utiliser pour accéder à votre registre Docker privé.
Exemple :
privateRegistry: credentials: fileRef: path: "my-config-folder/admin-creds.yaml"
privateRegistry.credentials.fileRef.entry
Obligatoire pour le registre privé
Modifiable
Chaîne
Par défaut : hériter du cluster d'administrateur
Nom du bloc d'identifiants, dans votre fichier de configuration des identifiants, qui contient le nom d'utilisateur et le mot de passe de votre compte de registre Docker privé.
privateRegistry: credentials: fileRef: entry: "private-registry-creds"
privateRegistry.credentials.secretRef.version
Obligatoire si vous souhaitez utiliser le secret préparé pour le registre privé
Chaîne
Valeurs possibles : chaîne d'entiers ou "latest"
Valeur par défaut : "latest"
Si vous fournissez une valeur pour preparedSecrets.namespace et que vous souhaitez utiliser le secret préparé pour le registre privé, renseignez ce champ. Sinon, supprimez cette section ou laissez-la en commentaire.
Version d'un secret préparé dans le cluster d'administrateur qui contient le nom d'utilisateur et le mot de passe de l'instance de vCenter Server que vous souhaitez utiliser pour ce cluster d'utilisateur.
Exemple :
privateRegistry: credentials: secretRef: version: "1"
privateRegistry.caCertPath
Obligatoire pour le registre privé
Modifiable
Chaîne
Par défaut : hériter du cluster d'administrateur
Lorsque Docker extrait une image de votre registre privé, le registre doit prouver son identité en présentant un certificat. Le certificat du registre est signé par une autorité de certification (CA). Docker utilise le certificat de l'autorité de certification pour valider le certificat du registre.
Définissez ce champ sur le chemin d'accès au certificat de l'autorité de certification.
Exemple :
privateRegistry: caCertPath: "my-cert-folder/registry-ca.crt"
network
Cette section contient des informations sur le réseau de votre cluster d'utilisateur.
network.hostConfig
Cette section contient des informations sur les serveurs NTP, les serveurs DNS et les domaines de recherche DNS utilisés par les VM qui sont vos nœuds de cluster. Si vous utilisez l'équilibreur de charge Seesaw, ces informations s'appliquent également à vos VM Seesaw.
Cette section est obligatoire si une ou plusieurs des conditions suivantes sont remplies :
network.ipMode.type
est définie surstatic
.enableControlplaneV2
est définie surtrue
ou autorisé à adopter par défauttrue
.loadBalancer.kind
est définie sur"Seesaw"
.
network.hostConfig.dnsServers
Obligatoire
Immuable
Tableau de chaînes.
Le nombre maximal d'éléments dans le tableau est de trois.
Adresses des serveurs DNS pour les VM.
Exemple :
network: hostConfig: dnsServers: - "172.16.255.1" - "172.16.255.2"
network.hostConfig.ntpServers
Obligatoire
Immuable
Tableau de chaînes
Adresses des serveurs de temps que les VM utilisent.
Exemple :
network: hostConfig: ntpServers: - "216.239.35.0"
network.hostConfig.searchDomainsForDNS
Facultatif
Immuable
Tableau de chaînes
Domaines de recherche DNS que les hôtes utilisent. Ces domaines sont utilisés dans le cadre d'une liste de recherche de domaines.
Exemple :
network: hostConfig: searchDomainsForDNS: - "my.local.com"
network.ipMode.type
Obligatoire
Immuable
Chaîne
Prérempli : "dhcp"
Par défaut : "dhcp"
Si vous souhaitez que les nœuds de votre cluster obtiennent leur adresse IP à partir d'un serveur DHCP, définissez la valeur sur "dhcp"
. Si vous souhaitez que les nœuds de votre cluster aient des adresses IP statiques venant d'une liste que vous fournissez, définissez ce paramètre sur "static"
.
Exemple :
network: ipMode: type: "static"
network.ipMode.ipBlockFilePath
Obligatoire si network.ipMode.type
= static
Immuable
Chaîne
Chemin d'accès au fichier de blocs d'adresses IP de votre cluster.
Exemple :
network: ipMode: ipBlockFilePath: "/my-config-folder/user-cluster-ipblock.yaml"
network.serviceCIDR
Obligatoire
Immuable
Chaîne
Prérempli : "10.96.0.0/20"
Une plage d'adresses IP au format CIDR à utiliser pour les services de votre cluster. Elle doit être au moins égale à /24.
Exemple :
network: serviceCIDR: "10.96.0.0/20"
network.podCIDR
Obligatoire
Immuable
Chaîne
Prérempli : "192.168.0.0/16"
Par défaut : "192.168.0.0/16"
Une plage d'adresses IP au format CIDR à utiliser pour les pods de votre cluster Elle doit être au moins égale à /18.
Exemple :
network: podCIDR: "192.168.0.0/16"
La plage de services ne doit pas chevaucher la plage de pods.
Les plages de services et de pods ne doivent chevaucher aucune adresse en dehors du cluster que vous souhaitez atteindre depuis l'intérieur du cluster.
Par exemple, supposons que votre plage de services soit 10.96.232.0/24 et que votre plage de pods soit 192.168.0.0/16. Tout trafic envoyé depuis un pod vers une adresse dans l'une de ces plages est traité comme étant dans un cluster et n'atteint aucune destination en dehors du cluster.
En particulier, les plages de services et de pods ne doivent pas chevaucher les éléments suivants :
Adresses IP des nœuds d'un cluster
Adresses IP utilisées par les machines des équilibreurs de charge
Adresses IP virtuelles utilisées par les nœuds de plan de contrôle et les équilibreurs de charge
Adresse IP des serveurs vCenter, DNS et NTP
Nous vous recommandons de placer vos plages de services et de pods dans l'espace d'adressage RFC 1918.
Voici l'une des raisons pour lesquelles il est recommandé d'utiliser les adresses RFC 1918 Supposons que votre plage de services et de pods contienne des adresses IP externes. Tout trafic envoyé depuis un pod vers l'une de ces adresses externes sera traité comme du trafic interne au cluster et n'atteindra pas la destination externe.
network.vCenter.networkName
Obligatoire si vCenter.address
est différent de l'adresse vCenter que vous utilisez pour le cluster d'administrateur.
Immuable
Chaîne
Nom du réseau vSphere pour les nœuds de votre cluster d'utilisateur.
Exemple :
network: vCenter: networkName: "my-network"
Si le nom contient un caractère spécial, vous devez utiliser une séquence d'échappement pour celui-ci.
Caractères spéciaux | Séquence d'échappement |
---|---|
Barre oblique (/ ) |
%2f |
Barre oblique inverse (\ ) |
%5c |
Signe de pourcentage (% ) |
%25 |
Si le nom de réseau n'est pas unique dans votre centre de données, vous pouvez spécifier un chemin d'accès complet.
Exemple :
network: vCenter: networkName: "/my-uc-datacenter/network/my-network"
network.additionalNodeInterfaces
Si vous définissez multipleNetworkInterfaces
sur true
, remplissez cette section.
Sinon, supprimez cette section ou laissez-la en commentaire.
Immuable
Tableau d'objets, chacun décrivant une interface réseau pouvant être utilisée sur tout ou partie des nœuds de votre cluster.
network.additionalNodeInterfaces[i].networkName
Obligatoire si multipleNetworkInterfaces
= true
Immuable
Chaîne
Nom du réseau vSphere auquel cette interface de nœud supplémentaire se connectera.
Exemple :
network: additionalNodeInterfaces: - networkName: "my-node-interface-1"
network.additionalNodeInterfaces[i].type
Obligatoire si multipleNetworkInterfaces
= true
Immuable
Chaîne
Exemple :
network: additionalNodeInterfaces: - name: "my-node-interface-1" type: "static"
network.additionalNodeInterfaces[i].ipBlockFilePath
Obligatoire si network.additionalNodeInterfaces[i].type
= static
Immuable
Chaîne
Chemin d'accès d'un fichier de bloc d'adresses IP contenant les adresses IP à utiliser pour cette interface réseau sur les nœuds possédant cette interface réseau.
Exemple :
network: additionalNodeInterfaces: - name: "my-node-interface-1" type: "static" ipBlockFilePath: "my-ipblock-file-1"
network.controlPlaneIPBlock
Si vous définissez enableControlplaneV2
sur true
, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
network.controlPlaneIPBlock.netmask
Obligatoire si enableControlplaneV2
= true
Immuable
Chaîne
Exemple :
network: controlPlaneIPBlock: netmask: "255.255.255.0"
network.controlPlaneIPBlock.gateway
Obligatoire si enableControlplaneV2
= true
Immuable
Chaîne
Exemple :
network: controlPlaneIPBlock: gateway: "172.16.21.1"
network.controlPlaneIPBlock.ips
Obligatoire si enableControlplaneV2
= true
Immuable
Tableau d'objets ayant chacun une adresse IP et un nom d'hôte facultatif.
Pour un cluster d'utilisateur à haute disponibilité, le tableau comporte trois éléments. Pour un cluster d'utilisateur standard, le tableau contient un élément.
Exemple :
network: controlPlaneIPBlock: ips: - ip: "172.16.21.6" hostname: "cp-vm-1" - ip: "172.16.21.7" hostname: "cp-vm-2" - ip: "172.16.21.8" hostname: "cp-vm-3"
loadBalancer
Cette section contient des informations sur l'équilibreur de charge de votre cluster d'utilisateur.
loadBalancer.vips.controlPlaneVIP
Obligatoire
Immuable
Chaîne
Adresse IP que vous avez choisi de configurer sur l'équilibreur de charge pour le serveur d'API Kubernetes du cluster d'utilisateur.
Exemple :
loadBalancer: vips: controlplaneVIP: "203.0.113.3"
loadBalancer.vips.ingressVIP
Obligatoire
Immuable
Chaîne
Adresse IP que vous avez choisie de configurer sur l'équilibreur de charge pour le proxy d'entrée.
Exemple :
loadBalancer: vips: ingressVIP: "203.0.113.4"
loadBalancer.kind
Obligatoire
Immuable
Chaîne
Prérempli : "MetalLB"
Définissez ce paramètre sur "ManualLB"
, "F5BigIP"
, "Seesaw"
ou "MetalLB"
.
Exemple :
loadBalancer: kind: "MetalLB"
loadBalancer.manualLB
Si vous définissez loadbalancer.kind
sur "manualLB"
, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
loadBalancer.manualLB.ingressHTTPNodePort
Obligatoire si loadBalancer.kind
= ManualLB
Immuable
Entier
Prérempli : 30243
Le proxy d'entrée d'un cluster d'utilisateur est exposé par un service Kubernetes de type LoadBalancer
.
Le service dispose d'un ServicePort pour HTTP. Vous devez choisir une valeur nodePort
pour le ServicePort HTTP.
Définissez ce champ sur la valeur nodePort
.
Exemple :
loadBalancer: manualLB: ingressHTTPNodePort: 32527
loadBalancer.manualLB.ingressHTTPSNodePort
Obligatoire si loadBalancer.kind
= ManualLB
Immuable
Entier
Prérempli : 30879
Le proxy d'entrée d'un cluster d'utilisateur est exposé par un service de type LoadBalancer. Le service dispose d'un ServicePort pour HTTPS. Vous devez choisir une valeur nodePort
pour le ServicePort HTTPS.
Définissez ce champ sur la valeur nodePort
.
Exemple :
loadBalancer: manualLB: ingressHTTPSNodePort: 30139
loadBalancer.manualLB.controlPlaneNodePort
Obligatoire si loadBalancer.kind
= ManualLB
et
enableControlplaneV2
= false
Immuable
Entier
Prérempli : 30562
Le serveur d'API Kubernetes d'un cluster d'utilisateur s'exécute dans le cluster d'administrateur et est exposé par un service de type LoadBalancer
. Vous devez choisir une valeur nodePort
pour le service.
Définissez ce champ sur la valeur nodePort
.
Exemple :
loadBalancer: manualLB: controlPlaneNodePort: 30968
loadBalancer.manualLB.konnectivityServerNodePort
Obligatoire si loadBalancer.kind
= ManualLB
et
enableControlplaneV2
= false
Immuable
Entier
Prérempli : 30563
Le serveur d'API Kubernetes d'un cluster d'utilisateur utilisant kubeception s'exécute dans le cluster d'administrateur et est exposé par un service de type LoadBalancer
. Le serveur konnectivity réutilise ce service avec une autre valeur nodePort
. Vous devez choisir une valeur nodePort
pour le serveur Konnectivity.
Définissez ce champ sur la valeur nodePort
pour le serveur Ktonctivity.
Exemple :
loadBalancer: manualLB: konnectivityServerNodePort: 30969
loadBalancer.f5BigIP
Si vous définissez loadbalancer.kind
sur "f5BigIP"
, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
loadBalancer.f5BigIP.address
Obligatoire si loadBalancer.kind
= "f5BigIP"
Chaîne
Adresse de votre équilibreur de charge F5 BIG-IP.
Exemple :
loadBalancer: f5BigIP: address: "203.0.113.2"
loadBalancer.f5BigIP.credentials.fileRef.path
Obligatoire si loadBalancer.kind
= "f5BigIP"
Chaîne
Chemin d'accès d'un fichier d'identifiants contenant le nom d'utilisateur et le mot de passe d'un compte que Google Distributed Cloud peut utiliser pour se connecter à votre équilibreur de charge F5 BIG-IP.
Le compte utilisateur doit disposer d'un rôle utilisateur possédant des autorisations suffisantes pour configurer et gérer l'équilibreur de charge. Le rôle Administrateur ou Administrateur de ressources est suffisant.
Pour en savoir plus sur la mise à jour de vos identifiants F5 BIG-IP, consultez la page Mettre à jour les identifiants du cluster.
Exemple :
loadBalancer: f5BigIP: credentials: fileRef: path: ""my-config-folder/user-creds.yaml"
loadBalancer.f5BigIP.credentials.fileRef.entry
Obligatoire si loadBalancer.kind
= "f5BigIP"
Chaîne
Nom du bloc d'identifiants, dans votre fichier de configuration des identifiants, qui contient le nom d'utilisateur et le mot de passe de votre compte F5 BIG-IP.
Exemple :
loadBalancer: f5BigIP: credentials: fileRef: entry: "f5-creds"
loadBalancer.f5BigIP.partition
Obligatoire si loadBalancer.kind
= "f5BigIP"
Chaîne
Nom d'une partition BIG-IP que vous avez créée pour votre cluster d'administrateur.
Exemple :
loadBalancer: f5BigIP: partition: "my-f5-user-partition"
loadBalancer.f5BigIP.snatPoolName
Obligatoire si loadBalancer.kind
= "f5BigIP"
et que vous utilisez SNAT
Chaîne
Nom de votre pool SNAT.
Exemple :
loadBalancer: f5BigIP: snatPoolName: "my-snat-pool"
loadBalancer.seesaw
Si vous définissez loadbalancer.kind
sur "Seesaw"
, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
Prenez note des restrictions suivantes :
- Si un cluster d'administrateur haute disponibilité gère ce cluster d'utilisateur, ce cluster ne peut pas utiliser l'équilibreur de charge Seesaw.
- Les clusters d'utilisateur sur lesquels Controlplane V2 est activé ne peuvent pas utiliser l'équilibreur de charge Seesaw.
Pour en savoir plus sur la configuration de l'équilibreur de charge Seesaw, consultez le guide de démarrage rapide de l'équilibreur de charge Seesaw et la section Équilibrage de charge groupé avec Seesaw.
loadBalancer.seesaw.ipBlockFilePath
Obligatoire si loadBalancer.kind
= Seesaw
Immuable
Chaîne
Chemin du fichier de bloc d'adresses IP pour vos VM Seesaw.
Exemple :
loadBalancer: seesaw: ipBlockFilePath: "config-folder/user-seesaw-ipblock.yaml"
loadBalancer.seesaw.vrid
Obligatoire si loadBalancer.kind
= Seesaw
Immuable
Entier
Valeurs possibles : 1 - 255
Prérempli : 0
Identifiant de routeur virtuel de votre VM Seesaw. Cet identifiant, qui est un entier de votre choix, doit être unique dans un VLAN.
Exemple :
loadBalancer: seesaw: vrid: 125
loadBalancer.seesaw.masterIP
Obligatoire si loadBalancer.kind
= Seesaw
Immuable
Chaîne
Adresse IP virtuelle configurée sur votre VM Seesaw principale.
Exemple :
loadBalancer: seesaw: masterIP: 172.16.20.21
loadBalancer.seesaw.cpus
Obligatoire si loadBalancer.kind
= Seesaw
Modifiable
Entier
Prérempli : 4
Nombre de processeurs pour chacune de vos VM Seesaw.
Exemple :
loadBalancer: seesaw: cpus: 8
loadBalancer.seesaw.memoryMB
Obligatoire si loadBalancer.kind
= Seesaw
Modifiable
Entier
Prérempli : 3072
Nombre de mébioctets de mémoire pour chacune de vos VM Seesaw.
Exemple :
loadBalancer: seesaw: memoryMB: 8192
Remarque : Ce champ spécifie le nombre de mébioctets de mémoire, et non le nombre de mégaoctets. Un mébioctet est égal à 2^20, soit 1 048 576 octets. Un mégaoctet est égal à 10^6, soit 1 000 000 octets.
loadBalancer.seesaw.vCenter.networkName
Facultatif
Immuable
Chaîne
Par défaut : identique aux nœuds de cluster
Nom du réseau vCenter contenant vos VM Seesaw.
Exemple :
loadBalancer: seesaw: vCenter: networkName: "my-seesaw-network"
loadBalancer.seesaw.enableHA
Facultatif
Immuable
Applicable si loadBalancer.kind
= Seesaw
Booléen
Prérempli : faux
Par défaut : faux
Si vous souhaitez créer un équilibreur de charge Seesaw à haute disponibilité, définissez cette valeur sur true
. Sinon, définissez cette valeur sur false
. Un équilibreur de charge Seesaw à haute disponibilité utilise une paire (maître, sauvegarde) de VM.
Exemple :
loadBalancer: seesaw: enableHA: true
loadBalancer.seesaw.disableVRRPMAC
Facultatif
Immuable
Applicable si loadBalancer.kind
= Seesaw
Booléen
Prérempli : vrai
Par défaut : vrai
Si vous définissez cette valeur sur true
, l'équilibreur de charge Seesaw n'utilise pas l'apprentissage MAC pour le basculement. Il utilise le protocole ARP gratuit.
Si vous définissez cette valeur sur false
, l'équilibreur de charge Seesaw utilise l'apprentissage MAC. Nous vous recommandons de définir cette valeur sur true
. Si vous utilisez vSphere 7.0 ou une version ultérieure, et que vous disposez d'un équilibreur de charge Seesaw à haute disponibilité, vous devez définir cette valeur sur true
.
Exemple :
loadBalancer: seesaw: disableVRRPMAC: true
loadBalancer.metalLB
Si vous définissez loadbalancer.kind
sur "MetalLB"
, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
Pour en savoir plus, consultez la page Équilibrage de charge groupé avec MetalLB.
loadBalancer.metalLB.addressPools
Obligatoire si loadBalancer.kind
= "MetalLB"
Modifiable
Tableau d'objets, chacun contenant des informations sur un pool d'adresses qui sera utilisé par l'équilibreur de charge MetalLB.
loadBalancer.metalLB.addressPools[i].name
Obligatoire si loadBalancer.kind
= MetalLB
Modifiable
Chaîne
Nom de votre choix pour un pool d'adresses.
Exemple :
loadBalancer: metalLB: addressPools: - name: "my-address-pool-1"
loadBalancer.metalLB.addressPools[i].addresses
Obligatoire si loadBalancer.kind
= MetalLB
Modifiable
Tableau de chaînes, chacune correspondant à une plage d'adresses. Chaque plage doit être au format CIDR ou au format de trait d'union.
Exemple :
loadBalancer: metalLB: addressPools: - name: "my-address-pool-1" addresses: - "192.0.2.0/26" - "192.0.2.64-192.0.2.72"
loadBalancer.metalLB.addressPools[i].avoidBuggyIPs
Facultatif
Applicable si loadBalancer.kind
= MetalLB
Modifiable
Booléen
Prérempli : faux
Par défaut : faux
Si vous définissez cette valeur sur true
, le contrôleur MetalLB n'attribue pas les adresses IP se terminant par .0 ou .255 aux services. Cela évite le problème des bugs avec les appareils grand public qui suppriment par erreur le trafic envoyé à ces adresses IP spéciales.
Exemple :
loadBalancer: metalLB: addressPools: - name: "my-address-pool-1" - "192.0.2.0/26" - "192.0.2.64-192.0.2.72" avoidBuggyIPs: true
loadBalancer.metalLB.addressPools[i].manualAssign
Facultatif
Applicable si loadBalancer.kind
= MetalLB
Modifiable
Booléen
Prérempli : faux
Par défaut : faux
Si vous ne souhaitez pas que le contrôleur MetalLB attribue automatiquement les adresses IP de ce pool aux services, définissez ce paramètre sur true
. Un développeur peut ensuite créer un service de type LoadBalancer
et spécifier manuellement l'une des adresses du pool.
Sinon, définissez cette valeur sur false
.
Exemple :
loadBalancer: metalLB: addressPools: - name: "my-address-pool-1" manualAssign: true
enableDataplaneV2
Immuable
Booléen
Prérempli : vrai
Par défaut : faux
Si vous souhaitez activer Dataplane V2 ou utiliser Controlplane V2, définissez cette valeur sur true
. Sinon, définissez cette valeur sur false
.
Nous vous recommandons d'activer Dataplane V2.
Exemple :
enableDataplaneV2: true
Pour en savoir plus sur la procédure de dépannage, consultez la page Dépannage de Dataplane V2.
dataplaneV2.lbMode
Facultatif
Immuable
Chaîne
Valeurs possibles : "snat", "dsr"
Prérempli : "snat"
Par défaut : "snat"
Mode d'équilibrage de charge pour un cluster sur lequel Dataplane V2 est activé.
En mode SNAT (Network Address Translation), un paquet fait l'objet d'une traduction SNAT lorsqu'il est transféré d'un nœud d'équilibreur de charge vers un pod de backend. Le pod ne peut pas voir l'adresse IP source d'origine et le paquet de retour doit passer par le nœud de l'équilibreur de charge.
Avec le mode de retour serveur direct (DSR), un paquet conserve son adresse IP source d'origine lorsqu'il est transféré d'un nœud d'équilibreur de charge vers un pod de backend. Le pod peut voir l'adresse IP source d'origine, et le paquet de retour est directement transmis au client sans passer par le nœud de l'équilibreur de charge.
Exemple :
dataplaneV2: lbMode: "dsr"
Remarque : La mise à jour de ce champ peut entraîner un problème connu en fonction des versions du cluster. Veuillez appliquer la solution mentionnée si votre version de cluster est concernée.
multipleNetworkInterfaces
Facultatif
Immuable
Booléen
Prérempli : faux
Par défaut : faux
Si vous souhaitez activer plusieurs interfaces réseau pour les pods, définissez ce paramètre sur true
. Sinon, définissez cette valeur sur false
.
Pour plus d'informations, consultez la page Configurer plusieurs interfaces réseau pour les pods.
Exemple :
multipleNetworkInterfaces: true
advancedNetworking
Facultatif
Immuable
Booléen
Prérempli : faux
Par défaut : faux
Si vous envisagez de créer une passerelle NAT de sortie, définissez cette valeur sur true
. Sinon, définissez cette valeur sur false
.
Si vous définissez ce champ sur true
, vous devez également définir enableDataplaneV2
sur true
.
Exemple :
advancedNetworking: true
disableBundledIngress
Définissez cette valeur sur true
si vous souhaitez désactiver l'entrée groupée pour le cluster. Sinon, définissez cette valeur sur false
.
Facultatif
Booléen
Modifiable
Prérempli : faux
Par défaut : faux
Exemple :
disableBundledIngress: true
storage.vSphereCSIDisabled
Si vous souhaitez désactiver le déploiement des composants CSI vSphere, définissez cette valeur sur true
. Sinon, définissez cette valeur sur false
.
Facultatif
Modifiable
Booléen
Prérempli : faux
Par défaut : faux
Exemple :
storage: vSphereCSIDisabled: false
masterNode
Cette section contient des informations sur les nœuds qui servent de nœuds de plan de contrôle pour ce cluster d'utilisateur.
masterNode.cpus
Facultatif
Modifiable
Entier
Prérempli : 4
Par défaut : 4
Nombre de processeurs de chaque nœud servant de plan de contrôle pour ce cluster d'utilisateur.
Exemple :
masterNode: cpus: 8
masterNode.memoryMB
Facultatif
Modifiable
Entier
Prérempli : 8192
Par défaut : 8192
Mébioctets de mémoire pour chaque nœud servant de plan de contrôle pour ce cluster d'utilisateur. Cette valeur doit être un multiple de 4.
Exemple :
masterNode: memoryMB: 8192
Remarque : Ce champ spécifie le nombre de mébioctets de mémoire, et non le nombre de mégaoctets. Un mébioctet est égal à 2^20, soit 1 048 576 octets. Un mégaoctet est égal à 10^6, soit 1 000 000 octets.
masterNode.replicas
Facultatif
Immuable
Entier
Valeurs possibles : 1 ou 3
Prérempli : 1
Par défaut : 1
Nombre de nœuds de plan de contrôle pour ce cluster d'utilisateur Ce nombre ne peut pas être modifié une fois le cluster créé. Si vous souhaitez mettre à jour le nombre d'instances dupliquées ultérieurement, vous devez recréer le cluster d'utilisateur.
Exemple :
masterNode: replicas: 3
masterNode.autoResize.enabled
Facultatif
Modifiable
Booléen
Prérempli : faux
Par défaut : faux
Définissez cette valeur sur true
pour activer le redimensionnement automatique des nœuds du plan de contrôle du cluster d'utilisateur. Sinon, définissez cette valeur sur false
.
Pour en savoir plus, consultez la section Activer le redimensionnement des nœuds pour les nœuds de plan de contrôle d'un cluster d'utilisateur.
Exemple :
masterNode: autoResize: enabled: true
masterNode.vsphere.datastore
Facultatif
Immuable
Chaîne
Par défaut : valeur de vCenter.datastore
Datastore dans lequel les nœuds de plan de contrôle de ce cluster d'utilisateur seront créés.
La valeur que vous spécifiez doit être un nom, et non un chemin d'accès. N'incluez aucun dossier dans la valeur.
Exemple :
masterNode: vSphere: datastore: "control-plane-datastore"
Si vous spécifiez une valeur pour ce champ, ne spécifiez pas de valeur pour masterNode.vsphere.storagePolicyName
. Le champ masterNode.vsphere.datastore
est immuable, sauf lorsque vous définissez le champ sur une chaîne vide lorsque vous migrez un datastore vers Storage Policy Based Management (SPBM).
masterNode.vsphere.storagePolicyName
Facultatif
Immuable
Chaîne
Par défaut : valeur de vCenter.storagePolicyName
Nom d'une règle de stockage de VM pour les nœuds de plan de contrôle.
Pour en savoir plus, consultez la page Configurer une règle de stockage.
Exemple :
masterNode: vSphere: storagePolicyName: "control-plane-storage-policy"
Si vous spécifiez une valeur pour ce champ, ne spécifiez pas de valeur pour masterNode.vsphere.datastore
.
nodePools
Obligatoire
Modifiable
Tableau d'objets, chacun décrivant un pool de nœuds.
Pour en savoir plus, consultez la page Créer et gérer des pools de nœuds.
nodePools[i].name
Obligatoire
Immuable
Chaîne
Nom de votre choix pour un pool de nœuds. Ce nom doit :
- contenir au maximum 40 caractères ;
- ne contenir que des caractères alphanumériques minuscules ou un trait d'union
-
; - commencer par un caractère alphabétique ;
- se terminer par un caractère alphanumérique.
Exemple :
nodePools: - name: "my-node-pool-1"
nodePools[i].gkeOnPremVersion
Lorsque vous mettez à niveau un cluster d'utilisateur, vous pouvez spécifier que les pools de nœuds sélectionnés restent à la version précédente.
Si vous souhaitez que ce pool de nœuds conserve la version précédente, définissez cette option sur la version précédente. Sinon, supprimez ce champ ou définissez-le sur une chaîne vide. Pour en savoir plus, consultez la page Mettre à niveau les pools de nœuds.
Facultatif
Modifiable
Chaîne
Par défaut : cluster gkeOnPremVersion
Exemple :
nodePools: - name: "my-node-pool" gkeOnPremVersion: "1.13.0-gke.16"
nodePools[i].cpus
Obligatoire
Modifiable
Entier
Prérempli : 4
Nombre de processeurs virtuels de chaque nœud du pool.
Exemple :
nodePools" - name: "my-node-pool" cpus: 8
nodePools[i].memoryMB
Obligatoire
Modifiable
Entier
Prérempli : 8192
Mébioctets de mémoire pour chaque nœud du pool. Cette valeur doit être un multiple de 4.
Exemple :
nodePools" - name: "my-node-pool" memoryMB: 8192
Remarque : Ce champ spécifie le nombre de mébioctets de mémoire, et non le nombre de mégaoctets. Un mébioctet est égal à 2^20, soit 1 048 576 octets. Un mégaoctet est égal à 10^6, soit 1 000 000 octets.
nodePools[i].replicas
Obligatoire
Modifiable
Entier
Prérempli : 3
Valeurs possibles : le nombre total de nœuds non rejetés dans tous les pools de nœuds du tableau doit être au moins égal à 3.
Nombre de nœuds du pool.
Exemple :
nodePools: - name: "my-node-pool" replicas: 5
nodePools[i].bootDiskSizeGB
Facultatif
Modifiable
Entier
Prérempli : 40
Par défaut : 40
Taille du disque de démarrage en gigaoctets pour chaque nœud du pool.
Exemple :
nodePools - name: "my-node-pool" bootDiskSizeGB: 40
nodePools[i].osImageType
Facultatif
Modifiable
Chaîne
Valeurs possibles: "ubuntu_containerd", "cos", "windows"
Prérempli : "ubuntu_containerd"
Par défaut : "ubuntu_containerd"
Type d'image d'OS à exécuter sur les VM du pool de nœuds.
Exemple :
nodePools - name: "my-node-pool" osImageType: "ubuntu_containerd"
nodePools[i].osImage
Obligatoire si nodePools[i].osImageType
= windows
Modifiable
Chaîne
Nom d'un modèle de VM Windows. Le modèle doit être basé sur un fichier ISO de Windows Server 2019 comportant le tag de langue/région en-US.
Pour en savoir plus, consultez le guide de l'utilisateur pour les pools de nœuds du système d'exploitation Windows Server.
nodePools[i].labels
Facultatif
Modifiable
Mappage
Libellés à appliquer à chaque objet de nœud Kubernetes du pool.
Exemple :
nodePools: - name: "my-node-pool" labels: environment: "production" tier: "cache"
Le kubelet ne peut pas s'appliquer de libellés à lui-même dans certains espaces de noms pour des raisons de sécurité.
Les espaces de noms de libellés de nœuds réservés sont les suivants : kubernetes.io
, k8s.io
et googleapis.com
.
nodePools[i].taints
Facultatif
Modifiable
Tableau d'objets, chacun décrivant un rejet Kubernetes appliqué à chaque nœud du pool. Les rejets sont des paires clé-valeur associées à un effect
. Les rejets sont utilisés avec les tolérances pour la planification des pods. Spécifiez l'une des options suivantes pour effect
: NoSchedule
, PreferNoSchedule
, NoExecute
.
Exemple :
nodePools: - name: "my-node-pool" taints: - key: "staging" value: "true" effect: "NoSchedule"
nodePools[i].vsphere.datastore
Modifiable
Chaîne
Par défaut : valeur de vCenter.datastore
Nom du datastore vCenter dans lequel les nœuds seront créés.
Exemple :
nodePools: - name: "my-node-pool" vsphere: datastore: "my-datastore"
Si vous spécifiez une valeur pour ce champ, ne spécifiez pas de valeur pour nodePools[i].vsphere.storagePolicyName
.
nodePools[i].vsphere.storagePolicyName
Modifiable
Chaîne
Par défaut : valeur de vCenter.storagePolicyName
Nom d'une règle de stockage de VM pour les nœuds du pool.
Pour en savoir plus, consultez la page Configurer une règle de stockage.
Exemple :
nodePools: - name: "my-node-pool" vsphere: storagePolicyName: "my-storage-policy"
Si vous spécifiez une valeur pour ce champ, ne spécifiez pas de valeur pour nodePools[i].vsphere.datastore
.
nodePools[i].vsphere.tags
Facultatif
Modifiable
Tableau d'objets, chacun décrivant un tag vSphere à placer sur les VM du pool de nœuds.
Chaque tag comprend une catégorie et un nom.
Exemple :
nodePools: - name: "my-node-pool" vsphere: tags: - category: "purpose" name: "testing"
Si vous souhaitez associer des tags à toutes les VM d'un pool de nœuds, votre compte utilisateur vCenter doit disposer de ces droits d'ajout de tags vSphere :
- "vSphere Tagging.Assign" ou "Unassign vSphere Tag"
- "vSphere Tagging.Assign" ou "Unassign vSphere Tag on Object" (vSphere 7)
nodePools[i].vsphere.hostgroups
Renseignez cette section si vous souhaitez configurer votre cluster pour qu'il utilise l'affinité VM-hôte.
Facultatif
Modifiable
Tableau de chaînes, chacune correspondant au nom d'un groupe DRS hôte.
Le tableau ne peut contenir qu'un seul élément.
nodePools[i].vsphere.hostgroups[j].hostgroup
Facultatif
Modifiable
Chaîne
Le nom d'un groupe DRS hôte existant
nodePools: - name: "my-node-pool" vsphere: hostgroups: - "my-hostgroup"
nodePools[i].autoscaling
Facultatif
Modifiable
Si vous souhaitez activer le scaling automatique pour le pool de nœuds, renseignez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
nodePools[i].autoscaling.minReplicas
Facultatif
Modifiable
Entier
Valeurs possibles : supérieur ou égal à 1
Prérempli : 0
Nombre minimal de nœuds que l'autoscaler peut définir pour le pool.
Exemple :
nodePools: - name: "my-node-pool" autoscaling: minReplicas: 5
nodePools[i].autoscaling.maxReplicas
Facultatif
Modifiable
Entier
Prérempli : 0
Nombre maximal de nœuds que l'autoscaler peut définir pour le pool.
Exemple :
nodePools: - name: "my-node-pool" autoscaling: maxReplicas: 10
nodePools[i].enableLoadBalancer
Facultatif
Applicable si loadBalancer.kind
= "MetalLB"
Modifiable
Booléen
Prérempli : vrai
Valeur par défaut : false
Définissez cette valeur sur true
si vous souhaitez autoriser le locuteur MetalLB à s'exécuter sur les nœuds du pool. Sinon, définissez cette valeur sur false
.
Pour en savoir plus, consultez la page Équilibrage de charge groupé avec MetalLB.
Exemple :
nodePools: - name: "my-node-pool" enableLoadBalancer: true
antiAffinityGroups.enabled
Facultatif
Modifiable
Booléen
Prérempli : vrai
Définissez ce paramètre sur true
pour activer la création de règles DRS. Sinon, définissez cette valeur sur false
.
Exemple :
antiAffinityGroups: enabled: true
Si ce champ est true
, Google Distributed Cloud crée des règles d'anti-affinité DRS (Distributed Resource Scheduler) VMware pour les nœuds de votre cluster d'utilisateur, ce qui les répartit sur au moins trois hôtes ESXi physiques dans votre centre de données.
Cette fonctionnalité nécessite que votre environnement vSphere remplisse les conditions suivantes :
La fonctionnalité VMware DRS est activée. VMware DRS nécessite l'édition de licence vSphere Enterprise Plus.
Votre compte utilisateur vSphere dispose du privilège
Host.Inventory.Modify cluster
.Au moins quatre hôtes ESXi sont disponibles.
Même si la règle nécessite que les nœuds de cluster soient répartis sur trois hôtes ESXi, nous vous recommandons vivement de disposer d'au moins quatre hôtes ESXi disponibles.
Rappelez-vous que si vous possédez une licence standard vSphere, vous ne pouvez pas activer VMware DRS.
Si vous n'avez pas activé DRS ou si vous n'avez pas au moins quatre hôtes sur lesquels les VM vSphere peuvent être planifiées, définissez antiAffinityGroups.enabled
sur false
.
enableVMTracking
Bêta
Facultatif
Immuable
Prérempli : faux
Définissez cette valeur sur true
pour activer le suivi des VM avec les tags vSphere. Sinon, définissez cette valeur sur false
.
Pour en savoir plus, consultez la page Activer le suivi des VM.
Exemple :
enableVMTracking: true
nodePoolUpdatePolicy.maximumConcurrentNodePoolUpdate
Facultatif
Modifiable
Entier
Valeurs possibles : 0 ou 1
Prérempli : 0
Nombre de pools de nœuds à mettre à jour simultanément. La valeur 1
indique qu'un seul pool de nœuds peut être mis à jour à la fois. La valeur 0
indique qu'un nombre illimité de pools de nœuds peuvent être mis à jour à la fois.
Exemple :
nodePoolUpdatePolicy: maximumConcurrentNodePoolUpdate: 1
authentication
Cette section contient des informations sur la manière dont les utilisateurs du cluster sont authentifiés et autorisés.
authentication.oidc
N'utilisez pas cette section. À la place, après la création du cluster, modifiez la ressource personnalisée ClientConfig, comme décrit dans la section Configurer des clusters pour Anthos Identity Service avec OIDC.
authentication.sni
Facultatif
Si vous souhaitez fournir un certificat de diffusion supplémentaire pour le serveur d'API Kubernetes du cluster, renseignez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
authentication.sni.certPath
Facultatif
Chaîne
Chemin d'accès d'un certificat de diffusion pour le serveur d'API Kubernetes.
Exemple :
authentication: sni: certPath: "my-cert-folder/example.com.crt"
authentication.sni.keyPath
Facultatif
Chaîne
Chemin du fichier de clé privée du certificat.
Exemple :
authentication: sni: keyPath: "my-cert-folder/example.com.key"
gkeConnect
Obligatoire
Immuable
Cette section contient des informations sur le projet et le compte de service Google Cloud que vous souhaitez utiliser pour enregistrer votre cluster dans un parc Google Cloud.
gkeConnect.projectID
Obligatoire
Immuable
Chaîne
L'ID de votre projet hôte de parc.
Pour les nouveaux clusters, cet ID de projet doit être identique à l'ID défini dans stackdriver.projectID
et cloudAuditLogging.projectID
. Si les ID de projet sont différents, la création du cluster échoue. Cette exigence n'est pas appliquée aux clusters existants.
Exemple :
gkeConnect: projectID: "my-fleet-host-project"
gkeConnect.registerServiceAccountKeyPath
Obligatoire
Modifiable
Chaîne
Chemin d'accès au fichier de clé JSON de votre compte de service connect-register.
Pour mettre à jour la valeur de ce champ, utilisez gkectl update cluster
.
Pour en savoir plus sur la modification de votre clé de compte de service connect-register, consultez la section Alterner les clés de compte de service.
Exemple :
gkeConnect: registerServiceAccountKeyPath: "my-key-folder/connect-register-key.json"
gkeConnect.registerServiceAccountKey.secretRef.version
Obligatoire si des identifiants préparés sont utilisés
Modifiable
Chaîne
Valeurs possibles : chaîne d'entiers ou "latest"
Valeur par défaut : "latest"
Version d'un secret préparé dans le cluster d'administrateur qui contient une clé JSON pour votre compte de service connect-register.
Exemple :
gkeConnect: registerServiceAccountKey: secretRef: version: "1"
gkeOnPremAPI
Facultatif
Dans les versions 1.16 et ultérieures, si l'API GKE On-Prem est activée dans votre projet Google Cloud, tous les clusters du projet sont automatiquement enregistrés dans l'API GKE On-Prem dans la région configurée dans stackdriver.clusterLocation
.
Si vous souhaitez enregistrer tous les clusters du projet dans l'API GKE On-Prem, veillez à suivre les étapes de la section Avant de commencer pour activer et utiliser l'API GKE On-Prem dans le projet.
Si vous ne souhaitez pas enregistrer le cluster dans l'API GKE On-Prem, incluez cette section et définissez
gkeOnPremAPI.enabled
surfalse
. Si vous ne souhaitez pas enregistrer de clusters dans le projet, désactivezgkeonprem.googleapis.com
(le nom de service de l'API GKE On-Prem) dans le projet. Pour obtenir des instructions, consultez la page Désactiver des services.
L'enregistrement de votre cluster d'utilisateur dans l'API GKE On-Prem vous permet d'utiliser les outils standards (la console Google Cloud, Google Cloud CLI et Terraform) pour gérer le cycle de vie du cluster. De plus, l'enregistrement du cluster vous permet d'utiliser la console ou gcloud CLI pour afficher les détails du cluster. Par exemple, vous pouvez exécuter des commandes gcloud
pour obtenir des informations sur votre cluster d'utilisateur.
Après avoir ajouté cette section et créé ou mis à jour le cluster, si vous supprimez par la suite la section et mettez à jour le cluster, la mise à jour échoue.
gkeOnPremAPI.enabled
Obligatoire si la section gkeOnPremAPI
est incluse.
Modifiable
Booléen
Par défaut : true
Par défaut, le cluster est enregistré dans l'API GKE On-Prem si l'API GKE On-Prem est activée dans votre projet. Définissez la valeur sur false
si vous ne souhaitez pas enregistrer le cluster.
Une fois le cluster enregistré dans l'API GKE On-Prem, si vous devez le désinscrire, apportez la modification suivante, puis mettez le cluster à jour:
gkeOnPremAPI: enabled: false
gkeOnPremAPI.location
Obligatoire si la section gkeOnPremAPI
est incluse.
Immuable
Chaîne
Par défaut : stackdriver.clusterLocation
Région Google Cloud dans laquelle l'API GKE On-Prem s'exécute et stocke les métadonnées du cluster. Choisissez l'une des régions disponibles.
Vous devez utiliser la même région que celle configurée dans stackdriver.clusterLocation
et cloudAuditLogging.clusterLocation
. Si gkeOnPremAPI.enabled
est défini sur false
, n'incluez pas ce champ.
stackdriver
Obligatoire par défaut
Modifiable
Si vous souhaitez activer Cloud Logging et Cloud Monitoring pour votre cluster, renseignez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
Cette section est obligatoire par défaut. Autrement dit, si vous ne remplissez pas cette section, vous devez inclure l'option --skip-validation-stackdriver
lorsque vous exécutez gkectl create cluster
.
Cette section est obligatoire dans le cluster d'utilisateur si vous souhaitez gérer le cycle de vie des clusters d'utilisateur dans la console Google Cloud.
stackdriver.projectID
Requis pour la journalisation et la surveillance
Immuable
Chaîne
L'ID de votre projet hôte de parc.
Pour les nouveaux clusters, cet ID de projet doit être identique à l'ID défini dans gkeConnect.projectID
et cloudAuditLogging.projectID
. Si les ID de projet sont différents, la création du cluster échoue. Cette exigence n'est pas appliquée aux clusters existants.
Si nécessaire, vous pouvez configurer un routeur de journaux dans ce projet pour acheminer les journaux vers les buckets de journaux d'un autre projet. Pour en savoir plus sur la configuration du routeur de journaux, consultez la section Destinations compatibles.
Exemple :
stackdriver: projectID: "my-fleet-host-project"
stackdriver.clusterLocation
Requis pour la journalisation et la surveillance
Immuable
Chaîne
Prérempli : "us-central1"
Région Google Cloud dans laquelle vous souhaitez stocker les journaux. Nous vous recommandons de choisir une région à proximité de votre centre de données sur site.
Pour les nouveaux clusters, si vous incluez les sections gkeOnPremAPI
et cloudAuditLogging
dans le fichier de configuration, la région que vous définissez ici doit être la même que celle que vous avez définie dans gkeOnPremAPI.location
et cloudAuditLogging.clusterLocation
. Si les régions ne sont pas identiques, la création du cluster échoue.
Exemple :
stackdriver: clusterLocation: "us-central1"
stackdriver.enableVPC
Facultatif
Immuable
Booléen
Prérempli : faux
Si le réseau de votre cluster est contrôlé par un VPC, définissez ce champ sur true
.
Ainsi, toute la télémétrie passe par les adresses IP restreintes de Google.
Sinon, définissez cette valeur sur false
.
Exemple :
stackdriver: enableVPC: false
stackdriver.serviceAccountKeyPath
Requis pour la journalisation et la surveillance
Modifiable
Chaîne
Chemin du fichier de clé JSON pour votre compte de service de journalisation-surveillance.
Pour mettre à jour la valeur de ce champ, utilisez gkectl update cluster
.
Pour en savoir plus sur la modification de votre clé de compte de service logging-monitoring, consultez la section Alterner les clés de compte de service.
Exemple :
stackdriver: serviceAccountKeyPath: "my-key-folder/log-mon-key.json"
stackdriver.serviceAccountKey.secretRef.version
Obligatoire si des identifiants préparés sont utilisés
Modifiable
Chaîne
Valeurs possibles : chaîne d'entiers ou "latest"
Valeur par défaut : "latest"
Version d'un secret préparé dans le cluster d'administrateur qui contient une clé JSON pour votre compte de service de surveillance de la journalisation.
Exemple :
stackdriver: serviceAccountKey: secretRef: version: "1"
stackdriver.disableVsphereResourceMetrics
Facultatif
Modifiable
Booléen
Prérempli : faux
Par défaut : faux
Définissez cette valeur sur true
pour désactiver la collecte de métriques depuis vSphere.
Sinon, définissez cette valeur sur false
.
Exemple :
stackdriver: disableVsphereResourceMetrics: true
usageMetering
Bêta
Immuable
Facultatif
Si vous souhaitez activer la mesure de l'utilisation de votre cluster, renseignez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
usageMetering.bigQueryProjectID
Preview
Obligatoire pour la mesure de l'utilisation
Immuable
Chaîne
ID du projet Google Cloud dans lequel vous souhaitez stocker les données de mesure de l'utilisation.
Exemple :
usageMetering: bigQueryProjectID: "my-bq-project"
usageMetering.bigQueryDatasetID
Preview
Obligatoire pour la mesure de l'utilisation
Immuable
Chaîne
ID de l'ensemble de données BigQuery dans lequel vous souhaitez stocker les données de mesure de l'utilisation. Exemple :
usageMetering: bigQueryDatasetID: "my-bq-dataset"
usageMetering.bigQueryServiceAccountKeyPath
Preview
Obligatoire pour la mesure de l'utilisation
Immuable
Chaîne.
Chemin d'accès au fichier de clé JSON de votre compte de service BigQuery.
Pour mettre à jour la valeur de ce champ, utilisez gkectl update cluster
.
Pour en savoir plus sur la modification de votre clé de compte de service BigQuery, consultez la section Effectuer une rotation des clés de compte de service.
Exemple :
usageMetering: bigQueryServiceAccountKeyPath: "my-key-folder/bq-key.json"
usageMetering.bigQueryServiceAccountKey.secretRef.version
Obligatoire si des identifiants préparés sont utilisés
Modifiable
Chaîne
Valeurs possibles : chaîne d'entiers ou "latest"
Valeur par défaut : "latest"
Version d'un secret préparé dans le cluster d'administrateur qui contient une clé JSON pour votre compte de service BigQuery.
Exemple :
gkeConnect: bigQueryServiceAccountKey: secretRef: version: "1"
usageMetering.enableConsumptionMetering
Preview
Obligatoire pour la mesure de l'utilisation
Immuable
Booléen
Prérempli : faux
Définissez cette valeur sur true
si vous souhaitez activer la mesure basée sur la consommation.
Sinon, définissez-la sur "false".
Exemple :
usageMetering: enableConsumptionMetering: true
cloudAuditLogging
Si vous souhaitez intégrer les journaux d'audit du serveur d'API Kubernetes de votre cluster aux journaux d'audit Cloud, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
cloudAuditLogging.projectID
Obligatoire pour les journaux d'audit Cloud
Immuable
Chaîne
L'ID de votre projet hôte de parc.
Pour les nouveaux clusters, cet ID de projet doit être identique à l'ID défini dans gkeConnect.projecID
et stackdriver.projectID
. Si les ID de projet sont différents, la création du cluster échoue. Cette exigence n'est pas appliquée aux clusters existants.
Si nécessaire, vous pouvez configurer un routeur de journaux dans ce projet pour acheminer les journaux vers les buckets de journaux d'un autre projet. Pour en savoir plus sur la configuration du routeur de journaux, consultez la section Destinations compatibles.
Exemple :
cloudAuditLogging: projectID: "my-fleet-host-project"
cloudAuditLogging.clusterLocation
Obligatoire pour les journaux d'audit Cloud
Immuable
Chaîne
Région Google Cloud dans laquelle vous souhaitez stocker les journaux d'audit. Nous vous recommandons de choisir une région à proximité de votre centre de données sur site.
Pour les nouveaux clusters, si vous incluez les sections gkeOnPremAPI
et stackdriver
dans le fichier de configuration, la région que vous définissez ici doit être la même que celle que vous avez définie dans gkeOnPremAPI.location
et stackdriver.clusterLocation
. Si les régions ne sont pas identiques, la création du cluster échoue.
Exemple :
cloudAuditLogging: clusterLocation: "us-central1"
cloudAuditLogging.serviceAccountKeyPath
Obligatoire pour les journaux d'audit Cloud
Modifiable
Chaîne
Chemin d'accès au fichier de clé JSON de votre compte de service de journalisation-audit.
Pour mettre à jour la valeur de ce champ, utilisez gkectl update cluster
.
Pour en savoir plus sur la modification de votre clé de compte de service de journalisation d'audit, consultez la section Alterner les clés de compte de service.
Exemple :
cloudAuditLogging: serviceAccountKeyPath: "my-key-folder/audit-log-key.json"
cloudAuditLogging.serviceAccountKey.secretRef.version
Facultatif
Modifiable
Chaîne
Valeurs possibles : une chaîne d'entiers ou "latest"
Valeur par défaut : "latest"
Version d'un secret préparé dans le cluster d'administrateur qui contient une clé JSON pour votre compte de service de journalisation d'audit.
Exemple :
cloudAuditLogging: serviceAccountKey: secretRef: version: "1"
autoRepair.enabled
Facultatif
Modifiable
Booléen
Prérempli : vrai
Définissez cette valeur sur true
pour activer la réparation automatique des nœuds. Sinon, définissez cette valeur sur false
.
Exemple :
autoRepair: enabled: true
secretsEncryption
Si vous souhaitez chiffrer des secrets sans avoir besoin de KMS (Key Management Service) externe ni d'autres dépendances, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
secretsEncryption.mode
Obligatoire pour le chiffrement des secrets
Immuable
Chaîne
Valeur possible : "GeneratedKey"
Prérempli : "GeneratedKey"
Mode de chiffrement du secret.
secretsEncryption: mode: "GeneratedKey"
secretsEncryption.generatedKey.keyVersion
Obligatoire pour le chiffrement des secrets
Modifiable
Entier
Prérempli : 1
Entier de votre choix à utiliser pour le numéro de version de clé. Nous vous recommandons de commencer par 1
.
Pour savoir comment mettre à jour ce champ pour un cluster existant, consultez la page Chiffrement des secrets toujours activé.
Exemple :
secretsEncryption: generatedKey: keyVersion: 1
secretsEncryption.generatedKey.disabled
Obligatoire pour le chiffrement des secrets
Modifiable
Booléen
Prérempli : faux
Définissez cette valeur sur true
pour désactiver le chiffrement des secrets. Sinon, définissez-la sur false
.
Pour savoir comment mettre à jour ce champ pour un cluster existant, consultez la page Chiffrement des secrets toujours activé.
Exemple :
secretsEncryption: generatedKey: disabled: false