Menghubungkan ke GitLab

Halaman ini menjelaskan cara membuat koneksi ke GitLab dan membuat link ke repositori GitLab. Anda dapat menyelesaikan tugas ini menggunakan konsol Google Cloud , atau Google Cloud CLI.

Petunjuk ini ditujukan untuk developer aplikasi, administrator platform, dan pengelola keamanan yang ingin menggunakan repositori kode sumber GitLab dengan Google. Secara khusus, Anda dapat menggunakan repositori GitLab dengan Gemini Code Assist.

Untuk mempelajari Developer Connect lebih lanjut, lihat Ringkasan Developer Connect.

Sebelum memulai

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Developer Connect, Secret Manager APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  4. Pastikan Anda memiliki akses ke akun di GitLab.

    Untuk membantu menjaga keamanan pekerjaan tim Anda, sebaiknya selesaikan tugas dalam panduan ini menggunakan akun layanan atau akun yang dibagikan oleh tim Anda, bukan akun pribadi.

  5. Pastikan Anda memiliki repositori GitLab, atau memiliki izin tingkat admin di repositori bersama.
  6. Opsional: Buat kunci enkripsi yang dikelola pelanggan (CMEK) untuk mengenkripsi secret autentikasi yang dibuat oleh Developer Connect.
  7. Opsional: Untuk menggunakan petunjuk command line dalam panduan ini, selesaikan langkah-langkah berikut:
    1. Instal Google Cloud CLI. Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru yang tersedia dengan menjalankan gcloud components update.
    2. Buat akun layanan Developer Connect dengan menjalankan perintah berikut, dengan PROJECT_ID sebagai Google Cloud project ID Anda:
              gcloud beta services identity create \
                  --service=developerconnect.googleapis.com \
                  --project=PROJECT_ID
              

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk membuat koneksi dan link, minta administrator untuk memberi Anda peran IAM berikut:

  • Jika Anda bukan Project Owner: Developer Connect Admin (roles/developerconnect.admin) di akun pengguna Anda.
  • Jika Anda berencana menggunakan CMEK untuk mengenkripsi secret yang dibuat Developer Connect: Cloud KMS CryptoKey Encrypter/Decrypter (roles/cloudkms.cryptoKeyEncrypterDecrypter) di Akun Layanan Secret Manager.
  • Jika Anda berencana menggunakan gcloud CLI untuk menyelesaikan langkah-langkah dalam panduan ini: Peran Secret Manager Admin (roles/secretmanager.admin) di Akun Layanan Developer Connect.
  • Jika Anda berencana menggunakan konsol Google Cloud untuk menyelesaikan langkah-langkah dalam panduan ini: Project IAM Admin (roles/resourcemanager.projectIamAdmin) di akun pengguna Anda.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat token akses

Untuk membuat token akses di GitLab, selesaikan langkah-langkah berikut:

  1. Login ke GitLab.

  2. Ikuti petunjuk dalam dokumentasi GitLab untuk membuat token akses pribadi, token akses grup, atau token akses project dengan izin berikut:

    • Satu token dengan cakupan api untuk menghubungkan dan berhenti menghubungkan repositori.
    • Satu token dengan cakupan read_api untuk mengizinkan Developer Connect membaca kode sumber di repositori Anda.
    • Untuk token akses grup dan token akses project, token harus memiliki peran Maintainer atau yang lebih tinggi.

Membuat koneksi

Bagian ini menjelaskan cara membuat koneksi antara Developer Connect dan GitLab. Jika menggunakan konsol Google Cloud , Anda juga dapat mulai menambahkan link ke repositori setelah selesai menyiapkan koneksi.

Untuk membuat koneksi GitLab baru, pilih salah satu opsi berikut:

Konsol

Mulai koneksi dengan menyelesaikan langkah-langkah berikut:

  1. Di konsol Google Cloud , buka Developer Connect.

    Buka Developer Connect

    Developer Connect menampilkan halaman Git repositories.

    • Jika Anda melihat daftar penyedia pengelolaan kode sumber: Mulai konfigurasikan koneksi pertama Anda dengan memilih penyedia pengelolaan kode sumber. Klik Connect di kartu GitLab.
    • Jika Anda melihat tabel yang mencantumkan koneksi yang ada: Tetapkan penyedia pengelolaan kode sumber dengan mengklik Create connection > GitLab.

      Halaman Create Connection akan terbuka.

  2. Untuk Region, pilih region untuk resource koneksi Anda.

    1. Untuk Name, masukkan nama untuk koneksi baru Anda.
  3. Di bagian Access Tokens, masukkan token untuk akun Anda:

    • Token akses API: Masukkan token akses dengan cakupan api.
    • Token akses Read API: Masukkan token akses dengan cakupan read_api.

    Anda bertanggung jawab untuk memastikan token GitLab Anda tetap valid. Token GitLab memiliki masa berlaku maksimum 365 hari, kecuali jika ditentukan lain oleh pembuat token atau administrator. Untuk mempelajari cara mengelola setelan masa berlaku token dan notifikasi, lihat dokumentasi GitLab tentang token akses pribadi, token akses grup, dan token akses project.

  4. Klik Tampilkan lainnya untuk melihat setelan konfigurasi opsional.

    1. Opsional: Di bagian Encryption, pilih kunci CMEK untuk mengenkripsi secret Secret Manager yang dibuat oleh Developer Connect.

    2. Opsional: Secara default, Developer Connect dapat bertindak sebagai proxy untuk panggilan Git ke GitLab. Untuk menonaktifkan opsi ini, hapus centang pada kotak Enable Developer Connect proxy.

  5. Klik Lanjutkan.

Setelah koneksi dibuat, halaman Link repositories akan muncul.

Selesaikan langkah-langkah berikut untuk menautkan repositori ke koneksi Anda:

  1. Dalam daftar repositori yang tersedia, pilih repositori yang ingin Anda gunakan.

  2. Klik Oke.

  3. Klik Tautkan.

Koneksi Anda ditambahkan ke halaman Connections dan link repositori Anda ditambahkan ke halaman Repositories di konsol Google Cloud . Anda dapat menambahkan lebih banyak link ke koneksi yang ada kapan saja.

Jika Anda menyiapkan Gemini Code Assist, lanjutkan prosesnya dengan mengikuti langkah-langkah di Mengonfigurasi dan menggunakan kustomisasi kode Gemini Code Assist.

gcloud

  1. Buat secret webhook di Secret Manager dengan menjalankan perintah berikut, dengan WEBHOOK_SECRET_NAME sebagai nama untuk secret webhook Anda:

         cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAME
    
  2. Simpan token akses Anda di Secret Manager dengan menjalankan perintah berikut:

    gcloud secrets create API_SECRET_NAME
    
    echo -n API_SECRET_DATA | gcloud secrets versions add API_SECRET_NAME --data-file=-
    
    gcloud secrets create READ_SECRET_NAME
    
    echo -n READ_SECRET_DATA | gcloud secrets versions add READ_SECRET_NAME --data-file=-
    

    Ganti kode berikut:

    • API_SECRET_NAME: nama untuk secret yang menyimpan token dengan cakupan api.
    • API_SECRET_DATA: token dengan cakupan api, mirip dengan glpat-XXXXXXXXXXXXXXXX.
    • READ_SECRET_NAME: nama untuk secret yang menyimpan token dengan cakupan read_api.
    • READ_SECRET_DATA: token dengan cakupan read_api, mirip dengan glpat-XXXXXXXXXXXXXXXX.
  3. Mulai koneksi ke akun GitLab Anda dengan menjalankan perintah developer-connect connections create:

    gcloud developer-connect connections create CONNECTION_NAME \
        --location=REGION \
        --gitlab-config-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/API_SECRET_NAME/versions/VERSION \
        --gitlab-config-read-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/READ_SECRET_NAME/versions/VERSION \
        --gitlab-config-webhook-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET_NAME/versions/VERSION \
        --git-proxy-config-enabled
    

    Ganti kode berikut:

    • CONNECTION_NAME: nama untuk koneksi Anda.
    • REGION: region untuk koneksi Anda.
    • PROJECT_NAME: project ID Anda Google Cloud.
    • API_SECRET_NAME: nama secret Secret Manager yang berisi token dengan cakupan api.
    • READ_SECRET_NAME: nama secret Secret Manager yang berisi token dengan cakupan read_api.
    • WEBHOOK_SECRET_NAME: nama secret Secret Manager yang berisi secret webhook Anda.
    • VERSION: nomor versi setiap secret. Ini dapat berupa latest untuk menggunakan nomor versi terbaru.
    • --git-proxy-config-enabled: flag opsional yang memungkinkan Developer Connect bertindak sebagai proxy untuk panggilan Git ke GitLab.

    Developer Connect menyelesaikan koneksi ke GitLab. Selanjutnya, tautkan ke repositori.

Setelah membuat koneksi ke GitLab, Anda dapat menautkan ke repositori. Anda dapat mengulangi langkah-langkah ini nanti untuk menautkan repositori tambahan sesuai kebutuhan.

Untuk membuat link repositori pada koneksi GitLab yang ada, pilih salah satu opsi berikut:

Konsol

Buat link ke repositori dengan menyelesaikan langkah-langkah berikut:

  1. Buka halaman Repositori di Google Cloud konsol.

    Buka halaman Repositories

  2. Klik Link repository.

    Panel Link Git repositories akan terbuka.

  3. Dalam daftar koneksi, pilih koneksi.

  4. Klik Lanjutkan.

  5. Dalam daftar repositori, pilih repositori yang ingin Anda tautkan.

    Developer Connect menampilkan nama yang disarankan untuk resource repositori Anda.

  6. Pilih opsi penamaan resource repositori:

    • Generated: Menggunakan nama resource repositori yang dihasilkan.
    • Manual: Masukkan nama Anda sendiri.
  7. Klik Create.

Developer Connect membuat link repositori dan menampilkannya di konsol Google Cloud .

gcloud

Tautkan ke repositori GitLab dengan menjalankan perintah berikut:

gcloud developer-connect connections git-repository-links create REPO_NAME \
    --clone-uri=REPO_URI \
    --connection=CONNECTION_NAME \
    --location=REGION

Ganti kode berikut:

  • REPO_NAME: nama untuk link repositori Anda.
  • REPO_URI: link ke repositori Anda, mirip dengan https://gitlab.com/my-project/test-repo.git.
  • CONNECTION_NAME: nama koneksi Anda.
  • REGION: region koneksi Anda.

Developer Connect akan membuat link repositori.

Untuk mencantumkan repositori tertaut, jalankan perintah developer-connect connections git-repository-links list.

Jika Anda menyiapkan Gemini Code Assist, lanjutkan prosesnya dengan mengikuti langkah-langkah di Mengonfigurasi dan menggunakan kustomisasi kode Gemini Code Assist.

Langkah berikutnya