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

appliesTo와 셀렉터

수정자 시스템은 Feature가 어떤 노드에 부착되는지를 결정합니다. Feature는 레이블 셀렉터를 선언하며, 컴파일러의 네이티브 레이블 매칭 엔진이 정적 분석 단계에서 각 대상 Component의 metadata.labels에 대해 이를 평가합니다. 같은 엔진과 같은 셀렉터 문법이 노드 간 타입 안전성을 위한 usesSchema 소켓 셀렉터도 평가하므로, 하나의 어휘가 언어의 모든 셀렉터 표면에 쓰입니다.

두 가지 엔벨로프

Feature spec은 최대 두 개의 셀렉터 필드를 가집니다.

  • appliesTo — AND 조합 표면입니다. 하나의 Kubernetes 스타일 레이블 셀렉터 문자열이며, 부착이 유효하려면 쉼표로 구분된 모든 요구 사항이 충족되어야 합니다.
  • appliesToAnyOf — OR 조합 표면입니다. 셀렉터 항목의 목록이며, 일치하는 항목이 하나라도 있으면 부착이 충족됩니다. 각 항목은 문자열 형식 셀렉터(appliesTo와 같은 문법이며, 문자열 안의 요구 사항은 AND로 결합됨)이거나, 동등성으로만 매칭되는 평면 키-값 맵입니다.

Feature가 둘 다 선언하면 결과는 엔벨로프 간에 AND로 결합됩니다. appliesTo 문자열이 충족되어야 하고, 적어도 하나의 appliesToAnyOf 항목이 일치해야 합니다. 생략되거나 비어 있는 셀렉터는 제약을 선언하지 않으며 모든 레이블 집합과 일치합니다. 두 필드가 모두 없는 Feature는 개발자가 두는 어디에나 부착됩니다.

spec:
appliesTo: "compliance.aggrega.ai/scope in (pci), tier notin (dev, staging)"
appliesToAnyOf:
- { component.aggrega.ai/type: stateful-server }
- "datastore.aggrega.ai/engine in (relational, document, vector)"

문자열 문법

셀렉터 문자열은 kubectl get -l이 받아들이는 레이블 셀렉터 구문을 따릅니다. 쉼표로 구분되고 AND로 조합되는 요구 사항이며, 각각은 다음 여섯 형식 중 하나입니다.

형식의미
key=value레이블이 정확히 이 값으로 존재함
key!=value레이블이 없거나, 다른 값으로 존재함
key in (v1, v2)레이블의 값이 집합 중 하나임
key notin (v1, v2)레이블이 없거나, 값이 집합 밖에 있음
key레이블이 존재함(값은 무관)
!key레이블이 없음

키에는 DNS 스타일 접두사(team.aggrega.ai/owner)를 붙일 수 있습니다. 연산자 어휘는 여섯 개로 닫힌 집합이며, 엔진은 정규식, 부분 문자열, 숫자 비교를 지원하지 않습니다.

appliesTo: "component.aggrega.ai/type in (server, worker), !legacy.aggrega.ai/exempt"

여섯 형식에 속하지 않는 요구 사항은 추측하지 않고 거부됩니다.

  • 빈 요구 사항 — 앞이나 뒤에 오거나 중복된 쉼표, 또는 구분자만으로 된 문자열입니다. "tier=frontend,"와 " , , "는 더 적은 요구 사항이나 요구 사항 없음으로 읽히지 않고 거부됩니다.
  • 공백이나 문법 자체의 문자를 포함한 키 — =, !, (, )와 쉼표로, 이들은 형식을 서로 구별하는 문자입니다. !는 레이블 키만을 지정하므로 !tier=frontend는 거부됩니다. frontend를 제외하려고 쓴 것이지만, 그렇지 않으면 “tier=frontend라는 이름의 레이블이 없음”으로 읽히게 되며, 이는 모든 component가 충족합니다. 값을 제외하려면 tier!=frontend로 씁니다. 같은 방식으로 tier in frontend도 거부되며(집합은 tier in (frontend)로 씁니다), tier: frontend도 마찬가지입니다.
  • 닫히지 않은 집합 — ) 없이 쓴 in ( 또는 notin (입니다.

값에는 어떤 문자 집합 제한도 없습니다. 값은 연산자 뒤의 텍스트에서 앞뒤 공백을 제거한 것이며, 작성된 그대로 레이블의 값과 비교됩니다. 따라서 tier==frontend는 값이 =frontend인 레이블을 요구합니다. ==는 동등성의 또 다른 표기가 아닙니다. 위의 키 규칙 외에는 키도 값도 판단되지 않습니다. 레이블은 엔진이 비교하는 불투명한 문자열입니다.

검증이 이루어지는 위치

두 계층이 의도적으로 서로 다른 엄격도로 셀렉터를 검사합니다.

  • JSON Schema pattern은 느슨한 바깥쪽 관문입니다. Feature 스키마는 appliesTo(및 문자열 형식 appliesToAnyOf 항목)를 명백히 잘못된 형태만 거부하는 경계 패턴을 가진 문자열로 선언합니다. 이는 의도적으로 관대합니다. 스키마는 엔진이 평가할 셀렉터를 결코 거부하지 않습니다.
  • 파서가 검증기입니다. 컴파일러의 셀렉터 파서가 문법을 소유합니다. 파서가 거부하는 셀렉터(위의 어떤 형태든)는 셀렉터, 이를 선언한 Feature, 소켓 또는 슬롯, 그리고 읽을 수 없었던 요구 사항을 명시하는 진단과 함께 빌드를 중단시킵니다. 파싱 실패는 명확하고 구체적으로 보고되며, 조용히 건너뛰지 않습니다. 빌드에서 파서는 셀렉터가 평가되는 곳에서 실행됩니다. 즉 Feature의 각 부착, 소켓을 통해 연결된 각 엣지, 슬롯의 각 채움마다 실행됩니다. aggrega validate는 카탈로그 전체에 대해서든 하나의 Component 또는 Feature에 대해서든, 엔터티의 문서가 선언하는 모든 소켓 및 슬롯 셀렉터도 읽으므로, 아무것도 사용하지 않는 소켓이나 슬롯에 있는 잘못된 셀렉터는 그곳에서 빌드와 같은 코드와 문구로 거부됩니다. 아무것도 부착하지 않는 Feature에 있는 잘못된 appliesTo는 무언가가 부착할 때까지 보고되지 않습니다.

파싱되지만 일치하지 않는 셀렉터는 그 자체로 오류가 아니며, 충족되지 않은 제약입니다. 정적 분석에서 대상 레이블이 Feature의 셀렉터를 충족하지 못하는 모든 Feature 부착은 feature 인스턴스, 대상 노드, 그 레이블, 제약을 명시하는 위반 진단을 생성합니다. 분석기는 중단하기 전에 모든 위반을 수집하므로, 한 번의 컴파일로 모든 위반이 드러납니다.

컴파일러가 하지 않는 일

컴파일러는 레이블 의미에 구애받지 않습니다. 컴파일러는 발견하는 레이블 문자열을 무엇이든 평가합니다. component.aggrega.ai/type을 특별하게 인식하지 않고, category 값이 표준 카탈로그의 닫힌 집합에 속하는지 검증하지 않으며, 키 이름에서 의미를 추론하지 않습니다. 레이블 어휘 자체(운영 타입 계약, 인지 category 축, 역할별 capability 레이블)는 컴파일러가 아니라 카탈로그 작성자와 게시 린터가 지키는 표준 라이브러리 관례입니다. 자체 카탈로그를 작성하는 기업은 자유롭게 고유한 레이블 어휘를 정의할 수 있으며, 셀렉터 엔진은 이를 동일하게 평가합니다. 표준 카탈로그가 사용하는 세 축 레이블 체계는 architecture/13-catalog-and-registry.md를 참조하고, 레이블별 설명은 architecture/09-ai-features.md §1.2를 참조하십시오.

언어 전반의 셀렉터 유사성

usesSchema 소켓 셀렉터(selector: "component.aggrega.ai/type=stateful-server") 및 이로부터 합성되는 x-aggrega-selector: 주석은 Feature appliesTo와 같은 문법과 같은 엔진을 사용합니다. 작성 지식은 일대일로 옮겨집니다. 소켓 셀렉터로 동작하는 문자열은 부착 셀렉터로도 동작합니다. 소켓 측 설명은 topology-triad.md 및 entities/component.md를 참조하십시오.

Feature 측 작성 표면(spec 필드, 실제 부착 예제, extends 상속과의 상호 작용)은 entities/feature.md §Label-Based Attachment를 참조하십시오.