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 comprobación previa a partir de la versión 1.13.0.
En la siguiente configuración de vCenter de ejemplo que indica la ruta de acceso de la raíz de vCenter al 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 grupo de recursos, especifica la ruta completa al grupo de recursos en la configuración de tu 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 mediante 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 vm.
Esto también se aplica a la configuración de la estación de trabajo de administrador y del clúster de usuario, ya que la sección de vCenter es común en estos archivos de configuración.
Reglas de nombres
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 principales requeridas 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 una resolución de objetos 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 nombres, 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 adelante.
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 se agrega 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 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 de objetos es ambigua:
path xxx resolves to multiple objects
Para corregir el error, asegúrate de que la ruta de acceso no contenga nombres de objetos en conflicto (como uno dentro de una carpeta y otro sin ellas). Quita o cambia el nombre del objeto que no pertenece al clúster y causa el conflicto. Debido a 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 mediante la modificación de la configuración de vCenter.