Spécifier des 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 décrit également les règles de dénomination appliquées par les validations de requête préliminaire à partir de la version 1.13.0.

En supposant que l'exemple de configuration vCenter suivant 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'administration 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é sous 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 de VM est imbriqué dans un autre dossier de VM, spécifiez le chemin d'accès complet de votre dossier de VM 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 caractère "/" dans le chemin d'accès complet de votre dossier de vm.

Cela s'applique également à la configuration du cluster d'utilisateur et du poste de travail d'administrateur, car la section vCenter est commune à ces fichiers de configuration.

Règles de dénomination

Ne spécifiez pas le dossier parent lorsque vous spécifiez un datastore, car le nom du datastore doit être unique dans 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 parent 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 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 exemples de situations 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 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 suivante :

 
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'ont pas spécifié le dossier "my-cluster" 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 en conflit (par exemple, un nom présent dans un dossier et un autre sans dossier). Supprimez ou renommez l'objet qui ne fait pas partie du cluster et qui est à l'origine du conflit. Étant donné que les champs vSphere sont immuables une fois le cluster créé, vous devez en créer un autre si le conflit ne peut pas être résolu en modifiant la configuration de vCenter.