REST Resource: projects.locations.rolloutKinds

리소스: RolloutKind

출시 실행의 다양한 설정을 설명하는 객체입니다. 기본 제공 정책과 맞춤설정 가능한 정책이 포함됩니다.

JSON 표현
{
  "name": string,
  "unitKind": string,
  "rolloutOrchestrationStrategy": string,
  "unitFilter": string,
  "updateUnitKindStrategy": enum (UpdateUnitKindStrategy),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "errorBudget": {
    object (ErrorBudget)
  }
}
필드
name

string

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

"projects/{project}/locations/{location}/rolloutKinds/{rolloutKindId}"

unitKind

string

필수 항목입니다. 변경할 수 없습니다. 이 출시 종류에 해당하는 UnitKind입니다. 이 출시 종류에서 파생된 출시는 이 단위 종류의 단위를 타겟팅합니다. 즉, 출시를 통해 업그레이드할 대상 단위의 모집단을 정의합니다.

rolloutOrchestrationStrategy

string

선택사항입니다. 출시를 실행하는 데 사용되는 전략입니다. 필수 입력란입니다.

'Google.Cloud.Simple.AllAtOnce' 및 'Google.Cloud.Simple.OneLocationAtATime'의 두 가지 지원되는 값 전략이 있습니다.

이러한 간단한 전략 중 하나를 사용하여 출시하면 연결된 UnitKind의 Saas Locations에 정의된 모든 위치에 출시됩니다.

unitFilter

string

선택사항입니다. 단위에 대한 CEL(https://github.com/google/cel-spec) 형식의 필터 문자열입니다. 필터가 적용되어 적격 단위 인구를 결정합니다. 이 필터는 출시 범위를 줄일 수만 있고 늘릴 수는 없습니다.

updateUnitKindStrategy

enum (UpdateUnitKindStrategy)

선택사항입니다. 단위 종류를 업데이트하기 위한 구성입니다. 기본적으로 단위 종류는 출시 시작 시 업데이트됩니다.

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"입니다.

errorBudget

object (ErrorBudget)

선택사항입니다. 오류 예산의 구성입니다. 실패한 단위 수가 max(allowedCount, allowed_ratio * totalUnits)를 초과하면 출시가 일시중지됩니다. 설정하지 않으면 발생한 실패 수와 관계없이 모든 단위가 업데이트됩니다.

UpdateUnitKindStrategy

열거형
UPDATE_UNIT_KIND_STRATEGY_UNSPECIFIED 전략이 지정되지 않았습니다.
UPDATE_UNIT_KIND_STRATEGY_ON_START 출시 시작 시 단위 종류 전략을 업데이트합니다.
UPDATE_UNIT_KIND_STRATEGY_NEVER 단위 종류를 업데이트하지 않습니다.

ErrorBudget

오류 예산의 구성입니다. 실패한 단위 수가 max(allowedCount, allowed_ratio * totalUnits)를 초과하면 출시가 일시중지됩니다.

JSON 표현
{
  "allowedCount": integer,
  "allowedPercentage": integer
}
필드
allowedCount

integer

선택사항입니다. 롤아웃을 일시중지하지 않고 위치에서 허용되는 최대 실패 단위 수입니다.

allowedPercentage

integer

선택사항입니다. 롤아웃을 일시중지하지 않고 위치 내에서 실패할 수 있는 최대 단위 비율 (0, 100] 입니다.

메서드

create

새 출시 종류를 만듭니다.

delete

단일 출시 종류를 삭제합니다.

get

단일 출시 종류를 가져옵니다.

list

출시 종류 컬렉션을 가져옵니다.

patch

단일 출시 종류를 업데이트합니다.