En este documento, se muestra cómo especificar objetos de vSphere en los archivos de configuración del clúster cuando la configuración de vCenter contiene carpetas superiores. También documenta las reglas de nomenclatura que aplican las validaciones de las comprobaciones preliminares a partir de la versión 1.13.0.
Supongamos que la siguiente configuración de vCenter de ejemplo 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 tu grupo de recursos está anidado en otro, 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 la carpeta de VM está anidada en otra carpeta de VM, especifica la ruta de acceso 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 tu 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 todos estos archivos de configuración.
Reglas de nomenclatura
No especifiques la carpeta superior mientras especificas un almacén de datos, ya que 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
- gkectl create
- gkectl check-config
Aún existe la posibilidad de 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 asignación de nombres y la configuración de vCenter contiene una carpeta o un objeto en conflicto.
- Los objetos con nombres en conflicto no estuvieron presentes durante la creación del clúster, pero se agregaron más tarde
Por ejemplo, considera la configuración de vCenter dada
my-vcenter
my-datacenter-folder
my-datacenter
my-cluster-folder
my-cluster
my-resourcepool
A continuación, si la siguiente jerarquía se agrega 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 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 él). 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 una creación de clúster nuevo si el conflicto no se puede resolver mediante la modificación de la configuración de vCenter.