Specifica le cartelle vSphere nella configurazione del cluster

Questo documento mostra come specificare gli oggetti vSphere nei file di configurazione del cluster quando la configurazione di vCenter contiene cartelle padre. Documenta inoltre le regole di denominazione applicate dalle convalide preflight a partire dalla versione 1.13.0.

Presumendo la seguente configurazione di vCenter di esempio che indica il percorso dalla directory principale di vCenter all'oggetto specifico

Host e cluster

VM e modelli

Storage

Rete

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
        

Per creare un cluster Anthos in my-resource-pool e my-vm-folder utilizzando my-datastore e my-portgroup, specifica la seguente configurazione del cluster di amministrazione:

    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"

  

Se il pool di risorse è nidificato in un altro pool di risorse, specifica il percorso completo del pool di risorse nella configurazione del cluster di amministrazione, come mostrato nell'esempio seguente:

    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"
  

Per creare un cluster di amministrazione Anthos nel pool di risorse predefinito utilizzando my-datastore e my-portgroup, specifica la seguente configurazione del cluster:

    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"
  

Se la tua cartella VM è nidificata in un'altra cartella VM, specifica il percorso completo della cartella VM nella configurazione del cluster di amministrazione, come mostrato nell'esempio seguente:

    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"
  

Tieni presente che devi includere il primo carattere "/" nel percorso completo della cartella VM.

Questo vale anche per la configurazione del cluster utente e della workstation di amministrazione poiché la sezione vCenter è comune a questi file di configurazione.

Regole di denominazione

Non specificare la cartella principale mentre specifichi un datastore, in quanto il nome del datastore deve essere univoco all'interno di un data center. Se viene specificata una cartella, viene restituito il seguente errore:

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

Per tutti gli altri tipi di oggetti vSphere, la cartella padre deve essere specificata quando la configurazione vCenter contiene cartelle padre. Se le cartelle padre richieste non sono specificate nella configurazione del cluster, ma sono presenti nella configurazione di vCenter, viene restituito il seguente errore:

 Parent folder is not specified for cluster, you must specify the full path 'clusters/my-cluster' in the cluster field  
A partire da Anthos Clusters su VMware 1.13.0, i nomi degli oggetti vSphere vengono convalidati in base alle regole riportate sopra per le seguenti operazioni:

  • Creazione gkectl
  • check-config gkectl

È ancora possibile che la risoluzione di un oggetto vSphere sia ambigua nelle seguenti situazioni di esempio

  • Viene eseguito l'upgrade di un cluster da una versione precedente che viola le regole di denominazione e la configurazione di vCenter contiene una cartella/un oggetto in conflitto e
  • Gli oggetti con nomi in conflitto non erano presenti durante la creazione del cluster, ma sono stati aggiunti in un secondo momento

Ad esempio, considera la configurazione vCenter specificata

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

Se la seguente gerarchia viene aggiunta in un secondo momento

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

La risoluzione di "my-resourcepool" è ambigua se i file di configurazione non hanno specificato la cartella my-cluster-folder durante la creazione del cluster

Potresti riscontrare il seguente errore: path 'my-resourcepool' resolves to multiple resource pools

Più in generale, la libreria vSphere restituisce il seguente messaggio di errore quando la risoluzione dell'oggetto è ambigua:

 path xxx resolves to multiple objects 

Per correggere l'errore, assicurati che il percorso non contenga nomi di oggetti in conflitto (ad esempio uno all'interno di una cartella e uno senza). Rimuovi o rinomina l'oggetto che non appartiene al cluster e causa il conflitto. Poiché i campi vSphere non possono essere modificati una volta creato il cluster, è necessaria una nuova creazione del cluster se il conflitto non può essere risolto modificando la configurazione di vCenter.