Microservices Engine：Implementasi rilis canary end-to-end menggunakan pipeline CI/CD di Jenkins

Aktifkan Microservices Governance untuk aplikasi mikro di kluster ACK

1. Aktifkan Microservices Governance. Untuk informasi lebih lanjut, lihat Aktifkan Microservices Governance.

2. Aktifkan Microservices Governance untuk aplikasi mikro di kluster Container Service for Kubernetes (ACK). Untuk informasi lebih lanjut, lihat Aktifkan Microservices Governance untuk Aplikasi Mikro di Kluster ACK.

Sebarkan aplikasi demo

1. Masuk ke Konsol ACK. Di panel navigasi di sebelah kiri, klik Clusters.

2. Di halaman Clusters, temukan kluster yang ingin Anda kelola dan klik nama kluster tersebut atau pilih Details di kolom Actions. Halaman detail kluster akan muncul.

3. Di panel navigasi di sebelah kiri halaman detail, pilih Workloads > Deployments.

4. Di halaman Deployments, klik Create from YAML.

5. Konfigurasikan parameter dan klik Create.

   Dalam contoh ini, aplikasi berikut diterapkan: spring-cloud-a (Aplikasi A), spring-cloud-b (Aplikasi B), spring-cloud-c (Aplikasi C), nacos-server, dan spring-cloud-zuul. Aplikasi nacos-server diterapkan sebagai registri dan aplikasi spring-cloud-zuul diterapkan sebagai aplikasi ingress. Aplikasi dipanggil dalam urutan berikut: spring-cloud-zuul -> spring-cloud-a -> spring-cloud-b -> spring-cloud-c.

   Aplikasi spring-cloud-zuul menangani default 100 QPS dan tambahan 10 QPS untuk permintaan yang dilampirkan dengan header x-mse-tag: gray. Header ini adalah header canary bawaan di MSE. Jika permintaan dilampirkan dengan header x-mse-tag: gray setelah Microservices Governance diaktifkan dan agen diinstal, permintaan yang dilampirkan dengan header ini secara otomatis diarahkan ke node hilir yang ditandai dengan gray. Anda dapat mengganti gray dengan nilai tag node lainnya sesuai dengan kebutuhan bisnis Anda.

   • Kode Yet Another Markup Language (YAML) untuk aplikasi ingress spring-cloud-zuul

     Show code

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: spring-cloud-zuul
     spec:
       replicas: 1
       selector:
         matchLabels:
           app: spring-cloud-zuul
       template:
         metadata: 
           labels:
             app: spring-cloud-zuul
             msePilotCreateAppName: spring-cloud-zuul
         spec:
           containers:
             - name: spring-cloud-zuul
               image: registry.cn-shanghai.aliyuncs.com/yizhan/spring-cloud-zuul:1.0.1
               imagePullPolicy: Always
               ports:
                 - containerPort: 20000

   • Kode YAML untuk versi dasar spring-cloud-a

     Show code

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: spring-cloud-a
     spec:
       replicas: 2
       selector:
         matchLabels:
           app: spring-cloud-a
       template:
         metadata:
           labels:
             app: spring-cloud-a
             msePilotCreateAppName: spring-cloud-a
         spec:
           containers:
           - name: spring-cloud-a
             image: registry.cn-shanghai.aliyuncs.com/yizhan/spring-cloud-a:0.1-SNAPSHOT
             imagePullPolicy: Always
             ports:
             - containerPort: 20001
             livenessProbe:
               tcpSocket:
                 port: 20001
               initialDelaySeconds: 10
               periodSeconds: 30

   • Kode YAML untuk versi dasar spring-cloud-b

     Show code

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: spring-cloud-b
     spec:
       replicas: 2
       selector:
         matchLabels:
           app: spring-cloud-b
       strategy:
       template:
         metadata: 
           labels:
             app: spring-cloud-b
             msePilotCreateAppName: spring-cloud-b
         spec:
           containers:
           - name: spring-cloud-b
             image: registry.cn-shanghai.aliyuncs.com/yizhan/spring-cloud-b:0.1-SNAPSHOT
             imagePullPolicy: Always
             ports:
             - containerPort: 8080
             livenessProbe:
               tcpSocket:
                 port: 20002
               initialDelaySeconds: 10
               periodSeconds: 30

   • Kode YAML untuk versi dasar spring-cloud-c

     Show code

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: spring-cloud-c
     spec:
       replicas: 1
       selector:
         matchLabels:
           app: spring-cloud-c
       template:
         metadata:  
           labels:
             app: spring-cloud-c
             msePilotCreateAppName: spring-cloud-c
         spec:
           containers:
           - name: spring-cloud-c
             image: registry.cn-shanghai.aliyuncs.com/yizhan/spring-cloud-c:0.1-SNAPSHOT
             imagePullPolicy: Always
             ports:
             - containerPort: 20003
             livenessProbe:
               tcpSocket:
                 port: 20003
               initialDelaySeconds: 10
               periodSeconds: 30

   • Kode YAML untuk nacos-server

     Show code

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nacos-server
     spec:
       replicas: 1
       selector:
         matchLabels:
           app: nacos-server
       template:
         metadata:
           labels:
             app: nacos-server
         spec:
           containers:
           - env:
             - name: MODE
               value: standalone
             image: nacos/nacos-server:v2.2.0
             imagePullPolicy: Always
             name: nacos-server
           dnsPolicy: ClusterFirst
           restartPolicy: Always
     
     # Buat instance Server Load Balancer (SLB) untuk aplikasi spring-cloud-zuul.
     ---
     apiVersion: v1
     kind: Service
     metadata:
       annotations:
         service.beta.kubernetes.io/alibaba-cloud-loadbalancer-spec: slb.s1.small
       name: zuul-slb
     spec:
       ports:
         - port: 80
           protocol: TCP
           targetPort: 20000
       selector:
         app: spring-cloud-zuul
       type: LoadBalancer

6. Setelah aplikasi diterapkan, lihat trafik yang melewati Aplikasi A di Konsol MSE, dan verifikasi bahwa semua trafik diarahkan ke node untagged dan tidak ada trafik yang diarahkan ke node canary.

Konfigurasikan izin untuk mendorong gambar ke repositori gambar

Dalam contoh ini, kode sumber perlu dikemas menjadi gambar dan kemudian didorong ke repositori gambar. Pastikan Jenkins memiliki izin untuk mendorong gambar ke repositori gambar. Untuk informasi lebih lanjut, lihat Sebarkan Jenkins di Kluster ACK dan Buat serta Sebarkan Aplikasi.

Buat pipeline rilis canary end-to-end di Jenkins

Anda dapat menggunakan pipeline Jenkins untuk pelepasan otomatis. Pipeline dapat menyediakan kemampuan rilis canary, observabilitas, dan rollback untuk pelepasan aplikasi guna memastikan keamanan produksi.

1. Di panel navigasi di sebelah kiri dasbor Jenkins, klik New Item.

2. Masukkan item name, pilih pipeline, dan kemudian klik OK.

3. Di halaman yang muncul, klik tab Pipeline. Di tab Pipeline, konfigurasikan parameter, masukkan jalur di bidang Script Path, dan kemudian klik Save.

   • Definition: Pilih Pipeline script from SCM dari daftar drop-down.

   • SCM: Pilih Git dari daftar drop-down.

   • Repository URL: Masukkan URL repositori Git. Dalam contoh ini, URL repositori adalah https://github.com/aliyun/alibabacloud-microservice-demo/tree/master/mse-simple-demo.

     Catatan

     Alibaba Cloud tidak dapat menarik kode sumber dari GitHub. Dalam hal ini, kode sumber dari Gitee digunakan sebagai gantinya.

   • Script Path: Masukkan Jenkinsfile.

     Konfigurasi parameter berikut disediakan untuk referensi Anda. Anda juga dapat mengedit Jenkinsfile dan menambahkan file tersebut ke jalur yang ditentukan di repositori Git. Jalur ini adalah jalur skrip yang ditentukan dari pipeline.

     Show code

     #!groovy
     pipeline {
     
         // Tentukan tag lingkungan build. Dalam contoh ini, slave-pipeline digunakan.
         agent{
             node{
               label 'slave-pipeline'
             }
         }
     
         // Parameter konstan. Dalam kebanyakan kasus, parameter ini tidak perlu dimodifikasi setelah ditentukan.
         environment{
             IMAGE = sh(returnStdout: true,script: 'echo registry.$image_region.aliyuncs.com/$image_namespace/$image_reponame:$image_tag').trim()
             BRANCH =  sh(returnStdout: true,script: 'echo $branch').trim()
         }
         options {
             // Pertahankan jumlah maksimum build.
             buildDiscarder(logRotator(numToKeepStr: '10'))
         }
     
         parameters {
             string(name: 'image_region', defaultValue: 'cn-shanghai')
             string(name: 'image_namespace', defaultValue: 'yizhan')
             string(name: 'image_reponame', defaultValue: 'spring-cloud-a')
             string(name: 'image_tag', defaultValue: 'gray')
             string(name: 'branch', defaultValue: 'master')
             string(name: 'number_of_pods', defaultValue: '2')
         }
     
         // Lewati setiap tahap pipeline.
         stages {
     
             stage('Pengemasan kode') {
                 steps{
                     container("maven") {
                         echo "Membangun gambar......"
                         sh "cd A && mvn clean package"
                     }
     
                 }
             }
     
     
             stage('Pembuatan dan pelepasan gambar'){
               steps{
                   container("kaniko") {
                       sh "kaniko -f `pwd`/A/Dockerfile -c `pwd`/A --destination=${IMAGE} --skip-tls-verify"
                   }
               }
             }
     
     
     
             stage('Penyebaran canary') {
                 steps{
                     container('kubectl') {
                         echo "Penyebaran canary......"
                         sh "cd A && sed -i -E \"s/${env.image_reponame}:.+/${env.image_reponame}:${env.image_tag}/\" A-gray-deployment.yaml"
                         sh "cd A && sed -i -E \"s/replicas:.+/replicas: ${env.number_of_pods}/\" A-gray-deployment.yaml"
                         sh "kubectl apply -f A/A-gray-deployment.yaml -n default"
                     }
                 }
             }
     
             stage('Menyelesaikan penyebaran canary') {
                 input {
                     message "Apakah Anda yakin ingin mengaktifkan pelepasan penuh"
                     ok "OK"
                     parameters {
                         string(name: 'continue', defaultValue: 'true', description: 'true menunjukkan pelepasan penuh, dan false menunjukkan rollback')
                     }
                 }
                 steps{
                     script {
                         env.continue = sh (script: 'echo ${continue}', returnStdout: true).trim()
                         if (env.continue.equals('true')) {
                             container('kubectl') {
                                 echo "Pelepasan penuh......"
                                 sh "cd A && sed -i -E \"s/${env.image_reponame}:.+/${env.image_reponame}:${env.image_tag}/\" A-deployment.yaml"
                                 sh "cd A && sed -i -E \"s/replicas:.+/replicas: ${env.number_of_pods}/\" A-deployment.yaml"
                                 sh "kubectl apply -f A/A-deployment.yaml -n default"
                             }
                         } else {
                             echo 'Melakukan rollback'
                         }
                         container('kubectl') {
                             sh "kubectl delete -f A/A-gray-deployment.yaml -n default"
                         }
                     }
                 }
             }
         }
     }
                                         

Bangun pipeline Jenkins

1. Di dasbor Jenkins, klik di sebelah kanan pipeline.

2. Klik Build.

   Catatan

   Jika Anda membangun pipeline Jenkins untuk pertama kali, Anda harus menarik konfigurasi dari repositori Git dan menginisialisasi pipeline. Jika terjadi kesalahan selama proses ini, Anda dapat mengklik Build with Parameters untuk menghasilkan parameter yang relevan, tentukan parameter tersebut, dan kemudian bangun pipeline Jenkins lagi.

   Lihat status penyebaran. Tahap code packaging, image building and releasing, dan canary deployment telah selesai, dan tahap untuk completing the canary deployment menunggu konfirmasi.

   • Jika hasilnya lolos verifikasi, lakukan pelepasan penuh. Untuk informasi lebih lanjut, lihat Lakukan Pelepasan Penuh Aplikasi.

   • Jika hasilnya tidak lolos verifikasi, lakukan rollback. Untuk informasi lebih lanjut, lihat Rollback Aplikasi.

Verifikasi hasil

1. Masuk ke Konsol ACK. Di panel navigasi di sebelah kiri, klik Clusters.

2. Di halaman Clusters, temukan kluster yang ingin Anda kelola dan klik namanya. Di panel sebelah kiri, pilih Workloads > Deployments.

3. Di halaman Deployments, konfirmasikan bahwa aplikasi spring-cloud-a-gray yang dibuat ditampilkan dan versi gambarnya diganti dengan versi spring-cloud-a:gray.

4. Di halaman detail kluster, pilih Network > Services, pilih namespace yang diperlukan, dan kemudian klik public endpoint dari layanan zuul-slb untuk melihat hasil panggilan aktual.

   • Jika Anda menggunakan header non-canary, trafik diarahkan ke node untuk versi dasar spring-cloud-a.

     • Perintah curl:

       curl http://182.92.XX.XX/A/a

     • Output:

       A[10.4.XX.XX] -> B[10.4.XX.XX] -> C[10.4.XX.XX]%

   • Jika Anda menggunakan header dengan tag rilis canary, trafik diarahkan ke node canary spring-cloud-a.

     • Perintah curl:

       curl http://182.92.XX.XX/A/a?name=xiaoming

     • Output:

       Agray[10.4.XX.XX] -> B[10.4.XX.XX] -> C[10.4.XX.XX]%

5. Masuk ke Konsol MSE. Di halaman application details, konfirmasikan bahwa trafik canary diarahkan ke node canary.