REST Resource: projects.locations.backends.builds

Resource: สร้าง

บิลด์เดียวสำหรับแบ็กเอนด์ที่แท็กอ้างอิงและช่วงเวลาของ Codebase ที่เจาะจง สรุปทรัพยากรหลายรายการ ซึ่งรวมถึงอิมเมจคอนเทนเนอร์ Artifact Registry, การเรียกใช้ Cloud Build ที่สร้างอิมเมจ และการแก้ไข Cloud Run ที่ใช้อิมเมจนั้น

การแสดง 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
}
ช่อง
name

string

ตัวระบุ ชื่อทรัพยากรของบิลด์

รูปแบบ:

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

string

ไม่บังคับ ชื่อที่มนุษย์อ่านได้ จำนวนอักขระสูงสุด 63 ตัว
state

enum (State)

เอาต์พุตเท่านั้น สถานะของบิลด์
error

object (Status)

เอาต์พุตเท่านั้น สถานะและข้อความแสดงข้อผิดพลาด (ที่มนุษย์อ่านได้) สำหรับบิลด์ หากอยู่ในสถานะ FAILED
environment

string

เอาต์พุตเท่านั้น ชื่อสภาพแวดล้อมของแบ็กเอนด์เมื่อสร้างบิลด์นี้
config

object (Config)

ไม่บังคับ การกำหนดค่าเพิ่มเติมของบริการ
image

string

เอาต์พุตเท่านั้น URI ของอิมเมจคอนเทนเนอร์ Artifact Registry ที่ใช้โดย Cloud Run revisionสำหรับบิลด์นี้
source

object (BuildSource)

ต้องระบุ เปลี่ยนแปลงไม่ได้ แหล่งที่มาของบิลด์
buildLogsUri

string

เอาต์พุตเท่านั้น ตำแหน่งของบันทึกของ Cloud Build สำหรับกระบวนการบิลด์
reconciling

boolean

เอาต์พุตเท่านั้น ฟิลด์ที่หากเป็น "จริง" แสดงว่าบิลด์มี LRO ต่อเนื่อง
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างบิลด์

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่อัปเดตบิลด์ครั้งล่าสุด

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
deleteTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่ลบบิลด์

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
labels

map (key: string, value: string)

ไม่บังคับ แมปค่าคีย์ที่ไม่มีโครงสร้างซึ่งใช้เพื่อจัดระเบียบและจัดหมวดหมู่ออบเจ็กต์ได้

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
annotations

map (key: string, value: string)

ไม่บังคับ แมปค่าคีย์แบบไม่มีโครงสร้างที่อาจกำหนดโดยเครื่องมือภายนอกเพื่อจัดเก็บและข้อมูลเมตาที่กำหนดเอง สืบค้นไม่ได้และควรเก็บไว้เมื่อแก้ไขออบเจ็กต์

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
uid

string

เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันซึ่งกำหนดโดยระบบ
etag

string

เอาต์พุตเท่านั้น การตรวจสอบข้อผิดพลาดที่ประมวลผลโดยเซิร์ฟเวอร์โดยอิงตามค่าอื่นๆ อาจส่งเมื่อมีการอัปเดตหรือลบเพื่อดูแลให้ทรัพยากรที่คาดหวังทำงานได้

รัฐ

สถานะของบิลด์

Enum
STATE_UNSPECIFIED บิลด์อยู่ในสถานะที่ไม่รู้จัก
BUILDING งานสร้างกำลังสร้าง
BUILT การสร้างเสร็จสมบูรณ์และกำลังรอขั้นตอนถัดไป การดำเนินการนี้อาจย้ายไปยัง "การทำให้ใช้งานได้" เมื่อโฮสติ้งแอปเริ่มตั้งค่าโครงสร้างพื้นฐาน
DEPLOYING กำลังตั้งค่าโครงสร้างพื้นฐานสำหรับบิลด์นี้
READY โครงสร้างพื้นฐานสำหรับบิลด์นี้พร้อมแล้ว บิลด์อาจแสดงหรือไม่ให้บริการรับส่งข้อมูล โปรดดู Backend.traffic สำหรับสถานะปัจจุบันของ หรือ Backend.traffic_statuses สำหรับสถานะที่ต้องการ
FAILED การสร้างล้มเหลว

การกำหนดค่า

การกำหนดค่าเพิ่มเติมของแบ็กเอนด์สำหรับบิลด์นี้

การแสดง JSON 
{
  "runConfig": {
    object (RunConfig)
  }
}
ช่อง
runConfig

object (RunConfig)

ไม่บังคับ การกำหนดค่าเพิ่มเติมของ Cloud Run service

กำหนดค่า

การกำหนดค่าเพิ่มเติมที่จะนำไปใช้กับ Cloud Run service

การแสดง JSON 
{
  "cpu": number,
  "memoryMib": integer,
  "concurrency": integer,
  "maxInstances": integer,
  "minInstances": integer
}
ช่อง
cpu

number

ไม่บังคับ จำนวน CPU ที่ใช้สำหรับแต่ละอินสแตนซ์ที่แสดงผล

โดยค่าเริ่มต้น CPU จะมีค่าเริ่มต้นเป็น 1.0 ของ Cloud Run

คุณสามารถตั้ง CPU เป็นค่า 1, 2, 4, 6 หรือ 8 CPU และสำหรับ CPU น้อยกว่า 1 ค่าได้ โดยค่าตั้งแต่ 0.08 ไปจนถึงน้อยกว่า 1.00 และเพิ่มทีละ 0.01

หากกำหนดค่าน้อยกว่า 1 CPU คุณจะต้องตั้งค่าการเกิดขึ้นพร้อมกันเป็น 1 และระบบจะจัดสรร CPU ในระหว่างการประมวลผลคำขอเท่านั้น

การเพิ่มขีดจำกัด CPU อาจทำให้ต้องเพิ่มขีดจำกัดของหน่วยความจำ ดังนี้

  • 4 CPU: อย่างน้อย 2 GiB
  • 6 CPU: อย่างน้อย 4 GiB
  • 8 CPU: อย่างน้อย 4 GiB
memoryMib

integer

ไม่บังคับ จำนวนหน่วยความจำที่จัดสรรสำหรับแต่ละอินสแตนซ์ที่แสดงผลใน MiB

โดยค่าเริ่มต้น หน่วยความจำจะใช้ค่าเริ่มต้นของ Cloud Run ซึ่งมีการจัดสรรหน่วยความจำ 512 MiB

คุณสามารถกำหนดค่าหน่วยความจำเป็นค่าจำนวนเต็มระหว่าง 128 ถึง 32768

การเพิ่มขีดจำกัดหน่วยความจำอาจทำให้ขีดจำกัด CPU เพิ่มขึ้น:

  • มากกว่า 4 GiB: CPU อย่างน้อย 2 CPU
  • มากกว่า 8 GiB: CPU อย่างน้อย 4 CPU
  • มากกว่า 16 GiB: CPU อย่างน้อย 6 CPU
  • มากกว่า 24 GiB: CPU อย่างน้อย 8 CPU
concurrency

integer

ไม่บังคับ จำนวนคำขอสูงสุดที่อินสแตนซ์ Cloud Run แต่ละรายการรับได้

โดยค่าเริ่มต้น อินสแตนซ์แต่ละรายการจะรับคำขอเริ่มต้นของ Cloud Run ได้พร้อมกันสูงสุด 80 รายการ

คุณสามารถตั้งค่าการเกิดขึ้นพร้อมกันเป็นจำนวนเต็มใดก็ได้ที่ไม่เกิน 1,000
maxInstances

integer

ไม่บังคับ จำนวนอินสแตนซ์ Cloud Run ที่จะรักษาไว้สูงสุดสำหรับการแก้ไขแต่ละครั้ง

โดยค่าเริ่มต้น Cloud Run แต่ละรายการ service จะปรับขนาดค่าเริ่มต้นของ Cloud Run ให้มีอินสแตนซ์สูงสุด 100 รายการ ขีดจำกัด maxInstances สูงสุดขึ้นอยู่กับโควต้าของคุณ โปรดดู https://cloud.google.com/run/docs/configuring/max-instances#limits
minInstances

integer

ไม่บังคับ จำนวนอินสแตนซ์ Cloud Run ที่จะคงไว้น้อยที่สุดสำหรับบริการ Cloud Run แต่ละรายการ

ไม่มีจำนวนขั้นต่ำโดยค่าเริ่มต้น

แม้ว่าบริการจะแยกการรับส่งข้อมูลในหลายการแก้ไข แต่จำนวนอินสแตนซ์ทั้งหมดของบริการจะถูกจำกัดไว้ที่ค่านี้

BuildSource

แหล่งที่มาของบิลด์

การแสดง 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.
}
ช่อง
ช่องการรวม source แหล่งที่มาของอินพุตสำหรับบิลด์ โดยปกติแล้วจะอ้างอิงคอมมิตในที่เก็บต้นทาง อาจอ้างอิงอิมเมจคอนเทนเนอร์ด้วย source ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
codebase

object (CodebaseSource)

แหล่งที่มาของโค้ดเบส
container

object (ContainerSource)

แหล่งที่มาของอิมเมจคอนเทนเนอร์ Artifact Registry

CodebaseSource

แหล่งที่มาของโค้ดเบสซึ่งแสดงสถานะของโค้ดเบสที่จะสร้างบิลด์

การแสดง 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.
}
ช่อง
displayName

string

เอาต์พุตเท่านั้น ชื่อที่มนุษย์เข้าใจได้ง่ายสำหรับฐานของโค้ดนี้เมื่อแสดงบิลด์ เราใช้อักขระ 8 ตัวแรกของแฮช SHA-1 สำหรับ GitHub.com
hash

string

เอาต์พุตเท่านั้น แฮช SHA-1 แบบเต็มของคอมมิต Git ถ้ามี
commitMessage

string

เอาต์พุตเท่านั้น ข้อความการเปลี่ยนแปลงฐานของโค้ด
uri

string

เอาต์พุตเท่านั้น URI ที่ลิงก์ไปยังฐานของโค้ดในเว็บไซต์ของผู้ให้บริการโฮสติ้ง อาจไม่ถูกต้องหากมีการใช้คอมมิตซ้ำหรือถูกบังคับให้ออกจากที่เก็บที่ลิงก์แล้ว
author

object (UserMetadata)

เอาต์พุตเท่านั้น ผู้เขียนอยู่ในข้อมูลเมตาของการเปลี่ยนแปลงการควบคุมเวอร์ชัน
commitTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่ทำการเปลี่ยนแปลง

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

ช่องการรวม reference

reference ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
branch

string

Branch ในฐานของโค้ดที่จะสร้าง โดยใช้คอมมิตล่าสุด
commit

string

คอมมิตในฐานของโค้ดที่จะสร้าง

UserMetadata

ข้อมูลเมตาการควบคุมเวอร์ชันสำหรับผู้ใช้ที่เชื่อมโยงกับฐานของโค้ดที่แก้ไขแล้ว ปัจจุบันจะถือว่าเป็นผู้ใช้ Git

การแสดง JSON 
{
  "displayName": string,
  "email": string,
  "imageUri": string
}
ช่อง
displayName

string

เอาต์พุตเท่านั้น "ชื่อ" ใน git.config ของผู้ใช้ Git ต้องใช้โดย Git
email

string

เอาต์พุตเท่านั้น "อีเมล" ใน git.config ของผู้ใช้ Git หากมี
imageUri

string

เอาต์พุตเท่านั้น URI ของไฟล์ภาพที่เชื่อมโยงกับบัญชีของผู้ใช้ในผู้ให้บริการควบคุมแหล่งที่มาภายนอก หากมี

แหล่งที่มาของคอนเทนเนอร์

URI ของอิมเมจคอนเทนเนอร์ Artifact Registry เพื่อใช้เป็นแหล่งที่มาของบิลด์

การแสดง JSON 
{
  "image": string
}
ช่อง
image

string

ต้องระบุ URI ที่แสดงถึงคอนเทนเนอร์ที่แบ็กเอนด์จะใช้

เมธอด

create

 สร้างบิลด์ใหม่สำหรับแบ็กเอนด์

delete

 ลบบิลด์เดียว

get

 รับข้อมูลเกี่ยวกับบิลด์

list

 แสดงรายการบิลด์ในโปรเจ็กต์ ตำแหน่ง และแบ็กเอนด์ที่ระบุ