Questo documento mostra come specificare gli oggetti vSphere nei file di configurazione del cluster quando la configurazione di vCenter contiene cartelle principali. Vengono inoltre documentate le regole di denominazione applicate dalle verifiche preliminari a partire dalla versione 1.13.0.
Supponiamo che la seguente configurazione di esempio di vCenter indichi il percorso dalla radice di 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 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 ResourcePool 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 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 "/" 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 durante la specifica di un data store, in quanto il nome del data store 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 principale deve essere specificata quando la configurazione di vCenter contiene cartelle principali. Se le cartelle principali 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
- gkectl create
- gkectl check-config
Esiste ancora la possibilità che la risoluzione di un oggetto vSphere sia ambigua nei seguenti esempi di situazioni
- 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 seguente configurazione di vCenter
my-vcenter
my-datacenter-folder
my-datacenter
my-cluster-folder
my-cluster
my-resourcepool
Successivamente, 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 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 sono immutabili una volta creato il cluster, è necessaria la creazione di un nuovo cluster se il conflitto non può essere risolto modificando la configurazione di vCenter.