Men-deploy ke beberapa target secara bersamaan

Dengan Cloud Deploy, Anda dapat men-deploy ke target yang dikonfigurasi untuk mewakili beberapa target, dan aplikasi Anda di-deploy ke target tersebut secara paralel (bersamaan). Target yang Anda identifikasi sebagai tahap dalam pipeline disebut sebagai multi-target, dan target yang terdiri dari multi-target disebut target turunan.

Anda dapat menggunakan deployment paralel dengan jenis target apa pun yang didukung Cloud Deploy.

Alasan menggunakan deployment paralel

Anda dapat menggunakan deployment paralel, misalnya, untuk men-deploy aplikasi ke beberapa target produksi. Dalam hal ini, Anda tidak perlu men-deploy ke setiap target secara berurutan, karena tidak ada progres (misalnya, dari pengembangan ke penahapan ke produksi).

Deployment paralel ini dapat menjadi bagian dari progres pipeline pengiriman normal progression:
dev -> staging -> prod [prod1, prod2, prod3, prod4, ...].

Resource Cloud Deploy yang digunakan untuk deployment paralel

Deployment paralel menggunakan resource khusus Cloud Deploy berikut:

  • Multi-target

    Multi-target adalah target yang dikonfigurasi dengan properti multiTarget, di tingkat atas YAML konfigurasi target, dan bukan merujuk ke cluster atau layanan runtime, tetapi merujuk ke satu atau beberapa target lain, menggunakan multiTarget.targetIds.

  • Target turunan

    Target turunan adalah target apa pun yang dirujuk oleh multi-target sebagai multiTarget.targetIds.

  • Peluncuran pengontrol

    Peluncuran pengontrol adalah peluncuran yang sesuai dengan multi-target.

    Lihat Batasan untuk mengetahui informasi selengkapnya tentang hal yang dapat dan tidak dapat Anda lakukan dengan peluncuran pengontrol.

  • Peluncuran turunan

    Lihat Batasan untuk mengetahui informasi selengkapnya tentang hal yang dapat dan tidak dapat Anda lakukan dengan peluncuran turunan.

Menyiapkan deployment paralel

Menyiapkan deployment paralel terdiri dari menentukan satu multi-target dan jumlah target turunan yang Anda perlukan (hingga batasnya). Definisi target sama seperti untuk semua target, kecuali hal berikut:

  • Multi-target mencakup properti multiTarget.
  • Target turunan tidak menyertakan properti multiTarget, tetapi dirujuk dari multi-target menggunakan properti multiTarget.targetIds.
  • Anda dapat mengonfigurasi multi-target untuk persetujuan, tetapi tidak untuk target turunan, yang tidak dapat menyertakan requireApproval:true.

Multi-target dan target turunan dapat menyertakan konfigurasi lingkungan eksekusi kustom . Jika target turunan tidak menentukan lingkungan eksekusi, target tersebut akan mewarisi lingkungan eksekusi yang ditentukan dalam definisi multi-target, atau default. Lihat Lingkungan eksekusi dan deployment paralel untuk mengetahui detail selengkapnya.

Mengonfigurasi multi-target

Multi-target adalah satu target yang diidentifikasi sebagai tahap dalam pipeline pengiriman, tetapi mengarah ke satu atau beberapa target turunan.

Konfigurasi multi-target mencakup properti multiTarget. Multi-target tidak dapat memiliki properti gke atau run atau anthosCluster. Konfigurasi untuk multi-target sama, terlepas dari runtime yang Anda gunakan untuk men-deploy.

Dalam YAML pipeline pengiriman atau dalam file YAML terpisah, buat definisi target dasar, termasuk multiTarget:

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
 name: TARGET_NAME
description: TARGET_DESCRIPTION
multiTarget:
 targetIds: [ CHILD_TARGET1, CHILD_TARGET2, CHILD_TARGETn ]

Dalam YAML ini...

  • TARGET_NAME adalah nama multi-target ini, yang digunakan dalam definisi pipeline pengiriman, stages.targetId properti.

  • CHILD_TARGET1, CHILD_TARGET2,...CHILD_TARGETn adalah nama target turunan yang di-deploy oleh multi-target ini. Setiap nama sesuai dengan properti name dalam definisi target turunan.

Keberadaan properti multiTarget.targetIds menjadikan target ini sebagai multi-target.

Mengonfigurasi target turunan

Untuk setiap target yang diidentifikasi sebagai turunan dalam konfigurasi multi-target, konfigurasi target lain, sebagai target turunan:

Dalam YAML pipeline pengiriman atau dalam file YAML terpisah, buat definisi target dasar:

GKE 

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
 name: CHILD_TARGET1
description: TARGET_DESCRIPTION
gke:
 cluster: projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME

Dalam YAML ini...

  • CHILD_TARGET1 adalah nama target turunan ini. Nama ini sesuai dengan satu anggota dalam daftar target di properti multiTarget.targetIds dalam definisi multi-target.

  • Nilai properti gke.cluster adalah nama resource cluster yang dirujuk oleh target ini, termasuk ID project, region, dan nama cluster.

Target ini dikonfigurasi sama seperti target GKE standar. Satu-satunya hal yang menjadikan target ini sebagai target turunan adalah target ini dirujuk oleh properti multiTarget.targetIds di multi-target.

Cloud Run 

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
 name: CHILD_TARGET1
description: TARGET_DESCRIPTION
run:
 location: projects/PROJECT_ID/locations/REGION

Dalam YAML ini...

  • CHILD_TARGET1 adalah nama target turunan ini. Nama ini sesuai dengan satu anggota dalam daftar target di properti multiTarget.targetIds dalam definisi multi-target.

  • Nilai properti run.location adalah nama resource layanan Cloud Run yang dirujuk oleh target ini, termasuk ID project dan region.

Target ini dikonfigurasi sama seperti target Cloud Run standar. Satu-satunya hal yang menjadikan target ini sebagai target turunan adalah target ini dirujuk oleh properti multiTarget.targetIds di multi-target.

Cluster terpasang GKE 

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
 name: CHILD_TARGET1
description: TARGET_DESCRIPTION
anthosCluster:
 membership: projects/PROJECT_ID/locations/global/memberships/MEMBERSHIP_NAME

Dalam YAML ini...

  • CHILD_TARGET1 adalah nama target turunan ini. Nama ini sesuai dengan satu anggota dalam daftar target di properti multiTarget.targetIds dalam definisi multi-target.

  • MEMBERSHIP_NAME adalah nama yang Anda pilih saat Anda mendaftarkan cluster ke fleet.

Target Kustom 

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
 name: CHILD_TARGET1
description: TARGET_DESCRIPTION
customTarget:
  customTargetType: CUSTOM_TARGET_TYPE_NAME

Dalam YAML ini...

  • CHILD_TARGET1 adalah nama target turunan ini. Nama ini sesuai dengan satu anggota dalam daftar target di properti multiTarget.targetIds dalam definisi multi-target.

  • CUSTOM_TARGET_TYPE_NAME adalah nama jenis target kustom yang digunakan oleh target ini.

Meneruskan parameter deployment ke target

Anda dapat membedakan target turunan dengan menyertakan parameter dalam manifes dan nilai dalam definisi pipeline pengiriman. Nilai tersebut dapat diterapkan secara terpisah ke manifes terpisah, berdasarkan pencocokan label pada target yang sesuai.

Misalnya, Anda mungkin menginginkan jumlah replika yang berbeda untuk setiap target turunan. Untuk melakukannya, Anda akan menyertakan parameter dan nilai dalam progres pipeline pengiriman , beserta label pada target turunan yang cocok untuk setiap pasangan parameter-nilai.

Pelajari parameter deployment lebih lanjut.

Membuat rilis

Dengan multi-target dan target turunan yang dikonfigurasi, buat pipeline pengiriman dan resource target, lalu buat rilis, seperti biasa.

Siklus proses pipeline pengiriman sama seperti pipeline dan target Cloud Deploy lainnya, kecuali saat mencapai tahap dengan multi-target, Cloud Deploy akan membuat peluncuran pengontrol untuk multi-target dan peluncuran turunan untuk men-deploy aplikasi ke setiap target turunan.

Pesan Pub/Sub sebagai respons terhadap operasi Cloud Deploy membedakan antara peluncuran pengontrol dan peluncuran turunan.

Batasan

  • Multi-target tidak boleh memiliki lebih dari 100 target turunan.

  • Semua target turunan dari satu multi-target harus memiliki runtime target yang sama (misalnya, semua GKE atau semua Cloud Run).

  • Dalam pipeline pengiriman, target turunan hanya dapat memiliki satu multi-target induk.

  • Multi-target tidak boleh tidak memiliki turunan, dan tidak dapat merujuk ke dirinya sendiri atau multi-target lain sebagai target turunan.

  • Anda tidak dapat menggunakan target turunan lebih dari satu kali dalam satu pipeline pengiriman, tetapi Anda dapat menggunakannya kembali di pipeline yang berbeda.

  • Jika target turunan adalah Target Kustom, semuanya harus merujuk ke CustomTargetType yang sama.

  • Pool default memiliki batas serentak, tetapi pool pribadi tidak.

    Saat Anda men-deploy ke multi-target, semua peluncuran turunan akan di-deploy secara bersamaan, hingga batas serentak Cloud Build. Jika Anda memiliki lebih banyak target turunan daripada batas tersebut, tugas deployment untuk beberapa target tidak akan berjalan hingga target lainnya selesai, yang berarti Cloud Deploy tidak men-deploy ke semua target turunan secara bersamaan, dalam hal ini.

    Selain itu, jika target menyertakan tugas verifikasi, ada kemungkinan satu atau beberapa tugas verifikasi tersebut akan dimulai sebelum aplikasi di-deploy ke semua target turunan.

    Jika Anda perlu dapat men-deploy secara bersamaan ke lebih banyak target daripada batas yang ditentukan dalam dokumentasi Cloud Build, Anda memiliki dua opsi:

Lingkungan eksekusi dan deployment paralel

Setiap target dapat dikonfigurasi untuk menggunakan lingkungan eksekusi non-default.

  • Jika multi-target memiliki lingkungan eksekusi non-default, semua target turunan yang menggunakan lingkungan eksekusi default akan mewarisi lingkungan eksekusi non-default dari multi-target

  • Jika multi-target menggunakan lingkungan eksekusi default, target turunan yang dikonfigurasi dengan lingkungan eksekusi non-default akan menggunakan lingkungan eksekusi non-default tersebut.

Aturan ini memudahkan penyebaran lingkungan eksekusi ke target turunan dari multi-target, sehingga Anda tidak perlu menentukan atau mengubah lingkungan eksekusi untuk setiap target turunan, sekaligus memungkinkan Anda menyesuaikan lingkungan eksekusi untuk satu atau beberapa target turunan jika perlu.

Lihat Menggunakan lingkungan eksekusi Cloud Deploy untuk mengetahui informasi selengkapnya tentang lingkungan eksekusi di Cloud Deploy.

Me-roll back deployment paralel

Jika Anda perlu me-roll back deployment dari beberapa target paralel, Roll back multi-target, seperti yang dijelaskan dalam Me-roll back target.

Persetujuan untuk deployment paralel

Seperti target lainnya, Anda dapat mengonfigurasi deployment paralel untuk memerlukan persetujuan. Namun, dengan deployment paralel, Anda hanya dapat mengonfigurasi persetujuan pada multi-target. Persetujuan atau penolakan memengaruhi semua target turunan secara bersamaan.

Melihat deployment paralel di Google Cloud konsol

Anda dapat melihat detail untuk multi-target, target turunan, peluncuran pengontrol, dan peluncuran turunan di konsol Google Cloud .

Saat Anda melihat daftar target untuk pipeline pengiriman tertentu, di Detail Pipeline Pengiriman, multi-target akan tercantum, tetapi target turunan tidak. Namun, saat melihat detail rilis, Anda dapat melihat peluncuran pengontrol dan peluncuran turunan. Anda juga dapat melihat peluncuran pengontrol dan turunan yang tercantum di tab Peluncuran di halaman detail Pipeline Pengiriman.

Di pemeriksa rilis, Anda dapat melihat, dan membandingkan, manifes yang dirender untuk peluncuran turunan.

Menggunakan deployment paralel dengan strategi deployment

Anda dapat men-deploy secara paralel saat menggunakan strategi deployment canary. Lihat Menggunakan deployment paralel dengan strategi deployment canary untuk mengetahui informasi selengkapnya.

Langkah berikutnya