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: |
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: 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: |
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:
|
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 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
menjalankan operasi dan mengisi provenance ini. Objek ini juga berisi
level SLSA. Nilai id yang diharapkan adalah salah satu dari yang berikut:
|
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. |