REST Resource: projects.locations.rolloutKinds

리소스: RolloutKind

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

JSON 표현 
{
  "name": string,
  "unitKind": string,
  "rolloutOrchestrationStrategy": string,
  "maintenancePolicyEnforcement": enum (MaintenancePolicyEnforcement),
  "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에 정의된 모든 위치에 출시됩니다.
maintenancePolicyEnforcement

enum (MaintenancePolicyEnforcement)

선택사항입니다. 엄격 (유지보수 정책을 적용하고 유지보수 정책이 있는 단위만 확인), 무시 (유지보수 정책 무시), 건너뛰기 (유지보수 정책이 있는 단위 건너뛰기) 중 값
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)를 초과하면 출시가 일시중지됩니다. 설정하지 않으면 발생한 실패 수와 관계없이 모든 단위가 업데이트됩니다.

MaintenancePolicyEnforcement

유지보수 정책 시행을 정의합니다.

열거형
MAINTENANCE_POLICY_ENFORCEMENT_UNSPECIFIED
MAINTENANCE_POLICY_ENFORCEMENT_STRICT
MAINTENANCE_POLICY_ENFORCEMENT_IGNORED
MAINTENANCE_POLICY_ENFORCEMENT_SKIPPED

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

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