Menghubungkan ke host GitLab

Halaman ini menjelaskan cara menghubungkan host GitLab ke Cloud Build.

Sebelum memulai

• Aktifkan Cloud Build dan Secret Manager 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

Menghubungkan ke host GitLab

Sebelum membuat koneksi host untuk instance GitLab, Anda harus membuat token akses pribadi di GitLab dengan menyelesaikan langkah-langkah berikut:

1. Login ke instance GitLab Anda.

2. Di halaman GitLab untuk instance Anda, klik avatar Anda di pojok kanan atas.

3. Klik Edit profil.

4. Di sidebar kiri, pilih Token akses.

   Anda akan melihat halaman Personal Access Tokens.

5. Buat token akses dengan cakupan api untuk digunakan dalam menghubungkan dan memutuskan hubungan repositori.

6. Buat token akses dengan cakupan read_api untuk memastikan repositori Cloud Build dapat mengakses kode sumber di repositori.

   Catatan: Selain token akses pribadi, Anda juga dapat menggunakan token akses project. Jika versi GitLab Anda adalah 14.2 atau yang lebih tinggi, Anda juga dapat menggunakan token akses grup. Jika Anda menggunakan token akses grup atau project, pilih peran Maintainer untuk memastikan koneksi berhasil.

Konsol

Untuk menghubungkan host GitLab Anda ke Cloud Build:

1. Buka halaman Repositori di Google Cloud konsol.

   Buka halaman Repositori

   Anda akan melihat halaman Repositories.

2. Di bagian atas halaman, pilih tab Generasi ke-2.

3. Di pemilih project di panel atas, pilih Google Cloud project Anda.

4. Klik Create host connection untuk menghubungkan host baru ke Cloud Build.

5. Di panel kiri, pilih GitLab sebagai penyedia sumber Anda.

6. Di bagian Configure Connection, masukkan informasi berikut:

   • Region: Pilih region untuk koneksi Anda.

     Catatan: Anda harus menentukan region. Koneksi Anda tidak dapat ada secara global.

   • Name: Masukkan nama untuk koneksi Anda.

7. Di bagian Host details, buka GitLab host, lalu pilih GitLab.com.

8. Opsional: Jika Anda ingin mengelola kunci enkripsi yang digunakan untuk mengenkripsi token akses untuk repositori GitLab Anda, buka bagian Encryption dan pilih kunci Cloud Key Management Service. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan kunci enkripsi yang dikelola pelanggan untuk Secret Manager.

9. Di bagian Personal access tokens, masukkan informasi berikut:

   • Token akses API: Masukkan token dengan akses cakupan api. Token ini digunakan untuk menghubungkan dan memutuskan hubungan repositori.

   • Token akses API baca: Masukkan token dengan cakupan read_api akses. Pemicu Cloud Build menggunakan token ini untuk mengakses kode sumber di repositori.

10. Klik Hubungkan.

    Setelah mengklik tombol Connect, token akses pribadi Anda akan disimpan dengan aman di Secret Manager. Setelah koneksi host, Cloud Build juga membuat rahasia webhook untuk Anda. Anda dapat melihat dan mengelola secret di halaman Secret Manager.

Anda kini telah berhasil membuat koneksi GitLab.

gcloud

Sebelum menghubungkan host GitLab ke Cloud Build, selesaikan langkah-langkah berikut untuk menyimpan kredensial Anda:

1. Simpan token Anda di Secret Manager.

2. Buat secret webhook di Secret Manager dengan menjalankan perintah berikut:

    cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create my-gle-webhook-secret --data-file=-
   

3. Jika Anda menyimpan secret di project Google Cloud lain daripada yang akan Anda gunakan untuk membuat koneksi host, masukkan perintah berikut untuk memberikan akses project Anda ke agen layanan Cloud Build:

   PN=$(gcloud projects describe PROJECT_ID --format="value(projectNumber)")
   CLOUD_BUILD_SERVICE_AGENT="service-${PN}@gcp-sa-cloudbuild.iam.gserviceaccount.com"
   gcloud projects add-iam-policy-binding PROJECT_ID \
     --member="serviceAccount:${CLOUD_BUILD_SERVICE_AGENT}" \
     --role="roles/secretmanager.admin"
   

   Dengan:

   • PROJECT_ID adalah Google Cloud project ID Anda.

Sekarang Anda dapat melanjutkan untuk menghubungkan host GitLab ke Cloud Build.

Selesaikan langkah-langkah berikut:

Untuk menghubungkan host GitLab Anda ke Cloud Build:

1. Masukkan perintah berikut untuk membuat koneksi GitLab:

   gcloud builds connections create gitlab CONNECTION_NAME \
     --host-uri=HOST_URI \
     --project=PROJECT_ID \
     --region=REGION \
     --authorizer-token-secret-version=projects/PROJECT_ID/secrets/API_TOKEN/versions/SECRET_VERSION \
     --read-authorizer-token-secret-version=projects/PROJECT_ID/secrets/READ_TOKEN/versions/SECRET_VERSION \
     --webhook-secret-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET/versions/SECRET_VERSION
   

   Dengan:

   • CONNECTION_NAME adalah nama untuk koneksi host GitLab Anda di Cloud Build.
   • HOST_URI adalah URI instance GitLab Anda. Contoh, https://my-gle-server.net.
   • PROJECT_ID adalah Google Cloud project ID Anda.
   • REGION adalah region untuk koneksi Anda.
   • API_TOKEN adalah nama token Anda dengan cakupan api.
   • READ_TOKEN adalah nama token Anda dengan cakupan read_api.
   • SECRET_VERSION adalah versi secret Anda.
   • WEBHOOK_SECRET adalah rahasia webhook Anda.

Anda kini telah berhasil membuat koneksi GitLab.

Mengganti token akses GitLab lama atau yang sudah habis masa berlakunya

Ganti token akses Anda agar koneksi host Cloud Build dapat mempertahankan koneksinya ke repositori GitLab Anda. Jika token akses GitLab Anda berakhir masa berlakunya, koneksi host Cloud Build Anda akan terputus dari repositori GitLab-nya. Jika hal ini terjadi, Anda tidak dapat menonaktifkan koneksi atau menautkan repositori hingga Anda mengganti token yang sudah habis masa berlakunya. Selain itu, Anda akan melihat error dalam situasi berikut:

• Halaman Detail koneksi untuk koneksi Anda menampilkan pesan error yang menyatakan Connection is disconnected due to an invalid or expired access token.

• Jika Anda mencoba menautkan repositori ke koneksi yang memiliki token yang sudah tidak berlaku, Anda akan melihat pesan Token akses tidak valid. Mengklik Lihat koneksi akan mengarahkan Anda ke halaman Detail koneksi untuk koneksi dengan token yang sudah tidak berlaku.

Cloud Build memungkinkan Anda mengganti token akses dengan memasukkan nilai token baru dan menyimpannya di Secret Manager dalam versi secret terbaru untuk token tersebut. Untuk merotasi token akses Anda, lakukan hal berikut:

1. Ganti setiap token akses di GitLab:

   1. Buka repositori GitLab yang terhubung ke koneksi host Cloud Build Anda.

   2. Ikuti petunjuk dalam dokumentasi GitLab untuk merotasi token akses. Saat Anda mengganti token, GitLab akan membuat token baru dengan kredensial baru dan membatalkan validasi token versi sebelumnya. Token yang dirotasi memiliki izin dan cakupan yang sama dengan token asli.

   3. Salin ID token yang dirotasi.

2. Perbarui token akses Anda di Cloud Build:

   1. Buka halaman Detail koneksi untuk koneksi Anda.

   2. Pilih Perbarui token akses.

   3. Di menu Token rotation, masukkan token baru Anda di kolom API access token dan Read access token.

   4. (Opsional): Jika Anda ingin koneksi Anda selalu menggunakan versi terbaru secret untuk token Anda, pilih Update connection to always use latest version. Membiarkan opsi ini tidak dipilih dapat berguna jika koneksi Anda menggunakan nomor versi rahasia tertentu.

   5. Pilih Perbarui untuk menyimpan perubahan.

      Cloud Build menyimpan token akses baru sebagai versi terbaru secret Anda di Secret Manager.

Untuk mengetahui informasi selengkapnya, lihat Masa berlaku token akses dalam dokumentasi GitLab.

Langkah berikutnya

• Pelajari cara menghubungkan repositori GitLab.
• Pelajari cara membangun dan men-deploy workload Anda ke Google Cloud menggunakan komponen CI/CD yang dikelola Google di pipeline GitLab Anda. Lihat GitLab di Google Cloud.