REST Resource: projects.locations.vmwareClusters

Ressource: VmwareCluster

Ressource représentant un cluster d'utilisateurs VMware.

##

Représentation JSON 
{
  "name": string,
  "adminClusterMembership": string,
  "description": string,
  "onPremVersion": string,
  "uid": string,
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "localName": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "controlPlaneNode": {
    object (VmwareControlPlaneNodeConfig)
  },
  "antiAffinityGroups": {
    object (VmwareAAGConfig)
  },
  "storage": {
    object (VmwareStorageConfig)
  },
  "networkConfig": {
    object (VmwareNetworkConfig)
  },
  "loadBalancer": {
    object (VmwareLoadBalancerConfig)
  },
  "vcenter": {
    object (VmwareVCenterConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "dataplaneV2": {
    object (VmwareDataplaneV2Config)
  },
  "vmTrackingEnabled": boolean,
  "autoRepairConfig": {
    object (VmwareAutoRepairConfig)
  },
  "fleet": {
    object (Fleet)
  },
  "authorization": {
    object (Authorization)
  },
  "deleteTime": string,
  "validationCheck": {
    object (ValidationCheck)
  },
  "adminClusterName": string,
  "enableControlPlaneV2": boolean,
  "binaryAuthorization": {
    object (BinaryAuthorization)
  },
  "upgradePolicy": {
    object (VmwareClusterUpgradePolicy)
  },
  "disableBundledIngress": boolean
}
Champs
name

string

Immuable. Nom de la ressource du cluster d'utilisateur VMware.
adminClusterMembership

string

Obligatoire. Cluster d'administrateur auquel appartient ce cluster d'utilisateur VMware. Il s'agit du nom de ressource complet de l'appartenance au parc du cluster d'administrateur. À l'avenir, les références à d'autres types de ressources pourront être autorisées si les clusters d'administrateurs sont modélisés en tant que ressources propres.
description

string

Description lisible de ce cluster d'utilisateur VMware.
onPremVersion

string

Obligatoire. Version d'Anthos clusters on VMware pour le cluster d'utilisateur.
uid

string

Uniquement en sortie. Identifiant unique du cluster d'utilisateurs VMware.
state

enum (State)

Uniquement en sortie. État actuel du cluster d'utilisateur VMware.
endpoint

string

Uniquement en sortie. Nom DNS du serveur d'API du cluster d'utilisateur VMware.
reconciling

boolean

Uniquement en sortie. Si cette option est définie, des modifications sont en cours de diffusion dans le cluster d'utilisateur VMware.
createTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle le cluster d'utilisateurs VMware 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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle le cluster d'utilisateurs VMware a été mis à jour pour la dernière fois.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
localName

string

Uniquement en sortie. Nom de l'objet de la ressource personnalisée VMware OnPremUserCluster sur le cluster d'administration 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 de l'ID 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.

Tous les utilisateurs doivent utiliser ce nom pour accéder à leur cluster à l'aide de gkectl ou kubectl. Ils doivent s'attendre à voir le nom local lorsqu'ils consultent les journaux du contrôleur de cluster administrateur.
etag

string

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

map (key: string, value: string)

Annotations sur le cluster d'utilisateur VMware. 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 "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
controlPlaneNode

object (VmwareControlPlaneNodeConfig)

Les nœuds du plan de contrôle du cluster d'utilisateur VMware doivent comporter un ou trois réplicas.
antiAffinityGroups

object (VmwareAAGConfig)

AAGConfig indique si les nœuds de cluster utilisateur VMware doivent être répartis sur au moins trois hôtes physiques dans le centre de données.
storage

object (VmwareStorageConfig)

Configuration de l'espace de stockage.
networkConfig

object (VmwareNetworkConfig)

Configuration réseau du cluster d'utilisateurs VMware.
loadBalancer

object (VmwareLoadBalancerConfig)

Configuration de l'équilibreur de charge.
vcenter

object (VmwareVCenterConfig)

VmwareVCenterConfig spécifie la configuration vCenter pour le cluster d'utilisateur. Si elle n'est pas spécifiée, elle est héritée du cluster d'administrateur.
status

object (ResourceStatus)

Uniquement en sortie. ResourceStatus représentant l'état détaillé du cluster.
dataplaneV2

object (VmwareDataplaneV2Config)

VmwareDataplaneV2Config spécifie la configuration pour Dataplane V2.
vmTrackingEnabled

boolean

Activez le suivi des VM.
autoRepairConfig

object (VmwareAutoRepairConfig)

Configuration de la réparation automatique.
fleet

object (Fleet)

Uniquement en sortie. Configuration du parc pour le cluster.
authorization

object (Authorization)

Stratégie RBAC qui sera appliquée et gérée par l'API Anthos sur site.
deleteTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle le cluster d'utilisateurs VMware a été supprimé.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
validationCheck

object (ValidationCheck)

Uniquement en sortie. ValidationCheck représente le résultat de la tâche de vérification préliminaire.
adminClusterName

string

Uniquement en sortie. Nom de la ressource du cluster d'administration VMware hébergeant ce cluster d'utilisateurs.
enableControlPlaneV2

boolean

Activez le plan de contrôle V2. La valeur par défaut est "false".
binaryAuthorization

object (BinaryAuthorization)

Configurations liées à l'autorisation binaire
upgradePolicy

object (VmwareClusterUpgradePolicy)

Spécifie la stratégie de mise à niveau du cluster.
disableBundledIngress

boolean

Désactivez l'entrée groupée.

État

État du cycle de vie du cluster d'utilisateur VMware.

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.

VmwareControlPlaneNodeConfig

Spécifie la configuration du nœud de plan de contrôle pour le cluster d'utilisateur VMware.

Représentation JSON 
{
  "cpus": string,
  "memory": string,
  "replicas": string,
  "autoResizeConfig": {
    object (VmwareAutoResizeConfig)
  },
  "vsphereConfig": {
    object (VmwareControlPlaneVsphereConfig)
  }
}
Champs
cpus

string (int64 format)

Nombre de CPU pour chaque nœud de cluster d'administrateur servant de plan de contrôle pour ce cluster d'utilisateur VMware. (par défaut: 4 CPU)
memory

string (int64 format)

Nombre de mégaoctets de mémoire pour chaque nœud de cluster d'administrateur servant de plan de contrôle pour ce cluster d'utilisateur VMware (valeur par défaut: 8 192 Mo de mémoire).
replicas

string (int64 format)

Nombre de nœuds de plan de contrôle pour ce cluster d'utilisateur VMware. (par défaut: 1 réplique)
autoResizeConfig

object (VmwareAutoResizeConfig)

AutoResizeConfig fournit des configurations de redimensionnement automatique.
vsphereConfig

object (VmwareControlPlaneVsphereConfig)

Configuration spécifique à Vsphere.

VmwareControlPlaneVsphereConfig

Spécifie la configuration du nœud de plan de contrôle.

Représentation JSON 
{
  "datastore": string,
  "storagePolicyName": string
}
Champs
datastore

string

Datastore Vsphere utilisé par le nœud de plan de contrôle.
storagePolicyName

string

Règle de stockage vSphere utilisée par le nœud du plan de contrôle.

VmwareStorageConfig

Spécifie la configuration de déploiement des composants CSI vSphere dans le cluster d'utilisateur VMware.

Représentation JSON 
{
  "vsphereCsiDisabled": boolean
}
Champs
vsphereCsiDisabled

boolean

Indique si les composants CSI vSphere doivent être déployés ou non dans le cluster d'utilisateur VMware. Cette option est activée par défaut.

VmwareNetworkConfig

Spécifie la configuration réseau du cluster d'utilisateur VMware.

Représentation JSON 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ],
  "vcenterNetwork": string,
  "hostConfig": {
    object (VmwareHostConfig)
  },
  "controlPlaneV2Config": {
    object (VmwareControlPlaneV2Config)
  },

  // Union field ip_configuration can be only one of the following:
  "staticIpConfig": {
    object (VmwareStaticIpConfig)
  },
  "dhcpIpConfig": {
    object (VmwareDhcpIpConfig)
  }
  // End of list of possible types for union field ip_configuration.
}
Champs
serviceAddressCidrBlocks[]

string

Obligatoire. Une adresse IPv4 RFC1918 de ces plages est attribuée à chaque service du cluster. Une seule plage est acceptée. Ce champ ne peut plus être modifié une fois l'espace créé.
podAddressCidrBlocks[]

string

Obligatoire. Une adresse IPv4 RFC1918 de ces plages est attribuée à chaque pod du cluster. Une seule plage est acceptée. Ce champ ne peut plus être modifié une fois l'espace créé.
vcenterNetwork

string

vcenterNetwork spécifie le nom du réseau vCenter. Hérité du cluster d'administrateur.
hostConfig

object (VmwareHostConfig)

Représente les paramètres réseau courants, quelle que soit l'adresse IP de l'hôte.
controlPlaneV2Config

object (VmwareControlPlaneV2Config)

Configuration pour le mode V2 du plan de contrôle.
Champ d'union ip_configuration. Type de configuration IP utilisé par le cluster d'utilisateurs VMware. ip_configuration ne peut être qu'un des éléments suivants :
staticIpConfig

object (VmwareStaticIpConfig)

Paramètres de configuration pour une adresse IP statique.
dhcpIpConfig

object (VmwareDhcpIpConfig)

Paramètres de configuration pour une configuration IP DHCP.

VmwareControlPlaneV2Config

Spécifie la configuration du plan de contrôle V2.

Représentation JSON 
{
  "controlPlaneIpBlock": {
    object (VmwareIpBlock)
  }
}
Champs
controlPlaneIpBlock

object (VmwareIpBlock)

Adresses IP statiques pour les nœuds du plan de contrôle.

VmwareLoadBalancerConfig

Spécifie la configuration de l'équilibreur de charge local pour le cluster d'utilisateur VMware.

Représentation JSON 
{
  "vipConfig": {
    object (VmwareVipConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "f5Config": {
    object (VmwareF5BigIpConfig)
  },
  "manualLbConfig": {
    object (VmwareManualLbConfig)
  },
  "seesawConfig": {
    object (VmwareSeesawConfig)
  },
  "metalLbConfig": {
    object (VmwareMetalLbConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
Champs
vipConfig

object (VmwareVipConfig)

Adresses IP virtuelles utilisées par l'équilibreur de charge.
Champ d'union load_balancer_configuration. Configuration de l'équilibreur de charge à utiliser dans le cluster d'utilisateur. load_balancer_configuration ne peut être qu'un des éléments suivants :
f5Config

object (VmwareF5BigIpConfig)

Configuration pour les équilibreurs de charge de type F5 Big IP.
manualLbConfig

object (VmwareManualLbConfig)

Équilibreurs de charge configurés manuellement
seesawConfig

object (VmwareSeesawConfig)

Uniquement en sortie. Configuration pour les équilibreurs de charge de type Seesaw.
metalLbConfig

object (VmwareMetalLbConfig)

Configuration pour les équilibreurs de charge de type MetalLB.

VmwareVipConfig

Spécifie la configuration de l'adresse IP virtuelle pour l'équilibreur de charge du cluster d'utilisateur VMware.

Représentation JSON 
{
  "controlPlaneVip": string,
  "ingressVip": string
}
Champs
controlPlaneVip

string

L'adresse IP virtuelle que vous avez précédemment réservée pour l'API Kubernetes de ce cluster.
ingressVip

string

L'adresse IP virtuelle que vous avez précédemment réservée pour le trafic entrant dans ce cluster.

VmwareF5BigIpConfig

Représente les paramètres de configuration d'un équilibreur de charge F5 BIG-IP.

Représentation JSON 
{
  "address": string,
  "partition": string,
  "snatPool": string
}
Champs
address

string

Adresse IP de l'équilibreur de charge.
partition

string

Partition préexistante à utiliser par l'équilibreur de charge. Cette partition est généralement créée pour le cluster d'administration (par exemple, "my-f5-admin-partition").
snatPool

string

Nom du pool. Uniquement nécessaire si vous utilisez la traduction d'adresse réseau source.

VmwareManualLbConfig

Représente les paramètres de configuration d'un équilibreur de charge manuel déjà existant. Compte tenu de la nature des équilibreurs de charge manuels, il est prévu qu'ils soient entièrement gérés par les utilisateurs.

IMPORTANT: Veuillez noter que l'API Anthos On-Prem ne génère ni ne met à jour les configurations ManualLB. Elle ne peut lier qu'une configuration préexistante à un nouveau cluster utilisateur VMware.

Représentation JSON 
{
  "ingressHttpNodePort": integer,
  "ingressHttpsNodePort": integer,
  "controlPlaneNodePort": integer,
  "konnectivityServerNodePort": integer
}
Champs
ingressHttpNodePort

integer

NodePort pour le protocole HTTP du service d'entrée. Le service d'entrée du cluster d'administrateur est mis en œuvre en tant que service de type NodePort (par exemple, 32527).
ingressHttpsNodePort

integer

NodePort pour le protocole HTTPS du service d'entrée. Le service d'entrée du cluster d'administrateur est mis en œuvre en tant que service de type NodePort (par exemple, 30139).
controlPlaneNodePort

integer

NodePort pour le service de plan de contrôle. Le serveur d'API Kubernetes du cluster d'administrateur est mis en œuvre en tant que service de type NodePort (par exemple, 30968).
konnectivityServerNodePort

integer

NodePort pour le service de serveur de connectivité exécuté en tant que sidecar dans chaque pod kube-apiserver (par exemple, 30564).

VmwareSeesawConfig

VmwareSeesawConfig représente les paramètres de configuration d'un équilibreur de charge Seesaw déjà existant.

IMPORTANT: Veuillez noter que l'API Anthos On-Prem ne génère ni ne met à jour de configurations Seesaw. Elle ne peut lier qu'une configuration préexistante à un nouveau cluster d'utilisateurs.

IMPORTANT: Lorsque vous essayez de créer un cluster d'utilisateurs avec un équilibreur de charge Seesaw préexistant, vous devez suivre certaines étapes de préparation avant d'appeler la méthode d'API vmwareClusters.create. Vous devez d'abord créer l'espace de noms du cluster d'utilisateur via kubectl. L'espace de noms doit utiliser la convention d'attribution de noms suivante : -gke-onprem-mgmt ou -gke-onprem-mgmt selon que vous avez utilisé "VmwareCluster.local_name" pour lever les ambiguïtés. Pour en savoir plus, consultez la documentation sur "VmwareCluster.local_name". Une fois l'espace de noms créé, vous devez créer une ressource de secret via kubectl. Ce secret contiendra des copies de vos identifiants Seesaw. Le secret doit être appelé "user-cluster-creds" et contenir les identifiants SSH et de certificat de Seesaw. Les identifiants doivent être associés aux noms suivants: "seesaw-ssh-private-key", "seesaw-ssh-public-key", "seesaw-ssh-ca-key" et "seesaw-ssh-ca-cert".

Représentation JSON 
{
  "group": string,
  "masterIp": string,
  "ipBlocks": [
    {
      object (VmwareIpBlock)
    }
  ],
  "enableHa": boolean,
  "vms": [
    string
  ],
  "stackdriverName": string
}
Champs
group

string

Obligatoire. En général, le format suivant doit être utilisé pour le nom du groupe Seesaw: seesaw-for-[nom du cluster].
masterIp

string

Obligatoire. MasterIP est l'adresse IP annoncée par le maître du groupe Seesaw.
ipBlocks[]

object (VmwareIpBlock)

Obligatoire. Blocs d'adresses IP à utiliser par l'équilibreur de charge Seesaw
enableHa

boolean

Activez deux VM d'équilibrage de charge pour obtenir un équilibreur de charge Seesaw à haute disponibilité.
vms[]

string

Noms des VM créées pour ce groupe Seesaw.
stackdriverName

string

Nom à utiliser par Stackdriver.

VmwareMetalLbConfig

Représente les paramètres de configuration de l'équilibreur de charge MetalLB.

Représentation JSON 
{
  "addressPools": [
    {
      object (VmwareAddressPool)
    }
  ]
}
Champs
addressPools[]

object (VmwareAddressPool)

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.

VmwareAddressPool

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

string

Obligatoire. Nom du pool d'adresses.
addresses[]

string

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

boolean

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.
manualAssign

boolean

Si la valeur est "true", empêchez l'attribution automatique d'adresses IP.

VmwareVCenterConfig

Représente la configuration du VCenter VMware pour le cluster d'utilisateur.

Représentation JSON 
{
  "resourcePool": string,
  "datastore": string,
  "datacenter": string,
  "cluster": string,
  "folder": string,
  "caCertData": string,
  "address": string,
  "storagePolicyName": string
}
Champs
resourcePool

string

Nom du pool de ressources vCenter pour le cluster d'utilisateur.
datastore

string

Nom du datastore vCenter pour le cluster d'utilisateur.
datacenter

string

Nom du centre de données vCenter pour le cluster d'utilisateur.
cluster

string

Nom du cluster vCenter pour le cluster d'utilisateur.
folder

string

Nom du dossier vCenter du cluster d'utilisateur.
caCertData

string

Contient la clé publique du certificat de l'autorité de certification vCenter pour la validation SSL.
address

string

Uniquement en sortie. Adresse IP de vCenter.
storagePolicyName

string

Nom de la règle de stockage vCenter pour le cluster d'utilisateur.

VmwareDataplaneV2Config

Contient des configurations pour Dataplane V2, un plan de données optimisé pour la mise en réseau Kubernetes. Pour en savoir plus, consultez la page https://cloud.google.com/kubernetes-engine/docs/concepts/dataplane-v2.

Représentation JSON 
{
  "dataplaneV2Enabled": boolean,
  "windowsDataplaneV2Enabled": boolean,
  "advancedNetworking": boolean,
  "forwardMode": string
}
Champs
dataplaneV2Enabled

boolean

Active Dataplane V2.
windowsDataplaneV2Enabled

boolean

Activez Dataplane V2 pour les clusters avec des nœuds Windows.
advancedNetworking

boolean

Activez la mise en réseau avancée, qui nécessite que dataplaneV2Enabled soit défini sur "true".
forwardMode

string

Configurez ForwardMode pour Dataplane V2.

VmwareClusterUpgradePolicy

VmwareClusterUpgradePolicy définit la stratégie de mise à niveau du cluster.

Représentation JSON 
{
  "controlPlaneOnly": boolean
}
Champs
controlPlaneOnly

boolean

Indique si la mise à niveau s'applique uniquement au plan de contrôle.

Méthodes

create

 Crée un cluster d'utilisateurs VMware dans un projet et un emplacement donnés.

delete

 Supprime un seul cluster VMware.

enroll

 Enregistre un cluster utilisateur VMware existant et ses pools de nœuds dans l'API Anthos On-Prem dans un projet et un emplacement donnés.

get

 Récupère les détails d'un seul cluster VMware.

list

 Répertorie les clusters VMware d'un projet et d'un emplacement donnés.

patch

 Met à jour les paramètres d'un seul cluster VMware.

queryVersionConfig

 Interroge la configuration de la version du cluster d'utilisateur VMware.