Cette page décrit les champs compatibles avec le fichier de configuration d'un cluster GKE sur Bare Metal. Pour chaque champ, le tableau suivant indique si le champ est obligatoire. Le tableau indique également les champs modifiables, ce c'est-à-dire les champs qui peuvent être modifiés après la création d'un cluster. Comme indiqué dans le tableau, certains champs modifiables ne peuvent être modifiés que lors d'une mise à niveau d'un cluster.
Générer un modèle pour votre fichier de configuration de cluster
Vous pouvez créer un fichier de configuration de cluster à l'aide de la commande bmctl create config. Bien que certains champs aient des valeurs par défaut et d'autres, tels que metadata.name, puissent être renseignés automatiquement, ce fichier de configuration au format YAML est un modèle permettant de spécifier des informations sur votre cluster.
Pour créer un nouveau fichier de configuration de cluster, exécutez la commande suivante dans le dossier /baremetal :
bmctl create config -c CLUSTER_NAME
Remplacez CLUSTER_NAME par le nom du cluster que vous souhaitez créer. Pour en savoir plus sur bmctl, consultez la section consacrée à l'outil bmctl.
Pour obtenir un exemple de fichier de configuration de cluster généré, consultez la section Exemple de fichier de configuration de cluster.
Remplir votre fichier de configuration
Dans votre fichier de configuration, saisissez les valeurs des champs comme décrit dans le tableau de référence des champs ci-dessous, avant de créer ou de mettre à niveau votre cluster.
Champs de configuration de cluster
Nom du champ
Type de ressource
nécessaire
Modifiable ?
anthosBareMetalVersion
Obligatoire. Chaîne. Version du cluster. Cette valeur est définie pour la création et les mises à niveau des clusters.
Mutabilité : cette valeur ne peut pas être modifiée pour les clusters existants.
La version ne peut être mise à jour qu'avec le processus de mise à niveau du cluster.
Ressource du cluster
Obligatoire
Non immuable
authentication
Cette section contient les paramètres nécessaires à l'utilisation d'OpenID Connect (OIDC).
OIDC vous permet d'utiliser votre fournisseur d'identité existant pour gérer l'authentification des utilisateurs et des groupes dans les clusters GKE sur Bare Metal.
Ressource du cluster
—
—
authentication.oidc.certificateAuthorityData
Facultatif. Certificat encodé au format PEM encodé en base64 pour le fournisseur OIDC. Pour créer la chaîne, encodez le certificat, y compris les en-têtes, en base64. Incluez la chaîne obtenue dans certificateAuthorityData en tant que ligne unique.
Par exemple (exemple encapsulé pour tenir dans un tableau) :
Facultatif. Chaîne. ID de l'application cliente qui envoie des requêtes d'authentification au fournisseur OpenID.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.clientSecret
Facultatif. Chaîne. Clé secrète partagée entre l'application cliente OIDC et le fournisseur OIDC.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.deployCloudConsoleProxy
Facultatif. Valeur booléenne (true|false). Spécifie si un proxy inverse est déployé dans le cluster pour connecter Google Cloud Console à un fournisseur d'identité sur site qui n'est pas accessible publiquement sur Internet. Si votre fournisseur d'identité n'est pas accessible sur l'Internet public, définissez ce champ sur true pour vous authentifier auprès de Google Cloud Console. Par défaut, cette valeur est définie sur false.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.extraParams
Facultatif. Liste d'éléments séparés par une virgule. Paramètres de clé-valeur supplémentaires à envoyer au fournisseur OpenID.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.groupPrefix
Facultatif. Chaîne. Préfixe ajouté aux revendications de groupe pour éviter les conflits avec les noms existants. Par exemple, pour un groupe dev et un préfixe oidc: donnés, oidc:dev.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.group
Facultatif. Chaîne.
Revendication JWT que le fournisseur utilise pour renvoyer vos groupes de sécurité.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.issuerURL
Facultatif. Chaîne d'URL. URL où les requêtes d'autorisation sont envoyées à votre OpenID, telle que https://example.com/adfs. Le serveur d'API Kubernetes utilise cette URL pour découvrir les clés publiques permettant de valider les jetons. L'URL doit utiliser le protocole HTTPS.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.kubectlRedirectURL
Facultatif. Chaîne d'URL. URL de redirection que kubectl utilise pour l'autorisation. Lorsque vous activez OIDC, vous devez spécifier une valeur kubectlRedirectURL.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.proxy
Facultatif. Chaîne d'URL. Serveur proxy à utiliser pour la connexion du cluster à votre fournisseur OIDC, le cas échéant. La valeur doit inclure un nom d'hôte ou une adresse IP, et éventuellement un port, un nom d'utilisateur et un mot de passe. Par exemple : http://user:password@10.10.10.10:8888.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.scopes
Facultatif. Liste d'éléments séparés par une virgule. Niveaux d'accès supplémentaires à envoyer au fournisseur OpenID. Microsoft Azure et Okta nécessitent le niveau d'accès offline_access.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.usernamePrefix
Facultatif. Chaîne. Préfixe ajouté aux revendications de nom d'utilisateur.
Ressource du cluster
Facultatif
Immuable
authentication.oidc.username
Facultatif. Chaîne.
Revendication JWT à utiliser comme nom d'utilisateur. Si aucune valeur n'est spécifiée, la valeur par défaut est sub.
Ressource du cluster
Facultatif
Immuable
bypassPreflightCheck
Facultatif. Valeur booléenne (true|false). Lorsque ce paramètre est défini sur true, les vérifications préliminaires internes sont ignorées lors de l'application de ressources aux clusters existants. La valeur par défaut est false.
Mutabilité : cette valeur peut être modifiée pour les clusters existants à l'aide de la commande bmctl update.
Ressource du cluster
Facultatif
Non immuable
clusterNetwork
Cette section contient les paramètres réseau de votre cluster.
Ressource du cluster
Obligatoire
Non immuable
clusterNetwork.advancedNetworking
Valeur booléenne. Définissez ce champ sur true pour activer les fonctionnalités réseau avancées, telles que l'équilibrage de charge groupé avec BGP ou la passerelle NAT de sortie. Ces deux fonctionnalités utilisent la passerelle réseau pour GDC. Network Gateway pour GDC est le composant clé pour activer les fonctionnalités de mise en réseau avancées dans GKE Enterprise et Google Kubernetes Engine (GKE). L'un des principaux avantages de la passerelle réseau pour GDC est qu'elle peut allouer dynamiquement des adresses IP flottantes à partir d'un ensemble d'adresses que vous spécifiez dans une ressource personnalisée NetworkGatewayGroup.
Valeur booléenne. Définissez ce champ sur false pour désactiver les fonctionnalités d&#Ingress fournies avec GKE sur une solution Bare Metal. Les fonctionnalités Ingress regroupées avec votre cluster ne sont compatibles qu'avec les entrées. Si vous intégrez Istio ou Anthos Service Mesh pour bénéficier des avantages supplémentaires d'un maillage de services entièrement fonctionnel, nous vous recommandons de désactiver les fonctionnalités Ingress regroupées. Ce champ est défini sur true par défaut. Ce champ n'est pas présent dans le fichier de configuration de cluster généré. Vous ne pouvez désactiver les fonctionnalités Ingress regroupées que pour les clusters de version 1.13.0 et ultérieures.
Valeur booléenne. Définissez ce champ sur true pour activer le modèle de réseau du cluster en mode plat. En mode plat, chaque pod possède sa propre adresse IP unique. Les pods peuvent communiquer entre eux directement sans avoir besoin d'une passerelle intermédiaire ni d'une traduction d'adresse réseau (NAT).
flatIPv4 est défini par défaut sur false. Vous ne pouvez activer le mode plat que lors de la création du cluster. Une fois que vous avez activé le mode plat pour votre cluster, vous ne pouvez plus le désactiver.
Ressource du cluster
Facultatif
Immuable
clusterNetwork.forwardMode
Facultatif. Chaîne. Spécifie le mode de mise en réseau pour l'équilibrage de charge Dataplane V2. La traduction d'adresse réseau source (SNAT) est le mode de mise en réseau par défaut. Le mode de retour direct du serveur (DSR) permet de résoudre les problèmes liés à l'équilibrage de charge SNAT. En mode DSR (forwardMode: dsr), le nœud d'équilibreur de charge utilise des options IP pour enregistrer l'adresse source du client.
Le mode de mise en réseau pour l'équilibrage de charge Dataplane V2 ne peut être configuré qu'au moment de la création du cluster.
Obligatoire. Plage d'adresses IPv4 au format de bloc CIDR. Les pods spécifient les plages d'adresses IP à partir desquelles sont alloués les réseaux de pods.
Plage CIDR minimale des pods:masque la valeur /18, qui correspond à une taille de 14 bits (16 384 adresses IP).
Plage CIDR maximale des pods:masque la valeur /8, qui correspond à une taille de 24 bits (16 777 216 adresses IP).
Exemple :
pods:
cidrBlocks:
- 192.168.0.0/16
Ressource du cluster
Requis
Immuable
clusterNetwork.sriovOperator
Facultatif. Valeur booléenne. Définissez ce champ sur true pour activer la mise en réseau SR-IOV pour votre cluster.
Pour en savoir plus sur la configuration et l'utilisation de la mise en réseau SR-IOV, consultez la documentation Configurer la mise en réseau SR-IOV.
Ressource du cluster
Facultatif
Non immuable
clusterNetwork.services.cidrBlocks
Obligatoire. Plage d'adresses IPv4 au format de bloc CIDR. Spécifiez la plage d'adresses IP à partir de laquelle les adresses IP virtuelles des services sont allouées. Les plages ne doivent chevaucher aucun sous-réseau accessible depuis votre réseau. Pour en savoir plus sur l'allocation d'adresses pour Internets privés, consultez la documentation RFC 1918.
À partir de la version 1.15.0 de GKE sur Bare Metal, ce champ est modifiable. Si nécessaire, vous pouvez augmenter le nombre d'adresses IP allouées aux services après avoir créé un cluster. Pour en savoir plus, consultez la section Augmenter la plage du réseau du service.
Vous ne pouvez augmenter que la plage du CIDR des services IPv4. La plage du réseau ne peut pas être réduite, ce qui signifie que le masque (la valeur après "/") ne peut pas être augmenté.
Plage CIDR minimale du service:masque la valeur de /24, qui correspond à une taille de 8 bits (256 adresses).
Plage CIDR maximale du service:masque la valeur de /12, qui correspond à une taille de 20 bits (1 048 576 adresses IP).
Exemple :
services:
cidrBlocks:
- 10.96.0.0/12
Ressource du cluster
Obligatoire
Non immuable
clusterOperations
Cette section contient des informations pour Cloud Logging et Cloud Monitoring.
Ressource du cluster
Obligatoire
Non immuable
clusterOperations.enableApplication
Ce champ n'est plus utilisé et n'a plus aucun effet. La journalisation et la surveillance des applications sont activées dans la ressource personnalisée Stackdriver. Pour en savoir plus sur l'activation de la journalisation et de la surveillance des applications, consultez la section Activer la journalisation et la surveillance des applications.
Ressource du cluster
No-op
Non immuable
clusterOperations.disableCloudAuditLogging
Valeur booléenne. Les journaux d'audit Cloud sont utiles pour analyser les requêtes API suspectes et collecter des statistiques. Les journaux d'audit Cloud sont activés (disableCloudAuditLogging: false) par défaut. Définissez la valeur sur true pour désactiver les journaux d'audit Cloud.
Chaîne. Une région Google Cloud où vous souhaitez stocker les journaux de Logging et les métriques de Monitoring.
Il est recommandé de choisir une région à proximité de votre centre de données sur site. Pour en savoir plus, consultez la section Emplacements mondiaux.
Exemple :
location: us-central1
Ressource du cluster
Requis
Immuable
clusterOperations.projectID
Chaîne. ID du projet Google Cloud dans lequel vous souhaitez afficher les journaux et les métriques.
Ressource du cluster
Requis
Immuable
controlPlane
Cette section contient des informations sur le plan de contrôle et ses composants.
Ressource du cluster
Obligatoire
Non immuable
controlPlane.apiServerCertExtraSANs
Facultatif. Tableau de chaînes (noms de domaine et adresses IP). Un SAN est une fonctionnalité des certificats SSL qui vous permet de définir les noms de domaine et les sous-domaines sur lesquels vous souhaitez qu'un certificat soit valide. Sur un cluster GKE sur Bare Metal, les SAN du certificat du serveur d'API incluent les adresses IP et IP virtuelles des nœuds du plan de contrôle, ainsi que les noms DNS Kubernetes par défaut.
Utilisez ce champ pour ajouter des SAN supplémentaires au certificat du serveur d'API pour le cluster. Les noms de domaine doivent être conformes à la norme RFC 1035.
Pour en savoir plus, consultez Ajouter des domaines au certificat du serveur d'API.
Vous pouvez ajouter ou modifier ce champ à tout moment.
Ressource du cluster
Facultatif
Non immuable
controlPlane.nodePoolSpec
Cette section spécifie les adresses IP du pool de nœuds utilisé par le plan de contrôle et ses composants. La spécification du pool de nœuds du plan de contrôle (comme la spécification du pool de nœuds de l'équilibreur de charge) est spéciale. Cette spécification déclare et contrôle les ressources critiques du cluster. Cette section du fichier de configuration du cluster constitue la source canonique de cette ressource. Ne modifiez pas directement les ressources du pool de nœuds du plan de contrôle de premier niveau. Modifiez plutôt les sections associées dans le fichier de configuration du cluster.
Ressource du cluster
Obligatoire
Non immuable
controlPlane.nodePoolSpec.nodes
Obligatoire. Tableau d'adresses IP. En règle générale, ce tableau contient soit une adresse IP pour une seule machine, soit les adresses IP de trois machines pour un déploiement à haute disponibilité.
Facultatif. Entier (non négatif). Spécifie la quantité maximale de demandes d'extraction d'images pouvant être ajoutées à la file d'attente de traitement pour gérer les pics de requêtes. Dès qu'une extraction commence, une nouvelle requête peut être ajoutée à la file d'attente. La valeur par défaut est 10. Ce champ correspond à l'option de configuration du kubelet registryBurst (v1beta1).
La valeur de registryPullQPS prévaut sur ce paramètre. Par exemple, avec les paramètres par défaut, jusqu'à 10 requêtes simultanées sont autorisées, mais elles doivent être traitées à la fréquence par défaut de cinq requêtes par seconde. Ce comportement d'utilisation intensive n'est utilisé que lorsque la valeur de registryPullQPS est supérieure à 0.
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster. Le paramètre est conservé lors des mises à niveau du cluster. Pour en savoir plus, consultez la section Configurer les paramètres d'extraction d'images du kubelet.
Facultatif. Entier (non négatif). Spécifie la vitesse de traitement des requêtes d'extraction d'images Container Registry pour les requêtes par seconde (RPS).
Lorsque registryPullQPS est défini sur une valeur supérieure à 0, le taux de requêtes est limité au nombre de requêtes par seconde. Si registryPullQPS est défini sur 0, il n'y a pas de restriction sur le taux de requêtes. La valeur par défaut est 5.
Ce champ correspond à l'option de configuration du kubelet registryPullQPS (v1beta1).
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster. Le paramètre est conservé lors des mises à niveau du cluster. Pour en savoir plus, consultez la section Configurer les paramètres d'extraction d'images du kubelet.
Facultatif. Booléen (true|false). Ce champ spécifie si les opérations d'extraction de Container Registry sont traitées en parallèle ou une par une. La valeur par défaut est true. Elle indique que les extractions sont traitées une par une. Lorsque ce paramètre est défini sur false, kubelet extrait des images en parallèle. Ce champ correspond à l'option de configuration du kubelet serializeImagePulls (v1beta1).
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster. Le paramètre est conservé lors des mises à niveau du cluster. Pour en savoir plus, consultez la section Configurer les paramètres d'extraction d'images du kubelet.
Ressource du cluster
Facultatif
Non immuable
gkeConnect
Cette section contient des informations sur le projet Google Cloud que vous souhaitez utiliser pour connecter votre cluster à Google Cloud.
Ressource du cluster
Requis
Immuable
gkeConnect.projectID
Obligatoire : chaîne. ID du projet Google Cloud que vous souhaitez utiliser pour connecter votre cluster à Google Cloud. Ce projet est également appelé projet hôte du parc.
Cette valeur ne peut pas être modifiée pour les clusters existants.
Ressource du cluster
Requis
Immuable
gkeConnect.location
Facultatif. Chaîne. Valeur par défaut : global
L'appartenance au parc de vos clusters est gérée par le service de parc (gkehub.googleapis.com) et le service Connect (gkeconnect.googleapis.com). L'appartenance au parc peut être globale ou régionale. Vous pouvez éventuellement utiliser gkeConnect.location pour spécifier la région Google Cloud dans laquelle les services de parc et Connect s'exécutent, afin que le trafic soit limité à votre région.
Pour obtenir la liste des régions compatibles, consultez la page Régions acceptées pour l'API GKE On-Prem.
Si aucune valeur n'est spécifiée, les instances globales des services sont utilisées.
Veuillez noter les points suivants :
Les clusters créés dans une version antérieure à 1.28 sont gérés par les services mondiaux de parc et de connexion.
Les clusters créés à l'aide des clients API GKE On-Prem, tels que la console Google Cloud, Google Cloud CLI ou Terraform, utilisent la même région que celle que vous spécifiez pour l'API GKE On-Prem.
Pour les nouveaux clusters, si vous incluez ce champ, la région que vous spécifiez doit être identique à la région configurée dans gkeOnPremAPI.location. Si les régions ne sont pas identiques, la création du cluster échoue.
Cette valeur ne peut pas être modifiée pour les clusters existants.
Ressource du cluster
Facultatif
Immuable
gkeOnPremAPI
À partir de la version 1.16, si l'API GKE On-Prem est activée dans votre projet Google Cloud, tous les clusters du projet sont enregistrés automatiquement dans l'API GKE On-Prem dans la région configurée dans clusterOperations.location.
Si vous souhaitez enregistrer tous les clusters du projet dans l'API GKE On-Prem, suivez la procédure décrite dans 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 sur false.
Si vous ne souhaitez enregistrer aucun cluster dans le projet, désactivez gkeonprem.googleapis.com (nom du service de l'API GKE On-Prem) dans le projet. Pour obtenir des instructions, consultez la section Désactiver des services.
L'enregistrement de votre cluster d'administrateur ou d'utilisateur dans l'API GKE On-Prem vous permet d'utiliser des outils standards (console Google Cloud, Google Cloud CLI ou
Terraform) pour afficher les détails du cluster et gérer son cycle de vie. Par exemple, vous pouvez exécuter les commandes de gcloud CLI pour
obtenir des informations sur votre cluster.
L'API GKE On-Prem stocke les métadonnées d'état du cluster dans Google Cloud.
Ces métadonnées permettent à l'API de gérer le cycle de vie du cluster. Les outils standards utilisent l'API GKE On-Prem et sont collectivement appelés clients de l'API GKE On-Prem.
Si vous définissez gkeOnPremAPI.enabled sur true, avant de créer ou de mettre à jour le cluster à l'aide de bmctl, veillez à suivre la procédure décrite dans la section Avant de commencer pour activer et initialiser l'API GKE On-Prem.
Une fois que vous avez ajouté cette section et créé ou mis à jour le cluster, la mise à jour échoue si vous supprimez la section et mettez à jour le cluster.
Si vous préférez créer le cluster à l'aide d'un outil standard au lieu de bmctl, consultez les pages suivantes:
Lorsque vous créez un cluster à l'aide d'un outil standard, le cluster est automatiquement enregistré dans l'API GKE On-Prem.
Ressource du cluster
Facultatif
gkeOnPremAPI.enabled
Par défaut, le cluster est enregistré dans l'API GKE On-Prem si celle-ci 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 annuler l'enregistrement du cluster, apportez la modification suivante, puis mettez-le à jour:
gkeOnPremAPI:
enabled: false
Ressource du cluster
Obligatoire
Non immuable
gkeOnPremAPI.location
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 compatibles. Doit être une chaîne non vide si gkeOnPremAPI.enabled est défini sur true. Si gkeOnPremAPI.enabled correspond à false, n'incluez pas ce champ.
Si cette section n'est pas incluse dans votre fichier de configuration, ce champ est défini sur clusterOperations.location.
Ressource du cluster
Facultatif
Immuable
kubevirt.useEmulation (obsolète)
Obsolète. À partir de la version 1.11.2, vous pouvez activer ou désactiver l'environnement d'exécution de VM sur GDC en ne mettant à jour que la ressource personnalisée VMRuntime.
Valeur booléenne. Détermine si l'émulation logicielle est utilisée ou non pour exécuter des machines virtuelles. Si le nœud est compatible avec la virtualisation matérielle, définissez useEmulation sur false pour améliorer les performances. Si la virtualisation matérielle n'est pas compatible ou si vous n'êtes pas sûr, définissez-la sur true.
Ressource du cluster
Facultatif
Non immuable
loadBalancer
Cette section contient les paramètres d'équilibrage de charge du cluster.
Ressource du cluster
Obligatoire
Non immuable
loadBalancer.addressPools
Objet. Nom et tableau des adresses IP pour le pool de l'équilibreur de charge de votre cluster. La configuration du pool d'adresses n'est valide que pour le mode LB bundled dans les clusters non administrateur. Vous pouvez ajouter de nouveaux pools d'adresses à tout moment, mais vous ne pouvez pas supprimer les pools d'adresses existants.
Vous pouvez modifier un pool d'adresses existant pour ne modifier que les champs avoidBuggyIPs et manualAssign.
Ressource du cluster
Facultatif
Immuable
loadBalancer.addressPools.addresses
Tableau de plages d'adresses IP. Spécifiez une liste de plages d'adresses IP sans chevauchement pour l'équilibreur de charge du plan de données. Toutes les adresses doivent se trouver dans le même sous-réseau que les nœuds de l'équilibreur de charge.
Chaîne. Nom que vous choisissez pour le pool de l'équilibreur de charge de votre cluster.
Ressource du cluster
Requis
Immuable
loadBalancer.addressPools.avoidBuggyIPs
Facultatif. Valeur booléenne (true | false). Si la valeur est true, le pool omet les adresses IP se terminant par .0 et .255.
Certains matériels réseau suppriment le trafic vers ces adresses spéciales. Vous pouvez omettre ce champ, dont la valeur par défaut est false.
Ressource du cluster
Facultatif
Non immuable
loadBalancer.addressPools.manualAssign
Facultatif. Valeur booléenne (true | false). Si la valeur est true, les adresses de ce pool ne sont pas automatiquement attribuées aux services Kubernetes. Si la valeur est true, une adresse IP de ce pool ne va être utilisée que si elle est spécifiée explicitement par un service. Vous pouvez omettre ce champ, dont la valeur par défaut est false.
Ressource du cluster
Facultatif
Non immuable
loadBalancer.mode
Obligatoire. Chaîne. Spécifie le mode d'équilibrage de charge. En mode bundled, GKE sur Bare Metal installe un équilibreur de charge sur les nœuds de l'équilibreur de charge lors de la création du cluster. En mode manual, le cluster repose sur un équilibreur de charge externe configuré manuellement. Pour plus d'informations, consultez la section Présentation des équilibreurs de charge.
Valeurs autorisées: bundled | manual
Ressource du cluster
Requis
Immuable
loadBalancer.type
Facultatif. Chaîne. Spécifie le type d'équilibrage de charge groupé utilisé, couche 2 ou protocole BGP (Border Gateway Protocol). Si vous utilisez l'équilibrage de charge groupé standard, définissez type sur layer2. Si vous utilisez l'équilibrage de charge groupé avec BGP, définissez type sur bgp. Si vous ne définissez pas type, la valeur par défaut est layer2.
Valeurs autorisées: layer2 | bgp
Ressource du cluster
Facultatif
Immuable
loadBalancer.nodePoolSpec
Facultatif. Utilisez cette section pour configurer un pool de nœuds d'équilibreur de charge. Les nœuds que vous spécifiez font partie du cluster Kubernetes et exécutent des charges de travail et des équilibreurs de charge standards. Si vous ne spécifiez pas de pool de nœuds, les nœuds du plan de contrôle sont utilisés pour l'équilibrage de charge. Cette section ne s'applique que lorsque le mode d'équilibrage de charge est défini sur bundled.
Si vous souhaitez empêcher l'exécution des charges de travail sur un nœud du pool de nœuds de l'équilibreur de charge, ajoutez le rejet suivant au nœud:
node-role.kubernetes.io/load-balancer:NoSchedule
GKE sur Bare Metal ajoute des tolérances pour ce rejet aux pods requis pour l'équilibrage de charge.
Ressource du cluster
Facultatif
Non immuable
loadBalancer.nodePoolSpec.nodes
Cette section contient un tableau d'adresses IP pour les nœuds de votre pool d'équilibreur de charge.
Ressource du cluster
Facultatif
Non immuable
loadBalancer.nodePoolSpec.nodes.address
Facultatif. Chaîne (adresse IPv4). Adresse IP d'un nœud. Bien que les nœuds du pool de nœuds de l'équilibreur de charge puissent exécuter des charges de travail, ils sont distincts des nœuds des pools de nœuds de calcul. Vous ne pouvez pas inclure un nœud de cluster donné dans plusieurs pools de nœuds. Le chevauchement des adresses IP des nœuds bloque la création de clusters et d'autres opérations sur les clusters.
Ressource du cluster
Facultatif
Non immuable
loadBalancer.nodePoolSpec.kubeletConfig
Facultatif.
Cette section contient des champs qui configurent kubelet sur tous les nœuds du pool de nœuds du plan de contrôle.
Facultatif. Entier (non négatif). Spécifie le nombre maximal de requêtes d'extraction d'image pouvant être ajoutées à la file d'attente de traitement pour gérer les pics de requêtes. Dès qu'une extraction commence, une nouvelle requête peut être ajoutée à la file d'attente. La valeur par défaut est 10. Ce champ correspond à l'option de configuration du kubelet registryBurst (v1beta1).
La valeur de registryPullQPS prévaut sur ce paramètre. Par exemple, avec les paramètres par défaut, jusqu'à 10 requêtes simultanées sont autorisées, mais elles doivent être traitées à la fréquence par défaut de cinq requêtes par seconde. Ce comportement d'utilisation intensive n'est utilisé que lorsque la valeur de registryPullQPS est supérieure à 0.
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster. Le paramètre est conservé lors des mises à niveau du cluster. Pour en savoir plus, consultez la section Configurer les paramètres d'extraction d'images du kubelet.
Facultatif. Entier (non négatif). Spécifie la vitesse de traitement des requêtes d'extraction d'images Container Registry pour les requêtes par seconde (RPS).
Lorsque registryPullQPS est défini sur une valeur supérieure à 0, le taux de requêtes est limité au nombre de requêtes par seconde. Si registryPullQPS est défini sur 0, il n'y a pas de restriction sur le taux de requêtes. La valeur par défaut est 5.
Ce champ correspond à l'option de configuration du kubelet registryPullQPS (v1beta1).
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster. Le paramètre est conservé lors des mises à niveau du cluster. Pour en savoir plus, consultez la section Configurer les paramètres d'extraction d'images du kubelet.
Facultatif. Booléen (true|false). Ce champ spécifie si les opérations d'extraction de Container Registry sont traitées en parallèle ou une par une. La valeur par défaut est true. Elle indique que les extractions sont traitées une par une. Lorsque ce paramètre est défini sur false, kubelet extrait des images en parallèle. Ce champ correspond à l'option de configuration du kubelet serializeImagePulls (v1beta1).
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster. Le paramètre est conservé lors des mises à niveau du cluster. Pour en savoir plus, consultez la section Configurer les paramètres d'extraction d'images du kubelet.
Ressource du cluster
Facultatif
Non immuable
loadBalancer.ports.controlPlaneLBPort
Nombre. Port de destination utilisé pour le trafic envoyé au plan de contrôle Kubernetes (serveurs d'API Kubernetes).
Ressource du cluster
Requis
Immuable
loadBalancer.vips.controlPlaneVIP
Obligatoire. Spécifie l'adresse IP virtuelle à connecter au serveur d'API Kubernetes. Cette adresse ne doit pas être comprise dans la plage d'adresses IP utilisées pour les pools d'adresses de l'équilibreur de charge, loadBalancer.addressPools.addresses.
Ressource du cluster
Requis
Immuable
loadBalancer.vips.ingressVIP
Facultatif. Chaîne (adresse IPv4). Adresse IP que vous avez choisie pour configurer l'équilibreur de charge pour le trafic entrant.
Ressource du cluster
Facultatif
Immuable
loadBalancer.localASN
Facultatif. Chaîne. Spécifie le numéro ASN (Autonomous System Number) du cluster en cours de création. Ce champ est utilisé lors de la configuration de la solution d'équilibrage de charge groupé qui utilise le protocole BGP (Border Gateway Protocol).
Pour en savoir plus, consultez la section Configurer des équilibreurs de charge groupés avec BGP.
Ressource du cluster
Facultatif
Non immuable
loadBalancer.bgpPeers
Facultatif. Objet (liste de mappages). Cette section spécifie un ou plusieurs pairs BGP (Border Gateway Protocol) de votre réseau local (externe au cluster). Vous spécifiez des pairs BGP lorsque vous configurez la partie d'équilibrage de charge du plan de contrôle dans la solution d'équilibrage de charge groupé qui utilise BGP. Chaque pair est spécifié à l'aide d'un mappage composé d'une adresse IP, d'un numéro ASN (autonomous system number) et, éventuellement, d'une liste d'une ou plusieurs adresses IP pour les nœuds du plan de contrôle. La configuration d'appairage BGP pour l'équilibrage de charge du plan de contrôle ne peut pas être mise à jour une fois le cluster créé.
Facultatif. Chaîne. Numéro de système autonome (numéro ASN) du réseau qui contient l'appareil pair externe. Spécifiez un numéro ASN pour chaque pair BGP configuré pour l'équilibrage de charge du plan de contrôle, lorsque vous configurez la solution d'équilibrage de charge groupé qui utilise BGP.
Pour en savoir plus, consultez la section Configurer des équilibreurs de charge groupés avec BGP.
Ressource du cluster
Facultatif
Non immuable
loadBalancer.bgpPeers.controlPlaneNodes
Facultatif. Tableau d'adresses IP (IPv4). Une ou plusieurs adresses IP pour les nœuds du plan de contrôle qui se connectent au pair BGP externe, lorsque vous configurez la solution d'équilibrage de charge groupé qui utilise BGP. Si vous ne spécifiez aucun nœud de plan de contrôle, tous les nœuds du plan de contrôle se connectent au pair externe. Si vous spécifiez une ou plusieurs adresses IP, seuls les nœuds spécifiés participent aux sessions d'appairage.
Pour en savoir plus, consultez la section Configurer des équilibreurs de charge groupés avec BGP.
Ressource du cluster
Facultatif
Non immuable
maintenanceBlocks.cidrBlocks
Facultatif. Adresse IPv4 unique ou plage d'adresses IPv4. Indiquez les adresses IP des machines de nœud que vous souhaitez passer en mode de maintenance. Pour plus d'informations, consultez la section Passer des nœuds en mode maintenance.
Exemple :
maintenanceBlocks:
cidrBlocks:
- 192.168.1.200 # Single machine
- 192.168.1.100-192.168.1.109 # Ten machines
Ressource du cluster
Facultatif
Non immuable
nodeAccess.loginUser
Facultatif. Chaîne. Spécifiez le nom d'utilisateur non racine que vous souhaitez utiliser pour accéder aux machines de nœud de votre cluster (fonctionnalité SUDO sans mot de passe). Votre clé SSH, sshPrivateKeyPath, doit fonctionner pour l'utilisateur spécifié. Les opérations de création et de mise à jour du cluster vérifient que les machines de nœud sont accessibles avec l'utilisateur et la clé SSH spécifiés.
Ressource du cluster
Facultatif
Non immuable
osEnvironmentConfig.addPackageRepo
Facultatif. Booléen (true | false). Indique si vous devez utiliser votre propre serveur de dépôt de packages à la place du dépôt Docker apt par défaut. Pour utiliser votre propre dépôt de packages, définissez addPackageRepo sur false. Utilisez cette fonctionnalité pour ignorer l'ajout de dépôts de packages à chaque machine Bare Metal de votre déploiement. Pour en savoir plus, consultez la section Utiliser un serveur de dépôt de packages privé.
Ressource du cluster
Facultatif
Immuable
nodeConfig
Cette section contient les paramètres de configuration des nœuds de cluster.
Ressource du cluster
Facultatif
Mutable (mise à niveau uniquement)
nodeConfig.containerRuntime (obsolète)
Obsolète. Depuis la version 1.13.0, GKE sur Bare Metal n'accepte containerd que comme environnement d'exécution de conteneurs. Le champ containerRuntime est obsolète et a été supprimé du fichier de configuration de cluster généré. Pour GKE sur une solution Bare Metal 1.13.0 ou version ultérieure, si votre fichier de configuration de cluster contient ce champ, la valeur doit être containerd.
Ressource du cluster
Facultatif
Mutable (mise à niveau uniquement)
nodeConfig.podDensity
Cette section spécifie la configuration de densité des pods.
Ressource du cluster
Facultatif
Immuable
nodeConfig.podDensity.maxPodsPerNode
Facultatif. Entier. Spécifie le nombre maximal de pods pouvant être exécutés sur un même nœud. Pour les clusters autogérés, les valeurs autorisées pour maxPodsPerNode sont comprises entre 32 et 250 pour les clusters à haute disponibilité, et entre 64 et 250 pour les clusters non haute disponibilité. Pour les clusters d'utilisateur, les valeurs autorisées pour maxPodsPerNode sont comprises entre 32 et 250. Sans valeur spécifiée, la valeur par défaut est 110. Une fois le cluster créé, cette valeur ne peut plus être mise à jour.
Kubernetes attribue un bloc CIDR (Classless Inter-Domain Routing) à chaque nœud afin que chaque pod puisse avoir une adresse IP unique. La taille du bloc CIDR correspond au nombre maximal de pods par nœud.
Pour en savoir plus sur la définition du nombre maximal de pods par nœud, consultez la page Mise en réseau de pods.
Ressource du cluster
Facultatif
Immuable
nodePoolUpgradeStrategy
Facultatif. Cette section contient les paramètres permettant de configurer la stratégie de mise à niveau des pools de nœuds de calcul de votre cluster. Pour en savoir plus, consultez la section Mises à niveau parallèles.
Ressource du cluster
Facultatif
Non immuable
nodePoolUpgradeStrategy.concurrentNodePools
Facultatif. Booléen (0 ou 1). Valeur par défaut: 1.
Ce champ indique si tous les pools de nœuds de calcul d'un cluster doivent être mis à niveau simultanément. Par défaut (1), les mises à niveau sont séquentielles, l'une après l'autre. Lorsque vous définissez concurrentNodePools sur 0, chaque pool de nœuds de calcul du cluster est mis à niveau en parallèle.
Les nœuds de chaque mise à niveau du pool de nœuds de calcul doivent respecter la stratégie de mise à niveau indiquée dans la spécification de pool de nœuds correspondante.
Facultatif. Booléen (true ou false). Valeur par défaut : false. Ce champ indique si une mise à niveau active du cluster doit être suspendue ou réactivée. Cette fonctionnalité n'est disponible que pour les clusters comportant tous les nœuds de plan de contrôle à la version mineure 1.28 ou ultérieure.
Cette section contient des informations de configuration pour les vérifications d'état périodiques. Dans la ressource Cluster, le seul paramètre disponible pour les vérifications d'état périodiques est le champ enable. Pour en savoir plus, consultez la page Vérifications d'état périodiques.
Ressource du cluster
Facultatif
Non immuable
periodicHealthCheck.enable
Facultatif. Booléen (true|false). Activez ou désactivez les vérifications d'état périodiques pour votre cluster. Les vérifications d'état périodiques sont activées par défaut sur tous les clusters. Vous pouvez désactiver les vérifications d'état périodiques pour un cluster en définissant le champ periodicHealthCheck.enable sur false.
Pour en savoir plus, consultez la section Désactiver les vérifications d'état périodiques.
Ressource du cluster
Facultatif
Non immuable
profile
Facultatif. Chaîne. Lorsque profile est défini sur edge pour un cluster autonome, cela réduit la consommation de ressources du cluster. Le profil de périphérie n'est disponible que pour les clusters autonomes.
Le profil de périphérie réduit les besoins en ressources système. Il est recommandé pour les appareils de périphérie présentant des contraintes de ressources restrictives.
Pour connaître les exigences matérielles associées au profil de périphérie, consultez la section Ressources nécessaires pour les clusters autonomes utilisant le profil de périphérie.
Ressource du cluster
Facultatif
Immuable
proxy
Si votre réseau est protégé par un serveur proxy, remplissez cette section.
Sinon, supprimez cette section.
Ressource du cluster
Facultatif
Non immuable
proxy.noProxy
Chaîne. 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 GKE sur Bare Metal envoie une requête à l'une de ces adresses, ou à l'un de ces hôtes ou domaines, celle-ci est envoyée directement.
Ressource du cluster
Facultatif
Immuable
proxy.url
Chaîne. 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.
Facultatif. Booléen (true|false). Activez ou désactivez seccomp à l'échelle du cluster. Lorsque ce champ est désactivé, les conteneurs sans profil seccomp dans le fichier de configuration du cluster s'exécutent de façon non confinée. Lorsque ce champ est activé, ces mêmes conteneurs sont sécurisés à l'aide du profil seccomp par défaut de leur environnement d'exécution. Cette fonctionnalité est activée par défaut.
Après la création du cluster, ce champ ne peut être activé ou désactivé que lors de la mise à niveau.
Pour en savoir plus, consultez la section Limiter les conteneurs à l'aide de seccomp.
Ressource du cluster
Facultatif
Mutable (mise à niveau uniquement)
clusterSecurity.enableRootlessContainers
Facultatif. Booléen (true|false). Active ou désactive les conteneurs système Bare Metal sans racine. Lorsque ce champ est activé, les conteneurs du système Bare Metal s'exécutent en tant qu'utilisateur non racine, avec un ID utilisateur compris entre 2 000 et 5 000. Lorsque ce champ est désactivé, les conteneurs du système Bare Metal s'exécutent en tant qu'utilisateur racine. Par défaut, cette fonctionnalité est activée. Nous vous déconseillons vivement de désactiver cette fonctionnalité, car l'exécution de conteneurs en tant qu'utilisateur racine entraîne un risque de sécurité. Après la création du cluster, ce champ ne peut être activé ou désactivé que lors de la mise à niveau. Pour en savoir plus, consultez la section Ne pas exécuter de conteneurs en tant qu'utilisateur racine.
Ressource du cluster
Facultatif
Mutable (mise à niveau uniquement)
clusterSecurity.authorization
Facultatif. L'autorisation configure l'accès des utilisateurs au cluster.
Ressource du cluster
Facultatif
Non immuable
clusterSecurity.authorization.clusterAdmin
Facultatif. Spécifie l'administrateur de cluster pour ce cluster.
Facultatif. Le champ gcpAccounts spécifie une liste de comptes disposant du rôle clusterrole/cluster-admin de contrôle des accès basé sur les rôles Kubernetes (RBAC). Les comptes dotés de ce rôle disposent d'un accès complet à toutes les ressources du cluster dans tous les espaces de noms. Ce champ configure également les stratégies RBAC qui permettent aux comptes spécifiés d'utiliser la passerelle de connexion pour exécuter des commandes kubectl sur le cluster. Cette approche est pratique si vous devez gérer plusieurs clusters, en particulier dans un environnement hybride comprenant des clusters GKE et sur site.
Ce champ accepte un tableau de noms de comptes. Les comptes utilisateur et les comptes de service sont acceptés. Vous spécifiez l'adresse e-mail du compte Google Cloud des utilisateurs. Pour les comptes de service, spécifiez les adresses e-mail au format suivant : SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com.
Exemple :
Lorsque vous mettez à jour un cluster pour ajouter un compte, veillez à inclure tous les comptes dans la liste (existants et nouveaux), car la commande de mise à jour remplace la liste par ce que vous spécifiez dans la mise à jour.
Ce champ ne s'applique qu'aux clusters pouvant exécuter des charges de travail. Par exemple, vous ne pouvez pas spécifier gcpAccounts pour les clusters d'administrateur.
Ressource du cluster
Facultatif
Non immuable
clusterSecurity.startUIDRangeRootlessContainers
Facultatif. Entier. Valeur par défaut : 2000 Les conteneurs système dans GKE sur une solution Bare Metal permettent d'installer et de gérer des clusters. Les ID utilisateur (UID) et les ID de groupe (GID) utilisés par ces conteneurs peuvent être contrôlés par le champ startUIDRangeRootlessContainers dans la spécification du cluster. Les conteneurs système utilisent les UID et les GID compris entre startUIDRangeRootlessContainers et startUIDRangeRootlessContainers + 2 999, ce qui donne une plage de 2000 à 4999 par défaut. Lorsque vous mettez à jour startUIDRangeRootlessContainers, sélectionnez une valeur qui garantit que les espaces UID et GID utilisés par les conteneurs système ne chevauchent pas ceux attribués aux charges de travail de l'utilisateur. La valeur startUIDRangeRootlessContainers ne peut être modifiée que pendant les mises à niveau.
Obligatoire. Chaîne. Utilisez le champ path pour spécifier le chemin d'accès de la machine hôte dans laquelle les disques installés peuvent être détectés. Un volume persistant (PersistentVolume ou PV) local est créé pour chaque installation. Le chemin par défaut est /mnt/localpv-share. Pour obtenir des instructions sur la configuration de vos installations de nœuds, consultez la section Configurer des installations de nœuds LVP.
Ressource du cluster
Requis
Immuable
storage
Cette section contient les paramètres de stockage des clusters.
Ressource du cluster
Requis
Immuable
storage.lvpNodeMounts
Cette section spécifie la configuration (chemin d'accès) des volumes persistants locaux reposant sur des disques installés. Vous devez formater et installer ces disques vous-même. Vous pouvez effectuer cette tâche avant ou après la création du cluster. Pour plus d'informations, consultez la section Installations de nœuds LVP.
Ressource du cluster
Requis
Immuable
storage.lvpShare
Cette section spécifie la configuration des volumes persistants locaux reposant sur des sous-répertoires d'un système de fichiers partagé. Ces sous-répertoires sont générés automatiquement lors de la création du cluster.
Pour en savoir plus, consultez la section Partage LVP.
Ressource du cluster
Requis
Immuable
storage.lvpShare.path
Obligatoire. Chaîne. Utilisez le champ path pour spécifier le chemin d'accès à la machine hôte dans laquelle les sous-répertoires peuvent être créés. Un volume persistant (PersistentVolume ou PV) local est créé pour chaque sous-répertoire. Pour obtenir des instructions sur la configuration de votre partage LVP, consultez la page Configurer un partage LVP.
Ressource du cluster
Requis
Immuable
storage.lvpShare.numPVUnderSharedPath
Obligatoire. Chaîne. Spécifiez le nombre de sous-répertoires à créer sous lvpShare.path. La valeur par défaut est 5. Pour obtenir des instructions sur la configuration de votre partage LVP, consultez la page Configurer un partage LVP.
Ressource du cluster
Requis
Immuable
storage.lvpShare.storageClassName
Obligatoire. Chaîne. Spécifiez la classe de stockage StorageClass à utiliser pour créer des volumes persistants. La StorageClass est créée lors de la création du cluster. La valeur par défaut est local-shared. Pour obtenir des instructions sur la configuration de votre partage LVP, consultez la page Configurer un partage LVP.
Ressource du cluster
Facultatif
Immuable
type
Obligatoire. Chaîne. Spécifie le type de cluster. Le modèle de déploiement standard se compose d'un seul cluster d'administrateur et d'un ou plusieurs clusters d'utilisateur, qui sont gérés par le cluster d'administrateur.
GKE sur Bare Metal est compatible avec les types de clusters suivants:
Administrateur : cluster permettant de gérer les clusters d'utilisateur.
Utilisateur : cluster utilisé pour exécuter des charges de travail.
Hybride : cluster unique pour les administrateurs et les charges de travail, pouvant également gérer les clusters d'utilisateur.
Autonome : cluster unique capable de s'administrer lui-même et d'exécuter des charges de travail, mais il ne peut pas créer ni gérer d'autres clusters d'utilisateur.
Le type de cluster est spécifié lors de la création du cluster et ne peut pas être modifié pour les mises à jour ou les mises à niveau. Pour en savoir plus sur la création d'un cluster, consultez la section Créer des clusters: présentation.
Valeurs autorisées: admin | user | hybrid | standalone
Cette valeur ne peut pas être modifiée pour les clusters existants.
Ressource du cluster
Requis
Immuable
name
Obligatoire. Chaîne. En règle générale, le nom de l'espace de noms utilise un modèle cluster-CLUSTER_NAME, mais le préfixe cluster- n'est pas strictement requis depuis la version 1.7.2 de GKE sur Bare Metal.
Cette valeur ne peut pas être modifiée pour les clusters existants.
Ressource d'espace de noms
Obligatoire
Immuable
clusterName
Chaîne. Obligatoire. Nom du cluster auquel vous ajoutez le pool de nœuds. Créez la ressource de pool de nœuds dans le même espace de noms que le cluster associé et référencez le nom du cluster dans ce champ. Pour en savoir plus, consultez la section Ajouter et supprimer des pools de nœuds dans un cluster.
Facultatif. Entier (non négatif). Spécifie la quantité maximale de demandes d'extraction d'images pouvant être ajoutées à la file d'attente de traitement pour gérer les pics de requêtes. Dès qu'une extraction commence, une nouvelle requête peut être ajoutée à la file d'attente. La valeur par défaut est 10. Ce champ correspond à l'option de configuration du kubelet registryBurst (v1beta1).
La valeur de registryPullQPS prévaut sur ce paramètre. Par exemple, avec les paramètres par défaut, jusqu'à 10 requêtes simultanées sont autorisées, mais elles doivent être traitées à la fréquence par défaut de cinq requêtes par seconde. Ce comportement d'utilisation intensive n'est utilisé que lorsque la valeur de registryPullQPS est supérieure à 0.
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster. Le paramètre est conservé lors des mises à niveau du cluster. Pour en savoir plus, consultez la section Configurer les paramètres d'extraction d'images du kubelet.
Ressource NodePool
Facultatif
Non immuable
kubeletConfig.registryPullQPS
Facultatif. Entier (non négatif). Spécifie la vitesse de traitement des requêtes d'extraction d'images Container Registry pour les requêtes par seconde (RPS).
Lorsque registryPullQPS est défini sur une valeur supérieure à 0, le taux de requêtes est limité au nombre de requêtes par seconde. Si registryPullQPS est défini sur 0, il n'y a pas de restriction sur le taux de requêtes. La valeur par défaut est 5.
Ce champ correspond à l'option de configuration du kubelet registryPullQPS (v1beta1).
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster. Le paramètre est conservé lors des mises à niveau du cluster. Pour en savoir plus, consultez la section Configurer les paramètres d'extraction d'images du kubelet.
Ressource NodePool
Facultatif
Non immuable
kubeletConfig.serializeImagePulls
Facultatif. Booléen (true|false). Ce champ spécifie si les opérations d'extraction de Container Registry sont traitées en parallèle ou une par une. La valeur par défaut est true. Elle indique que les extractions sont traitées une par une. Lorsque ce paramètre est défini sur false, kubelet extrait des images en parallèle. Ce champ correspond à l'option de configuration du kubelet serializeImagePulls (v1beta1).
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster. Le paramètre est conservé lors des mises à niveau du cluster. Pour en savoir plus, consultez la section Configurer les paramètres d'extraction d'images du kubelet.
Ressource NodePool
Facultatif
Non immuable
taints
Facultatif. Objet. Un rejet de nœud vous permet de marquer un nœud afin que le programmeur l'ignore ou empêche son utilisation pour certains pods. Un rejet est constitué d'une paire clé/valeur et d'un effet associé. Les valeurs key et value sont des chaînes permettant d'identifier le rejet, et la valeur effect spécifie la manière dont les pods sont gérés pour le nœud. L'objet taints peut avoir plusieurs rejets.
Le champ effect peut prendre l'une des valeurs suivantes :
NoSchedule : aucun pod ne peut être planifié sur le nœud à moins qu'il n'ait une tolérance correspondante.
PreferNoSchedule : le système évite de placer un pod qui ne tolère pas le rejet sur le nœud, mais ce n'est pas obligatoire.
NoExecute : les pods qui ne tolèrent pas le rejet sont immédiatement évincés. Les pods qui tolèrent le rejet ne sont jamais évincés.
Pour GKE sur Bare Metal, les rejets sont rapprochés des nœuds du pool de nœuds, sauf si l'annotation baremetal.cluster.gke.io/label-taint-no-sync est appliquée au cluster. Pour plus d'informations sur les rejets, consultez la section Rejets et tolérances.
Exemple :
taints:
- key: status
value: testpool
effect: NoSchedule
Ressource NodePool
Facultatif
Non immuable
labels
Facultatif. Mappage (paires clé/valeur).
Les libellés sont rapprochés des nœuds du pool de nœuds, sauf si l'annotation baremetal.cluster.gke.io/label-taint-no-sync est appliquée au cluster. Pour en savoir plus sur les libellés, consultez la page Libellés et sélecteurs.
Ressource NodePool
Facultatif
Non immuable
upgradeStrategy
Facultatif. Cette section contient les paramètres permettant de configurer la stratégie de mise à niveau des nœuds d'un pool de nœuds de calcul. Pour en savoir plus, consultez la section Mises à niveau parallèles.
Remarque: N'ajoutez pas cette section aux pools de nœuds du plan de contrôle ou de l'équilibreur de charge.
Ressource NodePool
Facultatif
Non immuable
upgradeStrategy.parallelUpgrade
Facultatif. Cette section contient les paramètres permettant de configurer les mises à niveau parallèles des nœuds pour un pool de nœuds de calcul. Lors d'une mise à niveau de cluster par défaut classique, chaque nœud de cluster est mis à niveau de manière séquentielle, l'un après l'autre. Vous pouvez configurer des pools de nœuds de calcul de sorte que plusieurs nœuds soient mis à niveau en parallèle lorsque vous mettez à niveau votre cluster. La mise à niveau des nœuds en parallèle accélère considérablement les mises à niveau des clusters, en particulier pour les clusters comportant des centaines de nœuds.
Pour un pool de nœuds de calcul, vous pouvez spécifier le nombre de nœuds à mettre à niveau simultanément et définir un seuil minimal pour le nombre de nœuds pouvant exécuter des charges de travail tout au long du processus de mise à niveau.
Facultatif. Entier (positif). Valeur par défaut : 1 Max. : 15.
Par défaut (1), les nœuds sont mis à niveau séquentiellement, l'un après l'autre. Lorsque vous définissez concurrentNodes sur un nombre supérieur à 1, ce champ indique le nombre de nœuds à mettre à niveau en parallèle. Notez les contraintes suivantes pour concurrentNodes:
La valeur ne peut pas dépasser soit 50 % du nombre de nœuds dans le pool de nœuds, soit le nombre fixe 15. Par exemple, si votre pool de nœuds comporte 20 nœuds, vous ne pouvez pas spécifier de valeur supérieure à 10. Si votre pool de nœuds comporte 100 nœuds, la valeur maximale que vous pouvez spécifier est 15.
Lorsque vous utilisez ce champ avec le champ minimumAvailableNodes, leurs valeurs combinées ne peuvent pas dépasser le nombre total de nœuds dans le pool de nœuds. Par exemple, si votre pool de nœuds comporte 20 nœuds et que minimumAvailableNodes est défini sur 18, concurrentNodes ne peut pas dépasser 2.
Les mises à niveau parallèles ne respectent pas le budget d'interruption de pod (PDB).
Si vos charges de travail sont sensibles aux interruptions, nous vous recommandons de spécifier minimumAvailableNodes afin qu'un certain nombre de nœuds restent disponibles pour exécuter des charges de travail tout au long du processus de mise à niveau. Pour en savoir plus, consultez la section Mises à niveau parallèles.
Facultatif. Entier (non négatif). Valeur par défaut: dépend de concurrentNodes. Pour en savoir plus sur les valeurs par défaut de minimumAvailableNodes, consultez la section Valeurs par défaut de la mise à niveau en parallèle. Le champ minimumAvailableNodes vous permet de spécifier la quantité de nœuds du pool qui doivent rester disponibles tout au long du processus de mise à niveau. Un nœud est considéré comme indisponible lorsqu'il est en cours de mise à niveau. Un nœud est également considéré comme indisponible lorsque l'une des conditions suivantes est remplie:
Le nœud est en mode de maintenance
Rapprochement du nœud
Le nœud est bloqué en cours de mise à niveau
Lorsque vous utilisez ce champ avec le champ concurrentNodes, leurs valeurs combinées ne peuvent pas dépasser le nombre total de nœuds dans le pool de nœuds. Par exemple, si votre pool de nœuds comporte 20 nœuds et que concurrentNodes est défini sur 10, minimumAvailableNodes ne peut pas dépasser 10.
Une valeur élevée pour minimumAvailableNodes minimise les problèmes de capacité lors de la planification des pods et contribue donc à protéger les charges de travail lors d'une mise à niveau du cluster. Cependant, une valeur élevée pour minimumAvailableNodes augmente le risque qu'une mise à niveau se bloque dans l'attente de la disponibilité des nœuds. Pour en savoir plus, consultez la section Mises à niveau parallèles.
Ressource NodePool
Facultatif
Non immuable
registryMirrors
Facultatif. Utilisez cette section pour spécifier un miroir de registre à utiliser pour l'installation des clusters, plutôt que Container Registry (gcr.io). Pour plus d'informations sur l'utilisation d'un miroir de registre, consultez la page Installer GKE sur une solution Bare Metal à l'aide d'un miroir de registre.
Chaîne. Point de terminaison du miroir, composé de l'adresse IP et du numéro de port du serveur de registre. Vous pouvez éventuellement utiliser votre propre espace de noms sur votre serveur de registre au lieu de l'espace de noms racine. Sans espace de noms, le format du point de terminaison est REGISTRY_IP:PORT. Lorsque vous utilisez un espace de noms, le format du point de terminaison est REGISTRY_IP:PORT/v2/NAMESPACE.
Le paramètre /v2 est requis lorsque vous spécifiez un espace de noms.
Le champ endpoint est obligatoire lorsque vous spécifiez un miroir de registre. Vous pouvez spécifier plusieurs miroirs/points de terminaison.
Facultatif. Chaîne. Chemin du fichier de certificat CA (autorité de certification racine du serveur) si votre serveur de registre utilise un certificat TLS privé. Si votre registre local ne nécessite pas de certificat TLS privé, vous pouvez omettre ce champ.
Mise en miroir du registre
Facultatif
Non immuable
registryMirrors.pullCredentialConfigPath
Facultatif. Chaîne. Chemin d'accès au fichier de configuration de la CLI Docker, config.json. Docker enregistre les paramètres d'authentification dans le fichier de configuration. Ce champ ne s'applique qu'à l'utilisation de miroirs de registre. Si votre serveur de registre ne nécessite pas de fichier de configuration Docker pour l'authentification, vous pouvez omettre ce champ.
Facultatif. Tableau des noms de domaine des hôtes mis en miroir localement pour le miroir de registre donné (endpoint). Lorsque l'environnement d'exécution du conteneur rencontre des demandes d'extraction d'images provenant d'un hôte spécifié, il vérifie d'abord le miroir du registre local. Pour en savoir plus, consultez la section Créer des clusters à partir du miroir de registre.
Le fichier de configuration de cluster généré par bmctl pour GKE sur une solution Bare Metal inclut des champs permettant de spécifier les chemins d'accès aux fichiers d'identifiants et aux fichiers de clés dans le système de fichiers local. Ces identifiants et clés sont nécessaires pour connecter vos clusters les uns aux autres et pour les connecter à votre projet Google Cloud.
Chaîne. Chemin d'accès à la clé du compte de service Container Registry. Le compte de service Container Registry est un compte de service géré par Google qui agit au nom de Container Registry lors de l'interaction avec les services Google Cloud.
Identifiants
Facultatif
Non immuable
sshPrivateKeyPath
Chaîne. Chemin d'accès à la clé privée SSH. SSH est requis pour l'accès aux nœuds.
Identifiants
Facultatif
Non immuable
gkeConnectAgentServiceAccountKeyPath
Chaîne. Chemin d'accès à la clé du compte de service de l'agent.
GKE sur Bare Metal utilise ce compte de service pour maintenir une connexion entre GKE sur Bare Metal et Google Cloud.
Chaîne. Chemin d'accès à la clé du compte de service d'enregistrement.
GKE sur Bare Metal utilise ce compte de service pour enregistrer vos clusters d'utilisateur auprès de Google Cloud.
Chaîne. Chemin d'accès à la clé du compte de service des opérations.
GKE sur Bare Metal utilise le compte de service Operations pour s'authentifier auprès de l'observabilité Google Cloud afin d'accéder à l'API Logging et à l'API Monitoring.
Définit la configuration de la plage CIDR IPv4. Au moins l'un des champs ipv4 ou ipv6 doit être fourni pour la ressource ClusterCidrConfig.
Ressource ClusterCIDRConfig
Facultatif
Immuable
ipv4.cidr
Chaîne. Définit le bloc CIDR du nœud IPv4. Les nœuds ne peuvent avoir qu'une seule plage de chaque famille. Ce bloc CIDR doit correspondre au CIDR du pod décrit dans la ressource Cluster.
Exemple :
ipv4:
cidr: "10.1.0.0/16"
Ressource ClusterCIDRConfig
Obligatoire
Immuable
ipv4.perNodeMaskSize
Entier. Définit la taille du masque du bloc CIDR IPv4 du nœud. Par exemple, la valeur 24 se traduit par le masque de réseau /24. Assurez-vous que le masque de réseau du bloc CIDR du nœud est supérieur au nombre maximal de pods que le kubelet peut programmer, qui est défini dans l'option --max-pods du kubelet.
Ressource ClusterCIDRConfig
Obligatoire
Immuable
ipv6
Définit la configuration de la plage CIDR IPv6. Au moins l'un des champs ipv4 ou ipv6 doit être fourni pour la ressource ClusterCidrConfig.
Ressource ClusterCIDRConfig
Facultatif
Immuable
ipv6.cidr
Chaîne. Définit le bloc CIDR du nœud IPv6. Les nœuds ne peuvent avoir qu'une seule plage de chaque famille.
Exemple :
ipv6:
cidr: "2620:0:1000:2631:3:10:3:0/112"
Ressource ClusterCIDRConfig
Obligatoire
Immuable
ipv6.perNodeMaskSize
Entier. Définit la taille du masque du bloc CIDR IPv6 du nœud. Par exemple, la valeur 120 se traduit par le masque de réseau /120. Assurez-vous que le masque de réseau du bloc CIDR du nœud est supérieur au nombre maximal de pods que le kubelet peut programmer, qui est défini dans l'option --max-pods du kubelet.
Ressource ClusterCIDRConfig
Obligatoire
Immuable
nodeSelector.matchLabels
Définit les nœuds auxquels la configuration CIDR s'applique. Un sélecteur de nœud vide fonctionne comme une valeur par défaut qui s'applique à tous les nœuds.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/04/08 (UTC).
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problème de traduction"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Autre"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile à comprendre"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"J'ai pu résoudre mon problème"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Autre"
}]
