Membuat pipeline dan rilis di Google Cloud konsol

Membuat pipeline dan rilis di Google Cloud konsol

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

Dalam panduan memulai ini, Anda akan melakukan hal berikut:

1. Membuat dua cluster GKE atau mengonfigurasi dua layanan Cloud Run.

2. Membuat pipeline pengiriman dan dua target menggunakan Google Cloud konsol.

3. Membuat instance pipeline pengiriman dengan membuat rilis menggunakan Google Cloud konsol.

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

4. Lihat hasilnya di Google Cloud konsol.

Sebelum memulai

Login ke akun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
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
Instal 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 Google Cloud konsol tanpa menginstal Google Cloud CLI. Untuk menjalankan gcloud CLI di konsol, gunakan Cloud Shell. Google Cloud

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

Instal 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 Google Cloud konsol tanpa menginstal Google Cloud CLI. Untuk menjalankan gcloud CLI di konsol, gunakan Cloud Shell. Google Cloud

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

gcloud components update

Membuat lingkungan runtime

Jika Anda 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 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 Google Cloud konsol.

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

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

   Buka halaman Delivery pipelines

2. Klik Create

   

   Formulir Create a delivery pipeline akan ditampilkan.

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

4. Jika mau, masukkan deskripsi untuk pipeline pengiriman ini.

5. Di menu 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 New target, di kolom Target name, ganti teks default dengan console-staging.

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

   3. Klik Done.

   4. Klik Add target.

      Ganti teks default untuk Target name dengan console-prod.

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

   6. Pilih Require approval for rollouts.

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

   7. Klik Create untuk membuat pipeline pengiriman ini.

      

   Cloud Run

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

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

   3. Klik Done.

   4. Klik Add target.

   5. Ganti teks default untuk Target name dengan console-prod.

   6. Aktifkan kotak centang Require approval for rollouts untuk target ini.

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

   7. Klik Create untuk membuat pipeline pengiriman ini.

      

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

   Sekarang Anda memiliki pipeline pengiriman dengan dua target, yang siap untuk membuat rilis.
   Halaman pipeline akan 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 akan ditampilkan, tanpa peluncuran.

2. Klik tombol Create release.

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

   

   Anda dapat mengklik tombol View manifest untuk melihat manifes yang dibuat secara otomatis, untuk salah satu target, dan Anda dapat mengklik View Skaffold file untuk melihat skaffold.yaml yang dibuat. Anda juga dapat mengeditnya, tetapi untuk panduan memulai ini, biarkan seperti apa adanya.

3. Jika mau, tambahkan deskripsi untuk rilis ini, di kolom Description.

4. Klik Create untuk memulai rilis.

   Halaman detail peluncuran akan ditampilkan, untuk peluncuran ke target pertama, dan Anda dapat melihat progres peluncuran ini. Prosesnya perlu waktu beberapa menit sampai selesai. Peluncuran mungkin memerlukan waktu beberapa detik untuk dimulai.

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

   

   Visualisasi pipeline akan ditampilkan, dengan peluncuran yang selesai ke target pertama.

   

6. Klik Promote untuk memulai peluncuran ke target berikutnya.

   Dialog Promote akan ditampilkan.

7. Pertahankan nilai default, tambahkan Rollout description jika Anda mau, lalu klik Promote.

   Karena kita memilih Require approval for rollouts saat membuat target kedua, promosi ini menunggu persetujuan.

8. Klik Review, di visualisasi pipeline pengiriman.

   Halaman persetujuan akan ditampilkan.

   

9. Klik Review lagi, dan di dialog persetujuan, klik Approve.

   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 akunAnda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut. Google Cloud

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 pipeline pengiriman, klik Delete untuk menghapus pipeline pengiriman, rilis, dan peluncuran.

   Ketik nama pipeline di kolom yang disediakan, lalu klik Confirm 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.

   Satu 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.

• Pelajari cara mengelola manifes Anda.

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