Cette page décrit les champs du fichier de configuration du cluster d'administrateur pour Anthos clusters on VMware (GKE On-Prem).
Générer un modèle pour votre fichier de configuration
Si vous avez utilisé gkeadm
pour créer le poste de travail d'administrateur, gkeadm
a généré un modèle pour le fichier de configuration de votre cluster d'administrateur. Par ailleurs, gkeadm
renseigne certains champs pour vous.
Si vous n'avez pas utilisé gkeadm
pour créer votre poste de travail d'administrateur, vous pouvez utiliser gkectl
pour générer un modèle pour votre fichier de configuration de cluster d'administrateur.
Pour générer un modèle pour votre fichier de configuration de cluster d'administrateur :
gkectl create-config admin --config=OUTPUT_FILENAME --gke-on-prem-version=VERSION
Remplacez OUTPUT_FILENAME
par le chemin d'accès que vous avez choisi pour le modèle généré. Si vous omettez cette option, gkectl
nomme le fichier admin-cluster.yaml
et le place dans le répertoire actuel.
Remplacez VERSION
par le numéro de version souhaité, qui doit être inférieur ou égal à votre version gkectl
. Par exemple : gkectl create-config admin --gke-on-prem-version=1.6.2-gke.0
. Si vous omettez cette option, le modèle de configuration généré est renseigné avec des valeurs basées sur la dernière version du cluster.
Modèle
Remplir votre fichier de configuration
Dans votre fichier de configuration, saisissez les valeurs des champs comme décrit dans les sections suivantes.
name
Facultatif
Chaîne immuable
Par défaut : nom aléatoire avec le préfixe "gke-admin-"
Nom de votre choix pour le cluster.
Exemple :
name: "my-admin-cluster"
bundlePath
Obligatoire
Chaîne modifiable
Chemin d'accès de votre fichier de bundle Anthos clusters on VMware.
Le fichier de bundle complet de Anthos clusters on VMware contient tous les composants dans une version spécifique de Anthos clusters on VMware. Lorsque vous créez un poste de travail d'administrateur, celui-ci est fourni avec un groupe complet dans :
/var/lib/gke/bundles/gke-onprem-vsphere-VERSION-full.tgz
Exemple :
bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-1.10.0-gke.8.full.tgz"
vCenter
Requis
Cette section contient des informations sur votre environnement vSphere et sur votre connexion au serveur vCenter.
vCenter.address
Obligatoire
Chaîne immuable
Adresse IP ou nom d'hôte de votre serveur vCenter.
Pour en savoir plus, consultez la section Rechercher l'adresse de votre serveur vCenter.
Exemples :
vCenter: address: "203.0.113.100"
vCenter: address: "my-vcenter-server.my-domain.example"
vCenter.datacenter
Obligatoire
Chaîne immuable
Nom d'un centre de données vCenter contenant les hôtes ESXi physiques sur lesquels vos VM de cluster d'administrateur seront exécutées.
Exemple :
vCenter: datacenter: "my-datacenter""
vCenter.cluster
Obligatoire
Chaîne immuable
Nom d'un cluster vSphere contenant les hôtes ESXi sur lesquels vos VM de cluster d'administrateur seront exécutées. Ce cluster vSphere est un ensemble d'hôtes ESXi physiques qui constituent un sous-ensemble des hôtes physiques ESXi de votre centre de données vCenter.
Exemple :
vCenter: cluster: "my-vsphere-cluster"
vCenter.resourcePool
Obligatoire
Chaîne immuable
Nom d'un pool de ressources vCenter pour les VM de votre cluster d'administrateur.
Exemple :
vCenter: resourcePool: "my-resource-pool-2"
Pour utiliser le pool de ressources par défaut, définissez cette valeur sur VSPHERE_CLUSTER/Resources.
Exemple :
vCenter: resourcePool: "my-vsphere-cluster-2/Resources"
Pour en savoir plus, consultez la section Spécifier le pool de ressources racine pour un hôte autonome.
vCenter.datastore
Obligatoire
Chaîne immuable
Nom d'un datastore vCenter pour les VM de votre cluster d'administrateur.
Exemple :
vCenter: datastore: "my-datastore"
vCenter.caCertPath
Obligatoire
Chaîne modifiable
Chemin d'accès du certificat CA de votre serveur vCenter.
Pour en savoir plus, consultez la section Obtenir votre certificat CA vCenter.
Pour en savoir plus sur la mise à jour de ce champ pour un cluster existant, consultez la page Mettre à jour les références de certificat vCenter.
Exemple :
vCenter: caCertPath: "/usr/local/google/home/me/certs/vcenter-ca-cert.pem"
vCenter.credentials.fileRef.path
Obligatoire
Chaîne modifiable
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
pour mettre à jour ce champ dans un cluster existant.
Pour en savoir plus sur la mise à jour de vos identifiants vCenter, consultez la page Mettre à jour les identifiants de cluster.
Exemple :
vCenter: credentials: fileRef: path: "my-config-folder/admin-creds.yaml"
vCenter.credentials.fileRef.entry
Obligatoire
Chaîne modifiable
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.
Vous pouvez utiliser gkectl update
pour mettre à jour ce champ dans un cluster existant.
Pour en savoir plus sur la mise à jour de vos identifiants vCenter, consultez la page Mettre à jour les identifiants de cluster.
Exemple :
vCenter: credentials: fileRef: entry: "vcenter-creds"
vCenter.folder
Facultatif
Chaîne immuable
Par défaut : dossier à l'échelle du centre de données
Nom du dossier vCenter où se trouvent les VM de votre cluster d'administrateur.
Exemple :
vCenter: folder: "my-folder"
vCenter.dataDisk
Obligatoire
Chaîne immuable
Anthos clusters on VMware crée un disque de machine virtuelle (VMDK) pour contenir
les données d'objet Kubernetes. Le programme d'installation crée le VMDK, mais vous devez lui attribuer un nom dans le champ vCenter.dataDisk
.
Exemple :
vCenter: dataDisk: "my-disk.vmdk"
Si vous utilisez un datastore vSAN, vous devez placer le VMDK dans un dossier créé manuellement au préalable.
Vous pouvez utiliser govc
pour créer un dossier :
govc datastore.mkdir -namespace=true my-folder
Définissez ensuite vCenter.dataDisk
sur le chemin d'accès du VMDK, en y incluant le nom du dossier.
Exemple :
vDenter: dataDisk: "my-folder/my-disk.vmdk"
network
Requis
Cette section préserve des informations sur votre réseau de clusters d'administrateur.
network.hostConfig
Facultatif
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.
network.hostConfig.dnsServers
Facultatif
Tableau de chaînes immuable
Adresses des serveurs DNS pour les VM.
Exemple :
network: hostConfig: dnsServers: - "172.16.255.1" - "172.16.255.2"
network.hostConfig.ntpServers
Facultatif
Tableau de chaînes immuable
Adresses des serveurs de temps que les VM utilisent.
Exemple :
network: hostConfig: ntpServers: - "216.239.35.0"
network.hostConfig.searchDomainsForDNS
Facultatif
Tableau de chaînes immuable
Domaines de recherche DNS que les VM utilisent. Ces domaines sont utilisés dans une liste de recherche de domaines.
Exemple :
network: hostConfig: searchDomainsForDNS: - "my.local.com"
network.ipMode.type
Obligatoire
Chaîne immuable
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.serviceCIDR
Obligatoire
Chaîne immuable
Plage la plus petite possible : /24
Plage la plus étendue possible : /12
Prérempli : "10.96.232.0/" 24"
Par défaut : "10.96.232.0/24"
Une plage d'adresses IP au format CIDR à utiliser pour les services de votre cluster.
Exemple :
network: serviceCIDR: "10.96.232.0/24"
network.podCIDR
Obligatoire
Chaîne immuable
Plage la plus petite possible : /18
Plage la plus étendue possible : /8
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
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
Chaîne immuable
Nom du réseau vSphere pour vos nœuds de cluster.
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 du réseau n'est pas unique, il est possible de spécifier un chemin d'accès au réseau, tel que /DATACENTER/network/NETWORK_NAME
.
Exemple :
network: vCenter: networkName: "my-network"
loadBalancer
Cette section contient des informations sur l'équilibreur de charge de votre cluster d'administrateur.
loadBalancer.vips.controlPlaneVIP
Obligatoire
Chaîne immuable
Adresse IP que vous avez choisie de configurer sur l'équilibreur de charge pour le serveur d'API Kubernetes du cluster d'administrateur.
Exemple :
loadBalancer: vips: controlplaneVIP: "203.0.113.3"
loadBalancer.vips.addonsVIP
Facultatif
Chaîne immuable
Adresse IP que vous avez choisie de configurer sur l'équilibreur de charge pour les modules complémentaires.
Exemple :
loadBalancer: vips: addonsVIP: "203.0.113.4"
loadBalancer.kind
Obligatoire
Chaîne immuable
Chaîne. 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.
loadBalancer.manualLB.ingressHTTPNodePort
Supprimez ce champ de votre fichier de configuration. Il n'est pas utilisé dans un cluster d'administrateur.
loadBalancer.manualLB.ingressHTTPSNodePort
Supprimez ce champ de votre fichier de configuration. Il n'est pas utilisé dans un cluster d'administrateur.
loadBalancer.manualLB.konnectivityServerNodePort
Supprimez ce champ de votre fichier de configuration. Il n'est pas utilisé dans un cluster d'administrateur.
loadBalancer.manualLB.controlPlaneNodePort
Obligatoire si loadBalancer.kind
= "ManualLB"
Entier immuable
Le serveur d'API Kubernetes du cluster d'administrateur est exposé par un service Kubernetes. Vous devez choisir une valeur nodePort
pour le service.
Définissez ce champ sur la valeur nodePort
.
Exemple :
loadBalancer: manualLB: contolPlaneNodePort: 30968
loadBalancer.manualLB.addonsNodePort
Obligatoire si loadBalancer.kind
= "ManualLB"
Entier immuable
Le serveur de modules complémentaires du cluster d'administrateur est exposé par un service Kubernetes.
Vous devez choisir une valeur nodePort
pour le service.
Définissez ce champ sur la valeur nodePort
.
Exemple :
loadBalancer: manualLB: addonsNodePort: 31405
loadBalancer.f5BigIP
Si vous définissez loadbalancer.kind
sur "f5BigIP"
, remplissez cette section. Sinon, supprimez cette section.
loadBalancer.f5BigIP.address
Obligatoire si loadBalancer.kind
= "f5BigIp"
Chaîne immuable
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 modifiable
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 Anthos clusters on VMware 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.
Vous pouvez utiliser gkectl update
pour mettre à jour ce champ dans un cluster existant.
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/admin-creds.yaml"
loadBalancer.f5BigIP.credentialsfileRef.entry
Obligatoire si loadBalancer.kind
= "f5BigIp"
Chaîne immuable
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.
Vous pouvez utiliser gkectl update
pour mettre à jour ce champ dans un cluster existant.
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: entry: "f5-creds"
loadBalancer.f5BigIP.partition
Obligatoire si loadBalancer.kind
= "f5BigIp"
Chaîne immuable
Nom d'une partition BIG-IP que vous avez créée pour votre cluster d'administrateur.
Exemple :
loadBalancer: f5BigIP: partition: "my-f5-admin-partition"
loadBalancer.f5BigIP.snatPoolName
Facultatif
Applicable si loadBalancer.kind
= "f5BigIp"
Chaîne immuable
Si vous utilisez SNAT, nom de votre pool SNAT. Si vous n'utilisez pas SNAT, supprimez ce champ.
Exemple :
loadBalancer: f5BigIP: snatPoolName: "my-snat-pool"
loadBalancer.seesaw
Si vous définissez loadbalancer.kind
sur "Seesaw"
, remplissez cette section. Sinon, supprimez cette section.
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"
Chaîne immuable
Chemin du fichier de bloc d'adresses IP pour vos VM Seesaw.
Exemple :
loadBalancer: seesaw: ipBlockFilePath: "config-folder/admin-seesaw-ipblock.yaml"
loadBalancer.seesaw.vrid
Obligatoire si loadBalancer.kind
= "Seesaw"
Entier immuable
Valeurs possibles : 1 - 255
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"
Entier 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"
Entier immuable
Prérempli : 2
Par défaut :
Nombre de processeurs pour chacune de vos VM Seesaw.
Exemple :
loadBalancer: seesaw: cpus: 8
loadBalancer.seesaw.memoryMB
Obligatoire si loadBalancer.kind
= "Seesaw"
Entier immuable
Prérempli : 3072
Par défaut : 1024
Nombre de mébioctets de mémoire pour chacune de vos VM Seesaw.
Exemple :
loadBalancer: seesaw: memoryMB: 8192
loadBalancer.seesaw.vCenter.networkName
Facultatif
Applicable si loadBalancer.kind
= "Seesaw"
Chaîne immuable
Nom du réseau vCenter contenant vos VM Seesaw.
Exemple :
loadBalancer: seesaw: vCenter: networkName: "my-seesaw-network"
loadBalancer.seesaw.enableHA
Facultatif
Applicable si loadBalancer.kind
= "Seesaw"
Booléen immuable
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
Applicable si loadBalancer.kind
= "Seesaw"
Booléen immuable
Prérempli : faux
Par défaut : faux
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
antiAffinityGroups.enabled
Obligatoire
Booléen modifiable
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
Anthos clusters on VMware crée automatiquement des règles anti-affinités VMware DRS (Distributed Resource Scheduler) pour les nœuds de votre cluster d'administrateur, avec pour effet de les répartir sur au moins trois hôtes 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 trois hôtes physiques sont 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 trois hôtes sur lesquels les VM vSphere peuvent être planifiées, définissez antiAffinityGroups.enabled
sur false
.
adminMaster
Bêta
Si vous souhaitez spécifier le processeur et la mémoire pour le nœud de plan de contrôle du cluster d'administrateur, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
adminMaster.cpus
Bêta
Facultatif
Entier immuable
Prérempli 4
Par défaut : 4
Nombre de vCPU pour le nœud du plan de contrôle du cluster d'administrateur.
Exemple :
adminMaster: cpus: 4
adminMaster.memoryMB
Bêta
Facultatif
Entier immuable
Prérempli 16384
Par défaut : 16384
Nombre de mébioctets de mémoire pour le nœud de plan de contrôle du cluster d'administrateur.
Exemple :
adminMaster: memoryMB: 16384
addonNode.autoResize.enabled
Bêta
Facultatif
Booléen modifiable
Prérempli : faux
Par défaut : faux
Définissez ce paramètre sur true
pour activer le redimensionnement automatique des nœuds de modules complémentaires dans le cluster d'administrateur. Sinon, définissez-le sur false
.
Pour mettre à jour la valeur de ce champ, utilisez gkectl update admin
.
Exemple :
addonNode: autoResize: enabled: true
connectivity
Facultatif
Chaîne immuable
Valeur possible : "connecté"
Prérempli : "connecté"
Par défaut : "connecté"
Spécifiez la connectivité à Google Cloud. La seule valeur possible pour connectivity
est "connecté".
Exemple :
connectivity: "connected"
proxy
Si votre réseau est protégé par un serveur proxy, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
proxy.url
Facultatif
Chaîne immuable
Adresse HTTP de votre serveur proxy. Incluez le numéro de port même s'il est identique au port par défaut du schéma.
Exemple :
proxy: url: "http://my-proxy.example.local:80"
Le serveur proxy que vous spécifiez ici est utilisé par vos clusters Anthos clusters on VMware. En outre, votre poste de travail d'administrateur est automatiquement configuré pour utiliser ce même serveur proxy, sauf si vous définissez la variable d'environnement HTTPS_PROXY
sur votre poste de travail d'administrateur.
Si vous spécifiez proxy.url
, vous devez également spécifier proxy.noProxy
.
Une fois la configuration du proxy pour le cluster d'administrateur définie, elle ne peut être ni modifiée, ni supprimée, sauf si le cluster est recréé.
proxy.noProxy
Facultatif
Chaîne immuable
Liste d'adresses IP, de plages d'adresses IP, de noms d'hôte et de noms de domaine séparés par une virgule qui ne doivent pas passer par le serveur proxy. Lorsque Anthos clusters on VMware envoie une requête à l'une de ces adresses, hôtes ou domaines, la requête est envoyée directement.
Exemple :
proxy: noProxy: "10.151.222.0/24,my-host.example.local,10.151.2.1"
privateRegistry
Si vous disposez d'un registre Docker privé, remplissez cette section. Sinon, supprimez cette section ou laissez-la en commentaire.
Les paramètres que vous sélectionnez dans la section privateregistry
concernent non seulement le cluster d'administrateur, mais également les clusters d'utilisateur.
privateRegistry.address
Obligatoire pour les registres privés
Chaîne immuable
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 les registres privés
Chaîne immuable
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 Anthos clusters on VMware 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 les registres privés
Chaîne immuable
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.caCertPath
Obligatoire pour les registres privés
Chaîne immuable
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"
componentAccessServiceAccountKeyPath
Obligatoire
Chaîne immuable
Chemin d'accès au fichier de clé JSON de votre compte de service d'accès au composant.
Exemple :
componentAccessServiceAccountKeyPath: "my-key-folder/access-key.json"
gkeConnect
Facultatif.
La section gkeConnect
, qui permet d'enregistrer un cluster d'administrateur, est une fonctionnalité en disponibilité générale pour la création de clusters, mais une fonctionnalité bêta pour les mises à jour de clusters.
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 pour l'enregistrement
Chaîne immuable
L'ID de votre projet hôte de parc.
Exemple :
gkeConnect: projectID: "my-fleet-host-project-123"
gkeConnect.registerServiceAccountKeyPath
Obligatoire pour l'enregistrement
Chaîne immuable
Chemin d'accès au fichier de clé JSON de votre compte de service connect-register.
Exemple :
gkeConnect: registerServiceAccountKeyPath: "my-key-folder/connect-register-key.json"
stackdriver
Facultatif
Si vous souhaitez activer Cloud Logging et Cloud Monitoring pour votre cluster, renseignez cette section. Sinon, supprimez cette section.
stackdriver.projectID
Requis pour la journalisation et la surveillance
Chaîne immuable
ID de votre projet logging-monitoring. Il s'agit du projet Google Cloud dans lequel vous verrez les journaux et les métriques.
Exemple :
stackdriver: projectID: "my-logs-project"
stackdriver.clusterLocation
Requis pour la journalisation et la surveillance
Chaîne immuable
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.
Exemple :
stackdriver: clusterLocation: "us-central1"
stackdriver.enableVPC
Facultatif
Booléen immuable
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 Logging et Monitoring
Chaîne modifiable
Chemin du fichier de clé JSON pour votre compte de service de journalisation-surveillance.
Pour savoir comment mettre à jour ce champ dans un cluster existant, consultez la page Appliquer une rotation des clés de compte de service.
Exemple :
stackdriver: serviceAccountKeyPath: "my-key-folder/log-mon-key.json"
stackdriver.disableVsphereResourceMetrics
Facultatif
Applicable à Logging et Monitoring
Booléen immuable
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
cloudAuditLogging
Bêta
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
Bêta
Obligatoire pour Cloud Audit Logs
Chaîne immuable
ID du projet Google Cloud dans lequel vous souhaitez stocker les journaux d'audit.
Exemple :
cloudAuditLogging: projectID: "my-audit-project"
cloudAuditLogging.clusterLocation
Bêta
Obligatoire pour Cloud Audit Logs
Chaîne immuable
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.
Exemple :
cloudAuditLogging: clusterLocation: "us-central1"
cloudAuditLogging.serviceAccountKeyPath
Bêta
Obligatoire pour les journaux d'audit Cloud
Chaîne modifiable
Chemin d'accès au fichier de clé JSON de votre compte de service de journalisation-audit.
Pour savoir comment mettre à jour ce champ dans un cluster existant, consultez la page Appliquer une rotation des clés de compte de service.
Exemple :
cloudAuditLogging: serviceAccountKeyPath: "my-key-folder/audit-log-key.json"
clusterBackup.datastore
Bêta
Facultatif
Chaîne immuable
Si vous souhaitez activer la sauvegarde du cluster d'administrateur, définissez ce paramètre sur le datastore vSphere dans lequel vous souhaitez enregistrer les sauvegardes de cluster.
Exemple :
clusterBackup: datastore: "my-datastore"
autoRepair.enabled
Obligatoire
Booléen modifiable
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
.
Pour mettre à jour la valeur de ce champ, utilisez gkectl update admin
.
Exemple :
autoRepair: enabled: true
secretsEncryption
Si vous souhaitez chiffrer des secrets sans avoir besoin de KMS externe (Key Management Service) 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
Chaîne immuable
Valeur possible : "GeneratedKey"
Prérempli : "GeneratedKey"
Mode de chiffrement du secret.
secretsEncryption: mode: "GeneratedKey"
secretsEncryption.generatedKey.keyVersion
Obligatoire pour le chiffrement des secrets
Entier modifiable
Prérempli : 1
Entier de votre choix à utiliser pour le numéro de version de clé. Nous vous recommandons de commencer par 1
.
Exemple :
secretsEncryption: generatedKey: keyVersion: 1
secretsEncryption.generatedKey.disabled
Obligatoire pour le chiffrement des secrets
Booléen modifiable
Prérempli : faux
Définissez cette valeur sur true
pour désactiver le chiffrement des secrets. Sinon, définissez-la sur false
.
Exemple :
secretsEncryption: generatedKey: disabled: false
osImageType
Facultatif
Chaîne immuable
Valeurs possibles : "ubuntu", "ubuntu_containerd" ou "cos"
Prérempli : "ubuntu_containerd"
Par défaut : "ubuntu_containerd"
Type d'image d'OS à exécuter sur vos nœuds de cluster d'administrateur.
Exemple :
osImageType: "cos"