Halaman ini menjelaskan cara menghubungkan repositori GitHub ke Cloud Build. Untuk mempelajari repositori Cloud Build lebih lanjut, lihat Repositori Cloud Build.
Sebelum memulai
Aktifkan Cloud Build API.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (
roles/serviceusage.serviceUsageAdmin), yang berisi izinserviceusage.services.enable. Pelajari cara memberikan peran.
- Siapkan kode sumber Anda di repositori GitHub.
- Siapkan
Dockerfileatau file konfigurasi Cloud Build di repositori sumber GitHub Anda. - Jika Anda awalnya menghubungkan repositori ke Cloud Build, pastikan Anda memiliki izin tingkat admin di repositori Anda. Untuk mempelajari izin repositori GitHub lebih lanjut, lihat Tingkat izin repositori untuk organisasi.
Untuk menggunakan
gcloudperintah di halaman ini, instal Google Cloud CLI.
Menghubungkan ke repositori GitHub
Untuk menghubungkan repositori GitHub ke Cloud Build Anda:
Buka halaman Repositories di Google Cloud konsol.
Di pemilih project di panel atas, pilih project Anda Google Cloud .
Di bagian atas halaman, pilih tab 1st gen.
Klik Connect repository.
Anda akan melihat panel Connect repository.
Di bagian Select source code management provider, pilih GitHub Cloud Build GitHub App.
Klik Continue.
Anda mungkin diminta untuk mengautentikasi koneksi Anda ke GitHub atau menginstal Aplikasi GitHub. Jika Anda belum melakukannya, selesaikan langkah-langkah berikut:
Jika Anda belum login ke GitHub sebelumnya, lakukan sekarang.
Halaman Otorisasi akan muncul, tempat Anda mengizinkan Aplikasi Google Cloud Build untuk terhubung ke Google Cloud.
Klik Authorize Google Cloud Build by GoogleCloudBuild.
Klik Install Google Cloud Build.
Di dialog yang muncul, pilih nama pengguna atau organisasi GitHub Anda.
Pilih salah satu opsi berikut berdasarkan kebutuhan bisnis Anda:
Semua repositori - mengaktifkan repositori GitHub saat ini dan mendatang untuk akses menggunakan aplikasi Cloud Build
Only select repositories - gunakan drop-down Select repositories untuk hanya mengaktifkan repositori tertentu untuk akses menggunakan aplikasi Cloud Build.
Anda dapat mengaktifkan repositori tambahan di lain waktu. Jika Anda memilih All repositories sebagai opsi, aplikasi Cloud Build akan diizinkan untuk mengakses semua repositori Anda. Namun, Anda harus menghubungkan setiap repositori baru melalui Cloud Build dengan mengikuti langkah-langkah yang diuraikan di bagian ini.
Klik Install untuk menginstal aplikasi Cloud Build.
Dialog akan ditutup dan halaman Repositories akan muncul.
Di bagian Select repository, pilih kolom berikut:
Akun GitHub: Akun GitHub yang digunakan untuk menginstal Aplikasi GitHub Cloud Build. Kolom ini mungkin telah dipilih sebelumnya untuk Anda.
Repository: Repositori yang ingin Anda hubungkan ke Cloud Build.
Jika Anda tidak melihat satu atau beberapa repositori target, klik Edit repositories on GitHub untuk mengaktifkan repositori tambahan di Aplikasi GitHub Cloud Build. Kemudian, Anda dapat memilih repositori target baru di bagian Select Repository.
Setelah memilih akun dan repositori GitHub, baca pernyataan penafian izin dan centang kotak di sampingnya untuk menunjukkan bahwa Anda menerima persyaratan yang ditampilkan.
Klik Connect.
(Opsional) Di bagian Create a trigger, pilih repositori yang ingin Anda buat pemicunya di kolom Create a sample trigger for these repositories. Setelah memilih repositori, klik Create a trigger.
Klik Done.
(Opsional) Memperbarui akun GitHub yang diautentikasi
Jika perlu memperbarui akun GitHub yang terkait dengan Akun Google Anda, Anda dapat membuka halaman Autentikasi dengan GitHub. Anda mungkin perlu melakukannya jika melihat bahwa halaman repositori Cloud Build Connect menunjukkan bahwa aplikasi GitHub tidak diinstal di repositori mana pun setelah menginstal aplikasi Cloud Build di GitHub.
Langkah berikutnya
- Pelajari cara mem-build repositori dari GitHub.
- Pelajari cara melakukan deployment biru-hijau di Compute Engine.
- Pelajari cara menentukan repositori tambahan sebagai dependensi untuk build Anda.