Membuat pipeline dan rilis di konsol Google Cloud

Membuat pipeline dan rilis di konsol Google Cloud

Halaman ini menunjukkan cara menggunakan konsol Google Cloud untuk membuat pipeline pengiriman Cloud Deploy, lalu membuat rilis untuk pipeline tersebut.

Dalam panduan memulai ini, Anda akan melakukan hal berikut:

1. Buat dua cluster GKE atau konfigurasi dua layanan Cloud Run.

2. Buat pipeline pengiriman dan dua target menggunakan konsolGoogle Cloud .

3. Buat instance pipeline pengiriman dengan membuat rilis menggunakan konsolGoogle Cloud .

   Setelah Anda membuat rilis ini, aplikasi akan otomatis di-deploy ke target.

4. Lihat hasilnya di konsol Google Cloud .

Sebelum memulai

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs
Install the Google Cloud CLI.
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:
gcloud init
Catatan: Anda dapat menjalankan gcloud CLI di konsol Google Cloud tanpa menginstal Google Cloud CLI. Untuk menjalankan gcloud CLI di konsol Google Cloud , gunakan Cloud Shell.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Install the Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Catatan: Anda dapat menjalankan gcloud CLI di konsol Google Cloud tanpa menginstal Google Cloud CLI. Untuk menjalankan gcloud CLI di konsol Google Cloud , gunakan Cloud Shell.

Jika Anda sudah menginstal CLI, pastikan Anda menjalankan versi terbaru:

gcloud components update

Buat lingkungan runtime Anda

Jika men-deploy ke Cloud Run, Anda dapat melewati perintah ini.

Untuk GKE, buat dua cluster: quickstart-cluster-for-console-staging dan quickstart-cluster-for-console-prod, dengan setelan default. Endpoint Kubernetes API cluster harus dapat dijangkau melalui jaringan dari internet publik. Cluster GKE dapat diakses secara eksternal secara default.

gcloud container clusters create-auto quickstart-cluster-for-console-staging \
                 --project=PROJECT_ID \
                 --region=us-central1 && \
gcloud container clusters create-auto quickstart-cluster-for-console-prod \
                 --project=PROJECT_ID \
                 --region=us-central1

Membuat pipeline pengiriman dan dua target

Anda dapat menggunakan Cloud Deploy untuk membuat pipeline pengiriman dan target berdasarkan konfigurasi yang ditentukan dalam satu atau beberapa file YAML. Namun, Anda juga dapat membuat pipeline pengiriman menggunakan konsol Google Cloud .

Di bagian ini, Anda akan menggunakan konsol Google Cloud untuk membuat pipeline pengiriman dan dua target. Saat menggunakan konsol Google Cloud , Anda tidak perlu membuat file YAML apa pun; Cloud Deploy akan membuat skaffold.yaml dan manifes untuk Anda.

1. Di konsol Google Cloud , buka halaman utama Cloud Deploy.

   Buka halaman Delivery pipelines

2. Klik Buat

   

   Formulir Create a delivery pipeline akan ditampilkan.

3. Di kolom Pipeline name, ganti teks default dengan in-console-quickstart-pipeline.

4. Secara opsional, masukkan deskripsi untuk pipeline pengiriman ini.

5. Di drop-down Region, pilih us-central1.

6. Pilih runtime Anda.

   Jika Anda men-deploy ke GKE, pilih Google Kubernetes Engine. Jika tidak, pilih Cloud Run.

7. Buat target Anda:

   GKE

   1. Di bagian Target baru, di kolom Nama target, ganti teks default dengan console-staging.

   2. Dari drop-down Kubernetes Engine cluster, pilih quickstart-cluster-for-console-staging.

   3. Klik Done.

   4. Klik Tambahkan target.

      Ganti teks default untuk Nama target dengan console-prod.

   5. Pilih quickstart-cluster-for-console-prod dari drop-down Kubernetes Engine cluster.

   6. Pilih Perlu persetujuan untuk peluncuran.

      Untuk quickstart ini, kami mewajibkan persetujuan pada target kedua, tetapi tidak pada target pertama.

   7. Klik Buat untuk membuat pipeline pengiriman ini.

      

   Cloud Run

   1. Di bagian Target baru, di kolom Nama target, ganti teks default dengan console-staging.

   2. Dari drop-down Region, pilih us-central1.

   3. Klik Done.

   4. Klik Tambahkan target.

   5. Ganti teks default untuk Nama target dengan console-prod.

   6. Centang kotak Wajibkan persetujuan untuk peluncuran untuk target ini.

      Untuk quickstart ini, kami mewajibkan persetujuan pada target kedua, tetapi tidak pada target pertama.

   7. Klik Buat untuk membuat pipeline pengiriman ini.

      

   Catatan: Jika akun layanan Compute Engine default tidak memiliki izin yang diperlukan, Anda dapat mengklik tombol Berikan untuk menambahkannya, saat diminta.

   Sekarang Anda memiliki pipeline pengiriman dengan dua target, yang siap membuat rilis.
   Halaman pipeline ditampilkan, yang menunjukkan kedua target, tanpa peluncuran.

   

Membuat rilis

Setelah memiliki pipeline pengiriman, dengan dua target, yang mengarah ke dua cluster GKE atau dua layanan Cloud Run, Anda dapat membuat rilis untuk men-deploy aplikasi ke target pertama.

1. Jika Anda belum berada di halaman pipeline pengiriman, yang menampilkan pipeline pengiriman baru in-console-quickstart-pipeline, buka halaman tersebut sekarang.

   Visualisasi pipeline ditampilkan, tanpa peluncuran.

2. Klik tombol Buat rilis.

   Dialog Create a release akan ditampilkan. Sebagian besar kolom sudah diisi otomatis. Pertahankan nilai default ini.

   

   Anda dapat mengklik tombol Lihat manifes untuk melihat manifes yang dibuat secara otomatis, untuk target mana pun, dan Anda dapat mengklik Lihat file Skaffold untuk melihat skaffold.yaml yang dihasilkan. Anda juga dapat mengeditnya, tetapi untuk panduan memulai cepat ini, biarkan apa adanya.

3. Anda juga dapat menambahkan deskripsi untuk rilis ini di kolom Description.

4. Klik Buat untuk memulai rilis.

   Halaman detail peluncuran ditampilkan untuk peluncuran ke target pertama, dan Anda dapat memantau progres peluncuran ini. Proses ini akan memerlukan waktu beberapa menit. Peluncuran mungkin memerlukan waktu beberapa detik untuk dimulai.

5. Setelah peluncuran pertama selesai, klik nama delivery pipeline untuk membuka halaman delivery pipeline.

   

   Visualisasi pipeline ditampilkan, dengan peluncuran selesai untuk target pertama.

   

6. Klik Promosikan untuk memulai peluncuran ke target berikutnya.

   Dialog Promosikan akan ditampilkan.

7. Biarkan nilai default, tambahkan Deskripsi peluncuran jika Anda mau, lalu klik Promosikan.

   Karena kita memilih Perlu persetujuan untuk peluncuran saat membuat target kedua, promosi ini menunggu persetujuan.

8. Klik Tinjau dalam visualisasi pipeline penayangan.

   Halaman persetujuan akan ditampilkan.

   

9. Klik Tinjau lagi, lalu di dialog persetujuan, klik Setujui.

   Peluncuran dimulai untuk target kedua. Anda dapat mengklik nama pipeline pengiriman lagi untuk melihat progres dalam visualisasi pipeline.

Setelah peluncuran kedua selesai, aplikasi akan di-deploy di target kedua, dan pipeline pengiriman Anda telah selesai.



Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

1. Hapus cluster GKE atau layanan Cloud Run:

   GKE

   gcloud container clusters delete quickstart-cluster-for-console-staging --region=us-central1 --project=PROJECT_ID \
   && gcloud container clusters delete quickstart-cluster-for-console-prod --region=us-central1 --project=PROJECT_ID
   

   Cloud Run

   gcloud run services delete in-console-quickstart-pipeline-target-1 --region=us-central1 --project=PROJECT_ID \
   && gcloud run services delete in-console-quickstart-pipeline-target-2 --region=us-central1 --project=PROJECT_ID
   

2. Dari halaman delivery pipeline, klik Hapus untuk menghapus delivery pipeline, rilis, dan peluncuran.

   Ketik nama pipeline di kolom yang disediakan, lalu klik Konfirmasi untuk menyelesaikan penghapusan resource.

   

3. Hapus kedua target:

   gcloud deploy targets delete console-staging --region=us-central1  && \
   gcloud deploy targets delete console-prod --region=us-central1
   

4. Hapus bucket Cloud Storage yang dibuat Cloud Deploy.

   Salah satunya diakhiri dengan _clouddeploy, dan yang lainnya adalah [region].deploy-artifacts.[project].appspot.com.

   Buka halaman browser Cloud Storage

Selesai, Anda telah menyelesaikan panduan memulai ini.

Langkah berikutnya

• Pelajari Cloud Deploy lebih lanjut.

• Pelajari dasar-dasar men-deploy aplikasi.

• Coba penelusuran Cloud Deploy.

• Pelajari cara mengelola manifes Anda.

• Pelajari cara menggabungkan alat CI/CD untuk mengembangkan dan mengirimkan software secara efektif ke GKE. Google Cloud