- 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 la ressource du cluster d'utilisateur Bare Metal. |
admin |
Obligatoire. Cluster d'administrateur auquel appartient ce cluster d'utilisateur Bare Metal. Il s'agit du nom de ressource complet de l'appartenance au parc du cluster d'administrateur. |
description |
Description lisible de ce cluster d'utilisateur bare metal. |
bare |
Obligatoire. Version des clusters Anthos sur Bare Metal pour le cluster d'utilisateur. |
uid |
Uniquement en sortie. Identifiant unique du cluster d'utilisateurs 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. |
create |
Uniquement en sortie. Heure à laquelle le cluster d'utilisateurs bare metal a été créé. Utilise la norme RFC 3339, où la sortie générée est toujours normalisée 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: |
update |
Uniquement en sortie. Heure de la dernière mise à jour du cluster d'utilisateurs bare metal. Utilise la norme RFC 3339, où la sortie générée est toujours normalisée 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: |
delete |
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ù la sortie générée est toujours normalisée 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: |
local |
Uniquement en sortie. Nom de l'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 en conflit lors de l'enregistrement de clusters existants dans l'API. Lorsqu'il est utilisé dans le cadre de l'enregistrement de cluster, ce champ diffère du nom de la 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 la 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 du cluster d'administration. Vous utilisez le nom du cluster lorsque vous y accédez à l'aide de bmctl et de 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 |
network |
Obligatoire. Configuration réseau. |
control |
Obligatoire. Configuration du plan de contrôle. |
load |
Obligatoire. Configuration de l'équilibreur de charge. |
storage |
Obligatoire. Configuration de l'espace de stockage. |
proxy |
Configuration du proxy. |
cluster |
Configuration des opérations de cluster. |
maintenance |
Configuration de la maintenance. |
node |
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. |
validation |
Uniquement en sortie. Résultat de la vérification préliminaire. |
security |
Configuration des paramètres liés à la sécurité. |
maintenance |
Uniquement en sortie. État des tâches de maintenance en cours. |
admin |
Uniquement en sortie. Nom de la ressource du cluster d'administrateur Bare Metal qui gère ce cluster d'utilisateur. |
node |
Configuration liée à l'accès aux nœuds. |
os |
Configurations liées à l'environnement de l'OS. |
binary |
Configurations liées à l'autorisation binaire |
upgrade |
La stratégie de mise à niveau du cluster. |
État
État du cycle de vie du cluster d'utilisateur Bare Metal.
Enums | |
---|---|
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 les 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 ses fonctionnalités. |
BareMetalNetworkConfig
Spécifie la configuration réseau du cluster.
Représentation JSON |
---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
Champs | |
---|---|
advanced |
Active l'utilisation des fonctionnalités réseau avancées d'Anthos, telles que l'équilibrage de charge groupé avec BGP ou la passerelle NAT de sortie. La configuration des fonctionnalités réseau avancées définira automatiquement cet indicateur. |
multiple |
Configuration pour plusieurs interfaces réseau. |
sr |
Configuration pour SR-IOV. |
Champ d'union cluster_cidr_configuration . Configuration CIDR à utiliser dans le cluster utilisateur bare metal. cluster_cidr_configuration ne peut être qu'un des éléments suivants : |
|
island |
Configuration du CIDR en 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 du CIDR du cluster lors de l'exécution en mode îlot.
Représentation JSON |
---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
Champs | |
---|---|
service |
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. |
pod |
Obligatoire. Une adresse IPv4 RFC1918 de ces plages est attribuée à chaque pod du cluster. Ce champ ne peut plus être modifié une fois l'espace créé. |
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 cette valeur est définie, networkConfig.advanced_networking 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 | |
---|---|
control |
Obligatoire. Configure le pool de nœuds exécutant le plan de contrôle. |
api |
Personnalise les arguments du serveur d'API par défaut. Seul un sous-ensemble des indicateurs personnalisés est accepté. Pour connaître le format exact, consultez la documentation du serveur d'API. |
BareMetalControlPlaneNodePoolConfig
Indique la configuration du pool de nœuds du plan de contrôle.
Représentation JSON |
---|
{
"nodePoolConfig": {
object ( |
Champs | |
---|---|
node |
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 des indicateurs personnalisés est accepté. Pour connaître le format exact, consultez la documentation du serveur d'API.
Représentation JSON |
---|
{ "argument": string, "value": string } |
Champs | |
---|---|
argument |
Obligatoire. Nom de l'argument tel qu'il apparaît dans la ligne de commande du serveur d'API. Veillez à supprimer les tirets au début. |
value |
Obligatoire. Valeur de l'argument telle qu'elle sera transmise à la ligne de commande du serveur d'API. |
BareMetalLoadBalancerConfig
Spécifie la configuration de l'équilibreur de charge.
Représentation JSON |
---|
{ "vipConfig": { object ( |
Champs | |
---|---|
vip |
Adresses IP virtuelles utilisées par l'équilibreur de charge. |
port |
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 utilisateur bare metal. load_balancer_configuration ne peut être qu'un des éléments suivants : |
|
metal |
Configuration des équilibreurs de charge MetalLB. |
manual |
Équilibreurs de charge configurés manuellement |
bgp |
Configuration pour les équilibreurs de charge de type BGP. Lorsque cette valeur est définie, networkConfig.advanced_networking 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 | |
---|---|
control |
L'adresse IP virtuelle que vous avez précédemment réservée pour l'API Kubernetes de ce cluster d'utilisateur bare metal. |
ingress |
L'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 utilisateur bare metal.
Représentation JSON |
---|
{ "controlPlaneLoadBalancerPort": integer } |
Champs | |
---|---|
control |
Port sur lequel les équilibreurs de charge hébergés par le 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 | |
---|---|
address |
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 de l'équilibreur de charge. IngressVIP doit être inclus dans les pools. |
load |
Indique le pool de nœuds exécutant l'équilibreur de charge. Une connectivité L2 est requise entre les nœuds de ce pool. En cas d'absence, le pool de nœuds du plan de contrôle est utilisé comme pool de l'équilibreur 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). |
avoid |
Si cette valeur est définie sur "true", évitez d'utiliser des adresses IP se terminant par .0 ou .255. Cela évite que les appareils grand public bugués ne suppriment par erreur le trafic IPv4 pour ces adresses IP spéciales. |
manual |
Si la valeur est "true", empêchez l'attribution automatique d'adresses IP. |
BareMetalLoadBalancerNodePoolConfig
Spécifie la configuration du pool de nœuds de l'équilibreur de charge.
Représentation JSON |
---|
{
"nodePoolConfig": {
object ( |
Champs | |
---|---|
node |
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. |
bgp |
Obligatoire. Liste des pairs BGP auxquels le cluster se connectera. Vous devez configurer au moins un pair pour chaque nœud de plan de contrôle. Les nœuds du plan de contrôle se connectent à 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. |
address |
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 de l'équilibreur de charge. IngressVIP doit être inclus dans les pools. |
load |
Indique 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 du réseau qui contient l'appareil pair externe. |
ip |
Obligatoire. Adresse IP de l'appareil pair externe. |
control |
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 de stockage du cluster.
Représentation JSON |
---|
{ "lvpShareConfig": { object ( |
Champs | |
---|---|
lvp |
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. |
lvp |
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 |
no |
Liste d'adresses IP, de noms d'hôte 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 | |
---|---|
enable |
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 mode maintenance et de les en sortir.
Représentation JSON |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
Champs | |
---|---|
maintenance |
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. Si les 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 | |
---|---|
max |
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. |
container |
Spécifie l'environnement d'exécution de conteneur à utiliser. |
ContainerRuntime
L'environnement d'exécution utilisé pour exécuter des conteneurs dans ce cluster d'utilisateurs.
Enums | |
---|---|
CONTAINER_RUNTIME_UNSPECIFIED |
Aucun environnement d'exécution de conteneur 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'utilisateurs. |
BareMetalMaintenanceStatus
Représente l'état de maintenance du cluster d'utilisateur bare metal.
Représentation JSON |
---|
{
"machineDrainStatus": {
object ( |
Champs | |
---|---|
machine |
État de la maintenance des machines de nœud. |
BareMetalMachineDrainStatus
Représente l'état des machines de nœuds en cours d'opérations de drainage.
Représentation JSON |
---|
{ "drainingMachines": [ { object ( |
Champs | |
---|---|
draining |
Liste des machines de drainage. |
drained |
Liste des machines vidées. |
BareMetalDrainingMachine
Représente une machine en cours de drainage.
Représentation JSON |
---|
{ "nodeIp": string, "podCount": integer } |
Champs | |
---|---|
node |
Adresse IP de la machine de drainage. |
pod |
Nombre de pods à vider. |
BareMetalDrainedMachine
Représente une machine en cours de drainage.
Représentation JSON |
---|
{ "nodeIp": string } |
Champs | |
---|---|
node |
Adresse IP de la machine drainé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 | |
---|---|
login |
LoginUser est le nom d'utilisateur utilisé pour accéder aux machines de nœud. 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 | |
---|---|
package |
Indique si le dépôt de paquets 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 |
Indique la stratégie de mise à niveau à utiliser. |
pause |
Uniquement en sortie. La valeur "Pause" permet d'afficher l'état de la mise à niveau en attente. Pour le moment, il n'est disponible qu'en lecture seule. |
NodePoolPolicy
Spécifie la stratégie de mise à niveau pour les pools de nœuds de calcul.
Enums | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
Aucune règle de mise à niveau n'est 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. |
|
Inscrit un cluster d'utilisateur Bare Metal existant et ses pools de nœuds à 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. |
|
Met à jour les paramètres d'un seul cluster bare metal. |
|
Interroge la configuration de la version du cluster d'utilisateur bare metal. |