Especifique pastas do vSphere na configuração do cluster

Este documento mostra como especificar objetos do vSphere em ficheiros de configuração de clusters quando a configuração do vCenter contém pastas principais. Também documenta as regras de nomenclatura aplicadas pelas validações de pré-lançamento a partir da versão 1.13.0.

Supondo a seguinte configuração do vCenter de exemplo que indica o caminho da raiz do vCenter para o objeto específico

Anfitriões e clusters	VMs e modelos	Armazenamento	Rede
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 criar um cluster do Anthos em my-resource-pool e my-vm-folder usando my-datastore e my-portgroup, especifique a seguinte configuração do cluster 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"

  

Se o seu conjunto de recursos estiver aninhado noutro conjunto de recursos, especifique o caminho completo para o seu conjunto de recursos na configuração do cluster de administrador, conforme mostrado no exemplo seguinte:

    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 criar um cluster de administrador do Anthos no ResourcePool predefinido com my-datastore e my-portgroup, especifique a seguinte configuração do cluster:

    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"
  

Se a pasta vm estiver aninhada noutra pasta vm, especifique o caminho completo para a pasta vm na configuração do cluster de administrador, conforme mostrado no exemplo seguinte:

    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"
  

Tenha em atenção que tem de incluir o primeiro "/" no caminho completo da pasta vm.

Isto também se aplica à configuração do cluster de utilizadores e da estação de trabalho de administrador, uma vez que a secção vCenter é comum a estes ficheiros de configuração.

Regras de nomenclatura

Não especifique a pasta principal quando especificar um arquivo de dados, uma vez que o nome do arquivo de dados tem de ser exclusivo num centro de dados. Se for especificada uma pasta, é devolvido o seguinte erro:

  Datastore name 'storage-folder/my-datastore' should not contain parent folders

Para todos os outros tipos de objetos do vSphere, a pasta principal deve ser especificada quando a configuração do vCenter contém pastas principais. Se as pastas principais necessárias não forem especificadas na configuração do cluster, mas estiverem presentes na configuração do vCenter, é devolvido o seguinte erro:

 Parent folder is not specified for cluster, you must specify the full path 'clusters/my-cluster' in the cluster field  

A partir dos clusters do Anthos no VMware 1.13.0, os nomes dos objetos do vSphere são validados de acordo com as regras acima para as seguintes operações:

• gkectl create
• gkectl check-config

Ainda existe a possibilidade de uma resolução de objetos do vSphere ser ambígua nas seguintes situações de exemplo

• Um cluster é atualizado a partir de uma versão anterior que viola as regras de nomenclatura e a configuração do vCenter contém uma pasta/objeto em conflito, e
• Os objetos com nomes em conflito não estavam presentes durante a criação do cluster, mas foram adicionados posteriormente

Por exemplo, considere a configuração do vCenter fornecida

 
my-vcenter
  my-datacenter-folder
    my-datacenter
      my-cluster-folder
        my-cluster
          my-resourcepool
  

Em seguida, se a seguinte hierarquia for adicionada mais tarde

my-vcenter
  my-datacenter-folder
    my-datacenter
      my-cluster
        my-resourcepool
  

A resolução de "my-resourcepool" é ambígua se os ficheiros de configuração não tiverem especificado my-cluster-folder durante a criação do cluster

Pode encontrar o seguinte erro: path 'my-resourcepool' resolves to multiple resource pools

De forma mais geral, a biblioteca vSphere devolve a seguinte mensagem de erro quando a resolução de objetos é ambígua:

 path xxx resolves to multiple objects 

Para corrigir o erro, certifique-se de que o caminho não contém nomes de objetos em conflito (como um numa pasta e outro sem pasta). Remova ou mude o nome do objeto que não pertence ao cluster e causa o conflito. Uma vez que os campos do vSphere são imutáveis após a criação do cluster, é necessária a criação de um novo cluster se o conflito não puder ser resolvido modificando a configuração do vCenter.