資源:版本
一個建構於特定點碼集參考標記與時間點的後端單一版本。封裝多項資源,包括 Artifact Registry 容器映像檔、建構該映像檔的 Cloud Build 叫用,以及使用該映像檔的 Cloud Run 修訂版本。
JSON 表示法 |
---|
{ "name": string, "displayName": string, "state": enum ( |
欄位 | |
---|---|
name |
ID。建構作業的資源名稱。 格式:
|
displayName |
選用設定。人類可讀的名稱。長度上限為 63 個半形字元。 |
state |
僅供輸出。建構狀態。 |
error |
僅供輸出。建構的狀態和 (人類可讀) 錯誤訊息 (處於 |
environment |
僅供輸出。建立這項建構作業時的後端環境名稱。 |
config |
選用設定。服務的其他設定。 |
image |
僅供輸出。Cloud Run |
source |
執行個體類型,不可變動。建構作業的原始碼。 |
buildLogsUri |
僅供輸出。建構程序的 Cloud Build 記錄檔位置。 |
reconciling |
僅供輸出。如果欄位為 true,表示建構作業有進行中的 LRO。 |
createTime |
僅供輸出。建立版本的時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
updateTime |
僅供輸出。上次更新時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
deleteTime |
僅供輸出。刪除建構作業的時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
labels |
選用設定。可用於整理物件及分類物件的非結構化鍵/值對應。 包含 |
annotations |
選用設定。非結構化鍵/值對應,可由外部工具設定,用於儲存和任意中繼資料。無法查詢,且在修改物件時應保留下來。 包含 |
uid |
僅供輸出。系統指派的專屬 ID。 |
etag |
僅供輸出。以其他值為基礎的伺服器運算總和檢查碼;更新或刪除時可能傳送,以確保作業會在預期的資源上完成。 |
狀態
建構狀態。
列舉 | |
---|---|
STATE_UNSPECIFIED |
建構作業處於不明狀態。 |
BUILDING |
版本正在建構中。 |
BUILT |
建構作業已完成,正在等待下一個步驟。App Hosting 開始設定基礎架構後,這可能會移至 DEPLOYING。 |
DEPLOYING |
正在設定這項建構作業的基礎架構。 |
READY |
這個版本的基礎架構已準備就緒。建構作業不一定能處理流量 - 請查看 Backend.traffic 瞭解目前狀態,或查看 Backend.traffic_statuses 代表所需狀態。 |
FAILED |
建構作業失敗。 |
設定
此建構作業的後端其他設定。
JSON 表示法 |
---|
{
"runConfig": {
object ( |
執行設定
要套用至 Cloud Run service
的其他設定。
JSON 表示法 |
---|
{ "cpu": number, "memoryMib": integer, "concurrency": integer, "maxInstances": integer, "minInstances": integer } |
欄位 | |
---|---|
cpu |
選用設定。每個服務執行個體使用的 CPU 數量。 CPU 預設使用 Cloud Run 的預設值 1.0。 CPU 可設為值 1、2、4、6 或 8。如果 CPU 數量小於 1 個,可用值介於 0.08 至 1.00 之間,以 0.01 為單位遞增。 如果設為小於 1 CPU,必須將並行設為 1,且系統只會在要求處理期間分配 CPU。 提高 CPU 限制可能會增加記憶體限制:
|
memoryMib |
選用設定。分配給 MiB 中每個服務執行個體的記憶體量。 根據預設,記憶體預設為 Cloud Run 的預設分配方式,也就是每個執行個體分配 512 MiB 的記憶體。 記憶體可設為介於 128 至 32768 之間的任何整數值。 提高記憶體限制可能會增加 CPU 限制:
|
concurrency |
選用設定。每個 Cloud Run 執行個體可以接收的要求數量上限。 根據預設,每個執行個體一次最多可以接收 80 個 Cloud Run 要求。 並行可設為任何整數值,上限為 1000。 |
maxInstances |
選用設定。每個修訂版本最多要維護的 Cloud Run 執行個體數量。 根據預設,每個 Cloud Run |
minInstances |
選用設定。每項 Cloud Run 服務所需保留的 Cloud Run 執行個體數量下限。 根據預設,這個數量沒有下限。 即使服務會將流量拆分至多個修訂版本,服務的執行個體總數上限仍會是這個值。 |
建構來源
建構作業的原始碼。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 source 。建構作業的輸入來源。通常會參照原始碼存放區中的修訂版本。也可以參照容器映像檔。source 只能採用下列其中一種設定: |
|
codebase |
程式碼集來源。 |
container |
Artifact Registry 容器映像檔來源。 |
程式碼集來源
程式碼集來源,代表用於建立建構作業的程式碼集狀態。
JSON 表示法 |
---|
{ "displayName": string, "hash": string, "commitMessage": string, "uri": string, "author": { object ( |
欄位 | |
---|---|
displayName |
僅供輸出。在顯示版本時,用於這個 Codebase 的易記名稱。我們會使用 GitHub.com 的 SHA-1 雜湊前八個字元。 |
hash |
僅供輸出。Git 修訂版本的完整 SHA-1 雜湊 (如有)。 |
commitMessage |
僅供輸出。程式碼集變更的訊息。 |
uri |
僅供輸出。連結至主機供應商網站上程式碼集的 URI。如果已在連結存放區中重新為修訂版本或強制停止存在,則可能無效。 |
author |
僅供輸出。版本管控變更的中繼資料中包含的作者。 |
commitTime |
僅供輸出。進行變更的時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
聯集欄位
|
|
branch |
程式碼集中的要建構來源分支,使用最新的修訂版本。 |
commit |
程式碼集中的修訂版本。 |
UserMetadata
與已解析程式碼集相關聯的使用者版本管控中繼資料。目前假設的是 Git 使用者。
JSON 表示法 |
---|
{ "displayName": string, "email": string, "imageUri": string } |
欄位 | |
---|---|
displayName |
僅供輸出。「name」也會寫入 Git 使用者 git.config 中的欄位此為 Git 的必要欄位。 |
email |
僅供輸出。「電子郵件」] 欄位 (如有)。 |
imageUri |
僅供輸出。外部來源控制供應器中的使用者帳戶相關圖片檔的 URI (如果有的話)。 |
ContainerSource
要做為建構來源的 Artifact Registry 容器映像檔 URI。
JSON 表示法 |
---|
{ "image": string } |
欄位 | |
---|---|
image |
執行個體類型,代表後端容器要使用的 URI。 |