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 yang lengkap.
buildConfigSource	objek	Spesifikasi buildConfigSource yang 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 In-line, tidak diambil dari sumber jarak jauh menggunakan pipelineRef/taskRef. [Opsional].
params	[objek]	Peta nama dan nilai parameter yang diberikan ke Pipeline. Nilai dapat berupa string, array, atau jenis objek. Default: null Catatan: Jika terjadi alur kerja yang 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	[objek]	Ruang kerja menyimpan kumpulan binding ruang kerja yang harus cocok dengan nama yang dideklarasikan dalam pipeline. Default: null
waktu tunggu habis	objek	Waktu hingga waktu tunggu pipeline habis. Waktu tunggu dapat ditentukan untuk Pipeline, Tasks, dan Akhirnya. Kedua class tersebut dikaitkan dengan formula Timeouts.pipeline Timeouts.tasks + Timeouts.finally.

Spesifikasi buildConfigSource

Kolom	Jenis	Detail
referensi	objek	Dapat berupa salah satu dari hal berikut: Referensi git. Misalnya, commit sha: sha1:563f0... Ringkasan gambar. Contoh: sha256:91fbe...
repositori	string	URI repositori git, atau URI repositori gambar
jalur	string	Jalur di repositori git, atau nama resource dalam paket image.

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. Class ini dikonfigurasi oleh builder dan berguna untuk reproduksi.

Menyelesaikan dependensi

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

Dependensi yang di-resolve mungkin 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 image container Langkah atau 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 menjalankan operasi dan mengisi provenance ini. Objek ini juga berisi level SLSA. Nilai id yang diharapkan adalah salah satu dari yang 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 khusus 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 samping	Objek results. Berisi TaskRunResults yang dihasilkan oleh PipelineRun. Konten dienkode dalam Base64.