Deployment berkelanjutan dari Git menggunakan Cloud Build

Anda dapat menggunakan Cloud Build untuk mengotomatiskan build dan deployment ke layanan Knative 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.

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 penayangan Knative.

Sebelum memulai

• Anda memiliki repositori git dengan Dockerfile atau codebase Anda ditulis dalam salah satu bahasa yang didukung oleh buildpack Google Cloud: Go, Node.js, Python, Java, atau .NET Core.

• Aktifkan Cloud Build API dan Cloud Source Repositories API, jika ada yang belum diaktifkan.

  Peran yang diperlukan untuk mengaktifkan API

  Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

  Aktifkan API

Menyiapkan deployment berkelanjutan dari antarmuka pengguna penayangan Knative

Prosedurnya sedikit berbeda bergantung pada apakah Anda menyiapkan continuous deployment pada layanan baru atau pada layanan yang sudah ada. Klik tab yang sesuai untuk mempelajari lebih lanjut.

Layanan baru

1. Buka Knative serving di konsol Google Cloud :

   Buka Knative serving

2. Klik Create service.

3. Isi Setelan Layanan dengan preferensi Anda.

4. Klik Berikutnya.

5. Pilih Deploy berkelanjutan revisi baru dari repositori sumber.

   

6. Klik Penyiapan dengan Cloud Build.

7. Pilih penyedia dan repositori.

   • GitHub - jika Anda belum diautentikasi, klik Authentication, lalu ikuti petunjuknya. Secara default, menghubungkan repositori dilakukan melalui aplikasi GitHub Cloud Build. Atau, Anda dapat menduplikasi repositori GitHub Anda di Cloud Source Repositories. Untuk melakukannya, klik Advanced options, lalu centang Duplikasi repositori GitHub menggunakan Cloud Source Repositories Pelajari lebih lanjut
   • Bitbucket - jika Anda belum diautentikasi, klik Authentication, lalu ikuti petunjuknya.
   • Cloud Source Repositories

   

8. Klik Berikutnya.

9. Isi opsi pada langkah Konfigurasi Build:

   • Branch - menunjukkan sumber yang harus digunakan saat menjalankan pemicu. Anda dapat memasukkan 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.

   

10. Klik Simpan.

11. Verifikasi setelan yang dipilih.

    

12. Klik Buat.

13. Perlu diperhatikan bahwa Anda akan dialihkan ke halaman Detail Layanan untuk melacak progres penyiapan Continuous Deployment.

14. Setelah semua langkah selesai, perhatikan opsi tambahan:

    • Tombol Edit Deployment Berkelanjutan.
    • Build History
    • Detail sumber di bagian Detail Revisi.

Layanan yang ada

1. Buka Knative serving di konsol Google Cloud :

   Buka Knative serving

2. Cari layanan dalam daftar layanan, lalu klik layanan tersebut.

3. Klik Set up Continuous Deployment.

4. Pilih penyedia dan repositori.

   • GitHub - jika Anda belum diautentikasi, klik Authentication, lalu ikuti petunjuknya. Secara default, menghubungkan repositori dilakukan melalui aplikasi GitHub Cloud Build. Atau, Anda dapat menduplikasi repositori GitHub Anda di Cloud Source Repositories. Untuk melakukannya, klik Advanced options, lalu centang Duplikasi repositori GitHub menggunakan Cloud Source Repositories Pelajari lebih lanjut
   • Bitbucket - jika Anda belum diautentikasi, klik Authentication, lalu ikuti petunjuknya.
   • Cloud Source Repositories

   

5. Klik Berikutnya.

6. Isi opsi pada langkah Konfigurasi Build:

   • Branch - menunjukkan sumber yang harus digunakan saat menjalankan pemicu. Anda dapat memasukkan 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.

   

7. Klik Simpan.

8. Halaman akan dimuat ulang dan menampilkan progres penyiapan Continuous Deployment.

9. Setelah semua langkah selesai, perhatikan opsi tambahan:

   • Tombol Edit Deployment Berkelanjutan.
   • Build History
   • Detail sumber di bagian Detail Revisi.

Menyiapkan continuous deployment secara manual

Lihat Menyiapkan continuous deployment secara manual jika Anda perlu menggunakan prosedur manual, bukan UI.

Memasang pemicu Cloud Build yang ada untuk layanan penayangan Knative.

Jika sudah memiliki pemicu build Cloud Build, Anda dapat menghubungkannya ke layanan dan memanfaatkan Google Cloud fitur konsol di halaman detail Layanan: tombol Edit continuous deployment dan diagram Build History.

Untuk melakukannya, Anda harus menambahkan label dengan gcb-trigger-id sebagai kunci dan ID unik pemicu Cloud Build sebagai nilai (bukan nama pemicu). Lihat petunjuk untuk menyiapkan label.