Ce document explique comment spécifier des objets vSphere dans les fichiers de configuration de cluster lorsque la configuration vCenter contient des dossiers parents. Il documente également les règles de dénomination appliquées par les validations préliminaires à partir de la version 1.13.0.
Prenons l'exemple de configuration vCenter suivant, qui indique le chemin d'accès de la racine vCenter à l'objet spécifique
Hôtes et clusters |
VM et modèles |
Stockage |
Réseau |
|---|---|---|---|
my-vcenter
my-datacenter-folder
my-datacenter
my-cluster-folder
my-cluster
my-resourcepool
|
my-vcenter
my-datacenter-folder
my-datacenter
my-vm-folder
|
my-vcenter
my-datacenter-folder
my-datacenter
my-storage-folder
my-datastore
|
my-vcenter
my-datacenter-folder
my-datacenter
my-network-folder
my-portgroup
|
Pour créer un cluster Anthos dans my-resource-pool et my-vm-folder à l'aide de my-datastore et my-portgroup, spécifiez la configuration de cluster d'administrateur suivante:
vCenter:
address: "my-vcenter"
datacenter: "my-datacenter-folder/my-datacenter"
cluster: "my-cluster-folder/my-cluster"
resourcePool: "my-resourcepool"
datastore: "my-datastore"
folder: "my-vm-folder"
network:
vCenter:
networkName: "my-network-folder/my-portgroup"
Si votre pool de ressources est imbriqué dans un autre pool de ressources, spécifiez le chemin d'accès complet à votre pool de ressources dans la configuration de votre cluster d'administrateur, comme illustré dans l'exemple suivant:
vCenter:
address: "my-vcenter"
datacenter: "my-datacenter-folder/my-datacenter"
cluster: "my-cluster-folder/my-cluster"
resourcePool: "my-cluster-folder/my-cluster/Resources/my-resourcepool/my-nested-resourcepool"
datastore: "my-datastore"
folder: "my-vm-folder"
network:
vCenter:
networkName: "my-network-folder/my-portgroup"
Pour créer un cluster d'administrateur Anthos dans le pool de ressources par défaut à l'aide de my-datastore et my-portgroup, spécifiez la configuration de cluster suivante:
vCenter:
address: "my-vcenter"
datacenter: "my-datacenter-folder/my-datacenter"
cluster: "my-cluster-folder/my-cluster"
resourcePool: "my-cluster-folder/my-cluster/Resources"
datastore: "my-datastore"
folder: "my-vm-folder"
network:
vCenter:
networkName: "my-network-folder/my-portgroup"
Si le dossier de votre VM est imbriqué dans un autre dossier de VM, spécifiez le chemin d'accès complet à ce dossier dans la configuration de votre cluster d'administrateur, comme illustré dans l'exemple suivant:
vCenter:
address: "my-vcenter"
datacenter: "my-datacenter-folder/my-datacenter"
cluster: "my-cluster-folder/my-cluster"
resourcePool: "my-resourcepool"
datastore: "my-datastore"
folder: "/my-datacenter-folder/my-datacenter/vm/my-vm-folder/my-nested-vm-folder"
network:
vCenter:
networkName: "my-network-folder/my-portgroup"
Notez que vous devez inclure la première barre oblique ("/") dans le chemin d'accès complet du dossier de votre VM.
Cela s'applique également à la configuration du cluster d'utilisateur et du poste de travail administrateur, car la section vCenter est commune à tous ces fichiers de configuration.
Règles d'attribution de noms
Ne spécifiez pas le dossier parent lorsque vous spécifiez un magasin de données, car le nom du magasin de données doit être unique au sein d'un centre de données. Si un dossier est spécifié, l'erreur suivante est renvoyée:
Datastore name 'storage-folder/my-datastore' should not contain parent folders
Pour tous les autres types d'objets vSphere, le dossier parent doit être spécifié lorsque la configuration vCenter contient des dossiers parents. Si les dossiers parents requis ne sont pas spécifiés dans la configuration du cluster, mais présents dans la configuration vCenter, l'erreur suivante est renvoyée:
Parent folder is not specified for cluster, you must specify the full path 'clusters/my-cluster' in the cluster field
- gkectl create
- gkectl check-config
Il est toujours possible qu'une résolution d'objet vSphere soit ambiguë dans les situations suivantes :
- Un cluster est mis à niveau à partir d'une version précédente qui ne respecte pas les règles de dénomination, et la configuration vCenter contient un dossier/objet en conflit.
- Les objets avec des noms en conflit n'étaient pas présents lors de la création du cluster, mais ont été ajoutés ultérieurement
Prenons l'exemple de la configuration vCenter donnée
my-vcenter
my-datacenter-folder
my-datacenter
my-cluster-folder
my-cluster
my-resourcepool
Si la hiérarchie suivante est ajoutée ultérieurement,
my-vcenter
my-datacenter-folder
my-datacenter
my-cluster
my-resourcepool
La résolution de "my-resourcepool" est ambiguë si le dossier "my-cluster-folder" n'est pas spécifié dans les fichiers de configuration lors de la création du cluster
Vous pouvez rencontrer l'erreur suivante :
path 'my-resourcepool' resolves to multiple resource pools
Plus généralement, la bibliothèque vSphere renvoie le message d'erreur suivant lorsque la résolution de l'objet est ambiguë:
path xxx resolves to multiple objects
Pour corriger cette erreur, assurez-vous que le chemin d'accès ne contient pas de noms d'objets en conflit (un dans un dossier et un sans, par exemple). Supprimez ou renommez l'objet qui n'appartient pas au cluster et qui provoque le conflit. Les champs vSphere étant immuables une fois le cluster créé, une création de cluster est nécessaire si le conflit ne peut pas être résolu en modifiant la configuration vCenter.