Spécifier les dossiers vSphere dans la configuration du cluster

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	Espace de 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 de "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 votre dossier "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 le premier "/" dans le chemin d'accès complet du dossier "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 datastore. En effet, le nom du datastore 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 qu'ils sont 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 en fonction des règles ci-dessus pour les opérations suivantes:

• gkectl create
• gkectl check-config

Il est toujours possible que la résolution d'un objet vSphere soit ambiguë dans les exemples suivants.

• 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, et
• Les objets ayant des noms contradictoires n'étaient pas présents lors de la création du cluster, mais ont été ajoutés ultérieurement

Prenons par exemple la configuration vCenter donnée

 
my-vcenter
  my-datacenter-folder
    my-datacenter
      my-cluster-folder
        my-cluster
          my-resourcepool
  

Ensuite, 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 les fichiers de configuration n'indiquaient pas le dossier "my-cluster-folder" 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 l'erreur, assurez-vous que le chemin d'accès ne contient pas de noms d'objets conflictuels (par exemple, un nom d'objet dans un dossier et un autre sans). Supprimez ou renommez l'objet qui n'appartient pas au cluster et provoque le conflit. Étant donné que les champs vSphere sont immuables une fois le cluster créé, une nouvelle création de cluster est requise si le conflit ne peut pas être résolu en modifiant la configuration vCenter.