Menentukan folder vSphere dalam konfigurasi cluster

Dokumen ini menunjukkan cara menentukan objek vSphere dalam file konfigurasi cluster jika konfigurasi vCenter berisi folder induk. Dokumen ini juga mendokumentasikan aturan penamaan yang diterapkan oleh validasi preflight yang dimulai dengan 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 kumpulan resource Anda berada di bawah kumpulan resource lain, tentukan kumpulan resource yang berbeda ke kumpulan resource di konfigurasi cluster admin, seperti yang ditampilkan 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 disarangkan di folder vm lain, tentukan jalur ke folder vm Anda di 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 umum terjadi di seluruh file konfigurasi ini.

Aturan Penamaan

Jangan menentukan folder induk ketika menentukan datastore karena nama datastore harus unik di dalam sebuah 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 jika 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  
Dimulai dengan Cluster Anthos di VMware 1.13.0, nama objek vSphere divalidasi sesuai dengan aturan di atas untuk operasi berikut:

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

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, serta
  • 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' 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 bersifat ambigu:

 path xxx resolves to multiple objects 

Untuk memperbaiki error, pastikan jalur tidak berisi nama objek yang bertentangan (seperti satu dalam folder dan satu lagi tanpa). Hapus atau ganti nama objek yang bukan bagian dari 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.