Dokumen ini memberikan informasi tentang pemeriksaan awal yang dijalankan saat Anda membuat atau mengupgrade cluster di Google Distributed Cloud (khusus software) untuk VMware.
Tinjau aturan firewall Anda
Pada versi 1.29 dan yang lebih baru, pemeriksaan pra-penerbangan sisi server diaktifkan secara default saat Anda membuat, mengupdate, dan mengupgrade cluster. Pemeriksaan pra-penerbangan sisi server memerlukan aturan firewall tambahan. Di Firewall rules for admin clusters, telusuri "Preflight checks" dan pastikan semua aturan firewall yang diperlukan telah dikonfigurasi.
Menjalankan gkectl check-config
Jika Anda berencana membuat cluster menggunakan gkectl, jalankan gkectl create-config untuk
membuat file konfigurasi. File konfigurasi mendorong penginstalan Anda:
Anda memberikan informasi tentang lingkungan vSphere, jaringan, dan load balancer, serta tampilan cluster yang Anda inginkan. Anda dapat membuat
file konfigurasi sebelum atau setelah membuat workstation admin. Agar
pemeriksaan tertentu lulus, pemeriksaan tersebut harus dijalankan dari workstation admin.
Setelah mengubah file agar sesuai dengan kebutuhan lingkungan dan cluster Anda, Anda menggunakan file tersebut untuk membuat cluster di lingkungan lokal.
Sebelum membuat cluster menggunakan gkectl, jalankan gkectl check-config untuk
memvalidasi file konfigurasi dengan beberapa pemeriksaan awal.
Jika perintah menampilkan pesan FAILURE, perbaiki masalahnya
dan validasi kembali file. Jika validasi fitur tertentu menampilkan pesan PERINGATAN, Anda harus memperbaiki masalah yang mendasarinya sebelum dapat menggunakan fitur tersebut.
Mode pemeriksaan preflight dan melewati validasi
gkectl check-config memiliki mode default dan mode cepat:
Dalam mode default, perintah akan memvalidasi setiap kolom secara komprehensif. Selain itu, mode default membuat virtual machine (VM) vSphere sementara sebagai bagian dari validasinya, yang dapat memakan waktu lebih lama.
Dalam mode cepat, perintah akan melewati pemeriksaan yang membuat VM pengujian dan hanya menjalankan pemeriksaan cepat. Anda mengaktifkan mode cepat dengan meneruskan flag
--fast.
Anda dapat melewati validasi tertentu dengan meneruskan flag lain, yang dijelaskan
di gkectl check-config --help.
Traffic antara workstation admin dan VM pengujian
Dalam mode default, pemeriksaan pra-penerbangan membuat VM pengujian untuk cluster. Setiap VM pengujian menjalankan server HTTP yang memproses port 443 dan port node yang Anda tentukan dalam file konfigurasi.
Beberapa alamat IP ditetapkan ke VM pengujian. Jika file konfigurasi Anda menunjukkan bahwa node cluster akan mendapatkan alamat IP dari server DHCP, pemeriksaan pra-penerbangan akan menggunakan server DHCP untuk menetapkan alamat IP ke VM pengujian. Jika file konfigurasi Anda menunjukkan bahwa node cluster Anda akan diberi alamat IP statis, pemeriksaan pra-penerbangan akan menetapkan alamat IP statis yang Anda tentukan dalam file blok IP ke VM pengujian.
Pemeriksaan pra-penerbangan, yang berjalan di workstation admin, mengirimkan permintaan HTTP ke VM pengujian menggunakan berbagai alamat IP yang ditetapkan ke VM. Permintaan dikirim ke port 443 dan ke port node yang Anda tentukan dalam file konfigurasi.
Kapan saya harus menjalankan pemeriksaan pra-penerbangan?
Sebaiknya jalankan pemeriksaan pra-penerbangan lebih awal dan sebelum mencoba membuat cluster. Menjalankan pemeriksaan pra-penerbangan lebih awal dapat membantu mengonfirmasi bahwa Anda telah mengonfigurasi lingkungan vSphere dan jaringan dengan benar.
Jika Anda menggunakan versi 1.2.0-gke.6, jalankan gkectl check-config dua kali:
Jalankan
gkectl check-config --fast.Jalankan
gkectl prepare.Jalankan
gkectl check-configlagi, tanpa flag--fast.
Alasan menjalankan dua kali adalah karena gkectl prepare mengupload template VM untuk
image OS node cluster ke lingkungan vSphere Anda. Template VM tersebut harus ada sebelum Anda menjalankan serangkaian validasi lengkap.
Pada versi 1.2.1 dan yang lebih baru, perintah check-config itu sendiri mengupload template VM, sehingga Anda dapat menjalankan serangkaian validasi lengkap sebelum menjalankan gkectl
prepare:
Jalankan
gkectl check-config, tanpa flag--fast.Jalankan
gkectl prepare.
Pemeriksaan pra-penerbangan memvalidasi nilai yang telah Anda berikan ke file. Anda tidak
perlu mengisi setiap kolom dalam file konfigurasi untuk menjalankan pemeriksaan pra-penerbangan
terhadap file; melainkan, Anda dapat memvalidasi file secara iteratif saat mengisi
kolomnya. Misalnya, jika hanya ingin memvalidasi konfigurasi vCenter, Anda dapat mengisi hanya kolom vcenter dan menjalankan pemeriksaan terhadap konfigurasi tersebut.
Perlu diingat bahwa konfigurasi Anda menjadi tidak dapat diubah setelah Anda membuat cluster. Menjalankan pemeriksaan pra-penerbangan membantu Anda menemukan dan menyelesaikan masalah dalam konfigurasi sebelum membuat cluster.
Mempertahankan VM pengujian untuk proses debug
Mulai dari versi 1.2.1, perintah gkectl check-config memiliki flag --cleanup.
Saat melakukan serangkaian validasi lengkap, gkectl check-config akan membuat VM pengujian dan kunci SSH terkait. Jika Anda ingin mempertahankan VM pengujian dan kunci SSH untuk tujuan debug, tetapkan --cleanup ke false.
Nilai default --cleanup adalah benar (true).
Daftar pemeriksaan preflight
Pemeriksaan pra-penerbangan memvalidasi setiap kolom dalam file konfigurasi. Berikut pemeriksaan saat ini:
| Kategori | Deskripsi | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| File konfigurasi | Secara umum memvalidasi bahwa setiap kolom dan spesifikasi memiliki format dan nilai yang diharapkan. Dilewati dengan
flag Lewati validasi
kolom |
||||||||||||||||
| Internet | Memvalidasi akses internet ke domain yang diperlukan. Memvalidasi konfigurasi proxy berdasarkan tempat Anda menjalankan gkectl. Dilewati dengan flag |
||||||||||||||||
| OS image | Memvalidasi bahwa image OS ada. Dilewati dengan flag |
||||||||||||||||
| Versi OS Windows | Memvalidasi versi OS Windows. Memvalidasi bahwa versi Windows didukung saat membuat workstation admin dengan alat command line |
||||||||||||||||
| Versi cluster | Memvalidasi bahwa versi cluster admin, versi cluster pengguna, dan versi Dilewati dengan flag |
||||||||||||||||
| Kondisi cluster | Memvalidasi bahwa cluster admin atau pengguna dalam kondisi baik sebelum upgrade:
Dilewati dengan flag |
||||||||||||||||
| Masuk | Memeriksa apakah cluster pengguna memiliki objek Istio Gateway sebelum upgrade. | ||||||||||||||||
| IP yang dicadangkan | Memvalidasi bahwa alamat IP yang tersedia cukup untuk pembuatan dan upgrade. Dilewati dengan flag |
||||||||||||||||
| Google Cloud |
--skip-validation-gcp.
| ||||||||||||||||
Akses ke gcr.io/gke-on-prem-release |
Memvalidasi akses ke registry image container yang dihosting di
Artifact Registry.
Dilewati oleh flag |
||||||||||||||||
| Registry Docker |
privateregistryconfigJika dikonfigurasi, memvalidasi akses ke Docker Registry.
Dilewati dengan flag |
||||||||||||||||
| vCenter | Memeriksa apakah semua kolom vcenter ada, dan juga
memeriksa hal berikut:
Dilewati dengan flag |
||||||||||||||||
| Penyimpanan |
| ||||||||||||||||
| Workload CSI |
Memvalidasi bahwa cluster dapat berhasil menjalankan workload yang menggunakan PersistentVolume yang disediakan secara dinamis yang dibuat melalui Driver CSI vSphere. Pemeriksaan ini berjalan selama upgrade dan hanya jika ada volume vSphere dalam struktur dan tidak ada Volume CSI vSphere. Pemeriksaan ini:
|
||||||||||||||||
| Host untuk grup anti-afinitas | Memvalidasi bahwa jumlah host vCenter fisik setidaknya
tiga jika
Untuk menonaktifkan Dilewati dengan flag |
||||||||||||||||
| Load balancer | Memvalidasi konfigurasi load balancing:
--skip-validation-load-balancer.
|
||||||||||||||||
| Jaringan | Memvalidasi bahwa rentang CIDR, VIP, dan IP statis yang diberikan (jika dikonfigurasi) tersedia. Memeriksa apakah alamat IP tidak tumpang-tindih. Dilewati dengan flag |
||||||||||||||||
| DNS | Memvalidasi bahwa server DNS yang diberikan tersedia. Dilewati dengan flag |
||||||||||||||||
| NTP | Memvalidasi bahwa server Network Time Protocol (NTP) yang disediakan tersedia. Dilewati dengan flag |
||||||||||||||||
| VIP | Melakukan ping ke VIP yang disediakan. Pemeriksaan ini berhasil jika ping gagal, yang menunjukkan bahwa VIP yang diharapkan belum digunakan. Dilewati dengan
flag |
||||||||||||||||
| IP Node | Melakukan ping ke alamat IP node yang diberikan. Pemeriksaan ini berhasil jika ping gagal, yang menunjukkan bahwa IP node yang diharapkan belum digunakan. Dilewati dengan
flag |
||||||||||||||||
Hasil pemeriksaan awal
Pemeriksaan pra-peluncuran dapat menampilkan hasil berikut:
- BERHASIL
- Kolom dan nilainya lulus pemeriksaan.
- GAGAL
- Kolom dan/atau nilainya tidak lulus pemeriksaan. Jika pemeriksaan menampilkan pesan
FAILURE, perbaiki masalahnya dan validasi file lagi. - DILEWATI
Pemeriksaan dilewati, kemungkinan karena pemeriksaan tidak relevan dengan konfigurasi Anda. Misalnya, jika Anda menggunakan server DHCP, pemeriksaan DNS dan IP node—yang hanya relevan dengan konfigurasi IP statis—akan dilewati.
Jika Anda meneruskan tanda yang melewati validasi, pemeriksaan yang dilewati tidak akan menampilkan hasil DILEWATI; melainkan, validasi tidak dijalankan dan tidak muncul dalam output perintah sama sekali.
- TIDAK DIKETAHUI
Lewatan menampilkan kode bukan nol. Anda dapat menganggap hasil UNKNOWN sebagai pemeriksaan yang gagal. TIDAK DIKETAHUI biasanya menunjukkan bahwa pemeriksaan gagal menjalankan beberapa paket sistem, seperti gagal menjalankan nslookup atau gagal menjalankan gcloud.
Segera hadir
Pemeriksaan pra-upload berikut akan ditambahkan dalam rilis mendatang:
- Server NTP
Menjalankan pemeriksaan preflight
Anda menjalankan pemeriksaan pra-penerbangan dengan menjalankan perintah berikut:
gkectl check-config --config [CONFIG]
dengan [CONFIG] adalah jalur ke file konfigurasi Anda
Berjalan dalam mode cepat
Jika mau, Anda dapat menjalankan pemeriksaan pra-penerbangan dalam "mode cepat", yang melewati validasi yang membuat VM pengujian sementara, seperti validasi IP node dan VIP load balancing. Untuk melakukannya, teruskan --fast:
gkectl check-config --config [CONFIG] --fast
Melewati validasi tertentu
Anda dapat meneruskan flag untuk melewati validasi tertentu secara terperinci, seperti DNS, proxy, dan jaringan. Setiap tanda lewati diawali dengan --skip-[VALIDATION].
Untuk mempelajari tanda lewati yang tersedia, jalankan perintah berikut:
gkectl check-config --help
Misalnya, untuk melewati validasi load balancer:
gkectl check-config --config my-config.yaml --skip-validation-load-balancer
Membatalkan pemeriksaan preflight
Jika Anda mulai menjalankan pemeriksaan awal dan ingin membatalkan, tekan CTRL + C dua kali. Jika pemeriksaan pra-penerbangan membuat VM pengujian, pembatalan juga akan menghapus VM secara otomatis.
Membersihkan VM pengujian
Jika VM pengujian masih ada setelah pemeriksaan awal selesai, Anda dapat menghapus VM dari vCenter. VM pengujian memiliki nama seperti ini:
check-config-[dhcp|static]-[random number]
Untuk menghapus VM:
Klik kanan VM, lalu klik Power > Power Off
Setelah VM dimatikan, klik kanan VM lagi, lalu klik Hapus dari Disk.
Contoh
Di bawah ini adalah contoh output perintah. Dalam contoh ini, konfigurasi yang divalidasi menggunakan mode load balancing terintegrasi dan IP statis tanpa registry Docker eksternal:
- Validation Category: Config Check
- [SUCCESS] Config
- Validation Category: Internet Access
- [SUCCESS] Internet access to required domains
- Validation Category: GCP
- [SUCCESS] GCP Service
- [SUCCESS] GCP Service Account
- Validation Category: Docker Registry
- [SUCCESS] gcr.io/gke-on-prem-release access
- Validation Category: vCenter
- [SUCCESS] Credentials
- [SUCCESS] Version
- [SUCCESS] Datacenter
- [SUCCESS] Datastore
- [SUCCESS] Data Disk
- [SUCCESS] Resource Pool
- [SUCCESS] Network
- [SUCCESS] VSphere CSI Driver
- Validation Category: F5 BIG-IP
- [SUCCESS] Admin Cluster F5 (credentials, partition and user role)
- [SUCCESS] User Cluster F5 (credentials, partition and user role)
- Validation Category: Network Configuration
- [SUCCESS] CIDR, VIP and static IP (availability and overlapping)
- Validation Category: DNS
- [SUCCESS] DNS (availability)
- Validation Category: VIPs
- [SUCCESS] ping (availability)
- Validation Category: Node IPs
- [SUCCESS] ping (availability)
Now running slow validation checks. ...
Reusing VM template "gke-on-prem-osimage-xxx" that already exists in vSphere.
Creating test VMs with admin cluster configuration... DONE
Waiting to get IP addresses from test VMs... DONE
Waiting for test VMs to become ready... DONE
Reusing VM template "gke-on-prem-osimage-xxx" that already exists in vSphere.
Creating test VMs with user cluster configuration... DONE
Waiting to get IP addresses from test VMs... DONE
Waiting for test VMs to become ready... DONE
- Validation Category: F5 BIG-IP
- [SUCCESS] Admin Cluster VIP and NodeIP
- [SUCCESS] Admin Cluster F5 Access
- [SUCCESS] User Cluster VIP and NodeIP
- [SUCCESS] User Cluster F5 Access
- Validation Category: Internet Access
- [SUCCESS] Internet access to required domains
- Validation Category: vCenter on test VMs
- [SUCCESS] Test VM: VCenter Access and Permission
- Validation Category: DNS on test VMs
- [SUCCESS] Test VM: DNS Availability
- Validation Category: TOD on test VMs
- [SUCCESS] Test VM: TOD Availability
- Validation Category: Docker Registry
- [SUCCESS] gcr.io/gke-on-prem-release access
Deleting test VMs with admin cluster configuration... DONE
Deleting test VMs with user cluster configuration... DONE
Masalah umum
Untuk versi 1.3.0-gke.16:
Anda harus menjalankan pemeriksaan validasi cepat,
gkectl check-config --fast, untuk pemeriksaan sebelum penerbangan jika kedua hal berikut berlaku:Anda mengonfigurasi Google Distributed Cloud untuk menggunakan proxy.
Anda menginstal salah satu paket berikut:
- Paket
/var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16.tgzdari halaman Download. - Paket
/var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16.tgzdari workstation admin.
- Paket
Anda dapat menjalankan set lengkap validasi hanya jika Anda menginstal paket lengkap. Contoh:
/var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16-full.tgzUntuk versi 1.2.0-gke.6:
Jika Anda menggunakan kumpulan resource bertingkat atau kumpulan resource default,
gkectl check-configakan gagal saat Anda mencoba melakukan serangkaian validasi lengkap. Namun, Anda dapat melakukan serangkaian validasi yang lebih kecil dengan meneruskan tanda--fast.gkectl check-config --config [CONFIG] --fast