Mengelola dependensi build

Halaman ini menjelaskan cara menentukan dependensi build. Cloud Build memungkinkan Anda mengelola dependensi kode sumber secara terpisah dari proses build.

Dalam file konfigurasi build, Anda dapat mencantumkan satu atau beberapa repositori untuk di-clone untuk build Anda, dan urutan pengambilan repositori tersebut. Menentukan dependensi dengan cara ini akan memisahkan pengambilan dependensi dari proses build itu sendiri.

Jika Anda tidak menyertakan dependensi apa pun dalam file konfigurasi build, Cloud Build akan meng-clone repositori kode sumber yang berisi file konfigurasi build Anda (untuk build yang dipicu) atau repositori yang berisi kode sumber Anda (untuk build yang Anda panggil dari command line). Jika Anda menyertakan dependensi dalam file konfigurasi build, Cloud Build hanya akan meng-clone repositori yang ditentukan di kolom dependencies.

Dependensi di-clone dalam urutan yang Anda tentukan. Selain itu, pengambilan dependensi terjadi sebelum logika yang ditentukan pengguna dijalankan. Dengan demikian, pengambilan dependensi dapat dipercaya.

Dependensi ditampilkan di tab Build dependencies pada halaman Build details.

Sebelum memulai

Petunjuk di halaman ini mengasumsikan bahwa Anda memiliki setidaknya salah satu dari dua jenis repositori berikut:

  • Repositori Git yang merupakan repositori publik atau ditautkan ke Cloud Build menggunakan Developer Connect.

  • Repositori umum.

Untuk memastikan memiliki izin yang diperlukan untuk menambahkan repositori Developer Connect sebagai dependensi, minta administrator untuk memberikan peran IAM Developer Connect Read Token Accessor (developerconnect.readTokenAccessor) kepada di akun layanan Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Menentukan dependensi

Anda menentukan dependensi dengan menambahkan kolom dependencies ke file konfigurasi build. dependencies adalah properti tingkat atas dalam konfigurasi build, tetapi Anda dapat menempatkannya di mana saja dalam file.

Menentukan dependensi GitHub

Untuk menentukan dependensi pada repositori GitHub, tambahkan konfigurasi dependencies berikut ke file konfigurasi build Anda:

YAML 

 dependencies:
 - gitSource:
     repository:
       url: 'URL'
       developerConnect: 'DC_RESOURCE_PATH'
     revision: 'REVISION'
     recurseSubmodules: 'true|false'
     depth: 'DEPTH'
     destPath: 'DEST_PATH'

JSON 

 {
     "dependencies": {
         "gitSource": {
             "repository": {
                 "url": "URL"
                 "developerConnect": "DC_RESOURCE_PATH"
             },
             "revision": "REVISION",
             "recurseSubmodules": true|false,
             "depth": "DEPTH",
             "destPath": "DEST_PATH",
         },
     },
 }

Ganti nilai berikut:

  • URL: URL HTTPS repositori yang akan diambil. Wajib diisi kecuali jika repositori Anda terhubung ke Cloud Build menggunakan Developer Connect.

  • DC_RESOURCE_PATH: Jalur resource ke repositori Developer Connect. Google Cloud Misalnya, projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo. Wajib diisi jika repositori Anda terhubung ke Cloud Build menggunakan Developer Connect.

    Jika repositori Anda terhubung menggunakan Developer Connect, Anda memerlukan hal berikut:

  • REVISION: Wajib diisi. Nama versi, hash commit, tag, atau cabang yang akan diambil dari repositori.

  • recurseSubmodules: 'true|false': Apakah akan mengambil submodule.

  • DEPTH: Opsional, seberapa dalam histori repositori yang akan diambil. Jika tidak ditentukan, commit terbaru akan diambil.

    • 1: commit terbaru
    • 2: dua commit terakhir
    • 3: tiga commit terakhir
    • -1: semua commit

  • DEST_PATH: Wajib diisi. Jalur ke direktori tempat repositori di-clone. Misalnya, my/repo.

    Saat Anda menetapkan dest_path, repositori akan diambil di /workspace/<dest_path>. Nilai dest_path harus berupa jalur relatif terhadap direktori kerja build.

Menentukan artefak umum sebagai dependensi

Untuk menentukan artefak umum sebagai dependensi, tambahkan konfigurasi berikut ke file konfigurasi build Anda:dependencies

YAML 

dependencies:
- genericArtifact:
    resource: RESOURCE
    destPath: PATH

JSON 

{
  "dependencies": [
    {
      "genericArtifact": {
        "resource": "RESOURCE",
        "destPath": "PATH"
      }
    }
  ]
}

Dengan:

  • RESOURCE adalah alamat lengkap artefak umum dalam repositori umum Artifact Registry Anda, yang diformat sebagai berikut:

    projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/packages/PACKAGE/versions/VERSION

    Sebaiknya sertakan sidik jari artefak Anda dalam alamat resource agar Cloud Build dapat memverifikasi bahwa referensi artefak tidak dapat diubah. Versi paket dengan sidik jari yang ditambahkan diformat sebagai berikut:

    VERSION@dirsum_sha256=HASH_VALUE

    Untuk menemukan sidik jari artefak di repositori Artifact Registry, lihat Mengambil sidik jari versi paket di repositori Anda.

  • PATH adalah alamat ke folder tempat Cloud Build mendownload paket dari repositori Anda. Jika folder belum ada, Cloud Build akan membuatnya secara otomatis.

Langkah berikutnya