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 mengetahui deskripsi struktur file YAML untuk pipeline dan target pengiriman.

Tentang pipeline pengiriman dan target

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

Menentukan pipeline pengiriman dan target

Struktur pipeline pengiriman dan file konfigurasi target dijelaskan di sini.

Anda dapat memanggil file ini apa pun yang Anda inginkan. Berdasarkan konvensi, 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 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 pengiriman dan target atau target baru. 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 Pipeline penayangan, klik Buat.

  2. Berikan nama (atau tetap gunakan nama default) dan, jika perlu, deskripsi.

  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, beri nama (atau tetap gunakan default).

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

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

  8. Klik Done.

  9. Klik Add target dan ikuti langkah-langkah ini untuk setiap target tambahan yang ingin Anda buat.

  10. Setelah memiliki semua target, klik Create untuk membuat pipeline penayangan dan resource target.

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, jalankan 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 targetnya yang ditentukan dalam file yang sama.

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

Anda sekarang memiliki pipeline pengiriman yang dapat mengelola deployment rilis, dan menargetkan resource yang dapat digunakan oleh semua pipeline pengiriman di project dan region yang sama.

Contoh satu file

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, 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

Tanda --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 direferensikan pipeline tersebut.

Membuat target dan pipeline pengiriman menggunakan Terraform

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

Penyedia Terraform versi beta Google Cloud mungkin menyertakan dukungan untuk fitur Cloud Deploy di Pratinjau.

Mengedit pipeline dan target yang ada

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

Mewajibkan persetujuan manual untuk deployment

Guna 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 melakukan promosi 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 membuat rollout, tetapi dalam status rilis tertunda hingga persetujuan diberikan.

Langkah selanjutnya