Container Service for Kubernetes：Gunakan gerbang multi-kluster ACK One MSE untuk menerapkan pemulihan bencana antarzona

Deploy menggunakan UI ArgoCD

1. Masuk ke Konsol ACK One. Di panel navigasi sebelah kiri, pilih Fleet > Multi-cluster GitOps.

2. Pada halaman GitOps, klik GitOps Console.

   Catatan

   • Jika GitOps belum diaktifkan untuk instans armada ACK One, klik Enable GitOps Now untuk masuk ke GitOps Console.

   • Untuk mengakses GitOps melalui jaringan publik, lihat Aktifkan akses publik ke GitOps.

3. Tambahkan repositori aplikasi.

   1. Di panel navigasi sebelah kiri UI Argo CD, pilih Settings. Lalu, pilih Repositories > + Connect Repo.

   2. Pada panel yang muncul, konfigurasikan parameter berikut dan klik CONNECT.

      Area	Parameter	Nilai
      Choose your connection method	-	VIA HTTP/HTTPS
      CONNECT REPO USING HTTP/HTTPS	Type	git
      	Project	default
      	Repository URL	https://github.com/AliyunContainerService/gitops-demo.git
      	Skip server verification	Pilih kotak centang ini.

      

      Setelah repositori terhubung, STATUS KONEKSI repositori Git berubah menjadi Berhasil.

      

4. Buat aplikasi.

   Pada halaman Applications di ArgoCD, klik + NEW APP dan konfigurasikan parameter berikut.

   Bagian	Parameter	Deskripsi
   UMUM	Nama Aplikasi	Masukkan nama aplikasi kustom.
   	Nama Proyek	default
   	KEBIJAKAN SYNC	Pilih kebijakan sinkronisasi sesuai kebutuhan. Nilai yang valid: Manual: Saat terjadi perubahan di repositori Git, Anda harus secara manual menyinkronkan perubahan tersebut ke kluster tujuan. Otomatis: Server ArgoCD memeriksa perubahan di repositori Git setiap 3 menit dan secara otomatis menerapkannya ke kluster tujuan.
   	OPSI SYNC	Pilih AUTO-CREATE NAMESPACE.
   SUMBER	URL Repositori	Pilih repositori Git yang Anda tambahkan pada langkah sebelumnya dari daftar tarik-turun. Dalam contoh ini, pilih https://github.com/AliyunContainerService/gitops-demo.git.
   	Revisi	Pilih Cabang: gateway-demo.
   	Jalur	manifests/helm/web-demo
   TUJUAN	URL Kluster	Pilih URL Kluster 1 atau Kluster 2. Anda juga dapat mengklik URL di sebelah kanan dan memilih kluster berdasarkan NAMA KLUSTER.
   	Namespace	Topik ini menggunakan gateway-demo. Sumber daya aplikasi, seperti Service dan Deployment, akan dibuat di namespace ini.
   Helm	Parameter	Atur nilai envCluster menjadi cluster-demo-1 atau cluster-demo-2 untuk membedakan kluster backend mana yang memproses permintaan.

Deploy menggunakan CLI ArgoCD

1. Aktifkan GitOps pada instans armada ACK One. Untuk informasi selengkapnya, lihat Aktifkan GitOps pada instans armada ACK One.

2. Akses ArgoCD. Untuk informasi selengkapnya, lihat Akses ArgoCD menggunakan CLI ArgoCD.

3. Buat dan publikasikan aplikasi.

   1. Jalankan perintah berikut untuk menambahkan repositori Git.

      argocd repo add https://github.com/AliyunContainerService/gitops-demo.git --name ackone-gitops-demos

      Output yang diharapkan:

      Repository 'https://github.com/AliyunContainerService/gitops-demo.git' added

   2. Jalankan perintah berikut untuk melihat daftar repositori Git yang telah ditambahkan.

      argocd repo list

      Output yang diharapkan:

      TYPE  NAME  REPO                                                       INSECURE  OCI    LFS    CREDS  STATUS      MESSAGE  PROJECT
      git         https://github.com/AliyunContainerService/gitops-demo.git  false     false  false  false  Successful           default

   3. Jalankan perintah berikut untuk melihat daftar kluster.

      argocd cluster list

      Output yang diharapkan:

      SERVER                          NAME                                        VERSION  STATUS      MESSAGE                                                  PROJECT
      https://1.1.XX.XX:6443      c83f3cbc90a****-temp01   1.22+    Successful
      https://2.2.XX.XX:6443      c83f3cbc90a****-temp02   1.22+    Successful
      https://kubernetes.default.svc  in-cluster                                           Unknown     Cluster has no applications and is not being monitored.

   4. Gunakan Application untuk membuat dan mempublikasikan aplikasi demo ke kluster tujuan.

      1. Buat file apps-web-demo.yaml dengan konten berikut.

         Ganti repoURL dengan alamat repositori aktual Anda.

         Lihat file apps-web-demo.yaml

         apiVersion: argoproj.io/v1alpha1
         kind: Application
         metadata:
           name: app-demo-cluster1
           namespace: argocd
         spec:
           destination:
             namespace: gateway-demo
             # https://1.1.XX.XX:6443
             server: ${cluster1_url}
           project: default
           source:
             helm:
               releaseName: "web-demo"
               parameters:
               - name: envCluster
                 value: cluster-demo-1
               valueFiles:
               - values.yaml
             path: manifests/helm/web-demo
             repoURL: https://github.com/AliyunContainerService/gitops-demo.git
             targetRevision: gateway-demo
           syncPolicy:
             syncOptions:
             - CreateNamespace=true
         ---
         apiVersion: argoproj.io/v1alpha1
         kind: Application
         metadata:
           name: app-demo-cluster1
           namespace: argocd
         spec:
           destination:
             namespace: gateway-demo
             server: ${cluster2_url}
           project: default
           source:
             helm:
               releaseName: "web-demo"
               parameters:
               - name: envCluster
                 value: cluster-demo-2
               valueFiles:
               - values.yaml
             path: manifests/helm/web-demo
             repoURL: https://github.com/AliyunContainerService/gitops-demo.git
             targetRevision: gateway-demo
           syncPolicy:
             syncOptions:
             - CreateNamespace=true

      2. Jalankan perintah berikut untuk mendeploy aplikasi.

         kubectl apply -f apps-web-demo.yaml

      3. Jalankan perintah berikut untuk melihat daftar aplikasi.

         argocd app list

         Output yang diharapkan:

         # app list
         NAME                      CLUSTER                  NAMESPACE  PROJECT  STATUS  HEALTH   SYNCPOLICY  CONDITIONS  REPO                                                       PATH                     TARGET
         argocd/web-demo-cluster1  https://10.1.XX.XX:6443             default  Synced  Healthy  Auto        <none>      https://github.com/AliyunContainerService/gitops-demo.git  manifests/helm/web-demo  main
         argocd/web-demo-cluster2  https://10.1.XX.XX:6443             default  Synced  Healthy  Auto        <none>      https://github.com/AliyunContainerService/gitops-demo.git  manifests/helm/web-demo  main

Pemulihan Bencana Zona Redundansi Aktif

Buat Ingress untuk menerapkan zona redundansi aktif

Buat objek Ingress berikut di instans armada ACK One untuk menerapkan zona redundansi aktif.

Secara default, trafik diseimbangkan ke setiap replika layanan backend dengan nama yang sama di kedua kluster yang ditambahkan ke gerbang multi-kluster. Jika backend Kluster 1 mengalami anomali, gerbang secara otomatis mengarahkan seluruh trafik ke Kluster 2. Jika rasio replika Kluster 1 terhadap Kluster 2 adalah 9:1, maka secara default 90% trafik diarahkan ke Kluster 1 dan 10% ke Kluster 2. Jika semua backend di Kluster 1 mengalami anomali, 100% trafik secara otomatis diarahkan ke Kluster 2. Gambar berikut menunjukkan topologinya.

1. Buat file ingress-demo.yaml dengan konten berikut.

   Dalam kode berikut, layanan backend service1 diekspos melalui aturan routing /svc1 di bawah nama domain example.com.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: web-demo
   spec:
     ingressClassName: mse
     rules:
     - host: example.com
       http:
         paths:
         - path: /svc1
           pathType: Exact
           backend:
             service:
               name: service1
               port: 
                 number: 80

2. Jalankan perintah berikut untuk mendeploy Ingress di instans armada ACK One.

   kubectl apply -f ingress-demo.yaml -n gateway-demo

Verifikasi versi rilis canary

Dalam skenario zona redundansi aktif, Anda dapat memverifikasi versi rilis canary aplikasi tanpa memengaruhi layanan Anda.

Buat aplikasi baru di kluster yang sudah ada. Bedakan aplikasi ini dari aplikasi asli hanya berdasarkan nama dan selector Service dan Deployment. Kemudian, gunakan header permintaan untuk memverifikasi aplikasi baru tersebut.

1. Buat file new-app.yaml di Kluster 1 dengan konten berikut. Hanya Service dan Deployment yang berbeda dari aplikasi asli.

   apiVersion: v1       
   kind: Service
   metadata:
     name: service1-canary-1
     namespace: gateway-demo
   spec:
     ports:
     - port: 80
       protocol: TCP
       targetPort: 8080
     selector:
       app: web-demo-canary-1
     sessionAffinity: None
     type: ClusterIP
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: web-demo-canary-1
     namespace: gateway-demo
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: web-demo-canary-1
     template:
       metadata:
         labels:
           app: web-demo-canary-1
       spec:
         containers:
           - env:
               - name: ENV_NAME
                 value: cluster-demo-1-canary
             image: 'registry-cn-hangzhou.ack.aliyuncs.com/acs/web-demo:0.6.0'
             imagePullPolicy: Always
             name: web-demo

2. Jalankan perintah berikut untuk mendeploy aplikasi baru di Kluster 1.

   kubectl apply -f new-app.yaml

3. Buat file new-ingress.yaml dengan konten berikut.

   Buat Ingress berbasis header di instans armada. Tambahkan anotasi untuk mengaktifkan fitur canary dan tentukan header. Gunakan header canary-dest: cluster1 dalam permintaan untuk mengarahkan trafik ke versi rilis canary guna verifikasi.

   • nginx.ingress.kubernetes.io/canary: Atur ke "true" untuk mengaktifkan fitur rilis canary.

   • nginx.ingress.kubernetes.io/canary-by-header: Kunci header untuk permintaan ke kluster ini.

   • nginx.ingress.kubernetes.io/canary-by-header-value: Nilai header untuk permintaan ke kluster ini.

     apiVersion: networking.k8s.io/v1
     kind: Ingress
     metadata:
       name: web-demo-canary-1
       namespace: gateway-demo
       annotations:
         nginx.ingress.kubernetes.io/canary: "true"
         nginx.ingress.kubernetes.io/canary-by-header: "canary-dest"
         nginx.ingress.kubernetes.io/canary-by-header-value: "cluster1"
     spec:
       ingressClassName: mse
       rules:
       - host: example.com
         http:
           paths:
           - path: /svc1
             pathType: Exact
             backend:
               service:
                 name: service1-canary-1
                 port: 
                   number: 80

4. Jalankan perintah berikut untuk mendeploy Ingress berbasis header di instans armada.

   kubectl apply -f new-ingress.yaml

Verifikasi zona redundansi aktif

Ubah jumlah replika yang dideploy ke Kluster 1 menjadi 9 dan jumlah replika yang dideploy ke Kluster 2 menjadi 1. Hasil yang diharapkan adalah trafik diarahkan ke Kluster 1 dan Kluster 2 dengan rasio 9:1 secara default. Ketika Kluster 1 mengalami anomali, seluruh trafik secara otomatis diarahkan ke Kluster 2.

Jalankan perintah berikut untuk memperoleh alamat IP publik gerbang multi-kluster.

kubectl get ingress web-demo -n gateway-demo -ojsonpath="{.status.loadBalancer}"

• Trafik default diarahkan ke kedua kluster berdasarkan rasio

  Jalankan perintah berikut untuk memeriksa routing trafik.

  Ganti XX.XX.XX.XX dengan alamat IP publik gerbang multi-kluster yang Anda peroleh pada langkah sebelumnya.

  for i in {1..100}; do curl -H "host: example.com" XX.XX.XX.XX done

  Output yang diharapkan: Output menunjukkan bahwa trafik diseimbangkan ke Kluster 1 dan Kluster 2. Rasio trafik antara Kluster 1 dan Kluster 2 adalah 9:1.

• Seluruh trafik dialihkan ke Kluster 2 saat Kluster 1 mengalami anomali

  Jika Anda mengubah jumlah replika Deployment di Kluster 1 menjadi 0, output berikut akan dikembalikan. Ini menunjukkan bahwa trafik telah secara otomatis dialihkan ke Kluster 2.

• Arahkan permintaan ke versi rilis canary menggunakan header

  Jalankan perintah berikut untuk memeriksa routing trafik.

  Ganti XX.XX.XX.XX dengan alamat IP yang diperoleh setelah aplikasi dan Ingress dideploy seperti yang dijelaskan di bagian Verifikasi versi rilis canary.

  for i in {1..100}; do curl -H "host: example.com" -H "canary-dest: cluster1" xx.xx.xx.xx/svc1; sleep 1;  done  

  Output yang diharapkan: Output menunjukkan bahwa permintaan dengan header canary-dest: cluster1 semuanya diarahkan ke versi rilis canary di Kluster 1.

Pemulihan bencana primer/sekunder

Buat objek Ingress berikut di instans armada ACK One untuk menerapkan pemulihan bencana primer/sekunder.

Ketika backend kedua kluster dalam kondisi normal, trafik hanya diarahkan ke backend layanan Kluster 1. Jika backend Kluster 1 mengalami anomali, gerbang secara otomatis mengarahkan trafik ke Kluster 2. Gambar berikut menunjukkan topologinya.

Buat Ingress untuk menerapkan pemulihan bencana primer/sekunder

1. Buat file ingress-demo-cluster-one.yaml dengan konten berikut.

   Tambahkan anotasi mse.ingress.kubernetes.io/service-subset dan mse.ingress.kubernetes.io/subset-labels ke file YAML objek Ingress untuk menggunakan /service1 di bawah nama domain example.com guna mengekspos Service backend service1. Untuk informasi selengkapnya tentang anotasi yang didukung oleh Ingress MSE, lihat Anotasi yang didukung oleh gerbang Ingress MSE.

   • mse.ingress.kubernetes.io/service-subset: Nama subset layanan. Kami menyarankan Anda menentukan nilai yang dapat dibaca terkait dengan kluster tujuan.

   • mse.ingress.kubernetes.io/subset-labels: Menentukan ID kluster tujuan.

     apiVersion: networking.k8s.io/v1
     kind: Ingress
     metadata:
       annotations:
         mse.ingress.kubernetes.io/service-subset: cluster-demo-1
         mse.ingress.kubernetes.io/subset-labels: |
           topology.istio.io/cluster ${cluster1-id}
       name: web-demo-cluster-one
     spec:
       ingressClassName: mse
       rules:
       - host: example.com
         http:
           paths:
           - path: /service1
             pathType: Exact
             backend:
               service:
                 name: service1
                 port: 
                   number: 80

2. Jalankan perintah berikut untuk mendeploy Ingress di instans armada ACK One.

   kubectl apply -f ingress-demo-cluster-one.yaml -ngateway-demo

Terapkan rilis canary tingkat kluster

Gerbang multi-kluster mendukung pembuatan Ingress berbasis header untuk mengarahkan permintaan ke kluster tertentu. Anda dapat menggunakan kemampuan ini, bersama dengan kemampuan load balancing replika penuh dari objek Ingress yang dijelaskan di bagian Buat Ingress untuk menerapkan pemulihan bencana primer/sekunder, untuk menerapkan rilis canary berbasis header.

1. Buat Ingress seperti yang dijelaskan di Buat Ingress untuk menerapkan pemulihan bencana primer/sekunder.

2. Buat Ingress dengan anotasi terkait header di instans armada ACK One untuk menerapkan rilis canary tingkat kluster. Ketika header permintaan sesuai dengan konfigurasi Ingress, permintaan diarahkan ke backend versi rilis canary.

   1. Buat file ingress-demo-cluster-gray.yaml dengan konten berikut.

      Dalam file YAML untuk objek Ingress berikut, ganti ${cluster1-id} dengan ID kluster target. Selain anotasi mse.ingress.kubernetes.io/service-subset dan mse.ingress.kubernetes.io/subset-labels, tambahkan anotasi berikut untuk mengekspos layanan backend service1 untuk aturan routing /service1 dari nama domain example.com.

      • nginx.ingress.kubernetes.io/canary: Atur ke "true" untuk mengaktifkan fitur rilis canary.

      • nginx.ingress.kubernetes.io/canary-by-header: Kunci header untuk permintaan ke kluster ini.

      • nginx.ingress.kubernetes.io/canary-by-header-value: Nilai header untuk permintaan ke kluster ini.

      apiVersion: networking.k8s.io/v1
      kind: Ingress
      metadata:
        annotations:
          mse.ingress.kubernetes.io/service-subset: cluster-demo-2
          mse.ingress.kubernetes.io/subset-labels: |
            topology.istio.io/cluster ${cluster2-id}
          nginx.ingress.kubernetes.io/canary: "true"
          nginx.ingress.kubernetes.io/canary-by-header: "app-web-demo-version"
          nginx.ingress.kubernetes.io/canary-by-header-value: "gray"
        name: web-demo-cluster-gray
      spec:
        ingressClassName: mse
        rules:
        - host: example.com
          http:
            paths:
            - path: /service1
              pathType: Exact
              backend:
                service:
                  name: service1
                  port: 
                    number: 80

   2. Jalankan perintah berikut untuk mendeploy Ingress di instans armada ACK One.

      kubectl apply -f ingress-demo-cluster-gray.yaml -n gateway-demo

Verifikasi pemulihan bencana primer/sekunder

Untuk mempermudah verifikasi, ubah jumlah replika yang dideploy ke Kluster 1 dan Kluster 2 masing-masing menjadi 1. Hasil yang diharapkan adalah trafik default hanya diarahkan ke Kluster 1, trafik dengan header canary diarahkan ke Kluster 2, dan ketika aplikasi di Kluster 1 mengalami anomali, trafik default juga diarahkan ke Kluster 2.

Jalankan perintah berikut untuk memperoleh alamat IP publik gerbang multi-kluster.

kubectl get ingress web-demo -n gateway-demo -ojsonpath="{.status.loadBalancer}"

• Trafik default diarahkan ke Kluster 1

  Jalankan perintah berikut untuk memeriksa apakah trafik default diarahkan ke Kluster 1.

  Ganti XX.XX.XX.XX dengan alamat IP publik gerbang multi-kluster yang Anda peroleh pada langkah sebelumnya.

  for i in {1..100}; do curl -H "host: example.com" xx.xx.xx.xx/service1; sleep 1;  done

  Output yang diharapkan: Output menunjukkan bahwa seluruh trafik default diarahkan ke Kluster 1.

• Arahkan permintaan ke versi rilis canary menggunakan header

  Jalankan perintah berikut untuk memeriksa apakah permintaan dengan header diarahkan ke versi rilis canary.

  Ganti XX.XX.XX.XX dengan alamat IP publik gerbang multi-kluster yang Anda peroleh pada langkah sebelumnya.

  for i in {1..50}; do curl -H "host: example.com" -H "app-web-demo-version: gray" xx.xx.xx.xx/service1; sleep 1;  done

  Output yang diharapkan: Output menunjukkan bahwa permintaan dengan header app-web-demo-version: gray semuanya diarahkan ke Kluster 2 (versi rilis canary).

• Trafik dialihkan ke Kluster 2 saat Kluster 1 mengalami anomali

  Jika Anda mengubah jumlah replika Deployment di Kluster 1 menjadi 0, output berikut akan dikembalikan. Ini menunjukkan bahwa trafik telah secara otomatis dialihkan ke Kluster 2.