Halaman ini menunjukkan cara membuat cluster zona Standar, dengan fitur default yang diaktifkan, di Google Kubernetes Engine (GKE). Cluster zona memiliki satu instance bidang kontrol dalam satu zona. Bergantung pada persyaratan ketersediaan, Anda dapat memilih untuk mendistribusikan node untuk cluster zona di satu zona atau di beberapa zona.
Halaman ini ditujukan untuk Operator, Cloud Architect, dan Developer, yang perlu membuat dan mengonfigurasi cluster, serta yang men-deploy workload di GKE. Untuk mempelajari lebih lanjut peran umum dan contoh tugas yang kami referensikan dalam konten Google Cloud, lihat Peran dan tugas pengguna GKE umum.
Sebelum membaca halaman ini, pastikan Anda memahami pilihan konfigurasi cluster.
Sebelum memulai
Sebelum memulai, pastikan Anda telah melakukan tugas berikut:
- Aktifkan Google Kubernetes Engine API. Aktifkan Google Kubernetes Engine API
- Untuk 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.
- Pastikan Anda memiliki izin yang tepat untuk membuat cluster. Minimal, Anda harus menjadi Admin Cluster Kubernetes Engine.
- Jika ingin mendaftarkan cluster baru Anda ke fleet, pastikan Anda memiliki API dan izin yang diperlukan.
Menyiapkan akun layanan IAM untuk GKE
GKE menggunakan akun layanan IAM yang dilampirkan ke node Anda untuk menjalankan tugas sistem seperti logging dan pemantauan. Setidaknya, akun layanan node ini harus memiliki peran Kubernetes Engine Default Node Service Account (roles/container.defaultNodeServiceAccount) di project Anda. Secara default,
GKE menggunakan
akun layanan default Compute Engine,
yang otomatis dibuat di project Anda, sebagai akun layanan node.
Untuk memberikan peran roles/container.defaultNodeServiceAccount ke
akun layanan default Compute Engine, selesaikan langkah-langkah berikut:
Konsol
- Buka halaman Welcome:
- Di kolom Project number, klik Copy to clipboard.
- Buka halaman IAM:
- Klik Grant access.
- Di kolom New principals, tentukan nilai berikut:
GantiPROJECT_NUMBER-compute@PROJECT_NUMBERdengan nomor project yang Anda salin. - Di menu Select a role, pilih peran Kubernetes Engine Default Node Service Account.
- Klik Simpan.
gcloud
- Temukan nomor project Google Cloud Anda:
gcloud projects describe PROJECT_ID \ --format="value(projectNumber)"
Ganti
PROJECT_IDdengan project ID Anda.Outputnya mirip dengan hal berikut ini:
12345678901
- Berikan peran
roles/container.defaultNodeServiceAccountke akun layanan default Compute Engine:gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:PROJECT_NUMBER-compute@" \ --role="roles/container.defaultNodeServiceAccount"
Ganti
PROJECT_NUMBERdengan nomor project dari langkah sebelumnya.
Membuat cluster zona
Informasi minimum yang perlu Anda tentukan saat membuat cluster zona baru adalah nama, project (biasanya project saat ini), dan zona (biasanya lokasi default untuk alat command line), menggunakan setelan default untuk semua nilai lainnya. Namun, ada lebih banyak kemungkinan setelan konfigurasi, yang hanya beberapa di antaranya dijelaskan di bagian ini dan beberapa di antaranya tidak dapat diubah setelah pembuatan cluster. Pastikan Anda memahami setelan mana yang tidak dapat diubah setelah pembuatan cluster, dan bahwa Anda memilih setelan yang tepat saat membuat cluster jika tidak ingin membuatnya lagi.
Anda dapat melihat ringkasan opsi konfigurasi cluster di Tentang pilihan konfigurasi cluster, dan daftar lengkap opsi yang memungkinkan di panduan referensi gcloud container clusters create dan Terraform google_container_cluster.
Anda dapat membuat cluster zona menggunakan gcloud CLI, konsolGoogle Cloud , atau Terraform.
Jika Anda mengembangkan aplikasi GKE dengan Cloud Code untuk VS Code, coba membuat cluster dengan Cloud Code.
gcloud
Untuk membuat cluster zona dengan gcloud CLI, gunakan salah satu perintah berikut.
Ganti kode berikut:
CLUSTER_NAME: nama cluster baru.CHANNEL: jenis saluran rilis, yang dapat berupa salah satu darirapid,regular,stable, atauNone(tidak digunakan lagi). Secara default, cluster didaftarkan di saluran rilisregular.CONTROL_PLANE_LOCATION: zona Compute Engine dari bidang kontrol cluster Anda.VERSION: versi yang ingin Anda tentukan untuk cluster.COMPUTE_ZONE,COMPUTE_ZONE1,[...]: zona tempat node dibuat. Anda dapat menentukan zona sebanyak mungkin yang dibutuhkan untuk cluster Anda. Semua zona harus berada di region yang sama dengan bidang kontrol cluster, yang ditentukan oleh flag--location. Untuk cluster zona,--node-locationsharus berisi zona utama cluster.
Sebaiknya tentukan akun layanan IAM dengan hak istimewa minimal yang dapat digunakan node Anda, bukan akun layanan default Compute Engine. Untuk mempelajari cara membuat akun layanan dengan hak istimewa minimal, lihat Menggunakan akun layanan dengan hak istimewa terendah.
Untuk menentukan akun layanan kustom di gcloud CLI, tambahkan flag berikut ke perintah Anda:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.Ganti SERVICE_ACCOUNT_NAME dengan nama akun layanan dengan hak istimewa minimal.
Menggunakan saluran rilis tertentu:
Untuk membuat cluster baru menggunakan saluran rilis tertentu, jalankan perintah berikut:
gcloud container clusters create CLUSTER_NAME \
--release-channel CHANNEL \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
Menggunakan versi tertentu:
Untuk membuat cluster baru menggunakan versi cluster tertentu, jalankan perintah berikut:
gcloud container clusters create CLUSTER_NAME \
--cluster-version VERSION \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
Contoh
Perintah berikut akan membuat cluster multi-zona bernama example-cluster,
dengan bidang kontrol cluster di zona us-east4-a, dan
ada tiga lokasi node. Cluster terdaftar di saluran rilis regular.
Jika flag --num-nodes
dihapus, jumlah default node per zona yang dibuat oleh cluster
adalah tiga. Karena tiga zona telah ditentukan, perintah ini akan membuat
cluster node dengan tiga node masing-masing di us-east4-a, us-east4-b,
dan us-east4-c. Di GKE versi 1.37.1-gke.1153000 dan yang lebih baru, Anda dapat menetapkan flag --num-nodes ke nilai 0 untuk membuat cluster yang tidak memiliki node.
gcloud container clusters create example-cluster \
--location us-east4-a \
--node-locations us-east4-a,us-east4-b,us-east4-c
Konsol
Untuk membuat cluster zona dengan konsol Google Cloud , lakukan tugas berikut:
Di konsol Google Cloud , buka halaman Create a Kubernetes cluster.
Di bagian Cluster basics, selesaikan langkah-langkah berikut:
- Masukkan Name untuk cluster Anda.
- Untuk Location type, pilih Zonal, lalu pilih zone untuk cluster Anda.
- Jika Anda membuat cluster multi-zona, pilih kotak centang Specify default node locations, lalu pilih zona tambahan tempat Anda ingin menjalankan kumpulan node.
Pilih saluran rilis. Anda dapat memilih No channel, tetapi opsi konfigurasi ini tidak digunakan lagi dan akan dihapus. Untuk mengetahui informasi selengkapnya, lihat Cluster yang tidak terdaftar di saluran rilis.
Opsional: Tentukan versi bidang kontrol dari menu drop-down Version.
Opsional: Konfigurasikan setelan lain untuk cluster baru Anda.
Opsional: Jika ingin mendaftarkan cluster baru ke fleet, buka bagian Advanced settings, dan ikuti petunjuk konsol Google Cloud untuk Create and register a new cluster guna menyelesaikan pendaftaran cluster Anda.
Untuk membuat dan mengonfigurasi node pool Anda sendiri, ikuti langkah-langkah berikut:
- Klik Add node pool.
- Dalam dialog Perubahan yang diperlukan, klik Buat perubahan.
Di menu navigasi, node pool bernama
default-poolakan muncul.Opsional: Untuk membuat cluster yang tidak memiliki node pool, ikuti langkah-langkah berikut:
- Di menu navigasi, klik default-pool.
- Klik Remove node pool.
- Konfigurasikan setelan yang tersisa untuk cluster, lalu klik Create.
Opsional: Untuk menambahkan node pool ke cluster, klik Add node pool. Di menu navigasi, node pool baru akan muncul.
Konfigurasikan setelan dasar untuk node pool:
- Di menu navigasi, di bagian Node pools, klik nama node pool. Halaman User-managed node pool details akan terbuka.
- Di kolom Name, masukkan nama untuk node pool.
- Di bagian Size, di kolom Number of nodes,
tentukan jumlah node yang akan dibuat. Anda harus memiliki kuota resource yang tersedia untuk node dan resource-nya (seperti rute firewall). Di GKE versi
1.37.1-gke.1153000 dan yang lebih baru, Anda dapat membuat node pool kosong dengan menentukan nilai
0.
Konfigurasikan setelan untuk instance VM yang menjalankan node:
- Di menu navigasi, di bagian yang diperluas untuk node pool yang Anda pilih, klik Nodes.
- Di menu drop-down Image type, pilih node image.
- Pilih Machine configuration default yang akan digunakan untuk instance. Setiap jenis mesin ditagih secara berbeda. Jenis mesin default-nya adalah
e2-medium. Untuk mengetahui informasi harga jenis mesin, lihat lembar harga jenis mesin. - Di menu drop-down Boot disk type, pilih disk type.
- Di kolom Boot disk size, tentukan ukuran, dalam GB, untuk boot disk.
Konfigurasikan setelan keamanan untuk node pool:
- Di menu navigasi, di bagian yang diperluas untuk node pool yang Anda pilih, klik Security.
- Secara opsional, tentukan akun layanan IAM kustom untuk node Anda:
- Di halaman Advanced settings, luaskan bagian Security.
- Di menu Service account, pilih akun layanan yang Anda inginkan.
Sebaiknya tentukan akun layanan IAM dengan hak istimewa minimal yang dapat digunakan node Anda, bukan akun layanan default Compute Engine. Untuk mempelajari cara membuat akun layanan dengan hak istimewa minimal, lihat Menggunakan akun layanan dengan hak istimewa terendah.
Klik Create.
Terraform
Untuk membuat cluster zona dengan node pool satu zona menggunakan Terraform, lihat contoh berikut:
Untuk membuat cluster zona dengan node pool multi-zona menggunakan Terraform, lihat contoh berikut:
Untuk mempelajari lebih lanjut cara menggunakan Terraform, lihat Dukungan Terraform untuk GKE.
Berinteraksi dengan cluster menggunakan kubectl
Setelah membuat cluster, Anda perlu mengonfigurasi kubectl sebelum dapat berinteraksi dengan cluster dari command line.
Membuat cluster zona yang tidak memiliki node
Di GKE versi 1.37.1-gke.1153000 dan yang lebih baru, Anda dapat membuat cluster zona yang tidak memiliki node dengan salah satu cara berikut:
- Skip creating the default node pool: GKE tidak menambahkan node pool apa pun ke cluster. Jika Anda berencana menjalankan workload menggunakan ComputeClass Autopilot, pembuatan otomatis node pool, atau node pool kustom yang Anda buat nanti, gunakan opsi ini.
- Membuat node pool kosong: GKE membuat node pool yang tidak memiliki node. Jika Anda ingin menyesuaikan setelan node pool selama pembuatan cluster tanpa membuat node yang sebenarnya, gunakan opsi ini.
Saat Anda membuat cluster yang tidak memiliki node, Pod sistem akan tetap dalam status tidak dapat diberi jadwal hingga setidaknya ada satu node di cluster. Untuk membuat cluster zona yang tidak memiliki node, pilih salah satu opsi berikut:
gcloud
Untuk melewati pembuatan node pool default, gunakan hanya flag
--num-nodes=0dalam perintahgcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0Ganti kode berikut:
CLUSTER_NAME: nama cluster zona baru Anda.CONTROL_PLANE_LOCATION: zona Compute Engine dari bidang kontrol cluster, sepertius-central1-a.
Jika Anda menentukan flag konfigurasi node pool lainnya, seperti flag
--machine-type,--disk-type, atau--disk-size, perintah akan gagal karena tidak ada node pool yang dapat dikonfigurasi GKE.Untuk membuat cluster yang memiliki node pool kosong, gunakan flag
--num-nodes=0dan flag--node-pool-namedalam perintahgcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0 \ --node-pool-name=NODEPOOL_NAMEGanti
NODEPOOL_NAMEdengan nama untuk node pool kosong. Anda dapat menentukan flag konfigurasi node lainnya untuk menyesuaikan node di node pool kosong.
Konsol
Di konsol Google Cloud , buka halaman Create a Kubernetes cluster.
Tentukan nama untuk cluster.
Di bagian Location type, pilih Zonal.
Di menu drop-down Zone, pilih zona untuk bidang kontrol cluster.
Lewati pembuatan node pool default atau buat node pool kosong:
Untuk melewati pembuatan node pool default, di bagian Default mode, pastikan opsi Autopilot dipilih. Atau, picu pembuatan node pool default, lalu hapus:
- Klik Add node pool.
- Dalam dialog Perubahan yang diperlukan, klik Buat perubahan.
Node pool bernama
default-poolakan muncul. - Di menu navigasi, klik default-pool.
- Klik Remove node pool.
Langkah-langkah ini membuat cluster yang tidak memiliki node pool dan menggunakan mode Autopilot untuk menjalankan workload yang tidak memilih ComputeClass. Anda juga dapat mencegah penggunaan mode Autopilot dengan memilih opsi User-managed node pool di bagian Default mode.
Untuk membuat node pool kosong, ikuti langkah-langkah berikut:
- Klik Add node pool.
- Dalam dialog Perubahan yang diperlukan, klik Buat perubahan.
Node pool bernama
default-poolakan muncul. - Di menu navigasi, klik default-pool.
- Di kolom Number of nodes, tentukan nilai
0.
Konfigurasikan setelan yang tersisa untuk cluster Anda, lalu klik Create.
Terraform
- Untuk melewati pembuatan node pool default, di resource
google_container_clusterAnda, tetapkan kolominitial_node_countke nilai0. Untuk membuat node pool awal yang kosong, lakukan hal berikut:
- Di resource
google_container_cluster, tetapkan kolominitial_node_countke nilai0. - Tambahkan resource
google_container_node_pooldan tetapkan kolomnode_countke nilai0.
- Di resource
Setelah membuat cluster yang tidak memiliki node, Anda dapat menyediakan node dengan cara berikut:
- Siapkan cluster Standard untuk menggunakan Autopilot secara default atau jalankan workload tertentu dalam mode Autopilot.
- Gunakan ComputeClasses untuk membuat node secara otomatis untuk workload yang masuk.
- Tambahkan node pool secara manual atau ubah ukuran node pool kosong yang ada.
Template cluster
GKE sebelumnya mendukung template untuk cluster. Template tersebut telah dihapus dari konsol Google Cloud , tetapi masih dapat diakses dari link berikut:
Langkah berikutnya
- Pelajari pilihan konfigurasi cluster yang dapat Anda buat.
- Pelajari arsitektur cluster GKE.
- Pelajari cara mengelola cluster Anda.
- Pelajari cara menghapus cluster.