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 Anda. 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 berkaitan dengan repo sumber yang memicu build (build yang dipicu peristiwa SCM) atau `gitFileSource` untuk semua jenis pemicu lainnya. `buildConfigSource` ATAU `buildConfig` (dalam kasus 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 (heks 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 mengetahui informasi selengkapnya tentang persyaratan format, lihat ResourceURI.
buildConfigSource.path	string	Jalur ke file konfigurasi build dalam commit. Contoh: `cloudbuild.yaml` Sangat eksklusif dengan pathAutodetect. Salah satu kolom ini harus ditetapkan ke nilai non-default.
buildConfigSource.pathAutoDetect	boolean	Jika benar, `path` akan otomatis dideteksi, yang sesuai dengan opsi deteksi otomatis di `BuildTrigger`. False dianggap setara dengan tidak ditetapkan; Cloud Build akan menggunakan `path` jika deteksi otomatis tidak diaktifkan. Sangat eksklusif dengan `path`. Tepat satu dari kolom ini HARUS ditetapkan ke nilai non-default.
sourceToBuild	objek	Kode sumber yang telah diperiksa dan dibuat. Biasanya ini sama dengan `buildConfigSource`; tetapi hanya berbeda jika BuildTrigger telah menetapkan `gitFileSource`. Kolom ini tidak ada jika `repository` dan `ref` sama dengan `buildConfigSource` dan `dir` kosong. Dalam BuildTrigger, ini berkaitan dengan `sourceToBuild` atau commit yang memicu build, bergantung pada jenis pemicunya.
sourceToBuild.ref	string	Referensi Git dalam `sourceToBuild.repository` yang di-check out, sebagai referensi 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 diperiksa, dengan protokol `https://`. Atribut ini akan diawali dengan `git+`.
sourceToBuild.dir	string	Direktori dalam commit tempat build akan dijalankan, tanpa garis miring di akhir. Boleh kosong, tidak disetel.
buildConfig	string	Saat konfigurasi build inline disediakan, seperti dalam build yang dikirim secara manual, informasi berikut dicatat. - langkah - opsi build (misalnya variabel lingkungan, volume, detail kumpulan pekerja, machineType, detail log) - substitusi 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 serial berenkode base64.
substitusi	peta<string,string></string,string>	Peta (string -> string) yang berisi substitusi yang akan dilakukan pada resource Build. Data ini hanya berisi substitusi "runtime" atau "independen" yang tidak tercatat dalam konfigurasi build, yaitu diteruskan dari pemicu atau flag gcloud CLI. Data ini tidak menyertakan substitusi default yang disediakan sistem karena dianggap `internalParameters`. Substitusi muncul di kolom ini terlepas dari apakah substitusi 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 penggantian default.

Kolom	Detail
triggerUri	URI resource dari pemicu yang memanggil build ini, dalam hal ini nama resource lengkap. Jika build tidak dipicu, build akan dihilangkan.
systemSubstitutions	Ada subset nilai substitusi default yang otomatis disediakan dalam build Cloud Build, seperti `PROJECT_ID`, `BUILD_ID`. Jika Anda menimpa salah satu substitusi default Cloud Build, substitusi Anda tidak akan ditampilkan di sini. Nilai Anda akan dicantumkan dalam `externalParameters.substitutions`.

Menyelesaikan dependensi

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

ResolvedDependencies sesuai dengan spesifikasi ResourceDescriptor.

Jenis dependensi	Detail
Repositori konfigurasi build	Repo tempat konfigurasi build (yaitu `cloudbuild.yaml`) ditarik, dalam kasus build yang dipicu. Kolom ini mungkin kosong jika ada konfigurasi build yang tidak dibaca dari repo dan disediakan secara inline, yang dalam hal ini akan dihilangkan.
Repositori sumber	Repo tempat kode sumber yang akan di-build diambil. Status ini bisa sama dengan `buildConfigSource`, atau berbeda. Jika sama dengan `buildConfigSource`, `sourceToBuild` 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 provenance ini. Paket ini juga berisi level SLSA. Nilai `id` yang diharapkan adalah `https://cloudbuild.googleapis.com/GoogleHostedWorker`.
metadata	Metadata tambahan tentang eksekusi khusus build 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 memuat artefak tambahan yang tidak dianggap sebagai output build, tetapi mungkin berguna untuk pemecahan masalah atau respons insiden.
systemSubstitutions	Ada subset nilai substitusi default yang otomatis disediakan dalam build Cloud Build, seperti `PROJECT_ID`, `BUILD_ID`. Jika Anda menimpa salah satu substitusi default Cloud Build, substitusi Anda tidak akan ditampilkan di sini. Nilai Anda akan dicantumkan dalam `externalParameters.substitutions`.