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.