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 preflight dimulai dengan 1.13.0.

Dengan asumsi bahwa contoh konfigurasi vCenter berikut 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 kumpulan resource Anda disusun bertingkat dalam kumpulan resource lain, tentukan jalur lengkap ke kumpulan resource Anda dalam konfigurasi cluster admin, seperti 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 ditempatkan di folder vm lain, tentukan jalur lengkap ke folder vm Anda 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 Anda.

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

Aturan Penamaan

Jangan menentukan folder induk saat menentukan datastore karena nama datastore harus unik dalam pusat data. 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 dari Cluster Anthos di VMware 1.13.0, nama objek vSphere divalidasi sesuai dengan aturan di atas untuk operasi berikut:

  • buat gkectl
  • {i>gkectl check-config<i}

Masih ada kemungkinan bahwa resolusi objek vSphere ambigu dalam situasi contoh 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 kemudian

Misalnya, pertimbangkan konfigurasi vCenter yang diberikan

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

Berikutnya, jika hierarki berikut ditambahkan nanti

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

resolusi 'my-resourcepool' bersifat 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 jika resolusi objek ambigu: 

 path xxx resolves to multiple objects

Untuk memperbaiki error, pastikan jalur tidak berisi nama objek yang bertentangan (misalnya nama dalam folder dan nama tanpa nama). 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.