Men-deploy ke Cloud Run menggunakan Cloud Build

Halaman ini menjelaskan cara men-deploy layanan Cloud Run secara otomatis menggunakan Cloud Build. Jika Anda baru menggunakan Cloud Build, baca panduan memulai dan ringkasan konfigurasi build terlebih dahulu.

Cloud Run memungkinkan Anda menjalankan container stateless di lingkungan serverless. Dengan menggunakan Cloud Build, Anda dapat men-deploy image container dari Container Registry (Tidak digunakan lagi) dan Artifact Registry ke Cloud Run. Anda dapat men-deploy image yang ada, mem-build dan men-deploy image, atau mengotomatiskan deployment.

Catatan: Anda juga dapat menggunakan Cloud Deploy untuk menyiapkan pipeline continuous-delivery guna melakukan deploy ke Cloud Run. Pelajari lebih lanjut.

Sebelum memulai

• Enable the Cloud Build, Cloud Run, Container Registry, and Resource Manager APIs.

  Enable the APIs

• Siapkan kode sumber aplikasi Anda. Kode sumber Anda harus disimpan di repositori, seperti Cloud Source Repositories, GitHub, atau Bitbucket.

• Untuk menjalankan perintah gcloud di halaman ini, instal Google Cloud CLI.

• Jika Anda menggunakan Kontrol Layanan VPC, siapkan kumpulan pribadi di perimeter Kontrol Layanan VPC. Anda juga harus mengonfigurasi Cloud Run untuk Kontrol Layanan VPC.

Perhatian: Container Registry tidak digunakan lagi dan dijadwalkan untuk dihentikan. Organisasi yang belum menggunakan Container Registry sebelum 8 Januari 2024 memiliki repositori gcr.io baru yang dihosting di Artifact Registry secara default. Mulai 15 Mei 2024, project Google Cloud yang sebelumnya tidak menggunakan Container Registry hanya akan mendukung hosting dan pengelolaan image untuk domain gcr.io di Artifact Registry.

Container Registry dijadwalkan untuk dihentikan pada 18 Maret 2025. Untuk mengetahui detail penghentian penggunaan ini, lihat Penghentian penggunaan Container Registry.

Perhatian: Mulai 17 Juni 2024, Cloud Source Repositories tidak tersedia untuk pelanggan baru. Jika organisasi Anda belum pernah menggunakan Cloud Source Repositories, Anda tidak dapat mengaktifkan API atau menggunakan Cloud Source Repositories. Project baru yang tidak terhubung ke organisasi tidak dapat mengaktifkan Cloud Source Repositories API. Organisasi yang telah menggunakan Repositori Sumber Cloud sebelum 17 Juni 2024 tidak akan terpengaruh oleh perubahan ini.

Izin IAM yang diperlukan

Jika image Anda disimpan di project Google Cloud yang sama dengan project tempat Anda ingin men-deploynya atau jika image Anda publik di Container Registry, Anda memerlukan izin IAM berikut:

Untuk men-deploy ke Cloud Run, berikan peran Admin Cloud Run dan Pengguna Akun Layanan ke akun layanan yang Anda gunakan untuk build:

1. Buka halaman setelan Cloud Build di konsol Google Cloud:

   Buka halaman setelan Cloud Build

2. Dari menu drop-down, pilih akun layanan yang perannya ingin Anda ubah.

   

3. Di panel izin akun Layanan, tetapkan status peran Admin Cloud Run ke ENABLED:

4. Di pop-up Mungkin diperlukan langkah tambahan, klik BERIKAN AKSES KE SEMUA AKUN LAYANAN.

Catatan: Untuk meningkatkan keamanan, berikan peran Service Account User hanya kepada Akun Layanan Runtime Cloud Run. Untuk petunjuk cara melakukannya, lihat Menggunakan izin IAM minimal.

Membangun dan men-deploy container

Cloud Build memungkinkan Anda mem-build image container, menyimpan image yang di-build di Container Registry, lalu men-deploy image ke Cloud Run.

Untuk mem-build dan men-deploy image container:

1. Di direktori utama project, buat file konfigurasi bernama cloudbuild.yaml.

2. Dalam file konfigurasi build, tambahkan langkah build docker untuk mem-build image dan mengirimnya ke Container Registry, lalu tambahkan langkah build gcloud untuk memanggil perintah gcloud run deploy guna men-deploy image di Cloud Run:

   steps:
   # Build the container image
   - name: 'gcr.io/cloud-builders/docker'
     args: ['build', '-t', 'gcr.io/PROJECT_ID/IMAGE', '.']
   # Push the container image to Container Registry
   - name: 'gcr.io/cloud-builders/docker'
     args: ['push', 'gcr.io/PROJECT_ID/IMAGE']
   # Deploy container image to Cloud Run
   - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
     entrypoint: gcloud
     args: ['run', 'deploy', 'SERVICE_NAME', '--image', 'gcr.io/PROJECT_ID/IMAGE', '--region', 'SERVICE_REGION']
   images:
   - gcr.io/PROJECT_ID/IMAGE
   

   Dengan keterangan:

   • SERVICE_NAME adalah nama layanan Cloud Run.
   • SERVICE_REGION adalah region layanan Cloud Run yang Anda deploy.
   • PROJECT_ID adalah project ID Google Cloud tempat image Anda disimpan.
   • IMAGE adalah nama image Anda di Container Registry.

3. Buka direktori utama project Anda dan jalankan perintah berikut, dengan BUILD_REGION adalah salah satu region build yang didukung untuk menjalankan build:

    gcloud builds submit --region=BUILD_REGION
   

Setelah berhasil diselesaikan, pesan berhasil akan ditampilkan beserta URL layanan yang di-deploy.

Deployment berkelanjutan

Anda dapat mengotomatiskan deployment software ke Cloud Run dengan membuat pemicu Cloud Build. Anda dapat mengonfigurasi pemicu untuk mem-build dan men-deploy image setiap kali mengupdate kode sumber.

Untuk mengotomatiskan deployment:

1. Di root repositori, tambahkan file konfigurasi bernama cloudbuild.yaml dengan langkah-langkah untuk mem-build image, mengirim image ke Container Registry, lalu memanggil perintah gcloud run deploy:

     steps:
     # Build the container image
     - name: 'gcr.io/cloud-builders/docker'
       args: ['build', '-t', 'gcr.io/$PROJECT_ID/SERVICE_NAME:$COMMIT_SHA', '.']
     # Push the container image to Container Registry
     - name: 'gcr.io/cloud-builders/docker'
       args: ['push', 'gcr.io/$PROJECT_ID/SERVICE_NAME:$COMMIT_SHA']
     # Deploy container image to Cloud Run
     - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
       entrypoint: gcloud
       args:
       - 'run'
       - 'deploy'
       - 'SERVICE_NAME'
       - '--image'
       - 'gcr.io/$PROJECT_ID/SERVICE_NAME:$COMMIT_SHA'
       - '--region'
       - 'SERVICE_REGION'
     images:
     - 'gcr.io/$PROJECT_ID/SERVICE_NAME:$COMMIT_SHA'
   

   Dengan keterangan:

   • SERVICE_NAME adalah nama layanan Cloud Run.
   • SERVICE_REGION adalah region layanan Cloud Run yang Anda deploy.

   Penggunaan variabel substitusi $COMMIT_SHA diisi oleh Cloud Build saat dipicu dari repositori Git.

2. Buat pemicu build dengan file konfigurasi yang dibuat di langkah sebelumnya:

   1. Buka halaman Pemicu:

      Buka halaman Pemicu

   2. Klik Create Trigger.

   3. Di kolom Nama, masukkan nama pemicu Anda.

   4. Di bagian Region, pilih region untuk pemicu Anda.

      Catatan: Region untuk pemicu Anda harus cocok dengan region layanan Cloud Run tempat Anda men-deploy.

   5. Di bagian Peristiwa, pilih peristiwa repositori untuk memulai pemicu Anda.

   6. Di bagian Sumber, pilih repositori dan cabang atau nama tag yang akan memulai pemicu Anda. Untuk informasi selengkapnya tentang menentukan cabang yang akan otomatis di-build, lihat Membuat pemicu build.

   7. Di bagian Konfigurasi, pilih File konfigurasi Cloud Build (YAML atau JSON).

   8. Di kolom Lokasi file konfigurasi Cloud Build, ketik cloudbuild.yaml setelah /.

   9. Klik Buat untuk menyimpan pemicu build Anda.

3. Selesai! Mulai sekarang, setiap kali Anda melakukan push ke repositori, build dan deployment ke layanan Anda akan otomatis dipanggil.

Catatan: memublikasikan layanan yang di-deploy, buat perubahan satu kali pada setelan layanan IAM.

Setiap kali Anda melakukan push kode baru ke repositori, Anda akan otomatis memicu build dan deployment ke layanan Cloud Run.

Untuk informasi selengkapnya tentang cara membuat pemicu Cloud Build, lihat Membuat dan mengelola pemicu build.

Menggunakan izin IAM minimal

Saat di-deploy dengan layanan Cloud Run, container dijalankan dengan identitas Akun Layanan Runtime di layanan Cloud Run. Karena Cloud Build dapat otomatis men-deploy container baru, Cloud Build harus dapat bertindak sebagaiAkun Layanan Runtime di layanan Cloud Run Anda.

Untuk memberikan akses terbatas pada Cloud Build guna men-deploy layanan Cloud Run:

Konsol

1. Buka halaman akun Layanan di konsol Google Cloud:

   Buka halaman Service accounts

2. Klik alamat email akun Layanan Runtime layanan Cloud Run Anda (secara default, alamatnya adalah [e-mail]).

3. Klik tab Izin.

4. Klik Berikan akses.

5. Masukkan Akun Layanan Cloud Build ([e-mail])

6. Di menu dropdown Pilih peran, pilih peran Akun Layanan > Pengguna Akun Layanan.

7. Klik Simpan.

gcloud

Gunakan perintah gcloud iam service-accounts add-iam-policy-binding, dengan PROJECT_NUMBER adalah ID numerik project Anda:

gcloud iam service-accounts add-iam-policy-binding \
  [e-mail] \
  --member="serviceAccount:[e-mail]" \
  --role="roles/iam.serviceAccountUser"

Ganti PROJECT_NUMBER dengan ID numerik project Anda.

Jika Anda menggunakan Cloud Run dengan identitas layanan yang disesuaikan, ganti [e-mail] dengan alamat akun layanan Anda.

Lihat Izin deployment untuk informasi selengkapnya.

Contoh kode

Berikut adalah beberapa contoh repositori, yang masing-masing berisi aplikasi contoh dan file konfigurasi build untuk men-deploy aplikasi ke Cloud Run:

• deploy-prebuilt: Contoh kode yang menunjukkan cara men-deploy image bawaan ke Cloud Run.
• run-example-builddeploy: Contoh kode yang menunjukkan cara mem-build dan men-deploy image ke Cloud Run.

Langkah selanjutnya

• Pelajari cara menggunakan Cloud Deploy untuk men-deploy ke Cloud Run.
• Pelajari cara men-deploy di GKE.
• Pelajari cara men-deploy di Cloud Run Functions.
• Pelajari cara men-deploy di App Engine.
• Pelajari cara men-deploy di Firebase.
• Pelajari cara melakukan deployment blue/green di Compute Engine.
• Pelajari cara memecahkan masalah error build.