Dokumen ini menunjukkan cara menentukan objek vSphere dalam file konfigurasi cluster saat konfigurasi vCenter berisi folder induk. Bagian ini juga mendokumentasikan aturan penamaan yang diterapkan oleh validasi pra-penerbangan yang dimulai dengan 1.13.0.
Dengan asumsi konfigurasi vCenter contoh 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 jalur lengkap ke kumpulan resource 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-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 berada di dalam 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 cluster pengguna dan workstation admin karena bagian vCenter umum di seluruh file konfigurasi ini.
Aturan Penamaan
Jangan tentukan 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
- gkectl create
- gkectl check-config
Masih ada kemungkinan bahwa resolusi objek vSphere 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 kemudian
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 umum, library vSphere menampilkan pesan error berikut saat resolusi objek tidak jelas:
path xxx resolves to multiple objects
Untuk memperbaiki error, pastikan jalur tidak berisi nama objek yang bertentangan (seperti satu di dalam folder dan satu di luar). 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.