REST Resource: projects.locations.backends.builds

Tài nguyên: Bản dựng

Một bản dựng cho phần phụ trợ, tại một thẻ tham chiếu cơ sở mã điểm cụ thể và tại một thời điểm cụ thể. Đóng gói một số tài nguyên, bao gồm một hình ảnh vùng chứa Artifact Registry, lệnh gọi Cloud Build tạo hình ảnh và bản sửa đổi Cloud Run có sử dụng hình ảnh đó.

Biểu diễn dưới dạng 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
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của bản dựng.

Định dạng:

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

string

Không bắt buộc. Tên dễ đọc. Giới hạn 63 ký tự.
state

enum (State)

Chỉ có đầu ra. Trạng thái của bản dựng.
error

object (Status)

Chỉ có đầu ra. Thông báo lỗi về trạng thái và (con người có thể đọc được) cho bản dựng nếu ở trạng thái FAILED.
environment

string

Chỉ có đầu ra. Tên môi trường của phần phụ trợ khi bản dựng này được tạo.
config

object (Config)

Không bắt buộc. Cấu hình bổ sung của dịch vụ.
image

string

Chỉ có đầu ra. URI hình ảnh vùng chứa của Artifact Registry, được Cloud Run revision sử dụng cho bản dựng này.
source

object (BuildSource)

Bắt buộc. Bất biến. Nguồn cho bản dựng.
buildLogsUri

string

Chỉ có đầu ra. Vị trí của nhật ký Cloud Build trong quy trình xây dựng.
reconciling

boolean

Chỉ có đầu ra. Một trường (nếu đúng) cho biết bản dựng có LRO đang diễn ra.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian tạo bản dựng.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian cập nhật bản dựng gần đây nhất.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm bản dựng bị xoá.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Không bắt buộc. Bản đồ khoá-giá trị phi cấu trúc có thể dùng để sắp xếp và phân loại đối tượng.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Không bắt buộc. Sơ đồ liên kết khoá không có cấu trúc có thể do các công cụ bên ngoài thiết lập để lưu trữ và siêu dữ liệu tuỳ ý. Các đối tượng này không truy vấn được và cần được giữ nguyên khi sửa đổi đối tượng.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Chỉ có đầu ra. Giá trị nhận dạng duy nhất do hệ thống chỉ định.
etag

string

Chỉ có đầu ra. Giá trị tổng kiểm do máy chủ tính dựa trên các giá trị khác; có thể được gửi khi cập nhật hoặc xoá để đảm bảo thao tác được thực hiện trên tài nguyên dự kiến.

Tiểu bang

Trạng thái của bản dựng.

Enum
STATE_UNSPECIFIED Bản dựng đang ở trạng thái không xác định.
BUILDING Công trình đang được xây dựng.
BUILT Quá trình xây dựng đã hoàn tất và đang chờ bước tiếp theo. Quá trình này có thể chuyển sang trạng thái Ngắt kết nối sau khi dịch vụ Lưu trữ ứng dụng bắt đầu thiết lập cơ sở hạ tầng.
DEPLOYING Cơ sở hạ tầng cho bản dựng này đang được thiết lập.
READY Cơ sở hạ tầng cho bản dựng này đã sẵn sàng. Bản dựng có thể phân phát hoặc không phân phát lưu lượng truy cập – hãy xem Backend.traffic để biết trạng thái hiện tại hoặc Backend.traffic_statuses để biết trạng thái mong muốn.
FAILED Không tạo được.

Config

Cấu hình bổ sung của phần phụ trợ cho bản dựng này.

Biểu diễn dưới dạng JSON 
{
  "runConfig": {
    object (RunConfig)
  }
}
Trường
runConfig

object (RunConfig)

Không bắt buộc. Cấu hình bổ sung của Cloud Run service.

Cấu hình chạy

Cấu hình bổ sung để áp dụng cho Cloud Run service.

Biểu diễn dưới dạng JSON 
{
  "cpu": number,
  "memoryMib": integer,
  "concurrency": integer,
  "maxInstances": integer,
  "minInstances": integer
}
Trường
cpu

number

Không bắt buộc. Số CPU được sử dụng cho mỗi phiên bản phân phát.

Theo mặc định, cpu mặc định là giá trị mặc định của Cloud Run là 1.0.

CPU có thể được đặt thành giá trị 1, 2, 4, 6 hoặc 8 CPU và đối với ít hơn 1 CPU, giá trị từ 0,08 đến nhỏ hơn 1,00, theo gia số 0,01.

Nếu thiết lập giá trị nhỏ hơn 1 CPU, bạn phải thiết lập mô hình đồng thời thành 1 và CPU sẽ chỉ được phân bổ trong quá trình xử lý yêu cầu.

Việc tăng giới hạn CPU có thể đòi hỏi phải tăng giới hạn bộ nhớ:

  • 4 CPU: ít nhất 2 GiB
  • 6 CPU: ít nhất 4 GiB
  • 8 CPU: ít nhất 4 GiB
memoryMib

integer

Không bắt buộc. Dung lượng bộ nhớ được phân bổ cho mỗi thực thể phân phát trong MiB.

Theo mặc định, bộ nhớ được đặt mặc định theo giá trị mặc định của Cloud Run, trong đó mỗi phiên bản được phân bổ 512 MiB bộ nhớ.

Bạn có thể đặt bộ nhớ thành bất kỳ giá trị số nguyên nào từ 128 đến 32768.

Bạn có thể phải tăng giới hạn CPU khi tăng giới hạn bộ nhớ:

  • Trên 4 GiB: ít nhất 2 CPU
  • Trên 8 GiB: ít nhất 4 CPU
  • Trên 16 GiB: ít nhất 6 CPU
  • Trên 24 GiB: ít nhất 8 CPU
concurrency

integer

Không bắt buộc. Số yêu cầu tối đa mà mỗi phiên bản Cloud Run có thể nhận được.

Theo mặc định, mỗi phiên bản có thể nhận được tối đa 80 yêu cầu theo mặc định của Cloud Run cùng một lúc.

Bạn có thể đặt mô hình đồng thời thành bất kỳ giá trị số nguyên nào tối đa 1000.
maxInstances

integer

Không bắt buộc. Số lượng thực thể Cloud Run cần duy trì tối đa cho mỗi bản sửa đổi.

Theo mặc định, mỗi Cloud Run service sẽ mở rộng theo giá trị mặc định của Cloud Run là tối đa 100 thực thể. Giới hạn maxInstances tối đa dựa trên hạn mức của bạn. Hãy truy cập vào https://cloud.google.com/run/docs/configure/max-instances#limits.
minInstances

integer

Không bắt buộc. Số lượng thực thể Cloud Run cần duy trì ở mức tối thiểu cho mỗi Dịch vụ Cloud Run.

Theo mặc định, không có giới hạn tối thiểu.

Ngay cả khi dịch vụ chia tách lưu lượng truy cập trên nhiều bản sửa đổi, tổng số bản sao của một dịch vụ sẽ bị giới hạn ở giá trị này.

Nguồn bản dựng

Nguồn cho bản dựng.

Biểu diễn dưới dạng 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.
}
Trường
Trường kết hợp source. Nguồn đầu vào cho bản dựng. Thường sẽ tham chiếu một cam kết trong một kho lưu trữ nguồn. Cũng có thể tham chiếu đến hình ảnh vùng chứa. source chỉ có thể là một trong những trạng thái sau đây:
codebase

object (CodebaseSource)

Nguồn cơ sở mã.
container

object (ContainerSource)

Nguồn hình ảnh vùng chứa của Artifact Registry.

Nguồn cơ sở mã

Nguồn cơ sở mã, biểu thị trạng thái của cơ sở mã mà bản dựng sẽ được tạo.

Biểu diễn dưới dạng 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.
}
Trường
displayName

string

Chỉ có đầu ra. Tên thân thiện với con người để sử dụng cho Cơ sở mã này khi hiển thị một bản dựng. Chúng ta sử dụng 8 ký tự đầu tiên của hàm băm SHA-1 cho GitHub.com.
hash

string

Chỉ có đầu ra. Hàm băm SHA-1 đầy đủ của một cam kết Git, nếu có.
commitMessage

string

Chỉ có đầu ra. Thông báo về việc thay đổi cơ sở mã.
uri

string

Chỉ có đầu ra. URI liên kết đến cơ sở mã trên trang web của nhà cung cấp dịch vụ lưu trữ. Có thể không hợp lệ nếu cam kết đã được đặt lại hoặc buộc ngừng tồn tại trong kho lưu trữ được liên kết.
author

object (UserMetadata)

Chỉ có đầu ra. Tác giả có trong siêu dữ liệu về sự thay đổi quản lý phiên bản.
commitTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian thực hiện thay đổi.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

Trường kết hợp reference.

reference chỉ có thể là một trong những trạng thái sau đây:
branch

string

Nhánh trong cơ sở mã cần tạo từ đó, sử dụng lệnh xác nhận mới nhất.
commit

string

Cam kết trong cơ sở mã để tạo bản dựng.

UserMetadata

Siêu dữ liệu quản lý phiên bản cho người dùng liên kết với cơ sở mã đã được phân giải. Hiện giả định là người dùng Git.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "email": string,
  "imageUri": string
}
Trường
displayName

string

Chỉ có đầu ra. "Tên" trong git.config của người dùng Git. Do Git yêu cầu.
email

string

Chỉ có đầu ra. Thuộc tính "email" trong git.config của người dùng Git, nếu có.
imageUri

string

Chỉ có đầu ra. URI của một tệp hình ảnh được liên kết với tài khoản của người dùng trong nhà cung cấp dịch vụ kiểm soát nguồn bên ngoài, nếu có.

Nguồn vùng chứa

URI của hình ảnh vùng chứa của Artifact Registry để dùng làm nguồn bản dựng.

Biểu diễn dưới dạng JSON 
{
  "image": string
}
Trường
image

string

Bắt buộc. URI đại diện cho một vùng chứa để phần phụ trợ sử dụng.

Phương thức

create

 Tạo một bản dựng mới cho phần phụ trợ.

delete

 Xoá một bản dựng.

get

 Lấy thông tin về bản dựng.

list

 Danh sách các bản dựng trong một dự án, vị trí và phần phụ trợ cụ thể.