Men-deploy aplikasi dalam container ke Cloud Run menggunakan Cloud Build

Men-deploy aplikasi dalam container ke Cloud Run menggunakan Cloud Build

Halaman ini menunjukkan cara menggunakan Cloud Build untuk men-deploy aplikasi dalam container ke Cloud Run.

Catatan: Panduan memulai ini menunjukkan cara men-deploy image ke Cloud Run, tetapi Cloud Build mendukung deployment di platform tambahan seperti App Engine, GKE, dan fungsi Cloud Run.

Anda juga dapat menggunakan Cloud Deploy untuk menyiapkan pipeline continuous delivery guna men-deploy ke Cloud Run.

---

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

---

Sebelum memulai

Login ke akun Google Cloud Anda. 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 Build, Cloud Run, Artifact Registry, and Compute Engine 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

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 Build, Cloud Run, Artifact Registry, and Compute Engine 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

Jika Anda telah menginstal Google Cloud CLI sebelumnya, pastikan Anda memiliki versi terbaru yang tersedia dengan menjalankan gcloud components update.

Memberikan izin

Cloud Build memerlukan beberapa izin sebelum dapat men-deploy image ke Cloud Run. Untuk memberikan izin ini, lakukan hal berikut:

1. Buka jendela terminal.

2. Tetapkan variabel lingkungan untuk menyimpan project ID dan nomor project Anda.

   PROJECT_ID=$(gcloud config list --format='value(core.project)')
   PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='value(projectNumber)')
   

3. Berikan peran Cloud Run Admin ke akun layanan Cloud Build Anda.

   gcloud projects add-iam-policy-binding $PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe $PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role=roles/run.admin \
   

4. Berikan peran Storage Object User ke akun layanan Cloud Build Anda.

   gcloud projects add-iam-policy-binding $PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe $PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role=roles/storage.objectUser \
   

5. Berikan peran Service Account User ke akun layanan Cloud Build Anda.

   gcloud projects add-iam-policy-binding $PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe $PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role=roles/iam.serviceAccountUser
   

   Catatan: Peran Service Account User memberikan izin yang terlalu luas kepada akun layanan Cloud Build. Saat Anda mengonfigurasi Cloud Build untuk men-deploy ke Cloud Run di lingkungan produksi, sebaiknya konfigurasi akun layanan Cloud Build untuk meniru identitas layanan Cloud Run yang ada. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi peniruan identitas akun layanan Cloud Build untuk layanan terkelola.

Men-deploy image bawaan

Anda dapat mengonfigurasi Cloud Build untuk men-deploy image yang telah dibuat sebelumnya dan disimpan di Artifact Registry ke Cloud Run.

Untuk men-deploy image yang telah dibuat sebelumnya:

1. Buka jendela terminal (jika belum terbuka).

2. Buat direktori baru bernama helloworld dan buka direktori tersebut:

   mkdir helloworld
   cd helloworld
   

3. Buat file bernama cloudbuild.yaml dengan konten berikut. File ini adalah file konfigurasi Cloud Build. File ini berisi petunjuk bagi Cloud Build untuk men-deploy image bernama us-docker.pkg.dev/cloudrun/container/hello di layanan Cloud Run bernama cloudrunservice.

   steps:
   - name: 'gcr.io/cloud-builders/gcloud'
     script: |
       gcloud run deploy cloudrunservice --image us-docker.pkg.dev/cloudrun/container/hello --region us-central1 --platform managed --allow-unauthenticated

4. Deploy image dengan menjalankan perintah berikut:

   gcloud builds submit --region=us-west2 --config cloudbuild.yaml
   

Setelah build selesai, Anda akan melihat output yang mirip dengan berikut ini:

DONE
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

ID                                    CREATE_TIME                DURATION  SOURCE                                                                                            IMAGES  STATUS
784653b2-f00e-4c4b-9f5f-96a5f115bef4  2020-01-23T14:53:13+00:00  23S       gs://cloudrunqs-project_cloudbuild/source/1579791193.217726-ea20e1c787fb4784b19fb1273d032df2.tgz  -       SUCCESS

Anda baru saja men-deploy image hello ke Cloud Run.

Menjalankan image yang di-deploy

1. Buka halaman Cloud Run di konsol Google Cloud :

   Buka halaman Cloud Run

2. Pilih project Anda lalu klik Buka.

   Anda akan melihat halaman Cloud Run Services.

3. Di tabel, temukan baris dengan nama cloudrunservice, lalu klik cloudrunservice.

   Halaman Service details untuk cloudrunservice akan ditampilkan.

4. Untuk menjalankan image yang Anda deploy di cloudrunservice, klik URL:

   

Langkah berikutnya

• Pelajari cara melakukan build menggunakan Cloud Build.
• Pelajari cara membuat file konfigurasi build dasar.
• Pelajari cara melihat hasil build.
• Pelajari cara lainnya untuk men-deploy ke Cloud Run.
• Pelajari cara men-deploy ke Google Kubernetes Engine.
• Pelajari lebih lanjut referensi DevOps.
• Eksplorasi program riset DevOps.