Menjalankan pemeriksaan preflight

Dokumen ini memberikan informasi tentang pemeriksaan preflight yang dijalankan saat Anda membuat atau mengupgrade cluster di software Google Distributed Cloud khusus untuk VMware.

Meninjau aturan firewall Anda

Di versi 1.29 dan yang lebih baru, pemeriksaan preflight sisi server diaktifkan secara default saat Anda membuat, mengupdate, dan mengupgrade cluster. Pemeriksaan preflight sisi server memerlukan aturan firewall tambahan. Di Aturan firewall untuk cluster admin, telusuri "Pemeriksaan preflight" 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 dapat 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 preflight. Jika perintah menampilkan pesan FAILURE, perbaiki masalahnya dan validasi file lagi. Jika validasi fitur tertentu menampilkan pesan PERINGATAN, Anda harus memperbaiki masalah yang mendasarinya sebelum dapat menggunakan fitur tersebut.

Peringatan: gkectl check-config hanya boleh digunakan sebelum pembuatan cluster. Menjalankannya pada cluster yang sudah ada akan menghasilkan pesan FAILURE yang tidak terduga.

Peringatan: Beberapa kolom dalam file konfigurasi tidak digunakan lagi. Jika Anda menjalankan gkectl check-config pada file yang memiliki kolom yang tidak digunakan lagi, perintah mungkin akan gagal. Untuk contoh, lihat catatan rilis ini.

Mode pemeriksaan preflight dan melewati validasi

gkectl check-config memiliki mode default dan mode cepat:

• Dalam mode default, perintah ini memvalidasi setiap kolom secara komprehensif. Selain itu, mode default membuat virtual machine (VM) vSphere sementara sebagai bagian dari validasinya, yang dapat memerlukan waktu lebih lama.

• Dalam mode cepat, perintah akan melewati pemeriksaan yang membuat VM pengujian dan hanya menjalankan pemeriksaan cepat. Anda dapat 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 preflight 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 preflight akan menggunakan server DHCP untuk menetapkan alamat IP ke VM pengujian. Jika file konfigurasi menunjukkan bahwa node cluster Anda akan diberi alamat IP statis, pemeriksaan preflight akan menetapkan alamat IP statis yang Anda tentukan dalam file blok IP ke VM pengujian.

Pemeriksaan preflight, 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 preflight?

Sebaiknya jalankan pemeriksaan preflight lebih awal dan sebelum mencoba membuat cluster. Menjalankan pemeriksaan preflight 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:

1. Jalankan gkectl check-config --fast.

2. Jalankan gkectl prepare.

3. Jalankan kembali gkectl check-config, tanpa flag --fast.

Alasan dijalankan dua kali adalah karena gkectl prepare mengupload template VM untuk OS image node cluster ke lingkungan vSphere Anda. Template VM tersebut harus sudah ada sebelum Anda menjalankan serangkaian validasi lengkap.

Di 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:

1. Jalankan gkectl check-config, tanpa flag --fast.

2. Jalankan gkectl prepare.

Pemeriksaan preflight memvalidasi nilai yang Anda berikan ke file. Anda tidak perlu mengisi setiap kolom dalam file konfigurasi untuk menjalankan pemeriksaan preflight terhadap file tersebut; sebagai gantinya, Anda dapat memvalidasi file secara iteratif saat mengisi kolomnya. Misalnya, jika Anda hanya ingin memvalidasi konfigurasi vCenter, Anda dapat mengisi kolom vcenter saja dan menjalankan pemeriksaan terhadap kolom tersebut.

Perlu diingat bahwa konfigurasi Anda tidak dapat diubah setelah Anda membuat cluster. Menjalankan pemeriksaan preflight membantu Anda menemukan dan menyelesaikan masalah dalam konfigurasi sebelum membuat cluster.

Mempertahankan VM pengujian untuk proses debug

Mulai versi 1.2.1, perintah gkectl check-config memiliki flag --cleanup.

Saat gkectl check-config menjalankan serangkaian validasi lengkap, alat ini akan membuat VM pengujian dan kunci SSH terkait. Jika Anda ingin mempertahankan VM pengujian dan kunci SSH untuk tujuan proses debug, tetapkan --cleanup ke false.

Nilai default --cleanup adalah true.

Daftar pemeriksaan preflight

Pemeriksaan preflight memvalidasi setiap kolom dalam file konfigurasi. Berikut adalah pemeriksaan saat ini:

Kategori	Deskripsi
File konfigurasi	Secara umum memvalidasi bahwa setiap kolom dan spesifikasi memiliki format dan nilai yang diharapkan. Dilewati dengan flag --skip-validation-config. Lewati validasi kolom proxy dengan flag --skip-validation-proxy.
Internet	Memvalidasi akses internet ke domain yang diperlukan. Memvalidasi konfigurasi proxy berdasarkan tempat Anda menjalankan gkectl. Dilewati dengan flag --skip-validation-internet.
OS image	Memvalidasi bahwa image OS ada. Dilewati dengan flag --skip-validation-os-images.
Versi OS Windows	Memvalidasi versi OS Windows. Memvalidasi bahwa versi Windows didukung saat membuat workstation admin dengan alat command line gkeadm. Perhatikan bahwa meskipun alat gkeadm tersedia untuk Windows 10, Windows Server 2019, dan Linux, tidak ada pemeriksaan preflight untuk Linux. Validasi ini dimulai dari versi rilis 1.4.1.
Versi cluster	Memvalidasi bahwa versi cluster admin, versi cluster pengguna, dan versi gkectl cocok untuk pembuatan dan upgrade. Dilewati dengan flag --skip-validation-cluster-version.
Kesehatan cluster	Memvalidasi bahwa cluster admin atau pengguna responsif sebelum upgrade: Cluster admin: Pemeriksaan mencakup layanan Kubernetes, status komponen, DaemonSet, deployment, mesin, dan pod. Cluster pengguna: Pemeriksaan mencakup layanan Kubernetes, endpoint API cluster, StatefulSet, deployment, deployment mesin, mesin, dan pod. Dilewati dengan flag --skip-validation-cluster-health.
Masuk	Memeriksa apakah cluster pengguna memiliki objek Gateway Istio sebelum upgrade.
IP yang Dicadangkan	Memvalidasi bahwa alamat IP yang tersedia cukup untuk pembuatan dan upgrade. Dilewati dengan flag --skip-validation-reserved-ips.
Google Cloud	Project ID [*].projectid Memvalidasi project ID yang diberikan ke berbagai kolom dalam konfigurasi. Jika project ID tidak ada, validasi akan dilewati. Mendaftarkan akun layanan registerserviceaccountkeypath Memvalidasi bahwa akun layanan memiliki peran IAM yang diperlukan. Memvalidasi bahwa API yang diperlukan telah diaktifkan. Menghubungkan akun layanan agentserviceaccountkeypath Memvalidasi bahwa akun layanan memiliki peran IAM yang diperlukan. Memvalidasi bahwa API yang diperlukan telah diaktifkan. Akun layanan Google Cloud Observability stackdriver.serviceaccountkeypath Memvalidasi bahwa akun layanan memiliki peran IAM yang diperlukan. Memvalidasi bahwa API yang diperlukan telah diaktifkan. Dilewati dengan flag --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 --skip-validation-docker.
Registry Docker	privateregistryconfig Jika dikonfigurasi, memvalidasi akses ke registry Docker. Dilewati dengan flag --skip-validation-docker.
vCenter	Memeriksa apakah semua kolom vcenter ada, dan juga memeriksa hal berikut: Kredensial vcenter.credentials.[*] Memvalidasi autentikasi ke vCenter Server menggunakan kredensial pengguna yang diberikan. Versi vSphere Memvalidasi bahwa versi vCenter dan ESXi didukung. Datacenter vcenter.datacenter Memvalidasi bahwa pusat data vSphere ada. Datastore vcenter.datastore Memvalidasi bahwa penyimpanan data vSphere ada. Disk data vcenter.datadisk Memvalidasi bahwa disk virtual machine (VMDK) vSphere belum ada di vSphere. Kumpulan resource vcenter.resourcepool Memvalidasi bahwa kumpulan resource vSphere ada. Jaringan vcenter.network Memvalidasi bahwa jaringan vSphere ada. Dilewati dengan flag --skip-validation-infra.
Penyimpanan	Driver CSI vSphere Memvalidasi bahwa driver CSI vSphere diaktifkan jika ada PersistentVolume vSphere intree atau CSI. Artinya, dalam file konfigurasi cluster pengguna, storage.vSphereCSIDisabled tidak ditetapkan ke true. Parameter StorageClass Memvalidasi bahwa StorageClass tidak memiliki parameter yang tidak didukung berikut: hostfailurestotolerate forceprovisioning cachereservation diskstripes objectspacereservation iopslimit diskformat Jika cluster Anda memiliki StorageClass dengan salah satu parameter sebelumnya, hal itu mungkin berarti Anda perlu memigrasikan volume. Untuk mengetahui informasi selengkapnya, lihat Pertimbangan untuk Migrasi Volume vSphere In-Tree dan bagian masalah umum tentang upgrade di 1.15. Anotasi di PersistentVolume dan PersistentVolumeClaim in-tree vSphere yang dibuat secara statis Sebelum upgrade, periksa anotasi di PersistentVolume in-tree vSphere dan PersistentVolumeClaim vSphere: PersistentVolume in-tree vSphere yang dibuat secara statis memiliki anotasi pv.kubernetes.io/provisioned-by: kubernetes.io/vsphere-volume PersistentVolumeClaim vSphere yang dibuat secara statis memiliki anotasi volume.beta.kubernetes.io/storage-provisioner: kubernetes.io/vsphere-volume dan volume.kubernetes.io/storage-provisioner: kubernetes.io/vsphere-volume Jika cluster Anda memiliki PersistentVolume in-tree vSphere atau PersistentVolumeClaims vSphere tanpa anotasi ini, Anda harus menganotasi PersistentVolume dan PersistentVolumeClaims sebelum melanjutkan, lihat Pertimbangan untuk Migrasi Volume vSphere In-Tree.
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 hierarki dan tidak ada Volume CSI vSphere. Pemeriksaan ini: Memeriksa bahwa tidak ada resource yang tersisa dari proses validasi sebelumnya. Menemukan atau membuat StorageClass dengan kolom penyedia yang ditetapkan ke kolom penyedia yang ditetapkan ke "csi.vsphere.vmware.com". Di cluster pengguna, opsi ini memilih StorageClass CSI standard-rwo. Di cluster admin, StorageClass ditemukan dengan kolom penyedia ditetapkan ke csi.vsphere.vmware.com. Jika tidak ada StorageClass seperti itu di cluster, pengujian akan membuat StorageClass CSI baru untuk sementara dan menggunakannya dalam pemeriksaan. Membuat PersistentVolumeClaim di namespace default menggunakan StorageClass yang ditemukan atau dibuat pada langkah sebelumnya dan menunggu PersistentVolume yang dibuat secara dinamis berada dalam fase Bound. Membuat Tugas penulis di namespace default yang memasang PersistentVolume yang dibuat di atas. Pod penulis dijadwalkan dan saat memulai, Pod tersebut akan menulis string ke file dalam sistem file yang terpasang. Menghapus Tugas penulis dan Pod terkaitnya. Membuat Tugas pembaca di namespace default yang memasang PersistentVolume yang dibuat di atas. Pod pembaca dijadwalkan dan saat memulai, Pod tersebut membaca file yang ditulis oleh Pod penulis untuk memastikan bahwa data yang ditulis oleh Pod penulis berhasil dibaca. Menghapus Tugas pembaca dan Pod terkaitnya. Menghapus PersistentVolumeClaim, sehingga PersistentVolume juga dihapus. Menghapus StorageClass jika dibuat selama pengujian.
Host untuk grup anti-afinitas	Memvalidasi bahwa jumlah host vCenter fisik minimal tiga jika antiAffinityGroups diaktifkan. Untuk menonaktifkan antiAffinityGroups untuk cluster, lihat antiAffinityGroups.enabled dan catatan rilis ini. Dilewati dengan flag --skip-validation-infra.
Load balancer	Memvalidasi konfigurasi load balancing: Jika mode load balancing terintegrasi (lbmode: Integrated), memvalidasi bahwa semua kolom bigip ada dalam spesifikasi admincluster dan usercluster. Jika mode load balancing adalah manual (lbmode: Manual), memvalidasi bahwa semua kolom manuallbspec ada dalam spesifikasi admincluster dan usercluster. Load balancing terintegrasi bigip.credentials.[*] Memvalidasi kredensial F5 BIG-IP Anda. bigip.partition Memvalidasi bahwa partisi yang disediakan ada. Peran pengguna F5 BIG-IP Memvalidasi bahwa pengguna F5 BIG-IP yang diberikan memiliki peran Administrator atau Administrator Resource. bigip.vips.[*] Memvalidasi VIP yang disediakan. Dilewati dengan flag --fast atau --skip-validation-load-balancer. Load balancing manual Konfigurasi jaringan Memvalidasi VIP, IP node, dll. Dilewati dengan flag --fast atau --skip-validation-load-balancer. [*].manuallbspec.[*] Memvalidasi port node yang disediakan. Dilewati dengan flag --skip-validation-load-balancer.
Jaringan	Memvalidasi bahwa rentang CIDR, VIP, dan IP statis yang disediakan (jika dikonfigurasi) tersedia. Memeriksa apakah alamat IP tidak tumpang-tindih. Dilewati dengan flag --skip-validation-net-config.
DNS	Memvalidasi bahwa server DNS yang disediakan tersedia. Dilewati dengan flag --skip-validation-dns.
NTP	Memvalidasi bahwa server Protokol Waktu Jaringan (NTP) yang disediakan tersedia. Dilewati dengan flag --skip-validation-tod.
VIP	Melakukan ping ke VIP yang disediakan. Pemeriksaan ini berhasil jika ping gagal, yang menunjukkan bahwa VIP yang diharapkan belum digunakan. Dilewati dengan flag --skip-validation-vips.
IP Node	Melakukan ping ke alamat IP node yang disediakan. Pemeriksaan ini berhasil jika ping gagal, yang menunjukkan bahwa IP node yang diharapkan belum digunakan. Dilewati dengan flag --skip-validation-node-ips.

Hasil pemeriksaan preflight

Pemeriksaan preflight 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 untuk DNS dan IP node—yang hanya relevan untuk konfigurasi IP statis—akan dilewati.

Jika Anda meneruskan flag yang melewati validasi, pemeriksaan yang dilewati tidak akan menampilkan hasil SKIPPED; melainkan, validasi tidak dijalankan dan tidak muncul dalam output perintah sama sekali.

TIDAK DIKETAHUI

Lewati menampilkan kode bukan nol. Anda dapat menganggap hasil UNKNOWN sebagai pemeriksaan yang gagal. UNKNOWN biasanya menunjukkan bahwa pemeriksaan gagal menjalankan beberapa paket sistem, seperti gagal menjalankan nslookup atau gagal menjalankan gcloud.

Segera hadir

Pemeriksaan preflight berikut akan ditambahkan dalam rilis mendatang:

• Server NTP

Menjalankan pemeriksaan preflight

Anda menjalankan pemeriksaan preflight dengan menjalankan perintah berikut:

gkectl check-config --config [CONFIG]

dengan [CONFIG] sebagai jalur ke file konfigurasi Anda

Berjalan dalam mode cepat

Jika mau, Anda dapat menjalankan pemeriksaan preflight 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 flag lewati diawali dengan --skip-[VALIDATION].

Untuk mempelajari flag 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 preflight dan ingin membatalkan, tekan CTRL + C dua kali. Jika pemeriksaan preflight membuat VM pengujian, pembatalan juga akan otomatis membersihkan VM.

Membersihkan VM pengujian

Jika VM pengujian tersisa setelah pemeriksaan preflight selesai, Anda dapat menghapus VM dari vCenter. VM pengujian memiliki nama seperti ini:

check-config-[dhcp|static]-[random number]

Untuk menghapus VM:

1. Klik kanan VM, lalu klik Power > Matikan

2. Setelah VM dimatikan, klik kanan VM lagi, lalu klik Delete from Disk.

Contoh

Berikut 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 preflight jika kedua hal berikut berlaku:

  1. Anda telah mengonfigurasi Google Distributed Cloud untuk menggunakan proxy.

  2. Anda menginstal salah satu paket berikut:

     • Paket /var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16.tgz dari halaman Download.
     • Paket /var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16.tgz dari workstation admin.

  Anda dapat menjalankan serangkaian validasi lengkap hanya jika Anda menginstal paket lengkap. Contoh: /var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16-full.tgz

• Untuk versi 1.2.0-gke.6:

  Jika Anda menggunakan kumpulan resource bertingkat atau kumpulan resource default, gkectl check-config akan gagal saat Anda mencoba melakukan serangkaian validasi lengkap. Namun, Anda dapat melakukan serangkaian validasi yang lebih kecil dengan meneruskan flag --fast.

  gkectl check-config --config [CONFIG] --fast

Langkah berikutnya

• Membuat cluster admin
• Membuat cluster pengguna