리소스: Waiter
대기자 리소스는 반환하기 전에 RuntimeConfig 리소스 내의 일부 종료 조건이 충족될 때까지 기다립니다. 예를 들어 각 노드가 시작 프로세스의 일부로 노드의 준비 상태를 나타내는 변수 리소스에 쓰는 분산 시스템이 있다고 가정해 보겠습니다.
그런 다음 일정 수의 노드가 체크인할 때까지 기다리도록 설정된 성공 조건으로 대기자 리소스를 구성합니다. 그런 다음 조건이 충족되고 웨이터가 성공적으로 반환된 후에 애플리케이션이 임의의 코드를 실행합니다.
Waiter 리소스는 생성되면 변경할 수 없습니다.
대기열 사용에 관한 자세한 내용은 대기열 만들기 문서를 참고하세요.
JSON 표현 | |
---|---|
{ "name": string, "timeout": string, "failure": { object( |
필드 | |
---|---|
name |
Waiter 리소스의 이름입니다(형식:
Waiter 리소스를 만든 후에는 리소스 이름을 변경할 수 없습니다. |
timeout |
[필수] 초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 ' |
failure |
[선택사항] 이 대기자의 실패 조건입니다. 이 조건이 충족되면 |
success |
[필수] 성공 조건입니다. 이 조건이 충족되면 |
createTime |
출력 전용입니다. 이 Waiter 리소스가 생성된 순간입니다. 이 인스턴스에 RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예를 들면 |
done |
출력 전용입니다. 값이 true인 경우 대기자가 완료된 것입니다. 시간 초과 또는 실패로 인해 대기자가 종료되면 |
error |
출력 전용입니다. 실패 또는 시간 초과로 인해 대기자가 종료된 경우 이 값이 설정됩니다. |
EndCondition
대기자 리소스가 기다리는 조건입니다.
JSON 표현 | |
---|---|
{
"cardinality": {
object( |
필드 | |
---|---|
cardinality |
|
카디널리티
대기자 리소스의 카디널리티 조건입니다. 카디널리티 조건은 지정된 경로 접두사 아래의 변수 수가 사전 정의된 수에 도달할 때 충족됩니다. 예를 들어 path
가 /foo
로 설정되고 경로 수가 2
로 설정된 카디널리티 조건을 설정하면 다음 변수가 RuntimeConfig 리소스의 조건을 충족합니다.
/foo/variable1 = "value1"
/foo/variable2 = "value2"
/bar/variable3 = "value3"
하지만 number
를 3
로 설정하면 동일한 조건을 충족하지 않습니다. /foo
로 시작하는 경로가 2개뿐이기 때문입니다. 카디널리티 조건은 재귀적입니다. 특정 경로 접두사 아래의 모든 하위 트리가 계산됩니다.
JSON 표현 | |
---|---|
{ "path": string, "number": number } |
필드 | |
---|---|
path |
모니터링할 변수 하위 트리의 루트입니다. 예를 들면 |
number |
이 조건을 충족하기 위해 |
메서드 |
|
---|---|
|
대기자 리소스를 만듭니다. |
|
지정된 이름의 대기자를 삭제합니다. |
|
단일 대기자에 관한 정보를 가져옵니다. |
|
지정된 구성 내의 대기자를 나열합니다. |
|
지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다. |