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