Jenis Build: Google Builder

Halaman ini menjelaskan definisi Jenis Build SLSA V1.0 untuk Google Builder.

Parameter eksternal

Tabel berikut menampilkan jenis parameter eksternal yang dapat digunakan dalam definisi Workflow PipelineRun dan Workflow TaskRun. Kecuali jika dinyatakan lain, semua parameter diperlukan.

Kolom Jenis Detail

runSpec

objek

Spesifikasi PipelineRun lengkap.

buildConfigSource

objek

Spesifikasi buildConfigSource lengkap.

Spesifikasi PipelineRun

Kolom Jenis Detail

pipelineRef/taskRef

objek

Tempat pipelineSpec/taskSpec dibaca.

Kolom ini hanya diisi jika pipelineSpec direferensikan dari sumber jarak jauh.

Default: null

pipelineSpec/taskSpec

objek

Spesifikasi Pipeline/Tugas yang Disisipkan, tidak diambil dari sumber jarak jauh menggunakan pipelineRef/taskRef.

[Opsional].

params

[object]

Peta nama dan nilai parameter yang disediakan ke Pipeline. Nilai dapat berupa string, array, atau jenis objek.

Default: null

Catatan: Jika alur kerja dipicu, kolom ini juga akan berisi beberapa parameter yang disediakan oleh sistem pemicu Cloud Build selain parameter yang dikonfigurasi oleh pengguna dalam definisi alur kerja.

ruang kerja

[object]

Ruang kerja menyimpan kumpulan binding ruang kerja yang harus cocok dengan nama yang dideklarasikan dalam pipeline.

Default: null

waktu tunggu habis/waktu tunggu

objek

Waktu setelah waktu tunggu pipeline habis. Waktu tunggu dapat ditentukan untuk Pipeline, Tugas, dan Akhirnya. Keduanya terkait dengan formula Timeouts.pipeline Timeouts.tasks + Timeouts.finally.

Spesifikasi buildConfigSource

Kolom Jenis Detail

ref

objek

Dapat berupa salah satu dari hal berikut:

  • Referensi git. Misalnya, sha commit: sha1:563f0...
  • Ringkasan image. Contoh: sha256:91fbe...

repositori

string

URI repositori git, atau URI repositori image

jalur

string

Jalur di repositori git, atau nama resource dalam paket gambar.

Parameter internal

Parameter internal disediakan oleh builder untuk proses build.

Kolom Jenis Detail
tekton-pipelines-feature-flags objek Flag fitur konfigurasi Tekton yang digunakan untuk build. Ini dikonfigurasi oleh builder dan berguna untuk reproduksi.
systemParameters objek Daftar pasangan nama dan nilai untuk penggantian sistem default yang disediakan oleh GCB.

Dependensi yang di-resolve

Kolom resolvedDependencies harus berisi entri yang mengidentifikasi referensi yang di-resolve yang sesuai dengan externalParameters.configRef. Ini adalah referensi ke Pipeline, jika spesifikasi PipelineRun, atau referensi ke Tugas, jika spesifikasi TaskRun.

Dependensi yang di-resolve dapat berisi artefak tambahan yang merupakan input untuk build, menggunakan kolom name untuk menunjukkan jenis artefak:

  • Untuk Pipeline jarak jauh, gunakan name: pipeline.
  • Untuk Tasks jarak jauh, gunakan name: pipelineTask.
  • Untuk referensi yang di-resolve ke Langkah atau image penampung file bantuan, kolom name bersifat opsional. Untuk kolom digest, meskipun gambar direferensikan oleh tag, ringkasan gambar harus disertakan.
  • Untuk artefak input lain yang digunakan untuk build, seperti kode sumber, gunakan name: inputs/result. Petunjuk jenis digunakan untuk hasil Tugas.

Contoh berikut berisi informasi tentang semua jenis dependensi yang di-resolve:

"resolvedDependencies": [
  {
    "name": "pipeline",
    "uri": "git+https://github.com/octocat/hello-world.git",
    "digest": {"sha1": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d"},
  },
  {
  "name": "pipelineTask",
  "uri": "git+https://github.com/octocat/hello-world.git",
  "digest": {"sha1": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d"},
  },
  {
  "uri": "gcr.io/tekton-releases/github.com/tektoncd/pipeline/cmd/git-init",
  "digest": {
    "sha256": "28ff94e63e4058afc3f15b4c11c08cf3b54fa91faa646a4bbac90380cd7158df"},
  },
  {
  "name": "inputs/result",
  "uri": "git+https://github.com/octocat/hello-world.git",
  "digest": {"sha1": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d"},
  }
]

RunDetails

Kolom Detail
builder Berisi subkolom id yang mengidentifikasi platform build yang mengeksekusi operasi dan mengisi asal ini. Ini juga berisi tingkat SLSA. Nilai id yang diharapkan adalah salah satu dari berikut:
  • https://cloudbuild.googleapis.com/GoogleBuilder. ID builder ini menunjukkan build SLSA L2.
  • https://cloudbuild.googleapis.com/GoogleIsolatedBuilder. ID builder ini menunjukkan build SLSA L3.
metadata Metadata tambahan tentang eksekusi build tertentu ini. invocationId menampilkan URL build, seperti https://cloudbuild.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/pipelineRuns/BUILD_ID.
Kolom startedOn dan finishedOn berisi stempel waktu saat build dimulai dan selesai.
produk sampingan Objek results.
Berisi TaskRunResults yang dihasilkan oleh PipelineRun. Konten tersebut dienkode dalam Base64.