REST Resource: projects.locations.backends.builds

Resource: Build

Build tunggal untuk backend, pada tag referensi codebase titik tertentu, dan pada waktu tertentu. Mengenkapsulasi beberapa resource, termasuk image container Artifact Registry, pemanggilan Cloud Build yang membuat image, dan revisi Cloud Run yang menggunakan image tersebut.

Representasi JSON 
{
  "name": string,
  "displayName": string,
  "state": enum (State),
  "error": {
    object (Status)
  },
  "environment": string,
  "config": {
    object (Config)
  },
  "image": string,
  "source": {
    object (BuildSource)
  },
  "buildLogsUri": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
Kolom
name

string

ID. Nama resource build.

Format:

projects/{project}/locations/{locationId}/backends/{backendId}/builds/{buildId}.
displayName

string

Opsional. Nama yang dapat dibaca manusia. Maksimal 63 karakter.
state

enum (State)

Hanya output. Status build.
error

object (Status)

Hanya output. Pesan error status dan (dapat dibaca manusia) untuk build, jika dalam status FAILED.
environment

string

Hanya output. Nama lingkungan backend saat build ini dibuat.
config

object (Config)

Opsional. Konfigurasi tambahan layanan.
image

string

Hanya output. URI image container Artifact Registry, yang digunakan oleh Cloud Run revision untuk build ini.
source

object (BuildSource)

Wajib diisi. Tidak dapat diubah. Sumber build.
buildLogsUri

string

Hanya output. Lokasi Log Cloud Build untuk proses build.
reconciling

boolean

Hanya output. Kolom yang, jika benar, menunjukkan bahwa build memiliki LRO yang sedang berlangsung.
createTime

string (Timestamp format)

Hanya output. Waktu build dibuat.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Hanya output. Waktu saat build terakhir diperbarui.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

Hanya output. Waktu saat build dihapus.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Opsional. Peta nilai kunci tidak terstruktur yang dapat digunakan untuk mengatur dan mengategorikan objek.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Opsional. Peta nilai kunci tidak terstruktur yang dapat ditetapkan oleh alat eksternal untuk menyimpan dan metadata arbitrer. Objek tersebut tidak dapat dikueri dan harus dipertahankan saat memodifikasi objek.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Hanya output. ID unik yang ditetapkan oleh sistem.
etag

string

Hanya output. Checksum yang dihitung oleh server berdasarkan nilai lain; mungkin dikirim saat pembaruan atau penghapusan untuk memastikan operasi dilakukan pada resource yang diharapkan.

Negara Bagian

Status build.

Enum
STATE_UNSPECIFIED Build dalam status tidak diketahui.
BUILDING Build sedang dibangun.
BUILT Build telah selesai dan menunggu langkah berikutnya. Tindakan ini mungkin akan dipindahkan ke DEPLOYING setelah App Hosting mulai menyiapkan infrastruktur.
DEPLOYING Infrastruktur untuk build ini sedang disiapkan.
READY Infrastruktur untuk build ini sudah siap. Build mungkin melayani atau tidak melayani traffic - lihat Backend.traffic untuk status saat ini, atau Backend.traffic_statuses untuk status yang diinginkan.
FAILED Build gagal.

Konfigurasi

Konfigurasi tambahan backend untuk build ini.

Representasi JSON 
{
  "runConfig": {
    object (RunConfig)
  }
}
Kolom
runConfig

object (RunConfig)

Opsional. Konfigurasi tambahan Cloud Run service.

{i>RunConfig

Konfigurasi tambahan untuk diterapkan ke Cloud Run service.

Representasi JSON 
{
  "cpu": number,
  "memoryMib": integer,
  "concurrency": integer,
  "maxInstances": integer,
  "minInstances": integer
}
Kolom
cpu

number

Opsional. Jumlah CPU yang digunakan untuk setiap instance penayangan.

Secara default, cpu ditetapkan secara default ke nilai default 1.0 Cloud Run.

CPU dapat diatur ke nilai 1, 2, 4, 6, atau 8 CPU, dan untuk kurang dari 1 CPU, nilai dari 0,08 hingga kurang dari 1,00, dengan kelipatan 0,01.

Jika menetapkan nilai kurang dari 1 CPU, Anda harus menetapkan konkurensi ke 1, dan CPU hanya akan dialokasikan selama pemrosesan permintaan.

Peningkatan batas CPU mungkin memerlukan peningkatan batas memori:

  • 4 CPU: minimal 2 GiB
  • 6 CPU: minimal 4 GiB
  • 8 CPU: minimal 4 GiB
memoryMib

integer

Opsional. Jumlah memori yang dialokasikan untuk setiap instance inferensi dalam MiB.

Secara default, memori ditetapkan secara default ke setelan default Cloud Run, dengan setiap instance diberi alokasi memori sebesar 512 MiB.

Memori dapat disetel ke nilai bilangan bulat apa pun antara 128 hingga 32768.

Peningkatan batas memori mungkin memerlukan peningkatan batas CPU:

  • Lebih dari 4 GiB: minimal 2 CPU
  • Di atas 8 GiB: setidaknya 4 CPU
  • Di atas 16 GiB: minimal 6 CPU
  • Di atas 24 GiB: setidaknya 8 CPU
concurrency

integer

Opsional. Jumlah permintaan maksimum yang dapat diterima setiap instance Cloud Run.

Secara default, setiap instance dapat menerima default Cloud Run hingga 80 permintaan sekaligus.

Konkurensi dapat ditetapkan ke nilai bilangan bulat apa pun hingga 1.000.
maxInstances

integer

Opsional. Jumlah instance Cloud Run yang akan dipertahankan secara maksimum untuk setiap revisi.

Secara default, setiap Cloud Run service diskalakan ke default Cloud Run dengan maksimum 100 instance. Batas maxInstances maksimum didasarkan pada kuota Anda. Lihat https://cloud.google.com/run/docs/configure/max-instances#limits.
minInstances

integer

Opsional. Jumlah instance Cloud Run yang akan dipertahankan minimal untuk setiap Layanan Cloud Run.

Secara default, tidak ada batas minimum.

Meskipun layanan tersebut membagi traffic ke beberapa revisi, jumlah total instance untuk layanan akan dibatasi pada nilai ini.

Sumber Build

Sumber build.

Representasi JSON 
{

  // Union field source can be only one of the following:
  "codebase": {
    object (CodebaseSource)
  },
  "container": {
    object (ContainerSource)
  }
  // End of list of possible types for union field source.
}
Kolom
Kolom union source. Sumber input untuk build. Biasanya akan merujuk commit dalam repositori sumber. Juga dapat merujuk ke image container. source hanya ada berupa salah satu diantara berikut:
codebase

object (CodebaseSource)

Sumber codebase.
container

object (ContainerSource)

Sumber image container Artifact Registry.

{i>CodebaseSource<i}

Sumber codebase, yang mewakili status codebase tempat build akan dibuat.

Representasi JSON 
{
  "displayName": string,
  "hash": string,
  "commitMessage": string,
  "uri": string,
  "author": {
    object (UserMetadata)
  },
  "commitTime": string,

  // Union field reference can be only one of the following:
  "branch": string,
  "commit": string
  // End of list of possible types for union field reference.
}
Kolom
displayName

string

Hanya output. Nama yang mudah digunakan untuk Codebase ini saat menampilkan build. Kita menggunakan delapan karakter pertama dari {i>hash<i} SHA-1 untuk GitHub.com.
hash

string

Hanya output. Hash SHA-1 lengkap dari commit Git, jika tersedia.
commitMessage

string

Hanya output. Pesan perubahan codebase.
uri

string

Hanya output. URI yang tertaut ke codebase di situs penyedia hosting. Mungkin tidak valid jika commit telah berbasis ulang atau dihapus secara paksa di repositori tertaut.
author

object (UserMetadata)

Hanya output. Penulis yang terdapat dalam metadata perubahan kontrol versi.
commitTime

string (Timestamp format)

Hanya output. Waktu saat perubahan dilakukan.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

Kolom union reference.

reference hanya dapat berupa salah satu dari yang berikut:
branch

string

Cabang dalam codebase yang akan di-build, menggunakan commit terbaru.
commit

string

Commit di codebase untuk membangun.

UserMetadata

Metadata kontrol versi untuk pengguna yang terkait dengan codebase yang telah diselesaikan. Saat ini mengasumsikan sebagai pengguna Git.

Representasi JSON 
{
  "displayName": string,
  "email": string,
  "imageUri": string
}
Kolom
displayName

string

Hanya output. 'Nama' di git.config pengguna Git. Diwajibkan oleh Git.
email

string

Hanya output. 'Email' di git.config pengguna Git, jika tersedia.
imageUri

string

Hanya output. URI file gambar yang terkait dengan akun pengguna di penyedia kontrol sumber eksternal, jika tersedia.

SumberContainer

URI image container Artifact Registry yang akan digunakan sebagai sumber build.

Representasi JSON 
{
  "image": string
}
Kolom
image

string

Wajib diisi. URI yang mewakili container untuk digunakan backend.

Metode

create

 Membuat build baru untuk backend.

delete

 Menghapus satu build.

get

 Mendapatkan informasi tentang build.

list

 Mencantumkan build di project, lokasi, dan backend tertentu.