Jenis Build: Build Cloud Build v1

Halaman ini menjelaskan Jenis Build untuk Cloud Build.

Definisi build

Parameter eksternal

Tabel berikut menampilkan jenis parameter eksternal yang dapat digunakan dalam build Cloud Build. Parameter eksternal adalah nilai yang Anda tentukan, dan tidak ada dalam konfigurasi build. Hal ini mencakup parameter pemicu yang tidak ada dalam file cloudbuild.yaml Anda.

Kolom Jenis Detail
buildConfigSource objek Lokasi tempat konfigurasi build dibaca.

Di BuildTrigger, ini sesuai dengan repo sumber yang memicu build (build yang dipicu peristiwa SCM) atau gitFileSource untuk semua jenis pemicu lainnya.

buildConfigSource ATAU buildConfig (dalam hal konfigurasi build inline) akan ditetapkan.
buildConfigSource.ref string Referensi Git dalam buildConfigSource.repository tempat konfigurasi dibaca, baik sebagai ref git yang sepenuhnya memenuhi syarat (dimulai dengan refs/) atau SHA commit (hex huruf kecil). SHA commit hanya digunakan jika ditentukan dalam pemicu.
buildConfigSource.repository string URI HTTPS repositori git yang berisi file konfigurasi build, dengan protokol https://. Ini akan diawali dengan git+ untuk kompatibilitas dengan format SPDX. Untuk informasi selengkapnya tentang persyaratan format, lihat ResourceURI.
buildConfigSource.path string Jalur ke file konfigurasi build dalam commit. Contoh: cloudbuild.yaml

Tidak dapat muncul bersamaan dengan pathAutodetect. Tepat satu dari kolom ini harus ditetapkan ke nilai non-default.
buildConfigSource.pathAutoDetect boolean Jika benar, path terdeteksi secara otomatis, yang sesuai dengan opsi deteksi otomatis di BuildTrigger. Salah dianggap setara dengan tidak ditetapkan; Cloud Build akan menggunakan path jika deteksi otomatis tidak diaktifkan.

Tidak dapat muncul bersamaan dengan path. Tepat satu dari kolom ini HARUS ditetapkan ke nilai non-default.
sourceToBuild objek Kode sumber yang diperiksa dan di-build. Biasanya ini sama dengan buildConfigSource; hanya berbeda jika BuildTrigger telah menetapkan gitFileSource.

Kolom ini tidak ada jika repository dan ref sama dengan buildConfigSource dan dir kosong.

Di BuildTrigger, ini sesuai dengan sourceToBuild atau commit yang memicu build, bergantung pada jenis pemicu.
sourceToBuild.ref string Referensi Git dalam sourceToBuild.repository yang di-check out, baik sebagai ref git yang sepenuhnya memenuhi syarat (dimulai dengan refs/) atau SHA commit (hex huruf kecil). SHA commit hanya digunakan jika ditentukan dalam pemicu.
sourceToBuild.repository string URI HTTPS repositori git yang di-check out, dengan protokol https://. Ini akan diawali dengan git+.
sourceToBuild.dir string Direktori dalam commit tempat menjalankan build, tanpa garis miring di akhir. Dapat kosong, tidak ditetapkan.
buildConfig string Jika konfigurasi build inline disediakan, seperti dalam build yang dikirimkan secara manual, informasi berikut akan dicatat.

- langkah
- opsi build (misalnya, variabel lingkungan, volume, detail kumpulan pekerja, machineType, detail log)
- penggantian

Jika konfigurasi build dibaca dari repositori, konfigurasi tersebut akan dicatat di bagian buildConfigSource dan konfigurasi build inline akan dihilangkan.

Informasi ini disimpan sebagai string JSON serialisasi yang dienkode base64.
penggantian map<string,string></string,string> Peta (string -> string) yang berisi penggantian yang akan dilakukan pada resource Build.

Ini hanya berisi penggantian "runtime" atau "independen" yang tidak dicatat dalam konfigurasi build, yaitu diteruskan dari pemicu atau flag gcloud CLI.

Data ini tidak menyertakan penggantian default yang disediakan sistem karena dianggap sebagai internalParameters.

Penggantian muncul di kolom ini, terlepas dari apakah kolom tersebut direferensikan atau digunakan dalam konfigurasi build.

Parameter internal

Tabel berikut menampilkan parameter internal yang ditetapkan Cloud Build untuk build, kecuali jika Anda menimpanya. Untuk mengetahui informasi selengkapnya, lihat substitusi default.

Kolom Detail
triggerUri URI resource pemicu yang memanggil build ini, dalam hal ini nama resource lengkap.

Jika build tidak dipicu, bagian ini akan dihilangkan.
systemSubstitutions Ada subkumpulan nilai penggantian default yang otomatis disediakan dalam build Cloud Build, seperti PROJECT_ID, BUILD_ID.

Jika Anda menimpa salah satu penggantian default Cloud Build, penggantian Anda tidak akan ditampilkan di sini. Nilai Anda akan dicantumkan di externalParameters.substitutions.

Dependensi yang di-resolve

Jika build memiliki repositori sumber atau repositori konfigurasi build, repositori akan dijelaskan di bagian resolvedDependencies BuildDefinition.

ResolvedDependencies sesuai dengan spesifikasi ResourceDescriptor.


Jenis dependensi
Detail

Mem-build repositori konfigurasi
Repo tempat konfigurasi build (yaitu cloudbuild.yaml) ditarik, dalam kasus build yang dipicu.


Kolom ini mungkin kosong jika konfigurasi build tidak dibaca dari repo dan disediakan secara inline, dalam hal ini kolom tersebut akan dihilangkan.

Repositori sumber
Repo tempat kode sumber yang akan di-build diambil. Nilai ini dapat sama dengan buildConfigSource, atau berbeda. Jika sama dengan buildConfigSource, sourceToBuild akan dihilangkan, misalnya, dalam build yang dipicu SCM.

sourceToBuild mungkin kosong jika build dijalankan melalui –no-source, dan akan dihilangkan.

Misalnya, info resolvedDependencies berikut berisi buildConfigRepo dan sourceRepo (yang sama), serta gambar langkah build.

"resolvedDependencies": [
{
    "uri": "git+https://github.com/octocat/hello-world.git",
    "digest": {"sha1": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d"}
}, {
    "uri": "gcr.io/cloud-builders/git",
    "digest": {
        "sha256": "28ff94e63e4058afc3f15b4c11c08cf3b54fa91faa646a4bba7158df"}
    }
]

RunDetails

Kolom Detail
builder Berisi subkolom id yang mengidentifikasi platform build yang menjalankan operasi dan mengisi asal ini. Ini juga berisi tingkat SLSA. Nilai id yang diharapkan adalah https://cloudbuild.googleapis.com/GoogleHostedWorker.
metadata Metadata tambahan tentang eksekusi build tertentu ini. invocationId menampilkan URL build, seperti https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/builds/BUILD_ID.
Kolom startedOn dan finishedOn berisi stempel waktu saat build dimulai dan selesai.
produk sampingan Belum digunakan. Dirancang untuk berisi artefak tambahan yang tidak dianggap sebagai output build, tetapi mungkin berguna untuk pemecahan masalah atau respons insiden.
systemSubstitutions Ada subkumpulan nilai penggantian default yang otomatis disediakan dalam build Cloud Build, seperti PROJECT_ID, BUILD_ID.

Jika Anda menimpa salah satu penggantian default Cloud Build, penggantian Anda tidak akan ditampilkan di sini. Nilai Anda akan dicantumkan di externalParameters.substitutions.