En este documento se explica cómo especificar objetos de vSphere en archivos de configuración de clústeres cuando la configuración de vCenter contiene carpetas principales. También se documentan las reglas de nomenclatura aplicadas por las validaciones previas a partir de la versión 1.13.0.
Supongamos que tiene la siguiente configuración de vCenter, que indica la ruta desde la raíz de vCenter hasta el objeto específico:
Hosts y clústeres |
Máquinas virtuales y plantillas |
Almacenamiento |
Red |
|---|---|---|---|
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
|
Para crear un clúster de Anthos en my-resource-pool y my-vm-folder con my-datastore y my-portgroup, especifica la siguiente configuración del clúster de administrador:
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"
Si tu grupo de recursos está anidado en otro grupo de recursos, especifica la ruta completa a tu grupo de recursos en la configuración del clúster de administrador, como se muestra en el siguiente ejemplo:
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"
Para crear un clúster de administrador de Anthos en el ResourcePool predeterminado con my-datastore y my-portgroup, especifica la siguiente configuración del clúster:
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"
Si tu carpeta vm está anidada en otra carpeta vm, especifica la ruta completa a tu carpeta vm en la configuración del clúster de administrador, como se muestra en el siguiente ejemplo:
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"
Ten en cuenta que debes incluir la primera "/" en la ruta completa de la carpeta de la máquina virtual.
Esto también se aplica a la configuración de los clústeres de usuarios y de las estaciones de trabajo de administrador, ya que la sección de vCenter es común en estos archivos de configuración.
Reglas de nomenclatura
No especifiques la carpeta principal al indicar un almacén de datos, ya que el nombre del almacén de datos debe ser único en el centro de datos. Si se especifica una carpeta, se devuelve el siguiente error:
Datastore name 'storage-folder/my-datastore' should not contain parent folders
En el caso de todos los demás tipos de objetos de vSphere, la carpeta superior debe especificarse cuando la configuración de vCenter contenga carpetas superiores. Si las carpetas principales obligatorias no se especifican en la configuración del clúster, pero están presentes en la configuración de vCenter, se devuelve el siguiente error:
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
Aun así, es posible que la resolución de un objeto de vSphere sea ambigua en las siguientes situaciones de ejemplo
- Un clúster se actualiza desde una versión anterior que infringe las reglas de nomenclatura y la configuración de vCenter contiene una carpeta u objeto en conflicto.
- Los objetos con nombres conflictivos no estaban presentes durante la creación del clúster, pero se añadieron más tarde
Por ejemplo, considere la configuración de vCenter que se muestra a continuación.
my-vcenter
my-datacenter-folder
my-datacenter
my-cluster-folder
my-cluster
my-resourcepool
A continuación, si se añade la siguiente jerarquía más adelante
my-vcenter
my-datacenter-folder
my-datacenter
my-cluster
my-resourcepool
La resolución de "my-resourcepool" es ambigua si los archivos de configuración no especificaron my-cluster-folder durante la creación del clúster.
Puede que se produzca el siguiente error:
path 'my-resourcepool' resolves to multiple resource pools
En general, la biblioteca de vSphere devuelve el siguiente mensaje de error cuando la resolución del objeto es ambigua:
path xxx resolves to multiple objects
Para corregir el error, asegúrese de que la ruta no contenga nombres de objeto que entren en conflicto (por ejemplo, uno dentro de una carpeta y otro fuera). Elimina o cambia el nombre del objeto que no pertenece al clúster y provoca el conflicto. Como los campos de vSphere no se pueden modificar una vez creado el clúster, es necesario crear un clúster si el conflicto no se puede resolver modificando la configuración de vCenter.