- Ressource : BareMetalCluster
- État
- BareMetalNetworkConfig
- BareMetalIslandModeCidrConfig
- BareMetalMultipleNetworkInterfacesConfig
- BareMetalSrIovConfig
- BareMetalControlPlaneConfig
- BareMetalControlPlaneNodePoolConfig
- BareMetalApiServerArgument
- BareMetalLoadBalancerConfig
- BareMetalVipConfig
- BareMetalPortConfig
- BareMetalMetalLbConfig
- BareMetalLoadBalancerAddressPool
- BareMetalLoadBalancerNodePoolConfig
- BareMetalManualLbConfig
- BareMetalBgpLbConfig
- BareMetalBgpPeerConfig
- BareMetalStorageConfig
- BareMetalProxyConfig
- BareMetalClusterOperationsConfig
- BareMetalMaintenanceConfig
- BareMetalWorkloadNodeConfig
- ContainerRuntime
- BareMetalSecurityConfig
- BareMetalMaintenanceStatus
- BareMetalMachineDrainStatus
- BareMetalDrainingMachine
- BareMetalDrainedMachine
- BareMetalNodeAccessConfig
- BareMetalOsEnvironmentConfig
- BareMetalClusterUpgradePolicy
- NodePoolPolicy
- Méthodes
Ressource : BareMetalCluster
Ressource représentant un cluster d'utilisateur Bare Metal.
Représentation JSON |
---|
{ "name": string, "adminClusterMembership": string, "description": string, "bareMetalVersion": string, "uid": string, "state": enum ( |
Champs | |
---|---|
name |
Immuable. Nom de ressource du cluster d'utilisateur Bare Metal. |
adminClusterMembership |
Obligatoire. Cluster d'administrateur auquel appartient ce cluster d'utilisateur Bare Metal. Nom complet de la ressource de l'appartenance au parc du cluster d'administrateur. |
description |
Description lisible de ce cluster d'utilisateur Bare Metal. |
bareMetalVersion |
Obligatoire. Version d'Anthos clusters on bare metal pour le cluster d'utilisateur. |
uid |
Uniquement en sortie. Identifiant unique du cluster d'utilisateur bare metal. |
state |
Uniquement en sortie. État actuel du cluster d'utilisateur Bare Metal. |
endpoint |
Uniquement en sortie. Adresse IP du serveur d'API du cluster d'utilisateur Bare Metal. |
reconciling |
Uniquement en sortie. Si cette option est définie, des modifications sont en cours de diffusion dans le cluster d'utilisateur bare metal. |
createTime |
Uniquement en sortie. Heure de création du cluster d'utilisateur Bare Metal. Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : |
updateTime |
Uniquement en sortie. Date et heure de la dernière mise à jour du cluster d'utilisateur bare metal. Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : |
deleteTime |
Uniquement en sortie. Heure à laquelle le cluster d'utilisateur bare metal a été supprimé. Si la ressource n'est pas supprimée, ce champ doit être vide. Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples : |
localName |
Uniquement en sortie. Nom d'objet de la ressource personnalisée du cluster d'utilisateur Bare Metal sur le cluster d'administrateur associé. Ce champ permet de gérer les noms conflictuels lors de l'enregistrement de clusters existants auprès de l'API. Lorsqu'il est utilisé dans l'enregistrement d'un cluster, ce champ diffère du nom dans le nom de ressource. Pour les nouveaux clusters, ce champ correspond au nom de cluster fourni par l'utilisateur et est visible dans le dernier composant du nom de ressource. Il n'est pas modifiable. Lorsque le nom local et le nom du cluster sont différents, le nom local est utilisé dans les journaux du contrôleur de cluster d'administrateur. Vous utilisez le nom du cluster lorsque vous y accédez à l'aide de bmctl et kubectl. |
etag |
Uniquement en sortie. Cette somme de contrôle est calculée par le serveur en fonction de la valeur des autres champs. Elle peut être envoyée lors des requêtes de mise à jour et de suppression pour s'assurer que le client dispose d'une valeur à jour avant de continuer. Permet aux clients d'effectuer des opérations de lecture-modification-écriture cohérentes via un contrôle de simultanéité optimiste. |
annotations |
Annotations sur le cluster d'utilisateur Bare Metal. Ce champ est soumis aux mêmes restrictions que les annotations Kubernetes. La taille totale de toutes les clés et valeurs combinées est limitée à 256 000. La clé peut comporter deux segments : un préfixe (facultatif) et un nom (obligatoire), séparés par une barre oblique (/). Le préfixe doit être un sous-domaine DNS. Le nom ne doit pas dépasser 63 caractères. Il doit commencer et se terminer par un caractère alphanumérique, et contenir des tirets (-), des traits de soulignement (_) et des points (.), avec des caractères alphanumériques entre chaque symbole. Objet contenant une liste de paires |
networkConfig |
Obligatoire. Configuration réseau. |
controlPlane |
Obligatoire. Configuration du plan de contrôle. |
loadBalancer |
Obligatoire. Configuration de l'équilibreur de charge. |
storage |
Obligatoire. Configuration du stockage. |
proxy |
Configuration du proxy. |
clusterOperations |
Configuration des opérations de cluster. |
maintenanceConfig |
Configuration de la maintenance. |
nodeConfig |
Configuration du nœud de charge de travail. |
fleet |
Uniquement en sortie. Configuration du parc pour le cluster. |
status |
Uniquement en sortie. État détaillé du cluster. |
validationCheck |
Uniquement en sortie. Résultat de la vérification préliminaire. |
securityConfig |
Configuration des paramètres liés à la sécurité. |
maintenanceStatus |
Uniquement en sortie. État des tâches de maintenance en cours. |
adminClusterName |
Uniquement en sortie. Nom de ressource du cluster d'administrateur Bare Metal gérant ce cluster d'utilisateur. |
nodeAccessConfig |
Configurations liées à l'accès aux nœuds. |
osEnvironmentConfig |
Configurations liées à l'environnement de l'OS. |
binaryAuthorization |
Configurations liées à l'autorisation binaire. |
upgradePolicy |
Règle de mise à niveau du cluster. |
localNamespace |
Uniquement en sortie. Espace de noms du cluster. |
État
État du cycle de vie du cluster d'utilisateur Bare Metal.
Énumérations | |
---|---|
STATE_UNSPECIFIED |
Non défini. |
PROVISIONING |
L'état "PROVISIONING" (En cours de provisionnement) indique que le cluster est en cours de création. |
RUNNING |
L'état "RUNNING" (En cours d'exécution) indique que le cluster a été créé et qu'il est entièrement utilisable. |
RECONCILING |
L'état "RECONCILING" (Rapprochement) indique que le cluster est en cours de mise à jour. Il reste disponible, mais ses performances peuvent être dégradées. |
STOPPING |
L'état "STOPPING" (Arrêt) indique que le cluster est en cours de suppression. |
ERROR |
L'état "ERROR" (Erreur) indique que le cluster est dans un état défaillant irrécupérable. |
DEGRADED |
L'état "DEGRADED" (Dégradé) indique que le cluster nécessite une action de l'utilisateur pour restaurer toutes les fonctionnalités. |
BareMetalNetworkConfig
Spécifie la configuration réseau du cluster.
Représentation JSON |
---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
Champs | |
---|---|
advancedNetworking |
Permet d'utiliser les fonctionnalités réseau Anthos avancées, telles que l'équilibrage de charge groupé avec BGP ou la passerelle NAT de sortie. La configuration des paramètres pour les fonctionnalités réseau avancées définit automatiquement cet indicateur. |
multipleNetworkInterfacesConfig |
Configuration pour plusieurs interfaces réseau. |
srIovConfig |
Configuration pour SR-IOV. |
Champ d'union cluster_cidr_configuration . Configuration CIDR à utiliser dans le cluster d'utilisateur Bare Metal. cluster_cidr_configuration ne peut être qu'un des éléments suivants : |
|
islandModeCidr |
Configuration du bloc CIDR du mode île. Dans un réseau en mode île, les nœuds ont des adresses IP uniques, mais les pods n'ont pas d'adresses uniques dans les clusters. Cela ne pose pas de problème, car les pods d'un cluster ne communiquent jamais directement avec les pods d'un autre cluster. Au lieu de cela, des passerelles jouent un rôle de médiation entre les pods de différents clusters. |
BareMetalIslandModeCidrConfig
Spécifie la configuration CIDR du cluster lors de l'exécution en mode île.
Représentation JSON |
---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
Champs | |
---|---|
serviceAddressCidrBlocks[] |
Obligatoire. Une adresse IPv4 RFC1918 de ces plages est attribuée à chaque service du cluster. Ce champ est modifiable après la création à partir de la version 1.15. |
podAddressCidrBlocks[] |
Obligatoire. Une adresse IPv4 RFC1918 de ces plages est attribuée à chaque pod du cluster. Une fois le compte créé, ce champ ne peut plus être modifié. |
BareMetalMultipleNetworkInterfacesConfig
Spécifie la configuration du cluster avec plusieurs interfaces réseau.
Représentation JSON |
---|
{ "enabled": boolean } |
Champs | |
---|---|
enabled |
Indique si vous souhaitez activer plusieurs interfaces réseau pour vos pods. Lorsque networkConfig.advanced_networking est défini, il est automatiquement défini sur "true". |
BareMetalSrIovConfig
Spécifie la configuration de l'opérateur de mise en réseau SR-IOV.
Représentation JSON |
---|
{ "enabled": boolean } |
Champs | |
---|---|
enabled |
Indique si l'opérateur SR-IOV doit être installé. |
BareMetalControlPlaneConfig
Spécifie la configuration du plan de contrôle.
Représentation JSON |
---|
{ "controlPlaneNodePoolConfig": { object ( |
Champs | |
---|---|
controlPlaneNodePoolConfig |
Obligatoire. Configure le pool de nœuds exécutant le plan de contrôle. |
apiServerArgs[] |
Personnalise les arguments par défaut du serveur d'API. Seul un sous-ensemble d'indicateurs personnalisés est accepté. Pour connaître le format exact, consultez la documentation du serveur de l'API. |
BareMetalControlPlaneNodePoolConfig
Spécifie la configuration du pool de nœuds du plan de contrôle.
Représentation JSON |
---|
{
"nodePoolConfig": {
object ( |
Champs | |
---|---|
nodePoolConfig |
Obligatoire. Configuration générique d'un pool de nœuds exécutant le plan de contrôle. |
BareMetalApiServerArgument
Représente une paire nom-valeur d'argument. Seul un sous-ensemble d'indicateurs personnalisés est accepté. Pour connaître le format exact, consultez la documentation du serveur de l'API.
Représentation JSON |
---|
{ "argument": string, "value": string } |
Champs | |
---|---|
argument |
Obligatoire. Nom de l'argument tel qu'il apparaît sur la ligne de commande du serveur d'API. Veillez à supprimer les tirets de début. |
value |
Obligatoire. Valeur de l'argument tel qu'il sera transmis à la ligne de commande du serveur d'API. |
BareMetalLoadBalancerConfig
Spécifie la configuration de l'équilibreur de charge.
Représentation JSON |
---|
{ "vipConfig": { object ( |
Champs | |
---|---|
vipConfig |
Adresses IP virtuelles utilisées par l'équilibreur de charge. |
portConfig |
Configure les ports sur lesquels l'équilibreur de charge écoutera. |
Champ d'union load_balancer_configuration . Configuration de l'équilibreur de charge pour le cluster d'utilisateur bare metal. load_balancer_configuration ne peut être qu'un des éléments suivants : |
|
metalLbConfig |
Configuration des équilibreurs de charge MetalLB. |
manualLbConfig |
Équilibreurs de charge configurés manuellement. |
bgpLbConfig |
Configuration pour les équilibreurs de charge typés BGP. Lorsque networkConfig.advanced_networking est défini, il est automatiquement défini sur "true". |
BareMetalVipConfig
Spécifie la configuration de l'adresse IP virtuelle pour l'équilibreur de charge Bare Metal.
Représentation JSON |
---|
{ "controlPlaneVip": string, "ingressVip": string } |
Champs | |
---|---|
controlPlaneVip |
Adresse IP virtuelle que vous avez précédemment réservée pour l'API Kubernetes de ce cluster d'utilisateur Bare Metal. |
ingressVip |
Adresse IP virtuelle que vous avez précédemment réservée pour le trafic entrant dans ce cluster d'utilisateur Bare Metal. |
BareMetalPortConfig
Spécifie les ports de l'équilibreur de charge pour le cluster d'utilisateur bare metal.
Représentation JSON |
---|
{ "controlPlaneLoadBalancerPort": integer } |
Champs | |
---|---|
controlPlaneLoadBalancerPort |
Port sur lequel les équilibreurs de charge hébergés du plan de contrôle écouteront. |
BareMetalMetalLbConfig
Représente les paramètres de configuration d'un équilibreur de charge MetalLB.
Représentation JSON |
---|
{ "addressPools": [ { object ( |
Champs | |
---|---|
addressPools[] |
Obligatoire. AddressPools est une liste de pools d'adresses IP sans chevauchement utilisés par les services de type équilibreur de charge. Toutes les adresses doivent pouvoir être routées vers les nœuds d'équilibrage de charge. L'adresse IP virtuelle d'entrée doit être incluse dans les pools. |
loadBalancerNodePoolConfig |
Spécifie le pool de nœuds exécutant l'équilibreur de charge. Une connectivité L2 est requise entre les nœuds de ce pool. S'il est manquant, le pool de nœuds du plan de contrôle est utilisé comme pool d'équilibrage de charge. |
BareMetalLoadBalancerAddressPool
Représente un pool d'adresses IP utilisé par l'équilibreur de charge.
Représentation JSON |
---|
{ "pool": string, "addresses": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
Champs | |
---|---|
pool |
Obligatoire. Nom du pool d'adresses. |
addresses[] |
Obligatoire. Adresses faisant partie de ce pool. Chaque adresse doit être au format CIDR (1.2.3.0/24) ou au format de plage (1.2.3.1-1.2.3.5). |
avoidBuggyIps |
Si la valeur est "true", évitez d'utiliser les adresses IP se terminant par .0 ou .255. Cela évite que les appareils grand public bogués suppriment par erreur le trafic IPv4 pour ces adresses IP spéciales. |
manualAssign |
Si la valeur est "true", les adresses IP ne sont pas attribuées automatiquement. |
BareMetalLoadBalancerNodePoolConfig
Spécifie la configuration du pool de nœuds de l'équilibreur de charge.
Représentation JSON |
---|
{
"nodePoolConfig": {
object ( |
Champs | |
---|---|
nodePoolConfig |
Configuration générique d'un pool de nœuds exécutant un équilibreur de charge. |
BareMetalManualLbConfig
Représente les paramètres de configuration d'un équilibreur de charge manuel.
Représentation JSON |
---|
{ "enabled": boolean } |
Champs | |
---|---|
enabled |
Indique si l'équilibrage de charge manuel est activé. |
BareMetalBgpLbConfig
BareMetalBgpLbConfig représente les paramètres de configuration d'un équilibreur de charge BGP (Border Gateway Protocol).
Représentation JSON |
---|
{ "asn": string, "bgpPeerConfigs": [ { object ( |
Champs | |
---|---|
asn |
Obligatoire. Numéro de système autonome (ASN) BGP du cluster. Ce champ peut être modifié après la création du cluster. |
bgpPeerConfigs[] |
Obligatoire. Liste des pairs BGP auxquels le cluster se connectera. Au moins un pair doit être configuré pour chaque nœud de plan de contrôle. Les nœuds du plan de contrôle se connecteront à ces pairs pour annoncer l'adresse IP virtuelle du plan de contrôle. L'équilibreur de charge Services utilise également ces pairs par défaut. Ce champ peut être modifié après la création du cluster. |
addressPools[] |
Obligatoire. AddressPools est une liste de pools d'adresses IP sans chevauchement utilisés par les services de type équilibreur de charge. Toutes les adresses doivent pouvoir être routées vers les nœuds d'équilibrage de charge. L'adresse IP virtuelle d'entrée doit être incluse dans les pools. |
loadBalancerNodePoolConfig |
Spécifie le pool de nœuds exécutant l'équilibrage de charge du plan de données. Une connectivité L2 est requise entre les nœuds de ce pool. S'il est manquant, le pool de nœuds du plan de contrôle est utilisé pour l'équilibrage de charge du plan de données. |
BareMetalBgpPeerConfig
BareMetalBgpPeerConfig représente les paramètres de configuration d'un pair BGP (Border Gateway Protocol).
Représentation JSON |
---|
{ "asn": string, "ipAddress": string, "controlPlaneNodes": [ string ] } |
Champs | |
---|---|
asn |
Obligatoire. Numéro de système autonome (ASN) BGP pour le réseau qui contient l'appareil pair externe. |
ipAddress |
Obligatoire. Adresse IP de l'appareil pair externe. |
controlPlaneNodes[] |
Adresse IP du nœud de plan de contrôle qui se connecte au pair externe. Si vous ne spécifiez aucun nœud de plan de contrôle, tous les nœuds de plan de contrôle peuvent se connecter au pair externe. Si vous spécifiez une ou plusieurs adresses IP, seuls les nœuds spécifiés participent aux sessions d'appairage. |
BareMetalStorageConfig
BareMetalStorageConfig spécifie la configuration du stockage du cluster.
Représentation JSON |
---|
{ "lvpShareConfig": { object ( |
Champs | |
---|---|
lvpShareConfig |
Obligatoire. Spécifie la configuration des PersistentVolumes locaux secondés (protégés) par des sous-répertoires dans un système de fichiers partagé. Ces sous-répertoires sont générés automatiquement lors de la création du cluster. |
lvpNodeMountsConfig |
Obligatoire. Spécifie la configuration des PersistentVolumes locaux secondés par des disques de nœud installés. Ces disques doivent être formatés et installés par l'utilisateur, avant ou après la création du cluster. |
BareMetalProxyConfig
Spécifie la configuration du proxy du cluster.
Représentation JSON |
---|
{ "uri": string, "noProxy": [ string ] } |
Champs | |
---|---|
uri |
Obligatoire. Spécifie l'adresse de votre serveur proxy. Exemples : Ne fournissez pas d'identifiants au format |
noProxy[] |
Liste d'adresses IP, de noms d'hôtes et de domaines qui doivent ignorer le proxy. Exemples : ["127.0.0.1", "example.com", ".corp", "localhost"]. |
BareMetalClusterOperationsConfig
Spécifie l'infrastructure d'observabilité du cluster d'utilisateur Bare Metal.
Représentation JSON |
---|
{ "enableApplicationLogs": boolean } |
Champs | |
---|---|
enableApplicationLogs |
Indique si la collecte des journaux/métriques d'application doit être activée (en plus des journaux/métriques système). |
BareMetalMaintenanceConfig
Spécifie les configurations permettant de mettre les nœuds Bare Metal en maintenance et de les en sortir.
Représentation JSON |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
Champs | |
---|---|
maintenanceAddressCidrBlocks[] |
Obligatoire. Toutes les adresses IPv4 de ces plages seront placées en mode maintenance. Les nœuds en mode maintenance seront marqués comme non programmables et drainés. Lorsque ces deux conditions sont remplies, l'annotation "baremetal.cluster.gke.io/maintenance" est définie sur la ressource de nœud. |
BareMetalWorkloadNodeConfig
Spécifie les configurations des nœuds de charge de travail.
Représentation JSON |
---|
{
"maxPodsPerNode": string,
"containerRuntime": enum ( |
Champs | |
---|---|
maxPodsPerNode |
Nombre maximal de pods qu'un nœud peut exécuter. La taille de la plage CIDR attribuée au nœud sera dérivée de ce paramètre. |
containerRuntime |
Spécifie l'environnement d'exécution de conteneurs qui sera utilisé. |
ContainerRuntime
Environnement d'exécution utilisé pour exécuter les conteneurs dans ce cluster d'utilisateur.
Énumérations | |
---|---|
CONTAINER_RUNTIME_UNSPECIFIED |
Aucun environnement d'exécution de conteneur n'est sélectionné. |
CONTAINERD |
Environnement d'exécution Containerd. |
BareMetalSecurityConfig
Spécifie les paramètres de sécurité du cluster d'utilisateur Bare Metal.
Représentation JSON |
---|
{
"authorization": {
object ( |
Champs | |
---|---|
authorization |
Configure l'accès des utilisateurs au cluster d'utilisateur. |
BareMetalMaintenanceStatus
Représente l'état de maintenance du cluster d'utilisateur Bare Metal.
Représentation JSON |
---|
{
"machineDrainStatus": {
object ( |
Champs | |
---|---|
machineDrainStatus |
État de maintenance des machines de nœud. |
BareMetalMachineDrainStatus
Représente l'état des machines de nœuds en cours de drainage.
Représentation JSON |
---|
{ "drainingMachines": [ { object ( |
Champs | |
---|---|
drainingMachines[] |
Liste des machines de vidange. |
drainedMachines[] |
Liste des machines vidées. |
BareMetalDrainingMachine
Représente une machine en cours de drainage.
Représentation JSON |
---|
{ "nodeIp": string, "podCount": integer } |
Champs | |
---|---|
nodeIp |
Adresse IP de la machine à vider. |
podCount |
Nombre de pods à vider. |
BareMetalDrainedMachine
Représente une machine actuellement vidée.
Représentation JSON |
---|
{ "nodeIp": string } |
Champs | |
---|---|
nodeIp |
Adresse IP de la machine vidée. |
BareMetalNodeAccessConfig
Spécifie les paramètres liés à l'accès aux nœuds pour le cluster d'utilisateur Bare Metal.
Représentation JSON |
---|
{ "loginUser": string } |
Champs | |
---|---|
loginUser |
LoginUser est le nom d'utilisateur utilisé pour accéder aux machines de nœud. Si aucune valeur n'est définie, la valeur par défaut est "root". |
BareMetalOsEnvironmentConfig
Spécifie les paramètres du système d'exploitation pour le provisionnement du cluster.
Représentation JSON |
---|
{ "packageRepoExcluded": boolean } |
Champs | |
---|---|
packageRepoExcluded |
Indique si le dépôt de packages ne doit pas être inclus lors de l'initialisation de machines Bare Metal. |
BareMetalClusterUpgradePolicy
BareMetalClusterUpgradePolicy définit la stratégie de mise à niveau du cluster.
Représentation JSON |
---|
{
"policy": enum ( |
Champs | |
---|---|
policy |
Spécifie la règle de mise à niveau à utiliser. |
pause |
Uniquement en sortie. "Pause" est utilisé pour afficher l'état de suspension de la mise à niveau. Pour l'instant, vous ne pouvez que le consulter. |
NodePoolPolicy
Spécifie la stratégie de mise à niveau pour les pools de nœuds de calcul.
Énumérations | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
Aucune règle de mise à niveau sélectionnée. |
SERIAL |
Mettez à niveau les pools de nœuds de calcul de manière séquentielle. |
CONCURRENT |
Mettez à niveau tous les pools de nœuds de calcul en parallèle. |
Méthodes |
|
---|---|
|
Crée un cluster Bare Metal dans un projet et un emplacement donnés. |
|
Supprime un seul cluster Bare Metal. |
|
Enregistre un cluster d'utilisateur Bare Metal existant et ses pools de nœuds auprès de l'API Anthos On-Prem dans un projet et un emplacement donnés. |
|
Récupère les détails d'un seul cluster bare metal. |
|
Répertorie les clusters Bare Metal d'un projet et d'un emplacement donnés. |
|
Mettre à jour les paramètres d'un seul cluster bare metal. |
|
Interroge la configuration de la version du cluster d'utilisateur Bare Metal. |