Menginstal kubectl dan mengonfigurasi akses cluster

Autopilot Standard

Halaman ini memberikan petunjuk untuk menginstal alat command line kubectl yang digunakan untuk mengelola dan mengakses cluster Google Kubernetes Engine (GKE). Konfigurasi kubectl diperlukan jika Anda menjalankan beberapa cluster di Google Cloud.

Anda akan mempelajari hal berikut:

• Cara kerja kubectl
• Cara menginstal kubectl dan dependensi yang diperlukan.
• Cara menetapkan cluster default untuk kubectl.
• Cara menjalankan perintah kubectl terhadap cluster tertentu.

Halaman ini ditujukan bagi administrator IT, Operator, dan Developer yang menyiapkan, memantau, dan mengelola infrastruktur cloud, termasuk menyediakan dan mengonfigurasi resource cloud. Untuk mempelajari lebih lanjut peran umum dan contoh tugas yang dirujuk dalam dokumentasi, lihat Peran dan tugas pengguna GKE umum. Google Cloud

Sebelum membaca halaman ini, pastikan Anda sudah memahami Kubernetes kubectl.

Sebelum memulai

Sebelum memulai, pastikan Anda telah melakukan tugas berikut:

• Aktifkan Google Kubernetes Engine API.
Aktifkan Google Kubernetes Engine API
• Jika ingin menggunakan Google Cloud CLI untuk tugas ini, instal lalu lakukan inisialisasi gcloud CLI. Jika sebelumnya Anda telah menginstal gcloud CLI, dapatkan versi terbaru dengan menjalankan perintah gcloud components update. Versi gcloud CLI yang lebih lama mungkin tidak mendukung menjalankan perintah dalam dokumen ini.
  Catatan: Untuk penginstalan gcloud CLI yang ada, pastikan untuk menyetel properti compute/region. Jika Anda terutama menggunakan cluster zona, tetapkan compute/zone. Dengan menyetel lokasi default, Anda dapat menghindari error di gcloud CLI yang seperti ini: One of [--zone, --region] must be supplied: Please specify location. Anda mungkin perlu menentukan lokasi dalam perintah tertentu jika lokasi cluster Anda berbeda dengan lokasi default yang Anda tetapkan.

• Pastikan Anda sudah memiliki cluster Autopilot atau Standard. Untuk membuat cluster baru, lihat Membuat cluster Autopilot.

Instal kubectl

Anda dapat menginstal kubectl menggunakan Google Cloud CLI atau pengelola paket eksternal, seperti apt atau yum.

gcloud

1. Instal komponen kubectl:

   gcloud components install kubectl
   

2. Pastikan kubectl sudah diinstal dengan memeriksa apakah aplikasi tersebut memiliki versi terbaru:

   kubectl version --client
   

apt

1. Verifikasi bahwa Anda memiliki repositori cloud-sdk:

   grep -rhE ^deb /etc/apt/sources.list* | grep "cloud-sdk"

   Outputnya mirip dengan hal berikut ini:

   deb  [signed-by=/usr/share/keyrings/cloud.google.gpg]  https://packages.cloud.google.com/apt cloud-sdk main
   

2. Jika repositori cloud-sdk tidak tercantum, instal gcloud CLI.

3. Instal komponen kubectl:

   apt-get update
   apt-get install -y kubectl

4. Pastikan kubectl sudah diinstal dengan memeriksa apakah aplikasi tersebut memiliki versi terbaru:

   kubectl version --client

yum

1. Verifikasi bahwa Anda memiliki repositori cloud-sdk:

   yum repolist | grep "google-cloud-sdk"

   Output-nya mirip dengan berikut ini:

   google-cloud-sdk    Google Cloud SDK    2,205
   

2. Instal komponen kubectl:

   yum install -y kubectl

3. Pastikan kubectl sudah diinstal dengan memeriksa apakah aplikasi tersebut memiliki versi terbaru:

   kubectl version --client

Menginstal plugin yang diperlukan

kubectl dan klien Kubernetes lainnya memerlukan plugin autentikasi, gke-gcloud-auth-plugin, yang menggunakan framework Plugin Kredensial Client-go untuk memberikan token autentikasi agar dapat berkomunikasi dengan cluster GKE.

Sebelum Kubernetes versi 1.26 dirilis, gcloud CLI akan mulai mewajibkan biner gke-gcloud-auth-plugin untuk diinstal. Jika plugin tidak diinstal, penginstalan kubectl yang ada atau klien Kubernetes kustom lainnya akan berhenti berfungsi.

Anda harus menginstal plugin ini untuk menggunakan kubectl dan klien lain agar dapat berinteraksi dengan GKE. Klien yang ada akan menampilkan pesan error jika plugin tidak diinstal.

Sebelum memulai, periksa apakah plugin sudah terinstal:

gke-gcloud-auth-plugin --version

Jika output menampilkan informasi versi, lewati bagian ini.

Anda dapat menginstal plugin autentikasi menggunakan gcloud CLI atau pengelola paket eksternal seperti apt atau yum.

gcloud

Instal biner gke-gcloud-auth-plugin:

  gcloud components install gke-gcloud-auth-plugin

apt

Instal biner gke-gcloud-auth-plugin:

  apt-get install google-cloud-sdk-gke-gcloud-auth-plugin

yum

Instal biner gke-gcloud-auth-plugin:

  yum install google-cloud-sdk-gke-gcloud-auth-plugin

Verifikasi penginstalan biner gke-gcloud-auth-plugin:

1. Periksa versi biner gke-gcloud-auth-plugin:

   gke-gcloud-auth-plugin --version
   

2. Update konfigurasi kubectl untuk menggunakan plugin:

   gcloud container clusters get-credentials CLUSTER_NAME \
       --location=CONTROL_PLANE_LOCATION
   

   Ganti kode berikut:

   • CLUSTER_NAME: nama cluster Anda.
   • CONTROL_PLANE_LOCATION: lokasi Compute Engine bidang kontrol cluster Anda. Berikan region untuk cluster regional, atau zona untuk cluster zona.

3. Verifikasi konfigurasi dengan menjalankan perintah berikut:

   kubectl get namespaces
   

   Outputnya mirip dengan hal berikut ini:

   NAME              STATUS   AGE
   default           Active   51d
   kube-node-lease   Active   51d
   kube-public       Active   51d
   kube-system       Active   51d
   

Untuk mengetahui informasi selengkapnya tentang plugin ini, lihat KEP Kubernetes.

Berinteraksi dengan kubectl

Kubernetes menggunakan file YAML bernama kubeconfig guna menyimpan informasi autentikasi cluster untuk kubectl. Secara default, file disimpan di $HOME/.kube/config.

kubeconfig berisi grup parameter akses yang disebut konteks. Setiap konteks berisi cluster Kubernetes, pengguna, dan namespace default opsional. kubectl merujuk pada konteks saat menjalankan perintah.

Secara opsional, Anda dapat mengonfigurasi kubectl menggunakan tugas berikut:

• Pilih cluster yang akan dihubungi kubectl.
• Tetapkan cluster default untuk kubectl dengan menyetel konteks saat ini di file kubeconfig.
• Jalankan perintah kubectl terhadap cluster tertentu menggunakan flag --cluster.

Lihat kubeconfig

Untuk melihat kubeconfig lingkungan Anda, jalankan perintah berikut:

kubectl config view

Perintah ini menampilkan daftar semua cluster dengan entri kubeconfig yang telah dibuat. Jika cluster GKE tercantum, Anda dapat menjalankan perintah kubectl untuknya di lingkungan Anda saat ini. Jika tidak, Anda perlu Menyimpan informasi cluster untuk kubectl.

Lihat konteks saat ini untuk kubectl

Konteks saat ini adalah cluster yang saat ini menjadi default untuk kubectl. Semua perintah kubectl dijalankan pada cluster tersebut.

Saat Anda membuat cluster menggunakan gcloud container clusters create-auto, entri akan otomatis ditambahkan ke file kubeconfig di lingkungan Anda, dan konteks saat ini akan berubah pada cluster tersebut. Contoh:

gcloud container clusters create-auto my-cluster
Creating my-cluster...done
Fetching cluster endpoint and auth data.
kubeconfig entry generated for my-cluster

Guna melihat konteks saat ini untuk kubectl, jalankan perintah berikut:

kubectl config current-context

Simpan informasi cluster untuk kubectl

Saat Anda membuat cluster menggunakan konsol Google Cloud atau menggunakan gcloud CLI dari komputer lain, file kubeconfig lingkungan Anda tidak akan diperbarui. Selain itu, jika anggota tim project menggunakan gcloud CLI untuk membuat cluster dari komputer mereka, kubeconfig mereka akan diupdate, tetapi milik Anda tidak. Entri kubeconfig berisi:

• Kredensial Anda seperti yang ditampilkan dalam gcloud auth list, atau
• Kredensial default aplikasi, jika dikonfigurasi.

Untuk membuat konteks kubeconfig di lingkungan Anda, pastikan Anda memiliki izin container.clusters.get. Peran IAM dengan hak istimewa paling rendah yang memberikan izin ini adalah container.clusterViewer.

Untuk menghasilkan konteks kubeconfig bagi cluster tertentu, jalankan perintah berikut:

gcloud container clusters get-credentials CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION

Ganti kode berikut:

• CLUSTER_NAME: nama cluster Anda.
• CONTROL_PLANE_LOCATION: lokasi Compute Engine bidang kontrol cluster Anda. Berikan region untuk cluster regional, atau zona untuk cluster zona.

Catatan: Menjalankan gcloud container clusters get-credentials juga akan mengubah konteks saat ini untuk kubectl ke cluster tersebut.

Membuat entri kubeconfig menggunakan alamat IP internal cluster

Semua cluster memiliki beberapa alamat endpoint, masing-masing dengan karakteristik yang berbeda. Salah satu endpoint ini berfungsi sebagai endpoint kanonis yang digunakan oleh kubectl dan layanan lainnya untuk berkomunikasi dengan bidang kontrol cluster Anda. GKE secara otomatis memilih endpoint berdasarkan urutan berikut:

• Alamat IP eksternal (jika Anda telah mengaktifkan endpoint eksternal)
• Alamat IP internal
• Alamat DNS (jika akses IP dinonaktifkan) Untuk menggunakan endpoint kanonis secara default, jalankan perintah get-credentials. Untuk kontrol lebih lanjut atas endpoint yang digunakan kubectl, gunakan flag --internal-ip atau --dns-endpoint. Untuk memperbarui file kubeconfig agar menggunakan alamat IP internal, jalankan perintah berikut:

gcloud container clusters get-credentials CLUSTER_NAME --internal-ip

Untuk memperbarui file kubeconfig agar menggunakan alamat DNS, jalankan perintah berikut:

gcloud container clusters get-credentials CLUSTER_NAME --dns-endpoint

Ganti CLUSTER_NAME dengan nama cluster Anda.

Secara default, menjalankan get-credentials akan menggunakan alamat IP yang ditentukan di kolom endpoint.

Menetapkan cluster default untuk perintah kubectl

Jika sebelumnya Anda telah membuat entri kubeconfig untuk cluster, Anda dapat mengalihkan konteks saat ini untuk kubectl ke cluster tersebut dengan menjalankan perintah berikut:

gcloud container clusters get-credentials CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION

Ganti kode berikut:

• CLUSTER_NAME: nama cluster Anda.
• CONTROL_PLANE_LOCATION: lokasi Compute Engine bidang kontrol cluster Anda. Berikan region untuk cluster regional, atau zona untuk cluster zona.

Misalnya, pertimbangkan project dengan dua cluster, my-cluster dan my-new-cluster. Konteks saat ini adalah my-new-cluster, tetapi Anda ingin menjalankan semua perintah kubectl terhadap my-cluster. Untuk mengalihkan konteks saat ini dari my-new-cluster ke my-cluster, jalankan perintah berikut:

gcloud container clusters get-credentials CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION

Menjalankan perintah kubectl individu terhadap cluster tertentu

Anda dapat menjalankan perintah kubectl satu per satu terhadap cluster tertentu menggunakan --cluster=CLUSTER_NAME.

Misalnya, pertimbangkan lingkungan dengan dua cluster, my-cluster dan my-new-cluster, dengan konteks saat ini adalah my-cluster. Anda ingin men-deploy aplikasi ke my-new-cluster, tetapi tidak ingin mengubah konteks saat ini. Untuk men-deploy aplikasi ke my-new-cluster tanpa mengubah konteks saat ini, Anda harus menjalankan perintah berikut:

kubectl run my-app --image us-docker.pkg.dev/my-project/my-repo/my-app:1.0 --cluster my-new-cluster

Langkah berikutnya

• Pelajari cara mengizinkan akses ke resource di cluster GKE.
• Mengautentikasi ke Google Cloud layanan dari workload GKE.
• Baca tips praktis kubectl.
• Memecahkan masalah alat command line kubectl.

Coba sendiri

Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa GKE dalam skenario dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Coba GKE gratis