vSphere-Ordner in der Clusterkonfiguration angeben

In diesem Dokument wird gezeigt, wie Sie vSphere-Objekte in Clusterkonfigurationsdateien angeben, wenn die vCenter-Konfiguration übergeordnete Ordner enthält. Außerdem werden die Benennungsregeln dokumentiert, die von Preflight-Validierungen ab Version 1.13.0 angewendet werden.

Angenommen, die folgende vCenter-Beispielkonfiguration gibt den Pfad vom vCenter-Stammverzeichnis zum spezifischen Objekt an

Hosts und Cluster	VMs und Vorlagen	Speicher	Netzwerk
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

Geben Sie die folgende Administratorclusterkonfiguration an, um einen Anthos-Cluster in "my-resource-pool" und "my-vm-folder" mit "my-datastore" und "my-portgroup" zu erstellen:

    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"

  

Wenn Ihr Ressourcenpool unter einem anderen Ressourcenpool verschachtelt ist, geben Sie den vollständigen Pfad zu Ihrem Ressourcenpool in der Konfiguration des Administratorclusters an, wie im folgenden Beispiel gezeigt:

    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"
  

Geben Sie die folgende Clusterkonfiguration an, um mit „my-datastore“ und „my-portgroup“ einen Anthos-Administratorcluster im standardmäßigen ResourcePool zu erstellen:

    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"
  

Wenn Ihr VM-Ordner in einem anderen VM-Ordner verschachtelt ist, geben Sie den vollständigen Pfad zu Ihrem VM-Ordner in der Konfiguration des Administratorclusters an, wie im folgenden Beispiel gezeigt:

    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"
  

Beachten Sie, dass Sie den ersten „/“ im vollständigen Pfad des VM-Ordners einfügen müssen.

Dies gilt auch für die Konfiguration von Nutzerclustern und Administrator-Workstations, da der vCenter-Abschnitt in diesen Konfigurationsdateien gemeinsam verwendet wird.

Regeln benennen

Geben Sie den übergeordneten Ordner nicht an, wenn Sie einen Datenspeicher angeben, da der Datenspeichername innerhalb eines Rechenzentrums eindeutig sein muss. Wenn ein Ordner angegeben ist, wird der folgende Fehler zurückgegeben:

  Datastore name 'storage-folder/my-datastore' should not contain parent folders

Bei allen anderen vSphere-Objekttypen sollte der übergeordnete Ordner angegeben werden, wenn die vCenter-Konfiguration übergeordnete Ordner enthält. Wenn die erforderlichen übergeordneten Ordner nicht in der Clusterkonfiguration angegeben, aber in der vCenter-Konfiguration vorhanden sind, wird der folgende Fehler zurückgegeben:

 Parent folder is not specified for cluster, you must specify the full path 'clusters/my-cluster' in the cluster field  

Ab Anthos-Cluster auf VMware 1.13.0 werden vSphere-Objektnamen gemäß den oben genannten Regeln für die folgenden Vorgänge validiert:

• gkectl erstellen
• gkectl check-config

Es besteht weiterhin die Möglichkeit, dass die vSphere-Objektauflösung in den folgenden Beispielsituationen mehrdeutig ist

• Ein Cluster wird von einer vorherigen Version aktualisiert, die gegen die Benennungsregeln verstößt und die vCenter-Konfiguration einen in Konflikt stehenden Ordner/Objekt enthält.
• Objekte mit in Konflikt stehenden Namen waren bei der Clustererstellung nicht vorhanden, wurden aber später hinzugefügt

Betrachten Sie beispielsweise die angegebene vCenter-Konfiguration

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

Als Nächstes, wenn die folgende Hierarchie später hinzugefügt wird:

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

Die Auflösung von "my-resourcepool" ist mehrdeutig, wenn die Konfigurationsdateien den "my-cluster-folder" bei der Clustererstellung nicht angegeben haben.

Der folgende Fehler kann auftreten: path 'my-resourcepool' resolves to multiple resource pools

Im Allgemeinen gibt die vSphere-Bibliothek die folgende Fehlermeldung zurück, wenn die Objektauflösung mehrdeutig ist:

 path xxx resolves to multiple objects 

Um den Fehler zu beheben, achten Sie darauf, dass der Pfad keine in Konflikt stehenden Objektnamen enthält (z. B. einen Objektnamen innerhalb eines Ordners und einen ohne.). Entfernen Sie das Objekt, das nicht zum Cluster gehört und den Konflikt verursacht, oder benennen Sie es um. Da die vSphere-Felder nach dem Erstellen des Clusters unveränderlich sind, ist ein neuer Cluster erforderlich, wenn der Konflikt nicht durch Ändern der vCenter-Konfiguration gelöst werden kann.