Memigrasikan dalam cluster ke Istio di cluster baru
Tutorial ini menunjukkan cara memigrasikan aplikasi dari cluster Google Kubernetes Engine (GKE) yang ada menggunakan Cloud Service Mesh dalam cluster ke cluster GKE baru menggunakan Istio open source. Anda akan memanfaatkan kemampuan mesh edge-to-multi-cluster untuk migrasi yang lancar.
Catatan terminologi: Dalam tutorial ini, Cloud Service Mesh mengacu pada Cloud Service Mesh dalam cluster Google, dan Istio mengacu pada mesh layanan Istio open source.
Dalam tutorial ini, Anda akan:
- Menyiapkan cluster yang ada dengan Cloud Service Mesh dalam cluster untuk migrasi.
- Menyediakan cluster GKE baru dengan Istio.
- Mengonfigurasi GKE multi-cluster Gateway API di cluster khusus dan Layanan multi-cluster untuk menyiapkan perutean ke ingress mesh.
- Menjalankan deployment canary untuk membagi traffic HTTP live antara Cloud Service Mesh dan Istio.
- Menyelesaikan cutover akhir ke Istio dan menonaktifkan resource Cloud Service Mesh dalam cluster.
Deployment canary
"Deployment canary" adalah teknik yang digunakan dalam rekayasa software untuk menguji versi software atau infrastruktur baru sebelum merilisnya ke semua pengguna produksi. Teknik ini melibatkan peningkatan persentase traffic yang dikirim ke versi target baru secara bertahap.
Dalam tutorial ini, Anda akan menyiapkan cluster baru dengan Istio dan mengalihkan traffic pengguna ke cluster tersebut secara bertahap. Anda akan mulai dengan mengarahkan 0% traffic pengguna ke cluster baru, lalu 50%, dan akhirnya 100% ke cluster GKE dengan Istio. Di lingkungan produksi, Anda dapat menggunakan kenaikan yang lebih kecil dan lebih terperinci (misalnya, 1%, 5%, 10%, 25%, 50%, 100%). Jika sewaktu-waktu Anda melihat bahwa cluster baru menunjukkan error atau penurunan performa, Anda dapat segera melakukan rollback dengan menetapkan persentase traffic kembali ke 0% untuk cluster Istio.
Bidang kontrol canary versus cluster canary
Ada dua strategi utama untuk bermigrasi antara bidang kontrol mesh layanan:
- Migrasi cluster canary (Direkomendasikan): Dalam strategi ini, Anda membuat cluster baru di Google Cloud project dan fleet yang sama dengan cluster yang ada, menginstal bidang kontrol mesh layanan target (Istio) di cluster tersebut, dan memigrasikan workload dan traffic ingress ke cluster baru.
- Migrasi bidang kontrol canary (Tidak didukung): Dalam strategi ini, Anda menginstal bidang kontrol baru secara berdampingan di cluster yang sama tempat bidang kontrol awal diinstal. Mode migrasi ini tidak didukung.
Dalam panduan ini, Anda akan mengikuti strategi migrasi cluster canary. Kedua cluster harus berada di project yang sama Google Cloud
Biaya
Tutorial ini menggunakan komponen yang dapat ditagih Google Cloud, termasuk:
Setelah menyelesaikan tutorial ini, Anda dapat menghindari biaya berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, baca bagian Pembersihan.
Sebelum memulai
-
Di Google Cloud konsol, di halaman pemilih project, pilih Google Cloud project tempat Cloud Service Mesh dalam cluster Anda diinstal.
- Login ke akun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Verify that billing is enabled for your Google Cloud project.
Enable the required APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
Verify that billing is enabled for your Google Cloud project.
Enable the required APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
Menyiapkan cluster menggunakan Cloud Service Mesh dalam cluster untuk migrasi
Di bagian ini, Anda akan menyiapkan cluster GKE yang ada yang menjalankan Cloud Service Mesh dalam cluster untuk migrasi ke cluster GKE dengan Istio.
Memastikan cluster Cloud Service Mesh dalam cluster berjalan dan siap untuk migrasi
Pastikan cluster Cloud Service Mesh dalam cluster Anda
GKE_CSM_CLUSTERberjalan denganistiodbidang kontrol dalam cluster yang mengikuti Panduan penginstalan Cloud Service Mesh dalam cluster.Jalankan perintah berikut untuk memeriksa status penginstalan:
kubectl get deployment -A -l app=istiod -L istio.io/revOutput yang diharapkan mirip dengan berikut ini:
NAMESPACE NAME READY UP-TO-DATE AVAILABLE AGE REV ISTIOD_NAMESPACE istiod-asm-1295-12 2/2 2 2 4d16h asm-1295-12Pastikan tidak ada error di bidang kontrol
istiodmenggunakan perintah berikut:kubectl logs -n ISTIOD_NAMESPACE -l app=istiod
Menyiapkan cluster untuk migrasi
Pastikan Workload Identity diaktifkan di cluster dan node pool.
Untuk memverifikasi Workload Identity di cluster, jalankan perintah berikut:
gcloud container clusters describe "GKE_CSM_CLUSTER" \ --location="LOCATION" \ --project="PROJECT_ID" \ --format="value(workloadIdentityConfig.workloadPool)"Ganti GKE_CSM_CLUSTER dengan nama cluster yang ada, LOCATION dengan lokasi cluster Anda, dan PROJECT_ID dengan ID project Anda.
Output yang diharapkan:
PROJECT_ID.svc.id.googJika Workload Identity tidak ada, lihat Panduan Workload Identity untuk memperbarui cluster Anda.
Pastikan cluster Anda terdaftar di fleet:
gcloud container clusters describe "GKE_CSM_CLUSTER" \ --location="LOCATION" \ --project="PROJECT_ID" \ --format="yaml(fleet)"Output yang diharapkan untuk cluster terdaftar:
fleet: membership: //gkehub.googleapis.com/projects/PROJECT_NUMBER/locations/LOCATION/memberships/MEMBERSHIP_NAMEJika detail fleet kosong, lihat Panduan pendaftaran keanggotaan fleet untuk mendaftarkan cluster Anda ke fleet.
Ekspos aplikasi Anda menggunakan gateway Ingress dengan mengikuti Panduan menginstal dan mengupgrade gateway guide.
Menginstal Istio di cluster GKE baru
Di bagian ini, Anda akan menyediakan cluster GKE baru yang menjalankan Istio open source untuk strategi migrasi cluster canary.
Buat cluster GKE baru
GKE_ISTIO_CLUSTERdi project yang sama Google Cloud (PROJECT_ID) dengan cluster Cloud Service Mesh dalam cluster yang ada.Saat membuat cluster, pastikan Anda menentukan
--projectdan mengaktifkan Workload Identity menggunakan--workload-pool=PROJECT_ID.svc.id.goog:gcloud container clusters create GKE_ISTIO_CLUSTER \ --project=PROJECT_ID \ --location=LOCATION \ --workload-pool=PROJECT_ID.svc.id.googJika Anda telah membuat cluster, gunakan Panduan Workload Identity untuk mengaktifkan Workload Identity.
Daftarkan cluster Istio Anda ke fleet:
gcloud container fleet memberships register \ GKE_ISTIO_CLUSTER \ --gke-cluster=LOCATION/GKE_ISTIO_CLUSTER \ --enable-workload-identity \ --location=LOCATION \ --project=PROJECT_IDInstal Istio dengan mengikuti Panduan Pemasangan Istio resmi dengan gateway ingress yang di-deploy untuk traffic masuk. Untuk migrasi yang lebih lancar, sebaiknya instal Istio open source versi yang sama. Jika Anda memutuskan untuk mengupgrade Istio open source, tinjau catatan rilis Istio untuk mengetahui perubahan perilaku.
Siapkan cluster ini dengan menginstal aplikasi Anda dengan cara yang sama seperti di cluster GKE menggunakan Cloud Service Mesh dalam cluster. Panduan ini mereferensikan namespace yang menghosting gateway ingress sebagai
ISTIO_INGRESS_NAMESPACE.Pastikan cluster responsif dan siap untuk menampilkan traffic. Tim aplikasi bertanggung jawab untuk mengonfirmasi bahwa semua microservice berjalan dengan baik dan lulus pemeriksaan kesehatan sebelum merutekan traffic pengguna live.
Mengonfigurasi multi-cluster Gateway API di cluster khusus
Di bagian ini, Anda akan mengonfigurasi Load Balancer Aplikasi (L7XLB) eksternal melalui pengontrol GKE Gateway untuk mengaktifkan traffic ingress ke mesh. Selama migrasi, sebaiknya deploy resource Gateway API di cluster konfigurasi GKE khusus untuk mengelola load balancer. Panduan ini menyebut cluster konfigurasi khusus ini sebagai GKE_CONFIG_CLUSTER.
Menyiapkan cluster konfigurasi
Siapkan cluster konfigurasi untuk menghosting Gateway dan HTTPRoute API dengan mengikuti
panduan multi-cluster Gateway.
Mengekspor Layanan menggunakan Layanan multi-cluster
Ekspor istio-ingressgateway Service di kedua cluster mesh menggunakan
ServiceExport seperti yang diarahkan dalam
panduan Layanan multi-cluster
(MCS):
apiVersion: net.gke.io/v1
kind: ServiceExport
metadata:
namespace: NAMESPACE
name: SERVICE_EXPORT_NAME
Menyediakan resource Gateway API di cluster konfigurasi
Ikuti panduan Gateway Edge-to-Mesh untuk membuat resource
GatewaydanHTTPRoutedi cluster konfigurasi khusus Anda. Contoh konfigurasi terlihat seperti berikut:apiVersion: gateway.networking.k8s.io/v1 kind: Gateway metadata: name: global-gateway namespace: CSM_INGRESS_NAMESPACE spec: gatewayClassName: gke-l7-global-external-managed-mc listeners: - name: http protocol: HTTP port: 80 allowedRoutes: namespaces: from: Same --- apiVersion: gateway.networking.k8s.io/v1 kind: HTTPRoute metadata: name: edge-to-mesh-route namespace: CSM_INGRESS_NAMESPACE spec: parentRefs: - name: global-gateway rules: - backendRefs: # Backend 1: Cloud Service Mesh Cluster (CSM_INGRESS_NAMESPACE namespace) - group: net.gke.io kind: ServiceImport name: istio-ingressgateway namespace: CSM_INGRESS_NAMESPACE port: 80 weight: 100Jika resource
ServiceImportAnda berada di namespace yang berbeda denganHTTPRoute, gunakanReferenceGrantuntuk mengaktifkan perutean traffic lintas namespace:apiVersion: gateway.networking.k8s.io/v1beta1 kind: ReferenceGrant metadata: name: allow-csm-ingress-to-ISTIO_INGRESS_NAMESPACE namespace: ISTIO_INGRESS_NAMESPACE spec: from: - group: gateway.networking.k8s.io kind: HTTPRoute namespace: CSM_INGRESS_NAMESPACE to: - group: net.gke.io kind: ServiceImport
Memigrasikan traffic menggunakan deployment canary
Di bagian ini, Anda akan mengalihkan traffic ke cluster baru dan menyelesaikan migrasi.
Mengalihkan 50% traffic ke Istio
Di bagian ini, Anda akan menjalankan deployment canary untuk memigrasikan traffic secara perlahan. Untuk mengetahui informasi selengkapnya, lihat panduan pembagian traffic.
Terapkan resource kustom
HTTPRoutedi cluster konfigurasi untuk membagi traffic canary ke cluster Istio:apiVersion: gateway.networking.k8s.io/v1 kind: HTTPRoute metadata: name: edge-to-mesh-route namespace: CSM_INGRESS_NAMESPACE spec: parentRefs: - name: global-gateway rules: - backendRefs: # Backend 1: CSM Cluster (CSM_INGRESS_NAMESPACE namespace) - group: net.gke.io kind: ServiceImport name: istio-ingressgateway namespace: CSM_INGRESS_NAMESPACE port: 80 weight: 50 # Backend 2: Istio Cluster (ISTIO_INGRESS_NAMESPACE namespace) - group: net.gke.io kind: ServiceImport name: istio-ingressgateway namespace: ISTIO_INGRESS_NAMESPACE port: 80 weight: 50Validasi distribusi traffic live dengan menjalankan permintaan paralel terhadap alamat IP publik Gateway.
Output yang diharapkan: Respons di-load balance di seluruh
GKE_CSM_CLUSTERdanGKE_ISTIO_CLUSTER.Dalam produksi, seperti yang disebutkan sebelumnya, migrasikan traffic dalam kenaikan yang lebih kecil (misalnya, 1%, 5%, 10%, 25%, 50%, 100%). Diperlukan waktu beberapa saat agar kenaikan bobot ini dapat diterapkan sepenuhnya ke load balancer, jadi pastikan traffic dibagi dengan benar sebelum menambahnya lebih lanjut.
Menyelesaikan migrasi ke cluster Istio
Pastikan aplikasi di cluster Istio beroperasi dengan benar di bawah traffic canary dan semua traffic telah dialihkan ke cluster tersebut. Setelah mengonfirmasi bahwa perutean traffic berfungsi dengan baik, selesaikan migrasi dengan menghapus resource ServiceExport di cluster Cloud Service Mesh dalam cluster:
kubectl --context="GKE_CSM_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n CSM_INGRESS_NAMESPACE
Pengontrol GKE Gateway otomatis melepaskan Network Endpoint Group (NEG) cluster Cloud Service Mesh dari the Google Cloud load balancer layanan backend. Semua traffic klien yang masuk akan bertransisi dengan lancar ke cluster Istio tanpa waktu henti.
Pembersihan
Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan dalam tutorial ini, bersihkan komponen yang di-deploy.
Hapus resource
ServiceExportdi cluster Istio:kubectl --context="GKE_ISTIO_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n ISTIO_INGRESS_NAMESPACEBatalkan pendaftaran keanggotaan fleet:
gcloud container fleet memberships unregister \ GKE_CSM_CLUSTER \ --gke-cluster="LOCATION/GKE_CSM_CLUSTER" \ --project="PROJECT_ID"Hapus cluster Cloud Service Mesh dalam cluster:
gcloud container clusters delete GKE_CSM_CLUSTER \ --location="LOCATION" \ --project="PROJECT_ID"
Langkah berikutnya
- Baca panduan arsitektur dasar: Dari edge ke mesh multi-cluster: Men-deploy aplikasi yang didistribusikan secara global melalui GKE Gateway dan Cloud Service Mesh.
- Pelajari lebih lanjut pola multi-cluster Gateway API.
- Pelajari lebih lanjut load balancing multi-cluster.
- Jelajahi Dokumentasi Pengelolaan Traffic Mesh Istio.