Halaman ini menjelaskan cara menggunakan Config Sync dan Terraform untuk membuat resource cakupan tim secara dinamis di seluruh cluster. Config Sync memperluas kemampuan pengelolaan tim fleet untuk membuat dan mengelola konfigurasi infrastruktur dan cluster di seluruh fleet Anda.
Panduan ini mengasumsikan bahwa Anda sudah memahami konsep pengelolaan tim fleet seperti cakupan tim dan namespace fleet. Untuk mengetahui informasi selengkapnya, lihat ringkasan pengelolaan tim fleet.
Untuk tutorial menyeluruh dengan konfigurasi contoh, lihat tutorial sewa armada di repositori contoh.
Untuk daftar kolom yang didukung untuk Config Sync di Terraform, lihat dokumentasi referensi Terraform untuk fitur fleet GKE.
Contoh alur kerja
Anda adalah administrator platform yang ingin membuat resource secara dinamis di seluruh cluster
dengan kebutuhan yang berbeda-beda untuk setiap tim. Misalnya, Anda mungkin ingin menerapkan
NetworkPolicy
ke namespace tim Backend, tetapi tidak ke namespace tim Frontend.
Dalam skenario ini, prosedur untuk membuat resource cakupan tim di seluruh namespace adalah sebagai berikut:
- Pilih atau buat fleet tempat Anda ingin mengelola resource untuk tim.
Siapkan sumber tepercaya Anda. Sumber tepercaya berisi objek
NamespaceSelector
yang Anda gunakan untuk memilih namespace tingkat fleet dalam cakupan tim, dan resource apa pun (sepertiNetworkPolicy
) yang ingin Anda sinkronkan di seluruh namespace ini.Buat konfigurasi default tingkat fleet untuk Config Sync. Config Sync menggunakan setelan default ini saat menyinkronkan dari sumber tepercaya yang dibuat pada langkah sebelumnya. Setelan Config Sync ini berlaku untuk cluster baru yang dibuat di fleet.
Buat cluster di fleet Anda.
Buat cakupan dan namespace tim Frontend dan Backend Anda sehingga Config Sync dapat mendeteksi dan merekonsiliasi resource di namespace Anda.
Setelah Anda menyelesaikan langkah-langkah ini, Config Sync akan membuat dan menerapkan
NetworkPolicy
berdasarkan NamespaceSelector
ke namespace tim Backend. Jika Anda mengubah atau menambahkan resource apa pun, Config Sync akan terus mendeteksi dan menerapkan perubahan apa pun pada file konfigurasi, cakupan tim, namespace fleet, dan anggota fleet.
Harga
Fitur Config Sync dan pengelolaan tim fleet hanya tersedia untuk pengguna yang telah mengaktifkan GKE Enterprise. Untuk mengetahui informasi selengkapnya tentang harga GKE Enterprise, lihat halaman Harga GKE.
Sebelum memulai
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Buat atau pilih project Google Cloud.
-
Membuat project Google Cloud:
gcloud projects create PROJECT_ID
Ganti
PROJECT_ID
dengan nama untuk project Google Cloud yang Anda buat. -
Pilih project Google Cloud yang Anda buat:
gcloud config set project PROJECT_ID
Ganti
PROJECT_ID
dengan nama project Google Cloud Anda.
-
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Buat atau pilih project Google Cloud.
-
Membuat project Google Cloud:
gcloud projects create PROJECT_ID
Ganti
PROJECT_ID
dengan nama untuk project Google Cloud yang Anda buat. -
Pilih project Google Cloud yang Anda buat:
gcloud config set project PROJECT_ID
Ganti
PROJECT_ID
dengan nama project Google Cloud Anda.
-
- Buat, atau miliki akses ke, sumber tepercaya (repositori Git atau image OCI) tempat Anda dapat menyimpan file konfigurasi. Contoh dalam panduan ini menggunakan repositori Git.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan guna membuat resource tim untuk fleet, minta administrator untuk memberi Anda peran IAM berikut di project Anda:
-
Mengelola resource fleet:
Fleet Admin (sebelumnya GKE Hub Admin) (
roles/gkehub.admin
) -
Membuat cluster GKE:
Kubernetes Engine Cluster Admin (
roles/container.clusterAdmin
) -
Mengaktifkan GKE Enterprise:
Service Usage Admin (
roles/serviceusage.serviceUsageAdmin
)
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Mendapatkan kredensial pengguna
Untuk menjalankan perintah Terraform dalam panduan ini di lingkungan lokal, jalankan perintah berikut untuk mendapatkan kredensial pengguna baru:
gcloud auth application-default login
Menyiapkan fleet
Di bagian ini, Anda akan membuat fleet dan mengaktifkan layanan yang diperlukan.
Untuk menyiapkan armada, selesaikan langkah-langkah berikut:
Buat direktori untuk file Terraform konfigurasi fleet. Ke direktori tersebut, tambahkan file
main.tf
dan filevariables.tf
.Di file
variables.tf
, tambahkan variabel berikut:Di file
main.tf
, tambahkan resource berikut:Ekspor variabel PROJECT_ID:
export TF_VAR_project=PROJECT_ID
Ganti
PROJECT_ID
dengan project ID tempat Anda ingin membuat fleet.Lakukan inisialisasi Terraform di direktori yang Anda buat:
terraform init
Pastikan perubahan yang Anda usulkan dengan Terraform sesuai dengan rencana yang diharapkan:
terraform plan
Buat fleet, aktifkan API, dan buat akun layanan:
terraform apply
Terkadang perlu waktu beberapa menit untuk mengaktifkan semua layanan.
Menyiapkan sumber tepercaya
Di bagian ini, Anda akan menambahkan file konfigurasi ke sumber tepercaya.
Anda memerlukan objek NamespaceSelector
untuk setiap cakupan tim yang ingin digunakan.
Misalnya, jika memiliki tim Frontend dan Backend, Anda harus membuat objek NamespaceSelector
untuk setiap tim. Objek NamespaceSelector
memilih semua atau beberapa
namespace dalam cakupan tim. Anda dapat menambahkan resource tim tambahan
ke sumber tepercaya, seperti NetworkPolicy
. Saat membuat resource ini,
Anda mereferensikan NamespaceSelector
sehingga Config Sync dapat men-deploy dan menyinkronkan resource tersebut
secara dinamis di seluruh namespace.
Untuk menyiapkan sumber tepercaya, selesaikan langkah-langkah berikut:
Di sumber tepercaya, buat direktori untuk file konfigurasi yang ingin disinkronkan oleh Config Sync.
Untuk setiap tim, buat objek
NamespaceSelector
di direktori konfigurasi Anda:apiVersion: configmanagement.gke.io/v1 kind: NamespaceSelector metadata: name: NAMESPACE_SELECTOR_NAME spec: mode: dynamic selector: matchLabels: fleet.gke.io/fleet-scope: SCOPE_NAME
Ganti kode berikut:
NAMESPACE_SELECTOR_NAME
: nama untuk objekNamespaceSelector
, misalnyabackend-scope
.SCOPE_NAME
: nama cakupan tim Anda, misalnyabackend
.
Setiap namespace yang merupakan bagian dari namespace fleet akan otomatis memiliki label
fleet.gke.io/fleet-scope: SCOPE_NAME
.NamespaceSelector
memilih semua namespace armada dari cakupan tim menggunakan label tersebut. Untuk contoh selengkapnya tentang cara menyertakan atau mengecualikan namespace, lihat contohNamespaceSelector
.Buat objek yang ingin Anda sinkronkan di seluruh namespace.
Untuk menyinkronkan objek hanya ke tim tertentu, tetapkan anotasi berikut di metadata objek tersebut:
annotations: configmanagement.gke.io/namespace-selector: NAMESPACE_SELECTOR_NAME
Misalnya,
NetworkPolicy
untuk tim Backend mungkin menyerupai hal berikut:
Membuat default tingkat fleet untuk Config Sync
Di bagian ini, Anda akan membuat setelan default tingkat fleet untuk Config Sync, yang menerapkan konfigurasi Config Sync yang sama ke semua cluster yang dibuat di fleet Anda.
Untuk membuat konfigurasi default tingkat grup untuk Config Sync, selesaikan langkah-langkah berikut:
Buat direktori untuk file Terraform konfigurasi default armada. Ke direktori tersebut, tambahkan file
main.tf
dan filevariables.tf
.Di file
variables.tf
, tambahkan variabel berikut:Di file
main.tf
, tambahkan resource berikut untuk mengonfigurasi setelan Config Sync:git
terraform { required_providers { google = { source = "hashicorp/google" version = ">=5.16.0" } } } provider "google" { project = var.project } resource "google_gke_hub_feature" "feature" { name = "configmanagement" location = "global" provider = google fleet_default_member_config { configmanagement { version = "VERSION" config_sync { source_format = "unstructured" git { sync_repo = "REPO" sync_branch = "BRANCH" policy_dir = "DIRECTORY" secret_type = "SECRET" } } } } }
Ganti kode berikut:
VERSION
: (opsional) nomor versi Config Sync. Harus disetel ke versi 1.17.0 atau yang lebih baru. Jika dibiarkan kosong, defaultnya adalah versi terbaru.REPO
: URL ke repositori yang berisi file konfigurasi Anda.BRANCH
: cabang repositori, misalnyamain
.DIRECTORY
: jalur dalam repositori Git yang mewakili tingkat teratas repositori yang ingin Anda sinkronkan.SECRET
: jenis autentikasi secret.
Untuk mengetahui daftar lengkap setelan yang didukung di blok
git
Config Sync, lihat dokumentasi referensi Terraform untuk fitur hub GKE.OCI
terraform { required_providers { google = { source = "hashicorp/google" version = ">=5.16.0" } } } provider "google" { project = var.project } resource "google_gke_hub_feature" "feature" { name = "configmanagement" location = "global" provider = google fleet_default_member_config { configmanagement { version = "VERSION" config_sync { source_format = "unstructured" oci { sync_repo = "REPO" policy_dir = "DIRECTORY" secret_type = "SECRET" } } } } }
Ganti kode berikut:
VERSION
: nomor versi Config Sync. Harus disetel ke versi 1.17.0 atau yang lebih baru. Jika dibiarkan kosong, defaultnya adalah versi terbaru.REPO
: URL ke repositori image OCI yang berisi file konfigurasi.DIRECTORY
: jalur absolut direktori yang berisi resource yang ingin Anda sinkronkan. Biarkan kosong untuk menggunakan direktori root.SECRET
: jenis autentikasi secret.
Untuk mengetahui daftar lengkap setelan yang didukung di blok
oci
Config Sync, lihat dokumentasi referensi Terraform untuk fitur hub GKE.Sebagai contoh, file
main.tf
berikut mengonfigurasi Config Sync untuk menyinkronkan dari repositori Git dan menyinkronkan semua objek yang ada di direktoriconfig
:Lakukan inisialisasi Terraform di direktori yang Anda buat:
terraform init
Pastikan perubahan yang Anda usulkan dengan Terraform sesuai dengan rencana yang diharapkan:
terraform plan
Buat konfigurasi anggota armada default:
terraform apply
Membuat cluster di fleet
Di bagian ini, Anda akan membuat konfigurasi cluster bersama, lalu membuat cluster di fleet.
Untuk membuat dan mendaftarkan cluster baru ke fleet Anda, selesaikan langkah-langkah berikut:
Buat direktori untuk file Terraform konfigurasi cluster. Ke direktori tersebut, tambahkan file
main.tf
dan filevariables.tf
.Di file
variables.tf
, tambahkan variabel berikut:Buat file
cluster.tf
yang berisi nilai default yang digunakan di semua cluster, seperti project dan ID armada Anda:variable "location" { type = string } variable "cluster_name" { type = string } data "google_project" "project" { provider = google } resource "google_container_cluster" "cluster" { provider = google name = var.cluster_name location = var.location initial_node_count = 3 project = data.google_project.project.project_id fleet { project = data.google_project.project.project_id } workload_identity_config { workload_pool = "${data.google_project.project.project_id}.svc.id.goog" } deletion_protection = false }
Di file
main.tf
, tambahkan resource berikut:terraform { required_providers { google = { source = "hashicorp/google" version = ">=5.16.0" } } } provider "google" { project = var.project } module "MODULE_NAME" { source = "CLUSTER_CONFIGURATION_FILEPATH" cluster_name = "CLUSTER_NAME" location="CLUSTER_LOCATION" }
Ganti kode berikut:
MODULE_NAME
: nama yang ingin Anda berikan ke modul cluster. MODULE_NAME dan CLUSTER_NAME dapat memiliki nilai yang sama, misalnyaus-east-cluster
.CLUSTER_CONFIGURATION_FILEPATH
: jalur relatif ke filecluster.tf
yang Anda buat.CLUSTER_NAME
: nama cluster Anda. MODULE_NAME dan CLUSTER_NAME dapat memiliki nilai yang sama, misalnyaus-east-cluster
.CLUSTER_LOCATION
: lokasi cluster Anda, misalnyaus-east1
.
Anda dapat membuat cluster sebanyak yang Anda inginkan. Sebagai contoh, file
main.tf
berikut membuat 3 cluster di region yang berbeda:Lakukan inisialisasi Terraform di direktori yang Anda buat:
terraform init
Pastikan perubahan yang Anda usulkan dengan Terraform sesuai dengan rencana yang diharapkan:
terraform plan
Buat cluster:
terraform apply
Mengonfigurasi cakupan tim dan namespace armada
Di bagian ini, Anda akan membuat cakupan tim dan mengaitkan cluster dengan cakupan tersebut. Kemudian, Anda membuat namespace fleet yang diperlukan, misalnya satu untuk setiap tim, di setiap cakupan, dan Config Sync akan membuat resource di seluruh namespace Anda.
Untuk mengonfigurasi cakupan tim dan namespace, selesaikan langkah-langkah berikut:
Buat direktori untuk file Terraform konfigurasi cakupan tim dan namespace. Ke direktori tersebut, tambahkan file
main.tf
dan filevariables.tf
.Di file
variables.tf
, tambahkan variabel berikut:Di file
main.tf
, tambahkan resource berikut:Tambahkan informasi penyedia:
terraform { required_providers { google = { source = "hashicorp/google" version = ">=5.16.0" } } } provider "google" { project = var.project }
Tambahkan resource cakupan tim:
resource "google_gke_hub_scope" "scope" { provider = google for_each = toset([ "SCOPE_NAME", "SCOPE_NAME_2", ]) scope_id = each.value }
Ganti kode berikut:
SCOPE_NAME
: nama cakupan tim Anda, misalnyabackend
.SCOPE_NAME_2
: cakupan tim tambahan jika Anda membuatnya.
Anda dapat menambahkan cakupan tim sebanyak yang diperlukan. Saat namespace fleet dibuat di cluster, namespace akan otomatis diberi label dengan
fleet.gke.io/fleet-scope: SCOPE_NAME
, sehingga Config Sync dapat memilih namespace berdasarkan labelNamespaceSelector
yang ada saat menyinkronkan resource Kubernetes.Sebagai contoh, resource Terraform cakupan tim yang menyertakan cakupan untuk tim Frontend dan Backend mungkin menyerupai hal berikut:
Tambahkan binding langganan fleet untuk setiap cluster yang ingin Anda terapkan ke cakupan tim:
resource "google_gke_hub_membership_binding" "membership-binding" { provider = google for_each = { MEMBERSHIP_BINDING_NAME = { membership_binding_id = "MEMBERSHIP_BINDING_ID" scope = google_gke_hub_scope.scope["SCOPE_NAME"].name membership_id = "CLUSTER_NAME" location = "CLUSTER_LOCATION" } MEMBERSHIP_BINDING_NAME_2 = { membership_binding_id = "MEMBERSHIP_BINDING_ID_2" scope = google_gke_hub_scope.scope["SCOPE_NAME_2"].name membership_id = "CLUSTER_NAME_2" location = "CLUSTER_LOCATION_2" } } membership_binding_id = each.value.membership_binding_id scope = each.value.scope membership_id = each.value.membership_id location = each.value.location depends_on = [google_gke_hub_scope.scope] }
Ganti kode berikut:
MEMBERSHIP_BINDING_NAME
: nama binding keanggotaan, misalnyaus-east-backend
.MEMBERSIP_BINDING_ID
: ID binding keanggotaan. URL ini dapat sama dengan MEMBERSHIP_BINDING_NAME.SCOPE_NAME
: pemilih label yang Anda berikan ke cakupan tim saat membuatNamespaceSelector
, misalnyabackend
.CLUSTER_NAME
: nama cluster yang Anda buat saat membuat cluster, misalnyaus-east-cluster
.CLUSTER_LOCATION
: lokasi cluster, misalnyaus-east1
.
Anda perlu menentukan binding keanggotaan fleet untuk setiap cluster. Jika Anda tidak menentukan cakupan tim untuk cluster, cluster tersebut tidak akan dibuat untuk namespace tersebut. Misalnya, jika Anda memiliki tiga cluster di region
us-east1
,us-west1
, danus-central1
, tetapi clusterus-central1
hanya untuk tim Frontend, resource binding keanggotaan Anda akan menyerupai hal berikut:Tambahkan namespace yang ingin Anda tentukan untuk tim:
resource "google_gke_hub_namespace" "fleet_namespace" { provider = google for_each = { FLEET_NAMESPACE = { scope_id = "SCOPE_NAME" scope_namespace_id = "FLEET_NAMESPACE_ID" scope = google_gke_hub_scope.scope["SCOPE_NAME"].name } FLEET_NAMESPACE_2 = { scope_id = "SCOPE_NAME" scope_namespace_id = "FLEET_NAMESPACE_ID_2" scope = google_gke_hub_scope.scope["SCOPE_NAME"].name } } scope_namespace_id = each.value.scope_namespace_id scope_id = each.value.scope_id scope = each.value.scope depends_on = [google_gke_hub_scope.scope] }
Ganti kode berikut:
FLEET_NAMESPACE
: nama yang ingin Anda berikan ke namespace, misalnyabackend-a
.SCOPE_NAME
: pemilih label yang Anda berikan ke cakupan tim saat membuatNamespaceSelector
, misalnyabackend
.FLEET_NAMESPACE_ID
: ID namespace. Nilai ini dapat sama dengan FLEET_NAMESPACE.
Misalnya, jika Anda ingin tim Frontend dan Backend memiliki dua namespace, resource namespace fleet Anda mungkin menyerupai hal berikut:
Lakukan inisialisasi Terraform di direktori yang Anda buat:
terraform init
Pastikan perubahan yang Anda usulkan dengan Terraform sesuai dengan rencana yang diharapkan:
terraform plan
Buat cakupan dan namespace fleet:
terraform apply
Setelah Anda membuat cakupan dan namespace fleet, Config Sync akan mendeteksi namespace baru tersebut dan cakupannya, memilih resource di namespace fleet, dan merekonsiliasinya dengan file konfigurasi Anda.
Anda dapat memeriksa apakah resource diterapkan ke cluster yang benar menggunakan nomos status
atau dengan membuka tab Packages Config Sync di Konsol Google Cloud dan mengubah tombol pilihan View by menjadi Cluster.
Config Sync menyinkronkan resource Anda di seluruh namespace berdasarkan cakupan tim Anda
sesuai dengan konfigurasi yang disimpan di sumber tepercaya Anda. Setiap kali Anda menambahkan resource baru,
selama Anda menyertakan anotasi NamespaceSelector
yang benar, Config Sync
akan otomatis merekonsiliasi resource tersebut di seluruh namespace tim Anda.
Jika Anda ingin menerapkan setelan Config Sync ke cluster yang ada, lihat petunjuk untuk Mengonfigurasi setelan default tingkat fleet dalam panduan penginstalan Config Sync.
Langkah selanjutnya
- Pelajari lebih lanjut cara menyiapkan tim untuk armada Anda.