콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

내장 태깅 플러그인

CLI에 컴파일되어 들어 있는 두 거버넌스 플러그인은 작성할 정책 없이 빌드의 노드에 레이블을 씁니다. 각각 무엇을 읽고 무엇을 쓰는지, 그리고 각각의 연결 예시와 그것이 쓴 레이블을 설명합니다.

CLI에는 정책 언어를 작성하지 않고 구성만으로 레이블을 다듬는 두 거버넌스 플러그인이 포함되어 있습니다.

Plugin쓰는 내용
governance/label-injector레이블이 규칙과 일치하는 모든 노드에 규칙 목록이 설정하는 레이블
governance/selector-tagger레이블 하나, tag. 그 값은 Component 이름의 맵이 각 노드에 부여합니다

둘 다 다른 거버넌스 플러그인과 마찬가지로 작업 공간 구성의 plugins.governance를 통해 연결하며(정책 연결 참조), 둘 다 내장 플러그인 목록에 있습니다. 이 페이지의 연결 예시는 표준 라이브러리 카탈로그에 있는 각 플러그인의 Plugin 엔터티 버전인 0.9.0을 지정합니다. 빌드는 CLI에 컴파일된 플러그인을 사용합니다.

두 플러그인의 공통점

label-transform 역할만 수행하며 다른 역할은 수행하지 않습니다. 둘 다 빌드 그래프가 구축된 후, 판정되기 전에 레이블을 다듬는 역할에서 레이블 변경을 보고합니다(변환 역할 참조). 다른 역할에 연결하면 해당 역할의 내보내기를 선언하지 않으므로 둘 다 실행 전에 거부됩니다. ir-verdict에서는 빌드가 다음과 같이 중단됩니다.

[E0085]
ir-verdict: plugin "governance/label-injector:0.9.0": call "verdict_ir": wasm: plugin "label-injector" does not declare export "verdict_ir" in describe(): wasm: plugin rejected by the sandbox
[E0085]
ir-verdict: plugin "governance/selector-tagger:0.9.0": call "verdict_ir": wasm: plugin "selector-tagger" does not declare export "verdict_ir" in describe(): wasm: plugin rejected by the sandbox

render-verdict와 annotation-transform에서도 거부는 동일한 E0085이며, 대신 verdict_render와 transform_annotations를 지정합니다.

노드의 레이블과 그 Component만 읽고 그 밖의 것은 읽지 않습니다. 노드의 레이블은 플러그인이 실행될 때 노드가 가진 레이블, 즉 그 Component 자체의 레이블과 그보다 앞에 나열된 변환이 쓴 레이블입니다. 노드의 Component는 core/datastore/mariadb처럼 Aggregate의 type:이 노드에 부여하는 이름입니다. 두 플러그인 모두 노드의 값, Release, 그 환경을 읽지 않습니다. 어느 쪽이든 노드에 쓰는 내용은 그 노드의 레이블과 Component만으로 결정됩니다.

레이블만, 오직 레이블만 씁니다. 두 플러그인이 보고하는 모든 변경은 빌드의 한 노드에 있는 레이블 하나를 문자열 값과 함께 지정합니다. 노드가 이미 가진 레이블을 쓰면 그 값이 대체되며, Component 자체의 레이블도 마찬가지입니다. 둘 다 레이블을 제거하지 않으며, 값, 노드의 Component나 버전, 노드 집합을 바꿀 수도 없습니다. 레이블을 다듬는 역할은 그런 종류의 변경을 제공하지 않기 때문입니다(레이블 다듬기 참조).

설정은 실행 전에 검사되지 않습니다. 둘 다 settings에 대한 스키마를 선언하지 않으므로 빌드는 설정을 작성된 그대로 플러그인에 넘깁니다. 플러그인이 읽지 않는 키는 무시됩니다. 철자가 틀린 rules는 아무것도 설정하지 않고 빌드는 완료됩니다. 반면 플러그인이 읽는 키에 다른 타입의 값이 있으면 플러그인 이름, 이어서 decode settings:와 이유를 담은 메시지로 빌드가 중단됩니다.

sources 아래의 파일을 파일 이름 순서로 YAML로 읽습니다. 연결에서 파일을 어떤 순서로 나열하든 플러그인은 파일 이름순으로 정렬된 파일을 받습니다. 유효한 YAML이 아닌 파일은 플러그인 이름, 이어서 parse source "<file>":와 파서의 이유를 담은 메시지로 빌드를 중단시킵니다. 내용이 플러그인이 읽는 형태가 아닌 파일은 decode source "<file>":와 이유로 빌드를 중단시킵니다.

빌드가 적용하는 입력은 잠금 파일이 보관합니다. Release의 잠금 파일을 확정하는 pull(aggrega pull 또는 --auto-pull을 사용한 빌드)은 각 연결의 설정과 각 파일의 내용을 기록하며, 빌드는 기록된 내용을 적용합니다. 연결의 설정이나 파일 중 하나를 편집한 후에는 잠금 파일을 다시 확정하십시오. 그렇게 하지 않은 빌드는 기록된 입력에 따른 레이블을 계속 씁니다.

with: 블록 없이 연결하면 둘 다 아무것도 쓰지 않으며, 빌드는 완료됩니다.

label-transform에 연결된 여러 항목은 나열된 순서대로 실행되며, 각각 앞선 연결이 쓴 레이블을 읽으므로 규칙은 앞선 연결이 설정한 레이블과 일치할 수 있습니다. examples/policy-label-transform/는 Rego 정책 뒤에 두 플러그인을 연결하고, 셋이 쓴 내용을 모두 읽는 판정도 연결합니다.

governance/label-injector

레이블 주입기는 레이블이 규칙과 일치하는 모든 노드에 레이블을 추가합니다.

레이블 주입기의 설정

설정타입기본값효과
rules규칙 목록없음모든 노드에 적용되는 규칙. 규칙이 없으면 플러그인은 아무것도 쓰지 않습니다

각 규칙은 레이블 키에서 문자열 값으로의 맵 두 개를 가집니다.

키기본값효과
match쌍 없음나열된 모든 쌍을 각각 그 값으로 가진 노드가 일치합니다. 쌍이 없는 규칙은 모든 노드와 일치합니다
set쌍 없음규칙이 일치하는 각 노드에 모든 쌍이 쓰입니다

노드가 갖지 않은 레이블은 빈 문자열로 비교되므로, 값이 ""인 match 쌍은 해당 키를 갖지 않은 노드와도 일치합니다.

규칙은 나열된 순서대로 각 노드에 적용되며, 뒤의 규칙이 쓰는 레이블은 같은 키에 대해 앞의 규칙이 쓴 값을 대체합니다.

규칙을 가져오는 곳

설정에 규칙이 하나 이상 있으면 플러그인은 설정에서 rules를 읽습니다. 하나도 없으면 sources 아래의 파일을 파일 이름 순서로 읽고, 최상위 rules 목록에 규칙이 하나 이상 있는 첫 번째 파일의 규칙을 같은 형태로 가져옵니다.

rules:
- match: {}
set:
ops.example.com/owner: shop-team

그 뒤 파일의 규칙은 읽지 않습니다. 그 앞에 있는 파일이 파싱되지 않으면 빌드가 중단됩니다.

연결된 레이블 주입기와 그것이 쓴 레이블

이 연결은 모든 노드에 소유자를 설정한 다음, datastore 카테고리의 노드에 백업 일정과 다른 소유자를 설정합니다.

plugins:
governance:
- uri: governance/label-injector:0.9.0
role: label-transform
with:
settings:
rules:
- match: {}
set:
ops.example.com/owner: shop-team
- match:
component.aggrega.ai/category: datastore
set:
backup.example.com/schedule: nightly
ops.example.com/owner: data-team

examples/policy-label-transform/의 Aggregate에 단독으로 연결하면(db는 core/datastore/mariadb, cache는 core/datastore/redis, web은 core/devtool/adminer), aggrega build --release release-production.yaml --auto-pull --ir-graph는 노드가 다음을 가진 빌드 그래프를 출력합니다.

"db": {
"labels": {
"component.aggrega.ai/type": "stateful-server",
"component.aggrega.ai/category": "datastore",
"component.aggrega.ai/upstream-licensing": "osi-approved",
"backup.example.com/schedule": "nightly",
"ops.example.com/owner": "data-team"
},
[… omitted: the node's Component, its version and the rest of the node]
},
"cache": {
"labels": {
"component.aggrega.ai/type": "server",
"component.aggrega.ai/category": "datastore",
"datastore.aggrega.ai/engine": "kv",
"component.aggrega.ai/hosting": "mixed",
"component.aggrega.ai/upstream-licensing": "mixed",
"backup.example.com/schedule": "nightly",
"ops.example.com/owner": "data-team"
},
[… omitted: the node's Component, its version and the rest of the node]
},
"web": {
"labels": {
"component.aggrega.ai/type": "server",
"component.aggrega.ai/category": "devtool",
"component.aggrega.ai/upstream-licensing": "osi-approved",
"ops.example.com/owner": "shop-team"
},
[… omitted: the node's Component, its version and the rest of the node]
}

모든 노드가 첫 번째 규칙과 일치하여 shop-team을 받았습니다. datastore 카테고리에 있는 db와 cache는 두 번째 규칙과도 일치했고, 그 규칙이 값을 data-team으로 대체했습니다. 그 밖의 모든 레이블은 Component 자체의 레이블입니다.

governance/selector-tagger

셀렉터 태거는 각 노드에 tag 레이블을 쓰며, 그 값은 노드의 Component로 조회합니다.

셀렉터 태거의 맵과 설정

항상 키 tag를 씁니다. 키는 구성할 수 없습니다.

맵은 sources 아래의 파일에서 가져옵니다. 각 파일은 Component 이름에서 그 노드가 받는 태그로의 YAML 맵입니다.

core/datastore/mariadb: orders
core/datastore/redis: sessions

모든 파일을 파일 이름 순서로 읽으며, 뒤 파일의 항목은 앞 파일에 있는 같은 Component의 항목을 대체합니다. 각 태그는 문자열입니다. 3처럼 YAML이 다른 타입으로 읽는 값은 빌드를 중단시키므로 "3"처럼 따옴표로 묶으십시오.

설정타입기본값효과
defaultstring비어 있음맵에 노드의 Component가 없을 때 그 노드가 받는 태그. 비어 있으면 그런 노드에는 tag가 붙지 않습니다

sources가 없으면 모든 노드가 default를 받습니다.

연결된 셀렉터 태거와 그것이 쓴 레이블

이 연결은 위의 맵인 tags.yaml에서 데이터베이스와 캐시에 태그를 붙이고, 나머지 모든 노드에는 untagged를 붙입니다.

plugins:
governance:
- uri: governance/selector-tagger:0.9.0
role: label-transform
with:
sources:
- tags.yaml
settings:
default: untagged

같은 Aggregate에 단독으로 연결하면 aggrega build --release release-production.yaml --auto-pull --ir-graph는 노드가 다음을 가진 빌드 그래프를 출력합니다.

"db": {
"labels": {
"component.aggrega.ai/type": "stateful-server",
"component.aggrega.ai/category": "datastore",
"component.aggrega.ai/upstream-licensing": "osi-approved",
"tag": "orders"
},
[… omitted: the node's Component, its version and the rest of the node]
},
"cache": {
"labels": {
"component.aggrega.ai/type": "server",
"component.aggrega.ai/category": "datastore",
"datastore.aggrega.ai/engine": "kv",
"component.aggrega.ai/hosting": "mixed",
"component.aggrega.ai/upstream-licensing": "mixed",
"tag": "sessions"
},
[… omitted: the node's Component, its version and the rest of the node]
},
"web": {
"labels": {
"component.aggrega.ai/type": "server",
"component.aggrega.ai/category": "devtool",
"component.aggrega.ai/upstream-licensing": "osi-approved",
"tag": "untagged"
},
[… omitted: the node's Component, its version and the rest of the node]
}

core/devtool/adminer는 맵에 없으므로 web은 default를 받았습니다. default 설정이 없으면 web에는 tag가 없고, 나머지 둘은 위와 같이 태그가 붙습니다.

컴파일러가 해석하지 않는 부분

플러그인도 컴파일러도 소유자, 백업 일정, 태그가 무엇을 의미하는지 알지 못합니다. 레이블 키와 값은 연결이 제공하는 문자열입니다. 컴파일러는 각 플러그인에 노드를 넘기고, 보고된 레이블을 적용하여 빌드 그래프에 담으며, 그것을 읽는 정책이 의미를 부여합니다.