Spécifier les dossiers vSphere dans la configuration du cluster

Version 1.15 

• Dernière version
• Version 1.16
• Versions antérieures (non compatibles)

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  

À partir de la version 1.13.0 de Clusters Anthos sur VMware, les noms d'objets vSphere sont validés selon les règles ci-dessus pour les opérations suivantes:

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