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:

  1. Menyiapkan cluster yang ada dengan Cloud Service Mesh dalam cluster untuk migrasi.
  2. Menyediakan cluster GKE baru dengan Istio.
  3. Mengonfigurasi GKE multi-cluster Gateway API di cluster khusus dan Layanan multi-cluster untuk menyiapkan perutean ke ingress mesh.
  4. Menjalankan deployment canary untuk membagi traffic HTTP live antara Cloud Service Mesh dan Istio.
  5. 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

  1. Di Google Cloud konsol, di halaman pemilih project, pilih Google Cloud project tempat Cloud Service Mesh dalam cluster Anda diinstal.

    Buka pemilih project

  2. 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.
  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the required APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. 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.

    Enable the APIs

  5. Verify that billing is enabled for your Google Cloud project.

  6. Enable the required APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. 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.

    Enable the APIs

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

  1. Pastikan cluster Cloud Service Mesh dalam cluster Anda GKE_CSM_CLUSTER berjalan dengan istiod bidang 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/rev
    

    Output 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-12
    
  2. Pastikan tidak ada error di bidang kontrol istiod menggunakan perintah berikut:

    kubectl logs -n ISTIOD_NAMESPACE -l app=istiod
    

Menyiapkan cluster untuk migrasi

  1. 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.goog
    

    Jika Workload Identity tidak ada, lihat Panduan Workload Identity untuk memperbarui cluster Anda.

  2. 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_NAME
    

    Jika detail fleet kosong, lihat Panduan pendaftaran keanggotaan fleet untuk mendaftarkan cluster Anda ke fleet.

  3. 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.

  1. Buat cluster GKE baru GKE_ISTIO_CLUSTER di project yang sama Google Cloud (PROJECT_ID) dengan cluster Cloud Service Mesh dalam cluster yang ada.

    Saat membuat cluster, pastikan Anda menentukan --project dan 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.goog
    

    Jika Anda telah membuat cluster, gunakan Panduan Workload Identity untuk mengaktifkan Workload Identity.

  2. 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_ID
    
  3. Instal 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.

  4. 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

  1. Ikuti panduan Gateway Edge-to-Mesh untuk membuat resource Gateway dan HTTPRoute di 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: 100
    
  2. Jika resource ServiceImport Anda berada di namespace yang berbeda dengan HTTPRoute, gunakan ReferenceGrant untuk 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.

  1. Terapkan resource kustom HTTPRoute di 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: 50
    
  2. Validasi distribusi traffic live dengan menjalankan permintaan paralel terhadap alamat IP publik Gateway.

    Output yang diharapkan: Respons di-load balance di seluruh GKE_CSM_CLUSTER dan GKE_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.

  1. Hapus resource ServiceExport di cluster Istio:

    kubectl --context="GKE_ISTIO_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n ISTIO_INGRESS_NAMESPACE
    
  2. Batalkan pendaftaran keanggotaan fleet:

    gcloud container fleet memberships unregister \
        GKE_CSM_CLUSTER \
        --gke-cluster="LOCATION/GKE_CSM_CLUSTER" \
        --project="PROJECT_ID"
    
  3. Hapus cluster Cloud Service Mesh dalam cluster:

    gcloud container clusters delete GKE_CSM_CLUSTER \
        --location="LOCATION" \
        --project="PROJECT_ID"
    

Langkah berikutnya