Cloud Service Mesh dengan contoh: Deployment Canary

---

Dalam tutorial ini, Anda akan mempelajari kasus penggunaan umum terkait peluncuran deployment canary dengan Cloud Service Mesh.

Apa yang dimaksud dengan deployment canary?

Deployment canary merutekan sebagian kecil traffic ke versi baru microservice, lalu memungkinkan Anda meluncurkannya secara bertahap ke seluruh basis pengguna, sambil menghentikan dan menghentikan versi lama. Jika terjadi masalah selama proses ini, traffic dapat dialihkan kembali ke versi lama. Dengan Cloud Service Mesh, Anda dapat merutekan traffic untuk memastikan bahwa layanan baru diperkenalkan dengan aman.

Biaya

Dalam dokumen ini, Anda akan menggunakan komponen Google Cloud yang dapat ditagih berikut:

• GKE
• Cloud Service Mesh

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga. Pengguna baru Google Cloud mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Setelah menyelesaikan tutorial ini, Anda dapat menghindari biaya berkelanjutan dengan menghapus resource yang Anda buat. Untuk informasi selengkapnya, lihat Pembersihan.

Sebelum memulai

• Pastikan penagihan diaktifkan untuk project Cloud Anda. Pelajari cara mengonfirmasi bahwa penagihan diaktifkan untuk project Anda.

• Instal Cloud Service Mesh terkelola* di cluster GKE.

  Catatan: Tutorial ini juga berfungsi untuk Cloud Service Mesh terkelola melalui asmcli dan Cloud Service Mesh dalam cluster.

• Men-deploy Ingress Gateway.

• Meng-clone repo:

  git clone https://github.com/GoogleCloudPlatform/anthos-service-mesh-samples
  cd anthos-service-mesh-samples/docs/canary-service
  

Men-deploy Online Boutique

1. Tetapkan konteks saat ini untuk kubectl ke cluster tempat Anda men-deploy Butik Online:

   gcloud container clusters get-credentials CLUSTER_NAME  \
   --project=PROJECT_ID \
   --zone=CLUSTER_LOCATION 
   

2. Buat namespace untuk aplikasi contoh dan gateway masuk:

   kubectl create namespace onlineboutique
   

3. Beri label pada namespace onlineboutique untuk otomatis memasukkan proxy Envoy. Ikuti langkah-langkah tentang cara mengaktifkan injeksi sidecar otomatis.

4. Deploy aplikasi contoh. Untuk tutorial ini, Anda akan men-deploy Online Boutique, aplikasi demo microservice.

   kubectl apply \
   -n onlineboutique \
   -f https://raw.githubusercontent.com/GoogleCloudPlatform/anthos-service-mesh-samples/main/docs/shared/online-boutique/kubernetes-manifests.yaml
   

5. Tambahkan label version=v1 ke deployment productcatalog dengan menjalankan perintah berikut:

   kubectl patch deployments/productcatalogservice -p '{"spec":{"template":{"metadata":{"labels":{"version":"v1"}}}}}' \
   -n onlineboutique
   

   Lihat layanan yang telah Anda deploy:

   kubectl get pods -n onlineboutique
   

   Output yang diharapkan:

   NAME                                     READY   STATUS    RESTARTS   AGE
   adservice-85598d856b-m84m6               2/2     Running   0          2m7s
   cartservice-c77f6b866-m67vd              2/2     Running   0          2m8s
   checkoutservice-654c47f4b6-hqtqr         2/2     Running   0          2m10s
   currencyservice-59bc889674-jhk8z         2/2     Running   0          2m8s
   emailservice-5b9fff7cb8-8nqwz            2/2     Running   0          2m10s
   frontend-77b88cc7cb-mr4rp                2/2     Running   0          2m9s
   loadgenerator-6958f5bc8b-55q7w           2/2     Running   0          2m8s
   paymentservice-68dd9755bb-2jmb7          2/2     Running   0          2m9s
   productcatalogservice-84f95c95ff-c5kl6   2/2     Running   0          114s
   recommendationservice-64dc9dfbc8-xfs2t   2/2     Running   0          2m9s
   redis-cart-5b569cd47-cc2qd               2/2     Running   0          2m7s
   shippingservice-5488d5b6cb-lfhtt         2/2     Running   0          2m7s
   

   Semua pod untuk aplikasi Anda harus aktif dan berjalan, dengan 2/2 di kolom READY. Hal ini menunjukkan bahwa pod telah berhasil memasukkan proxy sidecar Envoy.

6. Deploy VirtualService dan DestinationRule untuk v1 productcatalog:

   kubectl apply -f destination-vs-v1.yaml -n onlineboutique
   

   apiVersion: networking.istio.io/v1beta1
   kind: DestinationRule
   metadata:
     name: productcatalogservice
   spec:
     host: productcatalogservice
     subsets:
     - labels:
         version: v1
       name: v1
   ---
   apiVersion: networking.istio.io/v1beta1
   kind: VirtualService
   metadata:
     name: productcatalogservice
   spec:
     hosts:
     - productcatalogservice
     http:
     - route:
       - destination:
           host: productcatalogservice
           subset: v1

   Perhatikan bahwa hanya v1 yang ada dalam resource.

7. Buka aplikasi di browser menggunakan alamat IP eksternal ingress Anda:

   kubectl get services -n GATEWAY_NAMESPACE
   

Bagian berikutnya akan menjelajahi UI Cloud Service Mesh dan menunjukkan cara melihat metrik.

Men-deploy dan Melihat layanan Anda di konsol Google Cloud

1. Di konsol Google Cloud, buka halaman GKE Enterprise Services.

   Buka Layanan GKE Enterprise

2. Secara default, Anda melihat layanan dalam tampilan Tabel.

   Ringkasan Tabel memungkinkan Anda mengamati semua layanan, serta metrik penting secara sekilas.

   

3. Di kanan atas, klik Topologi. Di sini Anda dapat melihat layanan Anda dan interaksinya satu sama lain.

   Anda dapat meluaskan layanan dan melihat permintaan per detik untuk setiap layanan dengan mengarahkan kursor ke layanan tersebut.

   

4. Kembali ke Tampilan Tabel.

5. Di Tabel Layanan, pilih productcatalogservice. Tindakan ini akan mengarahkan Anda ke ringkasan layanan.

6. Di sebelah kiri layar, klik Traffic.

7. Pastikan 100% traffic masuk ke productcatalogservice dirutekan ke layanan beban kerja.

   

Bagian berikutnya akan membahas pembuatan layanan productcatalog v2.

Men-deploy v2 layanan

1. Untuk tutorial ini, productcatalogservice-v2 akan menambahkan latensi 3 detik ke permintaan dengan kolom EXTRA_LATENCY.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: productcatalogservice-v2
   spec:
     selector:
       matchLabels:
         app: productcatalogservice
     template:
       metadata:
         labels:
           app: productcatalogservice
           version: v2
       spec:
         containers:
         - env:
           - name: PORT
             value: '3550'
           - name: EXTRA_LATENCY
             value: 3s
           name: server
           image: gcr.io/google-samples/microservices-demo/productcatalogservice:v0.3.6
           livenessProbe:
             exec:
               command: ["/bin/grpc_health_probe", "-addr=:3550"]
           ports:
           - containerPort: 3550
           readinessProbe:
             exec:
               command: ["/bin/grpc_health_probe", "-addr=:3550"]
           resources:
             limits:
               cpu: 200m
               memory: 128Mi
             requests:
               cpu: 100m
               memory: 64Mi
         terminationGracePeriodSeconds: 5

   Terapkan resource ini ke namespace onlineboutique.

   kubectl apply -f productcatalog-v2.yaml -n onlineboutique
   

2. Periksa pod aplikasi Anda.

   kubectl get pods -n onlineboutique
   

   Output yang diharapkan:

   NAME                                     READY   STATUS    RESTARTS   AGE
   adservice-85598d856b-8wqfd                  2/2     Running   0          25h
   cartservice-c77f6b866-7jwcr                 2/2     Running   0          25h
   checkoutservice-654c47f4b6-n8c6x            2/2     Running   0          25h
   currencyservice-59bc889674-l5xw2            2/2     Running   0          25h
   emailservice-5b9fff7cb8-jjr89               2/2     Running   0          25h
   frontend-77b88cc7cb-bwtk4                   2/2     Running   0          25h
   loadgenerator-6958f5bc8b-lqmnw              2/2     Running   0          25h
   paymentservice-68dd9755bb-dckrj             2/2     Running   0          25h
   productcatalogservice-84f95c95ff-ddhjv      2/2     Running   0          25h
   productcatalogservice-v2-6df4cf5475-9lwjb   2/2     Running   0          8s
   recommendationservice-64dc9dfbc8-7s7cx      2/2     Running   0          25h
   redis-cart-5b569cd47-vw7lw                  2/2     Running   0          25h
   shippingservice-5488d5b6cb-dj5gd            2/2     Running   0          25h
   

   Perhatikan bahwa sekarang ada dua productcatalogservices yang tercantum.

3. DestinationRule adalah cara menentukan subset layanan. Dalam skenario ini, ada subset untuk v1 dan v2 productcatalogservice.

   apiVersion: networking.istio.io/v1beta1
   kind: DestinationRule
   metadata:
     name: productcatalogservice
   spec:
     host: productcatalogservice
     subsets:
     - labels:
         version: v1
       name: v1
     - labels:
         version: v2
       name: v2

   Perhatikan kolom labels. Versi productcatalogservice dibedakan setelah traffic dirutekan oleh VirtualService.

   Terapkan DestinationRule:

   kubectl apply -f destination-v1-v2.yaml -n onlineboutique
   

Memisahkan Traffic antara v1 dan v2

1. VirtualService adalah cara Anda memperkenalkan sebagian kecil traffic untuk diarahkan ke v2 productcatalogservice.

   apiVersion: networking.istio.io/v1beta1
   kind: VirtualService
   metadata:
     name: productcatalogservice
   spec:
     hosts:
     - productcatalogservice
     http:
     - route:
       - destination:
           host: productcatalogservice
           subset: v1
         weight: 75
       - destination:
           host: productcatalogservice
           subset: v2
         weight: 25

   Kolom subset menunjukkan versi, dan kolom bobot menunjukkan persentase pemisahan traffic. 75% traffic akan diarahkan ke v1 productcatalog, dan 25% akan diarahkan ke v2.

   Terapkan VirtualService:

   kubectl apply -f vs-split-traffic.yaml -n onlineboutique
   

Jika Anda mengunjungi EXTERNAL_IP ingress cluster, Anda akan melihat bahwa secara berkala, frontend lebih lambat dimuat.

Di bagian berikutnya, Anda akan mempelajari pemisahan traffic di konsol Google Cloud GKE Enterprise.

Mengamati Pemisahan Traffic di konsol Google Cloud

1. Kembali ke konsol Google Cloud dan buka halaman Layanan Enterprise GKE Buka Layanan Enterprise GKE

2. Di kanan atas, klik Topologi.

   Luaskan workload productcatalogservice. Anda akan melihat deployment productcatalogservice dan productcatalogservice-v2.

   

3. Kembali ke Tampilan Tabel. Klik productcatalogservice di Tabel Layanan. Kembali ke Traffic di menu navigasi sebelah kiri.

4. Perhatikan bahwa traffic masuk dibagi antara v1 dan v2 berdasarkan persentase yang ditentukan dalam file VirtualService, dan bahwa ada 2 beban kerja layanan productcatalog.

   Di sisi kanan layar, Anda akan melihat Metrik Permintaan, Rasio Error, dan Latensi. Dengan Cloud Service Mesh, setiap layanan akan memiliki metrik ini yang diuraikan untuk memberi Anda visibilitas.

   

   Catatan: Diperlukan waktu beberapa saat agar pembagian 75-25 yang sebenarnya ditampilkan, karena traffic dari waktu ke waktu akan diarahkan ke layanan v2.

Meluncurkan atau Melakukan rollback ke versi

Setelah mengamati metrik selama deployment canary, Anda dapat meluncurkan ke layanan baru, atau melakukan rollback ke layanan lama dengan memanfaatkan resource VirtualService.

Peluncuran

Setelah Anda puas dengan perilaku layanan v2, tingkatkan perilaku traffic ke layanan v2 secara bertahap. Pada akhirnya, traffic dapat dialihkan 100% ke layanan baru.

apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
  name: productcatalogservice
spec:
  hosts:
  - productcatalogservice
  http:
  - route:
    - destination:
        host: productcatalogservice
        subset: v2

Untuk mengarahkan semua traffic ke v2 productcatalogservice:

kubectl apply -f vs-v2.yaml -n onlineboutique

Rollback

Jika Anda perlu melakukan rollback ke layanan v1, cukup terapkan destination-vs-v1.yaml dari sebelumnya. Tindakan ini akan mengarahkan traffic hanya ke v1 productcatalogservice.

apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
  name: productcatalogservice
spec:
  hosts:
  - productcatalogservice
  http:
  - route:
    - destination:
        host: productcatalogservice
        subset: v1

Untuk mengarahkan semua traffic ke v1 productcatalogservice:

kubectl apply -f vs-v1.yaml -n onlineboutique

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.

Agar tidak dikenai biaya berkelanjutan pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, Anda dapat menghapus project atau menghapus setiap resource.

Menghapus project

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tutorial ini, saat menghapusnya, Anda juga akan menghapus pekerjaan lain yang telah dilakukan dalam project tersebut.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

1. Di Cloud Shell, hapus project:

   gcloud projects delete PROJECT_ID
   

Menghapus resource

• Jika Anda ingin mencegah tagihan tambahan, hapus cluster:

  gcloud container clusters delete  CLUSTER_NAME  \
  --project=PROJECT_ID \
  --zone=CLUSTER_LOCATION 
  

• Jika Anda ingin mempertahankan cluster dan menghapus contoh Butik Online:

  1. Hapus namespace aplikasi:

     kubectl delete -f namespace onlineboutique
     

     Output yang diharapkan:

     namespace "onlineboutique" deleted
     

  2. Hapus entri layanan:

     kubectl delete -f https://raw.githubusercontent.com/GoogleCloudPlatform/microservices-demo/main/istio-manifests/frontend.yaml -n onlineboutique
     kubectl delete -f https://raw.githubusercontent.com/GoogleCloudPlatform/microservices-demo/main/istio-manifests/frontend-gateway.yaml -n onlineboutique
     

     Output yang diharapkan:

     serviceentry.networking.istio.io "allow-egress-googleapis" deleted
     serviceentry.networking.istio.io "allow-egress-google-metadata" deleted
     

Langkah selanjutnya

• Untuk panduan umum tentang cara mengonfigurasi kebijakan PeerAuthentication, lihat Mengonfigurasi keamanan transpor.