Men-deploy aplikasi ke beberapa target secara bersamaan

Menyiapkan konfigurasi Skaffold dan manifes aplikasi Anda

Cloud Deploy menggunakan Skaffold untuk memberikan detail tentang apa yang akan di-deploy dan cara men-deploy-nya dengan benar untuk target terpisah Anda.

Dalam panduan memulai ini, Anda akan membuat file skaffold.yaml, yang mengidentifikasi manifes aplikasi yang akan digunakan untuk men-deploy aplikasi contoh.

1. Buka jendela terminal.

2. Buat direktori baru dan buka direktori tersebut.

   GKE

   mkdir deploy-gke-parallel-quickstart
   cd deploy-gke-parallel-quickstart
   

   Cloud Run

   mkdir deploy-run-parallel-quickstart
   cd deploy-run-parallel-quickstart
   

3. Buat file bernama skaffold.yaml dengan konten berikut:

   GKE

   apiVersion: skaffold/v4beta1
   kind: Config
   manifests:
     rawYaml:
     - k8s-deployment.yaml
   deploy:
     kubectl: {}
   

   Cloud Run

   apiVersion: skaffold/v4beta1
   kind: Config
   manifests:
     rawYaml:
     - service.yaml
   deploy:
     cloudrun: {}
   

   File ini adalah konfigurasi Skaffold minimal. Untuk panduan memulai ini, Anda akan membuat file. Namun, Anda juga dapat meminta Cloud Deploy membuatnya untuk Anda, untuk aplikasi non-produksi yang sederhana.

   Lihat referensi skaffold.yaml untuk mengetahui informasi selengkapnya tentang file ini.

4. Buat definisi untuk aplikasi Anda—definisi layanan untuk Cloud Run atau manifes Kubernetes untuk GKE.

   GKE

   Buat file bernama k8s-deployment.yaml, dengan konten berikut:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
     namespace: default
   spec:
     replicas: 1 # from-param: ${replicaCount}
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: nginx
           image: my-app-image
   

   File ini adalah manifes Kubernetes sederhana, yang diterapkan ke cluster untuk men-deploy aplikasi. Image container yang akan di-deploy ditetapkan di sini sebagai placeholder, my-app-image, yang diganti dengan image tertentu saat Anda membuat rilis.

   Cloud Run

   Buat file bernama service.yaml, dengan konten berikut:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: my-parallel-run-service
   spec:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/minScale: 1 # from-param: ${minInstances}
       spec:
         containers:
         - image: my-app-image
   

   File ini adalah definisi layanan Cloud Run sederhana, yang digunakan pada waktu deployment untuk membuat layanan Cloud Run Anda. Image container yang akan di-deploy ditetapkan di sini sebagai placeholder, my-app-image, yang diganti dengan image tertentu saat Anda membuat rilis.

Membuat target dan pipeline pengiriman

Anda dapat menentukan pipeline dan target dalam satu file atau dalam file terpisah. Dalam panduan memulai ini, Anda akan membuat satu file.

1. Buat definisi target dan pipeline pengiriman Anda:

   GKE

   Di direktori deploy-gke-parallel-quickstart, buat file baru: clouddeploy.yaml, dengan konten berikut:

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-parallel-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: qsprod-multi
       profiles: []
       deployParameters:
       - values:
           replicaCount: "1"
         matchTargetLabels:
           label1: label1
       - values:
           replicaCount: "2"
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-multi
   description: production clusters
   multiTarget:
     targetIds: [qsprod-a, qsprod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-a
     labels:
       label1: label1
   description: production cluster 2
   gke:
     cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsprod1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-b
     labels:
       label2: label2
   description: production cluster 3
   gke:
     cluster: projects/PROJECT_ID/locations/us-west1/clusters/quickstart-cluster-qsprod2
   

   Cloud Run

   Di direktori deploy-run-parallel-quickstart, buat file baru: clouddeploy.yaml, dengan konten berikut:

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-parallel-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: qsprod-multi
       profiles: []
       deployParameters:
       - values:
           minInstances: "2"
         matchTargetLabels:
           label1: label1
       - values:
           minInstances: "3"
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-multi
   description: production
   multiTarget:
     targetIds: [qsprod-a, qsprod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-a
     labels:
       label1: label1
   description: production us-central1
   run:
     location: projects/PROJECT_ID/locations/us-central1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-b
     labels:
       label2: label2
   description: production us-west1
   run:
     location: projects/PROJECT_ID/locations/us-west1
   

   Perhatikan bahwa file ini menyertakan tiga target: multi-target dan dua target turunan. Anda juga dapat mengonfigurasi target dalam file terpisah, bukan dengan pipeline pengiriman.

   Perhatikan juga bahwa pipeline pengiriman mencakup deployParameters, dengan label, dan target turunan mencakup label yang cocok dengan parameter tersebut. Hal ini memungkinkan Anda meneruskan nilai terpisah ke target turunan terpisah, jika Anda mau. Pelajari lebih lanjut.

2. Daftarkan pipeline dan target Anda dengan layanan Cloud Deploy:

   gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
   

   Sekarang Anda memiliki pipeline, dengan satu multi-target yang terdiri dari dua target GKE atau Cloud Run, yang siap men-deploy aplikasi Anda.

3. Konfirmasi pipeline dan target Anda:

   Di konsol Google Cloud , buka halaman Cloud Deploy Delivery pipelines untuk melihat daftar pipeline pengiriman yang tersedia.

   Buka halaman Delivery pipelines

   Pipeline pengiriman yang baru saja Anda buat akan ditampilkan. Perhatikan bahwa ada satu target yang tercantum di kolom Target meskipun Anda mengonfigurasi tiga target (satu multi-target dan dua target turunan) dalam file clouddeploy.yaml Anda.

   

   Perhatikan bahwa satu-satunya target yang tercantum adalah qsprod-multi multi-target. Target turunan tidak ditampilkan.

Membuat rilis

Rilis adalah resource Cloud Deploy pusat yang merepresentasikan perubahan yang di-deploy. Pipeline pengiriman menentukan siklus proses rilis tersebut. Lihat arsitektur layanan Cloud Deploy untuk mengetahui detail tentang siklus proses tersebut.

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-parallel-demo-app-1 \
   --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa \
   --to-target=qsprod-multi

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-parallel-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:95ade4b17adcd07623b0a0c68359e344fe54e65d0cb01b989e24c39f2fcd296a \
   --to-target=qsprod-multi

Perhatikan flag --images=, yang Anda gunakan untuk mengganti placeholder (my-app-image) dalam manifes atau definisi layanan dengan image spesifik yang memenuhi syarat SHA. Google merekomendasikan agar Anda membuat template manifes dengan cara ini, dan menggunakan nama image yang memenuhi syarat SHA saat pembuatan rilis.

Seperti biasa, saat Anda membuat rilis, peluncuran akan dibuat secara otomatis untuk target pertama dalam pipeline Anda (atau, seperti dalam kasus ini, target tertentu yang ditentukan menggunakan --to-target=). Dalam panduan memulai ini, target ini adalah multi-target, sehingga rollout adalah "peluncuran pengontrol" untuk dua target turunan, dan tidak ada target berikutnya dalam pipeline pengiriman. Artinya, aplikasi Anda di-deploy di mana saja setelah pembuatan peluncuran.

Melihat hasil di Google Cloud console

Setelah rilis dibuat, dan peluncuran pengontrol serta peluncuran anak dibuat, peluncuran anak tersebut kini di-deploy (atau sedang dalam proses di-deploy) ke cluster GKE atau layanan Cloud Run masing-masing.

1. Di konsol Google Cloud , buka halaman Cloud Deploy Delivery pipelines untuk melihat pipeline pengiriman my-parallel-demo-app-1.

   Buka halaman Delivery pipelines

2. Klik nama pipeline pengiriman Anda "my-parallel-demo-app-1".

   Visualisasi pipeline menampilkan status deployment aplikasi. Karena hanya ada satu tahap dalam pipeline, visualisasi hanya menampilkan satu node.

   

   Rilis Anda juga tercantum di tab Rilis di bagian Detail pipeline pengiriman.

3. Klik nama rilis, test-release-001.

   Peluncuran Anda akan muncul di bagian Peluncuran. Anda dapat mengklik peluncuran untuk melihat detailnya, termasuk log deployment.