REST Resource: projects.locations.releases

리소스: 릴리스

전파되어 기기에 배포될 새 버전입니다. 여기에는 아티팩트 레지스트리를 통한 실행을 위한 패키지화된 블루프린트 (예: Helm 또는 Terraform 구성 패키지)에 대한 포인터가 포함됩니다.

JSON 표현 
{
  "name": string,
  "unitKind": string,
  "blueprint": {
    object (Blueprint)
  },
  "releaseRequirements": {
    object (ReleaseRequirements)
  },
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "outputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "inputVariableDefaults": [
    {
      object (UnitVariable)
    }
  ],
  "applicationTemplateComponent": {
    object (ComponentRef)
  },
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
필드
name

string

식별자. 표준 명명 규칙을 따르는 리소스 이름 (리소스의 전체 URI)입니다.

"projects/{project}/locations/{location}/releases/{release}"
unitKind

string

필수 항목입니다. 변경할 수 없습니다. 이 버전이 해당하는 UnitKind에 대한 참조입니다 (생성된 후에는 필수이며 변경할 수 없음).
blueprint

object (Blueprint)

선택사항입니다. 청사진은 단위를 프로비저닝하는 데 필요한 모든 아티팩트가 포함된 OCI 이미지입니다.
releaseRequirements

object (ReleaseRequirements)

선택사항입니다. 이 버전을 사용할 때 유닛에서 충족해야 하는 요구사항 집합입니다.
inputVariables[]

object (UnitVariable)

선택사항입니다. 출력 전용입니다. 블루프린트에 선언된 입력 변수 목록으로, 단위 사양에 값이 있을 수 있습니다.
outputVariables[]

object (UnitVariable)

선택사항입니다. 출력 전용입니다. 블루프린트에서 선언되고 단위 상태에 값과 함께 표시될 수 있는 출력 변수 목록
inputVariableDefaults[]

object (UnitVariable)

선택사항입니다. 입력 변수를 기본값에 매핑합니다. 최대 100개
applicationTemplateComponent

object (ComponentRef)

출력 전용입니다. 복합 ApplicationTemplate의 구성요소 및 버전에 대한 참조입니다.
labels

map (key: string, value: string)

선택사항입니다. 분류에 사용할 수 있는 리소스의 라벨입니다. Kubernetes 리소스 라벨과 유사합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
annotations

map (key: string, value: string)

선택사항입니다. 주석은 리소스와 함께 저장되는 구조화되지 않은 키-값 맵으로, 임의의 메타데이터를 저장하고 검색하기 위해 외부 도구에서 설정할 수 있습니다. 이러한 속성은 쿼리할 수 없으며 객체를 수정할 때 보존해야 합니다.

자세한 내용은 https://kubernetes.io/docs/user-guide/annotations를 참고하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
uid

string

출력 전용입니다. 리소스의 고유 식별자입니다. UID는 서비스의 범위 내에서 이 리소스의 특정 시점과 공간에서 고유합니다. 일반적으로 리소스가 생성될 때 서버에서 생성되며 변경할 수 없습니다. UID는 리소스 이름을 재사용하는 리소스를 고유하게 식별하는 데 사용되며 UUID4여야 합니다.
etag

string

출력 전용입니다. 리소스의 버전 또는 세대를 고유하게 식별하는 불투명 값입니다. 클라이언트 및 서버의 리소스 작성 순서가 일치함을 확인하는 데 사용될 수 있습니다.
createTime

string (Timestamp format)

출력 전용입니다. 리소스가 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 리소스가 최종 업데이트된 타임스탬프입니다. 사용자가 리소스를 변경하면 이 값이 새로고침되어야 합니다. 서비스가 리소스를 변경하면 이 값이 새로고침되어야 합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

청사진

청사진은 단위를 프로비저닝하는 데 필요한 모든 아티팩트가 포함된 OCI 이미지입니다. 청사진을 작동하는 데 사용된 엔진 유형 (예: terraform, helm 등) 및 버전과 같은 메타데이터는 이미지 매니페스트에서 가져옵니다. 호스트 이름이 생략되면 Artifact Registry의 리전 경로 (예: us-east1-docker.pkg.dev)로 간주됩니다.

JSON 표현 
{
  "package": string,
  "engine": string,
  "version": string
}
필드
package

string

선택사항입니다. 변경할 수 없습니다. 단위에서 사용하는 청사진의 URI입니다 (unitKind 또는 release가 설정되지 않은 경우 필수).
engine

string

출력 전용입니다. 블루프린트를 작동하는 데 사용되는 엔진의 유형입니다(예: terraform, helm 등).
version

string

출력 전용입니다. 블루프린트에 있는 경우 버전 메타데이터

ReleaseRequirements

이 버전을 사용할 때 유닛에서 충족해야 하는 요구사항 집합입니다.

JSON 표현 
{
  "upgradeableFromReleases": [
    string
  ]
}
필드
upgradeableFromReleases[]

string

선택사항입니다. 단위를 이 출시 버전으로 업그레이드할 수 있는 출시 버전 목록입니다 (선택사항). 비워 두면 제약 조건이 적용되지 않습니다. 제공된 경우 이 버전에 대한 단위 업그레이드 요청은 이 제약 조건을 확인하고 적용합니다.

메서드

create

 새 버전을 만듭니다.

delete

 단일 버전을 삭제합니다.

get

 단일 버전을 가져옵니다.

list

 출시 버전 컬렉션을 가져옵니다.

patch

 단일 버전을 업데이트합니다.