Menentukan folder vSphere dalam konfigurasi cluster

Dokumen ini menunjukkan cara menentukan objek vSphere dalam file konfigurasi cluster saat konfigurasi vCenter berisi folder induk. Dokumen ini juga mendokumentasikan aturan penamaan yang diterapkan oleh validasi pra-penerbangan mulai dari versi 1.13.0.

Dengan asumsi contoh konfigurasi vCenter berikut yang menunjukkan jalur dari root vCenter ke objek tertentu

Host dan Cluster	VM dan Template	Penyimpanan	Jaringan
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

Untuk membuat cluster Anthos di my-resource-pool dan my-vm-folder menggunakan my-datastore dan my-portgroup, tentukan konfigurasi cluster admin berikut:

    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"

  

Jika resource pool Anda disusun bertingkat dalam resource pool lain, tentukan jalur lengkap ke resource pool dalam konfigurasi cluster admin, seperti yang ditunjukkan dalam contoh berikut:

    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"
  

Untuk membuat cluster admin Anthos di ResourcePool default menggunakan my-datastore dan my-portgroup, tentukan konfigurasi cluster berikut:

    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"
  

Jika folder vm Anda disusun bertingkat dalam folder vm lain, tentukan jalur lengkap ke folder vm dalam konfigurasi cluster admin, seperti yang ditunjukkan dalam contoh berikut:

    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"
  

Perhatikan bahwa Anda harus menyertakan "/" pertama di jalur lengkap folder vm.

Hal ini juga berlaku untuk konfigurasi workstation admin dan cluster pengguna karena bagian vCenter umum di seluruh file konfigurasi ini.

Aturan Penamaan

Jangan menentukan folder induk saat menentukan datastore karena nama datastore harus unik dalam datacenter. Jika folder ditentukan, error berikut akan ditampilkan:

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

Untuk semua jenis objek vSphere lainnya, folder induk harus ditentukan saat konfigurasi vCenter berisi folder induk. Jika folder induk yang diperlukan tidak ditentukan dalam konfigurasi cluster, tetapi ada dalam konfigurasi vCenter, error berikut akan ditampilkan:

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

Mulai Cluster Anthos di VMware 1.13.0, nama objek vSphere divalidasi sesuai dengan aturan di atas untuk operasi berikut:

• gkectl create
• gkectl check-config

Masih ada kemungkinan bahwa resolusi objek vSphere bersifat ambigu dalam contoh situasi berikut

• Cluster diupgrade dari versi sebelumnya yang melanggar aturan penamaan dan konfigurasi vCenter berisi folder/objek yang bertentangan, dan
• Objek dengan nama yang bertentangan tidak ada selama pembuatan cluster, tetapi ditambahkan nanti

Misalnya, pertimbangkan konfigurasi vCenter yang diberikan

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

Selanjutnya, jika hierarki berikut ditambahkan nanti

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

resolusi 'my-resourcepool' ambigu jika file konfigurasi tidak menentukan my-cluster-folder selama pembuatan cluster

Anda mungkin mengalami error berikut: path 'my-resourcepool' resolves to multiple resource pools

Secara lebih umum, library vSphere menampilkan pesan error berikut saat resolusi objek ambigu:

 path xxx resolves to multiple objects 

Untuk memperbaiki error, pastikan jalur tidak berisi nama objek yang bertentangan (seperti satu dalam folder dan satu tanpa folder). Hapus atau ganti nama objek yang bukan milik cluster dan menyebabkan konflik. Karena kolom vSphere tidak dapat diubah setelah cluster dibuat, pembuatan cluster baru diperlukan jika konflik tidak dapat diselesaikan dengan mengubah konfigurasi vCenter.