Especifica carpetas de vSphere en la configuración del clúster

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  
A partir de los clústeres de Anthos alojados en VMware 1.13.0, los nombres de objetos de vSphere se validan según las reglas anteriores para las operaciones siguientes:

  • 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.