Questo documento mostra come specificare gli oggetti vSphere nei file di configurazione del cluster quando la configurazione di vCenter contiene cartelle principali. Descrive anche le regole di denominazione applicate dalle convalide preliminari a partire dalla versione 1.13.0.
Supponendo la seguente configurazione di vCenter di esempio che indica il percorso dalla root 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 della VM è nidificata in un'altra cartella della VM, specifica il percorso completo della cartella della 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 della 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 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, 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 nelle seguenti situazioni di esempio
- Un cluster viene sottoposto ad upgrade 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 di vCenter indicata
my-vcenter
my-datacenter-folder
my-datacenter
my-cluster-folder
my-cluster
my-resourcepool
Se in un secondo momento viene aggiunta la seguente gerarchia
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 my-cluster-folder durante la creazione del cluster
Potresti riscontrare il seguente errore:
path 'my-resourcepool' resolves to multiple resource pools
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.