En este documento, se muestra cómo especificar objetos de vSphere en los archivos de configuración de clústeres cuando la configuración de vCenter contiene carpetas superiores. También documenta las reglas de nomenclatura aplicadas por las validaciones preliminares a partir de la versión 1.13.0.
El siguiente ejemplo de configuración de vCenter indica la ruta de acceso desde la raíz de vCenter hasta el objeto específico
Hosts y clústeres |
VMs 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 el grupo de recursos está anidado en otro grupo de recursos, especifica la ruta completa al 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 de VM está anidada en otra carpeta de VM, especifica la ruta completa a la carpeta de 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 VM.
Esto también se aplica a la configuración del clúster de usuario y de la estación de trabajo de administrador, ya que la sección de vCenter es común en estos archivos de configuración.
Reglas de denominación
No especifiques la carpeta superior mientras especificas un almacén de datos como su nombre debe ser único dentro de un centro de datos. Si se especifica una carpeta, se muestra el siguiente error:
Datastore name 'storage-folder/my-datastore' should not contain parent folders
Para todos los demás tipos de objetos de vSphere, la carpeta superior debe especificarse cuando la configuración de vCenter contiene carpetas superiores. Si las carpetas superiores necesarias no se especifican en la configuración del clúster, pero están presentes en la configuración de vCenter, se muestra el siguiente error:
Parent folder is not specified for cluster, you must specify the full path 'clusters/my-cluster' in the cluster field
- Crear gkectl
- gkectl check-config
Aún existe la posibilidad de que una resolución de 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 o un objeto en conflicto.
- Los objetos con nombres en conflicto no estaban presentes durante la creación del clúster, pero se agregaron más tarde.
Por ejemplo, considera la configuración dada de vCenter
my-vcenter
my-datacenter-folder
my-datacenter
my-cluster-folder
my-cluster
my-resourcepool
Luego, si se agrega la siguiente jerarquía
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 la carpeta my-cluster durante la creación del clúster
Es posible que encuentres el siguiente error:
path 'my-resourcepool' resolves to multiple resource pools
En términos más generales, la biblioteca de vSphere muestra el siguiente mensaje de error cuando la resolución del objeto es ambigua:
path xxx resolves to multiple objects
Para corregir el error, asegúrate de que la ruta de acceso no contenga nombres de objeto en conflicto (como uno dentro de una carpeta y otro sin ellos). Quita o cambia el nombre del objeto que no pertenece al clúster y causa el conflicto. Dado que los campos de vSphere son inmutables una vez que se crea el clúster, se requiere la creación de un clúster nuevo si el conflicto no se puede resolver modificando la configuración de vCenter.