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 vCenter contiene cartelle principali. 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 radice vCenter all'oggetto specifico

Host e cluster	VM e modelli	Archiviazione	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 all'interno di un altro pool di risorse, specifica il percorso completo del pool di risorse nella configurazione del cluster di amministrazione, come illustrato 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 padre quando specifichi un datastore poiché 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, è necessario specificare la cartella principale se la configurazione vCenter contiene cartelle principali. Se le cartelle padre richieste non sono specificate nella configurazione del cluster, ma sono presenti nella configurazione 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 on VMware 1.13.0, i nomi degli oggetti vSphere vengono convalidati in base alle regole riportate sopra per le seguenti operazioni:

• gkectl crea
• configurazione di controllo gkectl

Esiste ancora una possibilità 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

Considera ad esempio la configurazione vCenter specificata

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

Se in un secondo momento verrà aggiunta la seguente gerarchia

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

la risoluzione di "my-resourcepool" è ambigua se nei file di configurazione non è stata specificata la cartella my-cluster-durante la creazione del cluster

Potrebbe verificarsi 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. Una volta creato il cluster, i campi vSphere sono immutabili, pertanto è necessario creare un nuovo cluster se il conflitto non può essere risolto modificando la configurazione di vCenter.