Membangun repositori dari GitLab

Dengan Cloud Build, Anda dapat membuat pemicu untuk membangun dari repositori yang dihosting di GitLab. Anda dapat menjalankan build sebagai respons terhadap peristiwa seperti push commit atau permintaan penggabungan yang terkait dengan repositori GitLab Anda.

Halaman ini menjelaskan cara mengaktifkan pemicu build untuk instance GitLab. Untuk mengetahui informasi selengkapnya, lihat Pemicu Cloud Build dan Repositori Cloud Build.

Sebelum memulai

Ikuti petunjuk untuk menghubungkan ke host GitLab.

  • Enable the Cloud Build and Secret Manager APIs.

    Enable the APIs

Untuk membuat pemicu untuk repositori GitLab, Anda harus memiliki koneksi antara Google Cloud dan repositori Anda. Untuk membuat koneksi melalui aplikasi GitLab di Google Cloud, lihat Menghubungkan ke repositori GitLab.

Membuat pemicu GitLab

Bagian ini menjelaskan cara membuat pemicu dan menautkannya ke penginstalan GitLab Anda.

Google Cloud console

Untuk membuat pemicu GitLab menggunakan konsol Google Cloud , lakukan hal berikut:

  1. Buka halaman Pemicu:

    Buka halaman Pemicu

  2. Pilih Google Cloud project Anda dari bagian atas halaman, lalu klik Buka.

  3. Klik Create trigger.

  4. Masukkan setelan pemicu berikut:

    • Nama: Nama untuk pemicu Anda.

    • Region: Pilih region untuk pemicu Anda.

      • Jika file konfigurasi build yang terkait dengan pemicu menentukan kumpulan pribadi, Cloud Build akan menggunakan kumpulan pribadi untuk menjalankan build Anda. Dalam hal ini, region yang Anda tentukan di pemicu harus cocok dengan region tempat Anda membuat pool pribadi.
      • Jika file konfigurasi build yang terkait dengan pemicu tidak menentukan kumpulan pribadi, maka Cloud Build menggunakan kumpulan default untuk menjalankan build Anda di region yang sama dengan pemicu Anda.

    • Deskripsi (Opsional): Deskripsi untuk pemicu Anda.

    • Peristiwa: Pilih peristiwa repositori untuk memanggil pemicu Anda.

      • Push ke cabang: Tetapkan pemicu untuk memulai build pada commit ke cabang tertentu.

      • Push tag baru: Tetapkan pemicu untuk memulai build pada commit yang berisi tag tertentu.

      • Permintaan pull: Tetapkan pemicu untuk memulai build pada commit ke permintaan penggabungan.

    • Sumber: Konfigurasi informasi tentang repositori GitLab Anda:

      • Layanan repositori: Pilih Cloud Build.

      • Pembuatan repositori: Pilih Developer Connect sebagai sumber Anda.

      • Repositori: Dari daftar repositori yang tersedia, pilih repositori.

      • Cabang atau Tag: Tentukan ekspresi reguler dengan cabang atau nilai tag yang akan dicocokkan. Untuk mengetahui informasi mengenai sintaksis ekspresi reguler yang dapat diterima, lihat sintaksis RE2.

      • Kontrol komentar: Jika Anda memilih Pull request sebagai Peristiwa, pilih salah satu opsi berikut untuk mengontrol apakah build dieksekusi secara otomatis oleh pemicu:

        • Wajib kecuali untuk pemilik dan kolaborator: Saat permintaan tarikan dibuat atau diperbarui oleh pemilik atau kolaborator repositori, build akan otomatis dieksekusi oleh pemicu. Jika kontributor eksternal memulai tindakan, build hanya akan dieksekusi setelah pemilik atau kolaborator mengomentari /gcbrun pada pull request.

        • Wajib: Saat permintaan pull dibuat atau diperbarui oleh kontributor mana pun, build hanya dijalankan setelah pemilik atau kolaborator mengomentari /gcbrun permintaan pull. Build dieksekusi setiap kali perubahan dilakukan pada permintaan pull.

        • Tidak diperlukan: Saat permintaan pull dibuat atau diperbarui oleh kontributor mana pun, build akan otomatis dieksekusi oleh pemicu.

    • Konfigurasi: Pilih file konfigurasi build yang ada di repositori Anda atau konfigurasi build secara inline di pemicu.

      • Type: Pilih jenis konfigurasi yang akan digunakan untuk build Anda.

        • File konfigurasi Cloud Build (yaml atau json): Gunakan file konfigurasi build untuk konfigurasi Anda.
        • Dockerfile: Gunakan Dockerfile untuk konfigurasi Anda.

      • Lokasi: Tentukan lokasi untuk konfigurasi Anda.

        • Repositori: Jika file konfigurasi Anda berada di repositori, berikan lokasi file konfigurasi build atau direktori Dockerfile dan nama untuk image yang dihasilkan. Jika konfigurasi Anda adalah Dockerfile, Anda dapat secara opsional memberikan waktu tunggu untuk build Anda. Setelah memberikan Dockerfile dan nama image, Anda akan melihat pratinjau perintah docker build yang akan dijalankan build Anda.

        • Inline: Jika Anda memilih File konfigurasi Cloud Build (yaml atau json) sebagai opsi konfigurasi, Anda dapat menentukan konfigurasi build secara inline. Klik Open Editor untuk menulis file konfigurasi build di Google Cloud konsol menggunakan sintaksis YAML atau JSON. Klik Selesai untuk menyimpan konfigurasi build Anda.

  5. Klik Create untuk membuat pemicu GitLab Enterprise Edition.

gcloud CLI

Untuk membuat pemicu GitLab menggunakan perintah gcloud, jalankan perintah berikut:

    gcloud alpha builds triggers create developer connect
      --name=TRIGGER_NAME \
      --git-repository-link=projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/gitRepositoryLinks/REPO_NAME \
      --branch-pattern=BRANCH_PATTERN # or --tag-pattern=TAG_PATTERN \
      --build-config=BUILD_CONFIG_FILE \
      --region=REGION \
      --service-account=SERVICE-ACCOUNT

Dengan:

  • TRIGGER_NAME adalah nama pemicu Anda.
  • PROJECT_ID adalah Google Cloud project ID Anda.
  • REGION adalah region pemicu Anda.
  • CONNECTION_NAME adalah nama koneksi GitLab Anda.
  • GIT_REPOSITORY_LINK adalah link ke repositori Git Anda.
  • BRANCH_PATTERN adalah nama cabang di repositori Anda untuk memanggil build.
  • TAG_PATTERN adalah nama tag di repositori Anda untuk memanggil build.
  • BUILD_CONFIG_FILE adalah jalur ke file konfigurasi build Anda.
  • SERVICE-ACCOUNT adalah akun layanan yang akan digunakan untuk operasi pemicu dan build.

API

Untuk membuat pemicu GitLab dengan API, gunakan template JSON berikut:

{
    "filename": "cloudbuild.yaml",
    "name": "curl-trigger",
    "description": "curl trigger",
    "developer_connect_config" { 
      "git_repository_link": "PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/gitRepositoryLinks/REPO_NAME",
      "git_repository_link_type": "GITLAB",
      // Field filter must be only one of the following:
      "pullRequest": "PULL_REQUEST_FILTER",
      "push": "PUSH_FILTER"
   }
}

Dengan:

  • PROJECT_ID adalah Google Cloud project ID Anda.
  • REGION adalah region pemicu Anda.
  • CONNECTION_NAME adalah nama koneksi GitLab Anda.
  • GIT_REPOSITORY_LINK adalah link ke repositori Git Anda.
  • "REPO_NAME" adalah nama repositori Anda.
  • "PULL_REQUEST_FILTER" adalah instance PullRequestFilter, yang menentukan filter yang memungkinkan Cloud Build memicu build saat permintaan pull yang cocok dibuat di GitLab.
  • "PUSH_FILTER" adalah instance PushFilter, yang menentukan filter yang memungkinkan Cloud Build memicu build saat push yang cocok dilakukan di GitLab.

Masukkan perintah curl berikut di terminal Anda:

  curl -X POST -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8" -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/triggers -d @trigger.json

Dengan:

  • PROJECT_NUMBER adalah nomor project Google Cloud Anda.
  • PROJECT_ID adalah Google Cloud project ID Anda.

Berbagi data

Data yang dikirim ke GitLab dari Cloud Build membantu Anda mengidentifikasi pemicu menurut nama dan melihat hasil build di repositori GitLab Anda.

Data berikut dibagikan antara Cloud Build dan host GitLab Anda:

  • Google Cloud project ID
  • Nama pemicu

Langkah berikutnya