Membuat target dan pipeline pengiriman

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

Tentang pipeline pengiriman dan target

Pipeline pengiriman Anda menjelaskan progresi 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 atau file definisi target, Anda menjalankan gcloud deploy apply terhadap setiap file tersebut untuk mendaftarkannya sebagai resource Cloud Deploy.

Menentukan target dan pipeline pengiriman

Struktur file konfigurasi target dan pipeline pengiriman dijelaskan di sini.

Anda dapat memberi nama file ini sesuai keinginan. Berdasarkan konvensi, konfigurasi alur pengiriman yang mencakup definisi target disebut clouddeploy.yaml, dan konfigurasi yang merujuk target yang ditentukan dalam satu atau beberapa file terpisah disebut delivery-pipeline.yaml.

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

Membuat target dan pipeline pengiriman menggunakan konsol Google Cloud

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

Untuk membuat pipeline pengiriman:

  1. Dari halaman Delivery pipelines, klik Create.

  2. Berikan nama (atau biarkan default) dan deskripsi (opsional).

  3. Pilih wilayah Anda.

  4. Pilih lingkungan runtime Anda.

    Untuk GKE, pilih Google Kubernetes Engine, atau pilih Cloud Run jika itu adalah runtime yang Anda 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 Aktifkan canary.

  8. Klik Selesai.

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

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

Mendaftarkan target dan pipeline pengiriman

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

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

Perintah berikut mendaftarkan pipeline pengiriman dengan target 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 Anda, dan menargetkan resource yang dapat digunakan oleh pipeline pengiriman mana pun dalam 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 menggunakan file terpisah

Untuk contoh ini, ada tiga target yang ditentukan dalam tiga file terpisah, jadi 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 oleh pipeline tersebut.

Membuat target dan pipeline pengiriman menggunakan Terraform

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

Penyedia Terraform betaGoogle Cloud dapat mencakup dukungan untuk fitur Cloud Deploy dalam Pratinjau.

Mengedit target dan pipeline yang ada

Anda dapat mengedit pipeline pengiriman atau konfigurasi target nanti dan menjalankan gcloud deploy apply untuk memperbarui pipeline atau resource target. 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 pada definisi target:

requireApproval: true

Nilai defaultnya adalah false. Jika Anda menghapus properti ini dari konfigurasi delivery-pipeline, 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 menunggu rilis hingga persetujuan diberikan.

Langkah berikutnya