Documentation de référence sur les champs de configuration de cluster
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page décrit les champs compatibles avec le fichier de configuration du 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 Google Distributed Cloud.
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 de manière dynamique 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 Ingress;entrée fournies avec Google Distributed Cloud. 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 DSR (Direct Server Return) permet de résoudre les problèmes liés à l'équilibrage de charge SNAT. En mode DSR (forwardMode: dsr), le nœud de l'équilibreur de charge utilise les 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:valeur de masque de /18, ce qui correspond à une taille de 14 bits (16 384 adresses IP).
Plage CIDR maximale des pods:valeur de masque de /8, ce 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 Google Distributed Cloud, 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 de services.
Vous pouvez uniquement augmenter la plage du CIDR du service 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:valeur de masque /24, ce qui correspond à une taille de 8 bits (256 adresses).
Plage CIDR maximale du service:valeur de masque /12, ce 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 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 nom d'objet de remplacement (SAN, subject alternative name) 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 respecter la norme RFC 1035.
Pour en savoir plus, consultez la section 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 requêtes 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 est prioritaire sur ce paramètre. Par exemple, avec les paramètres par défaut, les rafales allant jusqu'à 10 requêtes simultanées sont autorisées, mais elles doivent être traitées au taux par défaut de cinq requêtes par seconde. Ce comportement d'utilisation intensive n'est utilisé que lorsque registryPullQPS est supérieur à 0.
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster et que le paramètre persiste 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 le taux de traitement des requêtes pour les extractions d'images Container Registry dans le nombre de requêtes par seconde (RPS).
Lorsque registryPullQPS est défini sur une valeur supérieure à 0, le taux de requêtes est limité à ce nombre de requêtes par seconde. Si registryPullQPS est défini sur 0, il n'y a aucune 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 et que le paramètre persiste 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 récupérations Container Registry sont traitées en parallèle ou une par une. La valeur par défaut est true, ce qui indique que les opérations d'extraction sont traitées une par une. Lorsque la valeur est false, kubelet extrait les 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 et que le paramètre persiste 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. Ceci 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 Parc (gkehub.googleapis.com) et le service Connect (gkeconnect.googleapis.com). Les membres du parc peuvent être mondiaux ou régionaux. Vous pouvez éventuellement utiliser gkeConnect.location pour spécifier la région Google Cloud dans laquelle le parc et les services Connect s'exécutent, afin que le trafic soit limité à votre région.
Pour obtenir la liste des régions disponibles, consultez la section Régions où l'API GKE On-Prem est disponible.
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 à des versions antérieures à 1.28 sont gérés par les services mondiaux Fleet et Connect.
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 à celle configurée dans gkeOnPremAPI.location. Si les régions sont différentes, la création du cluster échoue.
Cette valeur ne peut pas être modifiée pour les clusters existants.
Ressource du cluster
Facultatif
Immuable
gkeOnPremAPI
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 clusterOperations.location.
Si vous souhaitez enregistrer tous les clusters du projet dans l'API GKE On-Prem, veillez à suivre 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 de service de l'API GKE On-Prem) dans le projet. Pour obtenir des instructions, consultez la section Désactiver des services.
Si vous souhaitez enregistrer tous les clusters du projet dans l'API GKE On-Prem, veillez à suivre 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 de 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 la 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. Ils 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 les étapes de 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, si vous supprimez la section et mettez à jour le cluster par la suite, la mise à jour échouera.
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, il 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 cette API 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 à 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 disponibles. Ne doit pas être une chaîne vide si gkeOnPremAPI.enabled est défini sur true. Si gkeOnPremAPI.enabled est défini sur 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. Depuis la version 1.11.2, vous pouvez activer ou désactiver l'environnement d'exécution des 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 avez un doute, 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
Objets. 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.
Un pool d'adresses existant peut être modifié 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, Google Distributed Cloud 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 les charges de travail de s'exécuter 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
Google Distributed Cloud 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 de nœuds bloque la création du cluster et les autres opérations du cluster.
Ressource du cluster
Facultatif
Non immuable
loadBalancer.nodePoolSpec.kubeletConfig
Facultatif.
Cette section contient des champs permettant de configurer le 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'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 est prioritaire sur ce paramètre. Par exemple, avec les paramètres par défaut, les rafales allant jusqu'à 10 requêtes simultanées sont autorisées, mais elles doivent être traitées au taux par défaut de cinq requêtes par seconde. Ce comportement d'utilisation intensive n'est utilisé que lorsque registryPullQPS est supérieur à 0.
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster et que le paramètre persiste 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 le taux de traitement des requêtes pour les extractions d'images Container Registry dans le nombre de requêtes par seconde (RPS).
Lorsque registryPullQPS est défini sur une valeur supérieure à 0, le taux de requêtes est limité à ce nombre de requêtes par seconde. Si registryPullQPS est défini sur 0, il n'y a aucune 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 et que le paramètre persiste 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 récupérations Container Registry sont traitées en parallèle ou une par une. La valeur par défaut est true, ce qui indique que les opérations d'extraction sont traitées une par une. Lorsque la valeur est false, kubelet extrait les 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 et que le paramètre persiste 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 souhaitez utiliser ou non 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, Google Distributed Cloud n'accepte containerd que comme environnement d'exécution de conteneur. Le champ containerRuntime est obsolète et a été supprimé du fichier de configuration de cluster généré. Pour les versions 1.13.0 et ultérieures de Google Distributed Cloud, si le fichier de configuration de votre 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.
Cette section spécifie une configuration de registre privé au niveau du nœud pour les clusters d'utilisateur. Les registres privés au niveau du nœud sont conçus pour être utilisés avec vos charges de travail. Ils vous permettent de mieux contrôler les extractions d'images et leur sécurité associée.
Pour les clusters d'administrateur, le registre privé au niveau du nœud est spécifié dans la section Identifiants du fichier de configuration du cluster d'administrateur.
Le cas échéant, utilisez cette section pour spécifier le nom et l'espace de noms du secret créé pour stocker le certificat CA (autorité de certification racine du serveur) pour le registre privé. Si votre registre local ne nécessite pas de certificat TLS privé, vous pouvez omettre ce bloc.
La configuration d'un registre privé au niveau du nœud n'est disponible en version preview que sur les clusters version 1.29.
Chaîne. Ce champ spécifie l'hôte et le port d'un registre privé unique. Vous pouvez spécifier l'hôte avec un nom de domaine ou une adresse IP. N'incluez pas le préfixe http ni https.
Le champ host est obligatoire lorsque vous spécifiez un registre privé pour un cluster d'utilisateur.
La configuration d'un registre privé au niveau du nœud n'est disponible en version preview que sur les clusters version 1.29.
Le cas échéant, utilisez cette section pour spécifier le nom et l'espace de noms du secret créé pour stocker les identifiants du registre privé.
Utilisez le bloc pullCredentialSecretRef lorsque vous configurez un cluster d'utilisateur pour autoriser les nœuds à accéder à un registre privé nécessitant une authentification.
La configuration d'un registre privé au niveau du nœud n'est disponible en version preview que sur les clusters version 1.29.
La configuration d'un registre privé au niveau du nœud n'est disponible en version preview que sur les clusters version 1.29.
Ressource du cluster
Facultatif
Non 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), effectuez la mise à niveau de manière séquentielle, 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 pool de nœuds de calcul sont mis à niveau en fonction de la stratégie de mise à niveau de la spécification du pool de nœuds correspondante.
Ressource du cluster
Facultatif
Non immuable
nodePoolUpgradeStrategy.pause
Facultatif. Booléen (true ou false). Valeur par défaut : false. Ce champ indique si une mise à niveau active d'un cluster doit être suspendue ou réactivée.
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 section Vérifications d'état périodiques.
Ressource du cluster
Facultatif
Non immuable
periodicHealthCheck.enable
Facultatif. Booléen (true|false) : permet d'activer ou de désactiver 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 Google Distributed Cloud envoie une requête à l'un de ces hôtes ou domaines, la requête 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 dont le fichier de configuration du cluster ne comporte pas de profil seccomp s'exécutent de manière 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 l'environnement d'exécution de conteneurs. 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 Utiliser seccomp pour limiter les conteneurs.
Ressource du cluster
Facultatif
Mutable (mise à niveau uniquement)
clusterSecurity.enableRootlessContainers
Facultatif. Booléen (true|false). Permet d'activer ou de désactiver 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 la liste des comptes auxquels le rôle de contrôle des accès basé sur les rôles Kubernetes (RBAC) clusterrole/cluster-admin est attribué. 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 solution est pratique si vous devez gérer plusieurs clusters, en particulier dans un environnement hybride comportant à la fois des clusters GKE et des clusters sur site.
Ce champ accepte un tableau de noms de comptes. Les comptes utilisateur et les comptes de service sont compatibles. Pour les utilisateurs, vous devez spécifier l'adresse e-mail de leur compte Google Cloud. 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 de Google Distributed Cloud facilitent l'installation et la gestion 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 GID compris dans la plage startUIDRangeRootlessContainers à startUIDRangeRootlessContainers + 2 999, 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 des utilisateurs. 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.
Google Distributed Cloud accepte 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.
Cluster unique : cluster unique pour l'administration et les charges de travail, qui permet également de gérer des clusters d'utilisateur.
Autonome : un cluster unique pouvant s'administrer lui-même et exécuter des charges de travail, mais qui ne peut pas créer ni gérer d'autres clusters d'utilisateur.
Le type de cluster est spécifié lors de sa création et ne peut pas être modifié pour les mises à jour ou les mises à niveau. Pour en savoir plus sur la création de clusters, consultez la page 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 le format cluster-CLUSTER_NAME, mais le préfixe cluster- n'est pas strictement obligatoire depuis la version 1.7.2 de Google Distributed Cloud.
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 requêtes 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 est prioritaire sur ce paramètre. Par exemple, avec les paramètres par défaut, les rafales allant jusqu'à 10 requêtes simultanées sont autorisées, mais elles doivent être traitées au taux par défaut de cinq requêtes par seconde. Ce comportement d'utilisation intensive n'est utilisé que lorsque registryPullQPS est supérieur à 0.
Ce champ peut être défini chaque fois que vous créez, mettez à jour ou mettez à niveau un cluster et que le paramètre persiste 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 le taux de traitement des requêtes pour les extractions d'images Container Registry dans le nombre de requêtes par seconde (RPS).
Lorsque registryPullQPS est défini sur une valeur supérieure à 0, le taux de requêtes est limité à ce nombre de requêtes par seconde. Si registryPullQPS est défini sur 0, il n'y a aucune 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 et que le paramètre persiste 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 récupérations Container Registry sont traitées en parallèle ou une par une. La valeur par défaut est true, ce qui indique que les opérations d'extraction sont traitées une par une. Lorsque la valeur est false, kubelet extrait les 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 et que le paramètre persiste 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 n'est en mesure d'effectuer de planification sur le nœud, sauf s'il possède 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 supprimés. Les pods qui le tolèrent ne sont jamais expulsés.
Pour Google Distributed Cloud, 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 pour les 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 de nœuds pour un pool de nœuds de calcul. Dans 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 pour 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, 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 de manière séquentielle, 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 50 % du nombre de nœuds du pool de nœuds ou le nombre fixe 15, selon la valeur la plus faible. Par exemple, si votre pool de nœuds comporte 20 nœuds, vous ne pouvez pas spécifier une 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.
Si vos charges de travail sont sensibles aux interruptions, nous vous recommandons de spécifier minimumAvailableNodes pour vous assurer 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). Par défaut: dépend de concurrentNodes. Pour en savoir plus sur les valeurs par défaut pour minimumAvailableNodes, consultez la section Valeurs par défaut des mises à niveau parallèles. Le paramètre minimumAvailableNodes vous permet de spécifier la quantité de nœuds du pool de nœuds 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 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 réduit les problèmes de capacité liés à la planification des pods et contribue ainsi à protéger les charges de travail lors d'une mise à niveau du cluster. Toutefois, une valeur élevée pour minimumAvailableNodes augmente le risque de blocage d'une mise à niveau dans l'attente de la disponibilité des nœuds. Pour en savoir plus, consultez la section Mises à niveau parallèles.
Facultatif. Cette section permet de spécifier un registre privé à utiliser pour les images de charge de travail. Cette méthode de configuration du registre privé dans la section des identifiants du fichier de configuration du cluster est destinée aux clusters hybrides ou autonomes ne comportant que des pools de nœuds de calcul.
Chaîne. Ce champ spécifie l'hôte et le port d'un registre privé unique. Vous pouvez spécifier l'hôte avec un nom de domaine ou une adresse IP. N'incluez pas le préfixe http ni https.
Le champ host est obligatoire lorsque vous spécifiez un registre privé pour un cluster hybride ou autonome.
Facultatif. Chaîne. Chemin d'accès 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 n'exige pas de certificat TLS privé, vous pouvez omettre ce champ.
Facultatif. Chaîne. Chemin d'accès du 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 registres privés au niveau du nœud.
Utilisez le champ pullCredentialConfigPath lorsque vous configurez un cluster hybride ou autonome pour permettre aux nœuds d'accéder à un registre privé nécessitant une authentification.
Identifiants
Facultatif
Non immuable
registryMirrors
Facultatif. Dans cette section, spécifiez un miroir de registre à utiliser pour l'installation des clusters, à la place de Container Registry (gcr.io). Pour plus d'informations sur l'utilisation d'un miroir de registre, consultez la page Installer Google Distributed Cloud à 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 d'accès 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 n'exige pas de certificat TLS privé, vous pouvez omettre ce champ.
Miroir du registre
Facultatif
Non immuable
registryMirrors.pullCredentialConfigPath
Facultatif. Chaîne. Chemin d'accès du 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 des 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 de 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 d'un hôte spécifié, il vérifie d'abord le miroir du registre local. Pour en savoir plus, consultez la page Créer des clusters à partir du miroir de registre.
Le fichier de configuration de cluster généré par bmctl pour Google Distributed Cloud inclut des champs permettant de spécifier les chemins d'accès aux fichiers d'identifiants et 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 agent de service qui agit au nom de Container Registry lors des interactions 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.
Google Distributed Cloud utilise ce compte de service pour maintenir une connexion entre Google Distributed Cloud et Google Cloud.
Chaîne. Chemin d'accès à la clé du compte de service d'enregistrement.
Google Distributed Cloud 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.
Google Distributed Cloud utilise le compte de service des opérations pour s'authentifier auprès de Google Cloud Observability afin d'accéder à l'API Logging et à l'API Monitoring.
Définit la configuration de la plage CIDR IPv4. Vous devez renseigner au moins l'un des champs ipv4 ou ipv6 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 de masque pour le bloc CIDR IPv4 du nœud. Par exemple, la valeur 24 se traduit par 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 planifier, 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. Vous devez renseigner au moins l'un des champs ipv4 ou ipv6 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 de masque pour le bloc CIDR IPv6 du nœud. Par exemple, la valeur 120 se traduit par 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 planifier, 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 par défaut et 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/06/28 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/06/28 (UTC)."],[],[]]
