Membuat target dan pipeline pengiriman

Halaman ini menjelaskan cara membuat pipeline pengiriman dan target yang menjelaskan tempat dan cara Cloud Deploy akan men-deploy aplikasi Anda. Lihat Skema file konfigurasi untuk deskripsi struktur file YAML untuk pipeline dan target pengiriman.

Tentang target dan pipeline pengiriman

Pipeline pengiriman Anda menjelaskan progres target deployment. Anda dapat menentukan target tersebut dalam file yang sama dengan pipeline pengiriman atau dalam satu atau beberapa file terpisah.

Setelah membuat pipeline pengiriman dan file definisi target, Anda akan menjalankan gcloud deploy apply terhadap setiap file tersebut untuk mendaftarkannya sebagai resource Cloud Deploy.

Menentukan target dan pipeline pengiriman

Struktur pipeline pengiriman dan file konfigurasi target dijelaskan di sini.

Anda dapat memberi nama file ini sesuai keinginan. Secara umum, konfigurasi pipeline pengiriman yang menyertakan definisi target disebut clouddeploy.yaml, dan konfigurasi yang mereferensikan target yang ditentukan dalam satu atau beberapa file terpisah diberi nama delivery-pipeline.yaml.

Target dapat mengarah ke GKE, GKE Enterprise, atau Cloud Run. Dalam pipeline pengiriman, semua target harus mereferensikan jenis runtime yang sama (misalnya, semua GKE, atau semua GKE Enterprise).

Membuat pipeline dan target pengiriman menggunakan konsol Google Cloud

Anda dapat menggunakan konsol Google Cloud untuk membuat pipeline pengiriman dan target baru. Hal ini berguna untuk mencoba Cloud Deploy, tetapi tidak cocok untuk beban kerja produksi. (Anda juga dapat menggunakan konsol Google Cloud untuk membuat rilis.)

Untuk membuat pipeline pengiriman:

  1. Dari halaman Delivery pipelines, klik Create.

  2. Berikan nama (atau pertahankan default) dan, secara opsional, deskripsi.

  3. Pilih wilayah Anda.

  4. Pilih lingkungan runtime Anda.

    Untuk GKE, pilih Google Kubernetes Engine, atau pilih Cloud Run jika itu adalah runtime tempat Anda men-deploy.

  5. Di bagian Target baru, berikan nama (atau biarkan default).

  6. Jika Anda ingin mewajibkan persetujuan pada target ini, centang kotak Wajibkan persetujuan untuk peluncuran.

  7. Jika Anda akan menggunakan strategi deployment canary pada target ini, centang kotak Enable canary.

  8. Klik Done.

  9. Klik Tambahkan target dan ikuti langkah-langkah berikut untuk setiap target tambahan yang ingin Anda buat.

  10. Jika Anda memiliki semua target, klik Buat untuk membuat pipeline pengiriman dan resource target.

Mendaftarkan target dan pipeline pengiriman

Jika membuat pipeline dan target menggunakan Konsol Google Cloud, Anda tidak perlu melakukannya.

Untuk mendaftarkan pipeline pengiriman ke Cloud Deploy, Anda harus menjalankan gcloud deploy apply satu kali untuk setiap file definisi terpisah. Artinya, jika menentukan tiga target dalam tiga file, Anda akan menjalankan perintah empat kali—satu kali untuk pipeline pengiriman, dan satu kali untuk setiap target.

Perintah berikut mendaftarkan pipeline pengiriman dengan targetnya yang ditentukan dalam file yang sama.

gcloud deploy apply --file=PIPELINE_CONFIG \
                    --region=LOCATION \
                    --project=PROJECT

Sekarang Anda memiliki pipeline pengiriman yang dapat mengelola deployment rilis, dan resource target yang dapat digunakan oleh pipeline pengiriman apa pun di project dan region yang sama.

Contoh file tunggal

Perintah dalam contoh ini mendaftarkan pipeline pengiriman dan target yang semuanya ditentukan dalam file yang sama:

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

Contoh penggunaan file terpisah

Untuk contoh ini, ada tiga target yang ditentukan dalam tiga file terpisah, sehingga Anda menjalankan empat perintah:

gcloud deploy apply --file=delivery-pipeline.yaml --region=us-central1 && \
gcloud deploy apply --file=target_dev.yaml --region=us-central1 && \
gcloud deploy apply --file=target_staging.yaml --region=us-central1 && \
gcloud deploy apply --file=target_prod.yaml --region=us-central1

Flag --region diperlukan kecuali jika Anda telah menetapkan default (menggunakan gcloud config set deploy/region [REGION]). Region harus sama untuk pipeline pengiriman dan semua target yang dirujuk pipeline.

Membuat target dan pipeline pengiriman menggunakan Terraform

Anda juga dapat menggunakan penyedia Terraform Google Cloud untuk membuat resource pipeline pengiriman dan target.

Penyedia Terraform Google Cloud versi beta dapat menyertakan dukungan untuk fitur Cloud Deploy dalam Pratinjau.

Mengedit pipeline dan target yang ada

Anda dapat mengedit pipeline pengiriman atau konfigurasi target dan menjalankan gcloud deploy apply untuk memperbarui pipeline atau resource target nanti. Namun, perubahan tersebut tidak memengaruhi rilis yang ada, karena dikelola oleh pipeline pengiriman asli.

Mewajibkan persetujuan manual untuk deployment

Untuk mewajibkan persetujuan manual untuk target tertentu, sertakan properti berikut di definisi target:

requireApproval: true

Nilai defaultnya adalah false. Jika Anda menghapus properti ini dari konfigurasi pipeline pengiriman, atau tidak memberikan nilai untuknya, deployment ke target ini tidak memerlukan persetujuan. (Namun, pemanggil yang mencoba mempromosikan ke target masih memerlukan izin IAM clouddeploy.rollouts.create.)

Anda bahkan dapat mewajibkan persetujuan manual pada target pertama. Saat rilis dibuat, menggunakan CLI, untuk target pertama, rollout akan dibuat secara otomatis. Jika persetujuan diperlukan, Cloud Deploy akan membuat rollout, tetapi dalam status rilis tertunda hingga persetujuan diberikan.

Langkah selanjutnya