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: |
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: 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: |
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:
|
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 kolomdigest
, 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:
|
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. |