Tutorial ini menunjukkan cara menyiapkan Config Sync untuk edisi Google Kubernetes Engine (GKE) Enterprise di dua lingkungan, satu untuk pengembangan dan satu lagi untuk produksi, menggunakan praktik terbaik untuk Config Sync.
Dalam skenario ini, Anda adalah bagian dari tim admin platform di Foo Corp. Aplikasi Foo Corp
di-deploy ke GKE Enterprise, dengan resource yang dibagi menjadi
dua project, dev
dan prod
. Project dev
berisi pengembangan
cluster GKE Enterprise, dan project prod
berisi
cluster GKE Enterprise produksi. Tujuan Anda sebagai admin platform adalah memastikan bahwa kedua lingkungan tetap mematuhi kebijakan Foo Corp, dan bahwa resource tingkat dasar, seperti namespace Kubernetes dan akun layanan, tetap konsisten di kedua lingkungan tersebut.
Diagram berikut menunjukkan ringkasan lingkungan yang Anda siapkan dalam tutorial ini:
Tutorial ini memanfaatkan fitur rendering otomatis di Config Sync untuk merender resource di cluster. Setiap cluster dikonfigurasi untuk disinkronkan dari direktori yang berisi file konfigurasi Kustomization, yang memicu proses rendering secara otomatis di Config Sync. Untuk detail selengkapnya, lihat Menggunakan repo dengan konfigurasi Kustomize dan diagram Helm.
Seperti ditampilkan dalam diagram sebelumnya, dalam tutorial ini, Anda akan membuat resource berikut:
- Dua project Google Cloud yang mewakili lingkungan pengembangan dan produksi.
- Dua cluster GKE Enterprise,
dev
danprod
, di project terpisah, dengan Config Sync terinstal.
Arsitektur repositori
Dalam tutorial ini, Anda mengonfigurasi Config Sync untuk menyinkronkan konfigurasi di direktori config-source/
pada repositori contoh. Direktori ini berisi
direktori dan file berikut:
config-source/
├── base
│ ├── foo
│ │ ├── kustomization.yaml
│ │ ├── namespace.yaml
│ │ └── serviceaccount.yaml
│ ├── kustomization.yaml
│ ├── pod-creator-clusterrole.yaml
│ └── pod-creator-rolebinding.yaml
├── cloudbuild.yaml
├── overlays
│ ├── dev
│ │ └── kustomization.yaml
│ └── prod
│ └── kustomization.yaml
└── README.md
Direktori config-source
mencakup manifes base/
serta overlay dev/
dan
prod/
Kustomize. Setiap direktori berisi file kustomization.yaml
, yang mencantumkan file yang harus dikelola dan diterapkan oleh Kustomize ke cluster.
Dalam dev/kustomization.yaml
dan prod/kustomization.yaml
, serangkaian patch
ditentukan. Patch ini memanipulasi resource base/
untuk lingkungan
tertentu.
Misalnya, RoleBinding dev memungkinkan semua developer Foo Corp men-deploy Pod ke
cluster dev, sedangkan prod RoleBinding hanya mengizinkan agen
Continuous Deployment, deploy-bot@foo-corp.com
, untuk men-deploy Pod ke produksi:
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- ../../base
patches:
# ServiceAccount - make name unique per environ
- target:
kind: ServiceAccount
name: foo-ksa
patch: |-
- op: replace
path: /metadata/name
value: foo-ksa-dev
- op: replace
path: /metadata/namespace
value: foo-dev
# Pod creators - give all Foo Corp developers access
- target:
kind: RoleBinding
name: pod-creators
patch: |-
- op: replace
path: /subjects/0/name
value: developers-all@foo-corp.com
commonLabels:
environment: dev
Tujuan
- Siapkan Config Sync agar otomatis merender dan menyinkronkan konfigurasi untuk dua lingkungan yang terpisah.
Biaya
Dalam dokumen ini, Anda menggunakan komponen Google Cloud yang dapat ditagih berikut:
Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda,
gunakan kalkulator harga.
Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.
Sebelum memulai
Sebelum memulai tutorial ini, pastikan Anda telah menyelesaikan langkah-langkah berikut:
Di Konsol Google Cloud, pada halaman pemilih project, pilih atau buat dua project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
Upgrade Google Cloud CLI ke versi terbaru.
Menginstal atau mengupgrade perintah
nomos
Membuat dan mendaftarkan cluster Anda
Agar Anda dapat berfokus pada alur kerja yang perlu digunakan saat mengonfigurasi
Config Sync untuk beberapa lingkungan, direktori
multi-environments-kustomize
berisi skrip yang dapat Anda gunakan untuk mengotomatiskan konfigurasi
Config Sync.
Gandakan repositori sampel
git clone https://github.com/GoogleCloudPlatform/anthos-config-management-samples.git
Buka folder yang berisi resource yang Anda butuhkan untuk tutorial ini:
cd anthos-config-management-samples/multi-environments-kustomize/
Untuk menjalankan skrip yang digunakan dalam tutorial ini, tetapkan variabel berikut:
export DEV_PROJECT="DEV_PROJECT_ID" export PROD_PROJECT="PROD_PROJECT_ID" export DEV_CLUSTER_ZONE="DEV_CLUSTER_ZONE" export PROD_CLUSTER_ZONE="PROD_CLUSTER_ZONE" export CM_CONFIG_DIR="config-sync-rendering"
Ganti kode berikut:
DEV_PROJECT_ID
: project ID dari project Google Cloud yang ingin digunakan sebagai project dev AndaPROD_PROJECT_ID
: project ID dari project Google Cloud yang ingin Anda gunakan sebagai project produksiDEV_CLUSTER_ZONE
: zona Compute Engine tempat Anda ingin membuat cluster dev. Misalnya,us-central1-c
.PROD_CLUSTER_ZONE
: zona Compute Engine tempat Anda ingin membuat cluster produksi
Untuk membuat dua cluster, jalankan skrip
./create-clusters.sh
:./create-clusters.sh
Skrip ini membuat satu cluster GKE Enterprise bernama
dev
di project pengembangan dan satu cluster GKE Enterprise bernamaprod
di project produksi. Skrip ini juga mengaktifkan GKE Enterprise API dan terhubung ke clusterdev
danprod
sehingga Anda dapat mengakses API mereka dengankubectl
.Contoh output:
kubeconfig entry generated for dev. Fetching cluster endpoint and auth data. kubeconfig entry generated for prod. ⭐️ Done creating clusters.
Untuk mendaftarkan cluster Anda ke dua fleet yang terpisah, jalankan skrip
register-clusters.sh
:./register-clusters.sh
Skrip ini membuat akun dan kunci layanan Google Cloud untuk pendaftaran cluster GKE Enterprise, lalu menggunakan perintah
gcloud container fleet memberships register
untuk mendaftarkan clusterdev
danprod
ke GKE Enterprise dalam project mereka sendiri.Contoh output:
Waiting for Feature Config Management to be created...done. ⭐️ Done registering clusters.
Menyiapkan Config Sync
Setelah membuat dan mendaftarkan cluster, Anda dapat menginstal Config Sync dan memverifikasi penginstalan.
Menginstal Config Sync
Untuk menginstal Config Sync, pada cluster dev dan prod, jalankan skrip install-config-sync.sh
:
./install-config-sync.sh
Output yang diharapkan:
🔁 Installing ConfigSync on the dev cluster...
Updated property [core/project].
Switched to context "DEV_CLUSTER".
Waiting for Feature Config Management to be updated...done.
🔁 Installing ConfigSync on the prod cluster...
Updated property [core/project].
Switched to context "PROD_CLUSTER".
Waiting for Feature Config Management to be updated...done.
Config Sync kini sedang menyinkronkan ke konfigurasi di repositori Anda.
Verifikasi konfigurasi Anda
Di bagian ini, Anda akan memeriksa untuk memastikan bahwa cluster Anda disinkronkan ke konfigurasi di repositori Anda:
Untuk memeriksa status penginstalan Config Sync, jalankan perintah
nomos status
:nomos status
Anda akan melihat bahwa cluster dev dan prod Anda kini disinkronkan ke repo masing-masing:
gke_DEV_PROJECT_ID_us-central1-c_dev -------------------- <root> https://github.com/GoogleCloudPlatform/anthos-config-management-samples/multi-environments-kustomize/config-source/overlays/dev@main SYNCED 8f2e196f Managed resources: NAMESPACE NAME STATUS clusterrole.rbac.authorization.k8s.io/pod-creator Current namespace/default Current namespace/foo Current default rolebinding.rbac.authorization.k8s.io/pod-creators Current foo serviceaccount/foo-ksa-dev Current *gke_PROD_PROJECT_ID_us-central1-c_prod -------------------- <root> https://github.com/GoogleCloudPlatform/anthos-config-management-samples/multi-environments-kustomize/config-source/overlays/prod@main SYNCED c91502ee Managed resources: NAMESPACE NAME STATUS clusterrole.rbac.authorization.k8s.io/pod-creator Current namespace/default Current namespace/foo Current default rolebinding.rbac.authorization.k8s.io/pod-creators Current foo serviceaccount/foo-ksa-prod Current ```
Gunakan
kubectl
untuk beralih ke cluster dev:kubectl config use-context "gke_${DEV_PROJECT}_${DEV_CLUSTER_ZONE}_dev"
Untuk memverifikasi bahwa resource sudah disinkronkan, dapatkan namespace. Anda akan melihat namespace
foo
muncul.kubectl get namespace
Contoh output:
NAME STATUS AGE config-management-monitoring Active 9m38s config-management-system Active 9m38s default Active 47h foo Active 9m5s kube-node-lease Active 47h kube-public Active 47h kube-system Active 47h resource-group-system Active 9m30s
Anda kini telah menyiapkan rendering konfigurasi otomatis untuk lingkungan pengembangan dan produksi, di berbagai project dan lingkungan Google Cloud.
Pembersihan
Agar tidak perlu membayar biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus setiap resource.
Hapus semua referensi
Untuk menghapus resource yang Anda buat dalam tutorial ini, tetapi agar project dev dan prod tetap utuh, jalankan skrip pembersihan:
./cleanup.sh
Menghapus project
- Di konsol Google Cloud, buka halaman Manage resource.
- Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
- Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.
Langkah selanjutnya
- Pelajari Peluncuran aman dengan Config Sync
- Pelajari arsitektur referensi, diagram, dan praktik terbaik tentang Google Cloud. Lihat Cloud Architecture Center kami.