리소스: 빌드
특정 지점 코드베이스 참조 태그와 특정 시점에 백엔드를 위한 단일 빌드입니다. Artifact Registry 컨테이너 이미지, 이미지를 빌드한 Cloud Build 호출, 해당 이미지를 사용하는 Cloud Run 버전 등 여러 리소스를 캡슐화합니다.
JSON 표현 |
---|
{ "name": string, "displayName": string, "state": enum ( |
필드 | |
---|---|
name |
식별자. 빌드의 리소스 이름입니다. 형식:
|
displayName |
선택사항입니다. 인간이 읽을 수 있는 이름입니다. 글자 수가 63자(영문 기준)로 제한됩니다. |
state |
출력 전용입니다. 빌드 상태입니다. |
error |
출력 전용입니다. |
environment |
출력 전용입니다. 이 빌드가 생성되었을 때 백엔드의 환경 이름입니다. |
config |
선택사항입니다. 서비스의 추가 구성입니다. |
image |
출력 전용입니다. 이 빌드에 Cloud Run |
source |
필수 항목입니다. 변경할 수 없습니다. 빌드의 소스입니다. |
buildLogsUri |
출력 전용입니다. 빌드 프로세스의 Cloud Build 로그 위치입니다. |
reconciling |
출력 전용입니다. true인 경우 빌드에 진행 중인 LRO가 있음을 나타내는 필드입니다. |
createTime |
출력 전용입니다. 빌드가 생성된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
updateTime |
출력 전용입니다. 빌드가 마지막으로 업데이트된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
deleteTime |
출력 전용입니다. 빌드가 삭제된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
labels |
선택사항입니다. 객체를 구성하고 분류하는 데 사용할 수 있는 구조화되지 않은 키-값 맵입니다.
|
annotations |
선택사항입니다. 임의의 메타데이터를 저장하기 위해 외부 도구에서 설정할 수 있는 구조화되지 않은 키-값 맵입니다. 쿼리할 수 없으며 객체를 수정할 때 보존해야 합니다.
|
uid |
출력 전용입니다. 시스템에서 할당한 고유 식별자입니다. |
etag |
출력 전용입니다. 다른 값을 기반으로 서버에서 계산된 체크섬 예상된 리소스에서 작업이 완료되도록 업데이트 또는 삭제 시 전송될 수 있습니다. |
주
빌드 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
빌드가 알 수 없는 상태입니다. |
BUILDING |
빌드가 진행 중입니다. |
BUILT |
빌드가 완료되었으며 다음 단계를 기다리는 중입니다. App Hosting에서 인프라 설정을 시작하면 배포로 이동할 수 있습니다. |
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개 미만의 CPU는 0.08~1.00 사이의 값을 0.01 단위로 설정할 수 있습니다. CPU를 1개 미만으로 설정하는 경우 동시 실행을 1로 설정해야 하며 CPU는 요청 처리 중에만 할당됩니다. CPU 한도를 늘리면 메모리 한도를 늘려야 할 수 있습니다.
|
memoryMib |
선택사항입니다. 각 제공 인스턴스에 할당된 메모리 양(MiB) 기본적으로 메모리는 각 인스턴스에 512MiB의 메모리가 할당되는 Cloud Run의 기본값으로 설정됩니다. 메모리는 128에서 32768 사이의 정수 값으로 설정할 수 있습니다. 메모리 한도를 늘리면 CPU 한도를 늘려야 할 수 있습니다.
|
concurrency |
선택사항입니다. 각 Cloud Run 인스턴스가 수신할 수 있는 최대 요청 수입니다. 기본적으로 각 인스턴스는 Cloud Run의 기본 요청인 최대 80개를 동시에 수신할 수 있습니다. 동시 실행은 최대 1,000의 정수 값으로 설정할 수 있습니다. |
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 |
출력 전용입니다. 빌드를 표시할 때 이 코드베이스에 사용할 사용자 친화적인 이름입니다. GitHub.com에서는 SHA-1 해시의 처음 8자를 사용합니다. |
hash |
출력 전용입니다. Git 커밋의 전체 SHA-1 해시입니다(사용 가능한 경우). |
commitMessage |
출력 전용입니다. 코드베이스 변경 메시지입니다. |
uri |
출력 전용입니다. 호스팅 제공업체 웹사이트의 코드베이스에 연결되는 URI입니다. 커밋이 연결된 저장소에서 리베이스되거나 강제 푸시된 경우에는 유효하지 않을 수 있습니다. |
author |
출력 전용입니다. 버전 제어 변경사항의 메타데이터에 포함된 작성자입니다. |
commitTime |
출력 전용입니다. 변경 시간 RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
통합 필드
|
|
branch |
최신 커밋을 사용하여 빌드할 코드베이스의 브랜치입니다. |
commit |
빌드할 코드베이스의 커밋입니다. |
UserMetadata
결정된 코드베이스와 연결된 사용자의 버전 제어 메타데이터입니다. 현재는 Git 사용자를 가정합니다.
JSON 표현 |
---|
{ "displayName": string, "email": string, "imageUri": string } |
필드 | |
---|---|
displayName |
출력 전용입니다. '이름' Git 사용자의 git.config 필드에 입력합니다. Git에 필요합니다. |
email |
출력 전용입니다. '이메일' 가능한 경우 Git 사용자의 git.config 필드에 입력합니다. |
imageUri |
출력 전용입니다. 사용 가능한 경우, 외부 소스 제어 제공자의 사용자 계정과 연결된 이미지 파일의 URI입니다. |
컨테이너 소스
빌드 소스로 사용할 Artifact Registry 컨테이너 이미지의 URI입니다.
JSON 표현 |
---|
{ "image": string } |
필드 | |
---|---|
image |
필수 항목입니다. 백엔드에서 사용할 컨테이너를 나타내는 URI입니다. |