Anda dapat menggunakan Cloud Build untuk mengotomatiskan build dan deployment ke Cloud Run dengan menggunakan pemicu Cloud Build untuk mem-build dan men-deploy kode secara otomatis setiap kali commit baru didorong ke cabang tertentu dari repositori Git. Misalnya, lihat panduan memulai untuk membuat repositori template dan men-deploy secara berkelanjutan dari git.
Saat Anda menggunakan pemicu Cloud Build untuk membangun container, informasi repositori sumber akan ditampilkan di konsol Google Cloud untuk layanan Anda setelah Anda melakukan deployment ke Cloud Run.
Atau, Anda dapat menggunakan Cloud Deploy untuk menyiapkan continuous delivery pipeline untuk men-deploy layanan Cloud Run ke beberapa lingkungan.
Sebelum memulai
- Anda memiliki repositori git dengan
Dockerfile
atau codebase Anda ditulis dalam salah satu bahasa yang didukung oleh buildpack Google Cloud. -
Aktifkan API Cloud Build .
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna men-deploy layanan Cloud Run dari Git menggunakan Cloud Build, minta administrator untuk memberi Anda peran IAM berikut pada project Anda:
-
Administrator Artifact Registry (
roles/artifactregistry.admin
) -
Editor Cloud Build (
roles/cloudbuild.builds.editor
) -
Developer Cloud Run (
roles/run.developer
) -
Service Account User (
roles/iam.serviceAccountUser
) -
Service Usage Admin (
roles/serviceusage.serviceUsageAdmin
)
Akun layanan yang menjalankan build harus memiliki peran berikut:
- Akun Layanan Cloud Build (
roles/cloudbuild.builds.builder
) - Cloud Run Admin (
roles/run.admin
) - Service Account User (
roles/iam.serviceAccountUser
)
Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan Izin IAM Cloud Run. Jika antarmuka layanan Cloud Run Anda dengan Google Cloud API, seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.
Menyiapkan continuous deployment dari antarmuka pengguna Cloud Run
Prosedur penyiapannya sedikit berbeda bergantung pada apakah Anda menyiapkan deployment berkelanjutan pada layanan baru atau pada layanan yang sudah ada. Klik tab yang sesuai untuk mempelajari lebih lanjut.
Layanan baru
Buat layanan baru seperti yang dijelaskan dalam Men-deploy layanan baru, pastikan Anda memilih Terus-menerus men-deploy revisi baru dari repositori sumber di Service setelan.
Di halaman Service settings, klik Set up with Cloud Build.
GitHub adalah penyedia repositori default. Jika Anda belum diautentikasi, klik Authenticate dan ikuti petunjuknya. Menghubungkan repositori dilakukan menggunakan aplikasi Cloud Build GitHub.
Klik Berikutnya.
Isi opsi pada langkah Konfigurasi Build:
- Branch - menunjukkan sumber yang harus digunakan saat menjalankan pemicu. Anda dapat menempatkan regex di sini. Cabang yang cocok akan otomatis diverifikasi: Anda dapat melihatnya di bawah input. Perhatikan bahwa jika hanya satu cabang yang cocok, pemicu akan otomatis dieksekusi setelah pembuatan.
Jenis Build
Jika repositori Anda harus di-build menggunakan Docker dan berisi Dockerfile, pilih Dockerfile. Source location menunjukkan lokasi dan nama Dockerfile. Direktori ini akan digunakan sebagai konteks build Docker. Semua jalur harus relatif terhadap direktori saat ini.
Jika tidak, pilih Google Cloud Buildpacks. Gunakan Konteks Buildpack untuk menentukan direktori dan Entrypoint (opsional) guna memberikan perintah untuk memulai server. Contoh:
gunicorn -p :8080 main:app
untuk Python,java -jar target/myjar.jar
untuk Java. Biarkan kosong untuk menggunakan perilaku default.
Klik Simpan.
Verifikasi setelan yang dipilih.
Klik Buat.
Perlu diperhatikan bahwa Anda akan dialihkan ke halaman Detail Layanan untuk melacak progres penyiapan Continuous Deployment.
Setelah semua langkah selesai, perhatikan opsi tambahan:
- Edit Deployment Berkelanjutan.
- Build History
- Detail sumber di bagian Detail Revisi.
Layanan yang ada
Cari layanan di daftar layanan, lalu klik.
Klik Set up Continuous Deployment.
GitHub adalah penyedia repositori default. Jika Anda belum diautentikasi, klik Autentikasi dan ikuti petunjuknya. Menghubungkan repositori dilakukan menggunakan aplikasi Cloud Build GitHub.
Klik Berikutnya.
Isi opsi pada langkah Konfigurasi Build:
- Branch - menunjukkan sumber yang harus digunakan saat menjalankan pemicu. Anda dapat menempatkan regex di sini. Cabang yang cocok akan otomatis diverifikasi: Anda dapat melihatnya di bawah input. Perhatikan bahwa jika hanya satu cabang yang cocok, pemicu akan otomatis dieksekusi setelah pembuatan.
Jenis Build
Jika repositori Anda harus di-build menggunakan Docker dan berisi Dockerfile, pilih Dockerfile. Source location menunjukkan lokasi dan nama Dockerfile. Direktori ini akan digunakan sebagai konteks build Docker. Semua jalur harus relatif terhadap direktori saat ini.
Jika tidak, pilih Google Cloud Buildpacks. Gunakan Konteks Buildpack untuk menentukan direktori dan Entrypoint (opsional) guna memberikan perintah untuk memulai server. Contoh:
gunicorn -p :8080 main:app
untuk Python,java -jar target/myjar.jar
untuk Java. Biarkan kosong untuk menggunakan perilaku default.
Klik Simpan.
Halaman akan dimuat ulang dan menampilkan progres penyiapan Continuous Deployment.
Setelah semua langkah selesai, perhatikan opsi tambahan:
- Edit Deployment Berkelanjutan.
- Build History
- Detail sumber di bagian Detail Revisi.
Siapkan continuous deployment secara manual
Lihat Menyiapkan deployment berkelanjutan secara manual jika Anda perlu menggunakan prosedur manual, bukan UI.
Memasang pemicu Cloud Build yang ada untuk layanan Cloud Run
Jika sudah memiliki pemicu Cloud Build, Anda dapat melampirkannya ke layanan dan memanfaatkan fitur Google Cloud Console di halaman Service Details: tombol Edit Continuous Deployment dan Build History.
Untuk melakukannya, tambahkan label dengan gcb-trigger-id sebagai kunci dan ID unik pemicu Cloud Build sebagai nilai (bukan pemicu nama). Lihat Menetapkan atau mengubah label untuk cara menyiapkan label.