Aggrega 카탈로그(Feature) 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 ID: https://aggrega.ai/schemas/feature-v1beta1.schema.json
컴포넌트에 동적으로 바인딩되는 모듈식 운영 기능입니다.
Feature 엔터티 작성에 대한 설명 안내는 Feature 작성 레퍼런스를 참조하십시오. 이 페이지는 해당 레퍼런스가 설명하는 구조적 스키마를 문서화합니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 예 | 상수: "aggrega.ai/v1beta1" |
kind | const “Feature” | 예 | 상수: "Feature" |
metadata | object | 예 | |
spec | object | 예 | 카탈로그 Feature의 검증, 대상 지정 및 상호 운용성 계약입니다. 스키마로 작성하는 자유 형식 축(values, infra, provides), 고정 형식 축(usesSchema 의존성 소켓, featuresSchema 연결 슬롯), 컴포넌트 대상 지정(appliesTo 및 appliesToAnyOf), 그리고 상호 운용성 제어로 구성됩니다. |
추가 속성은 허용되지 않습니다.
feature.metadata
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 최소 1자 이상이어야 합니다. |
version | string | 예 | feature의 엄격한 Semantic Versioning입니다(예: 1.0.0). 패턴: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | 아니요 | 이 엔터티가 무엇이며 무엇을 위한 것인지를, 사용 여부를 결정하려는 사람을 위해 작성합니다. 대상을 밝히는 문장으로 시작한 뒤, 독자가 이를 선택하고 올바르게 사용하는 데 필요한 내용, 즉 이를 배포하는 Release에 무엇을 기대하는지와 동작에서 예상 밖인 점을 덧붙입니다. 보통 짧은 단락 하나 정도의 길이입니다. |
maintainers | object[] | 아니요 | 이 엔티티를 소유하는 메인테이너 목록입니다. |
license | string | 아니요 | 이 엔티티가 기술하는 소프트웨어의 라이선스를 나타내는 SPDX 식별자로, MIT 또는 AGPL-3.0 등이 있습니다. 이 파일의 조건이 아니라 해당 소프트웨어의 조건을 기록합니다. |
repository | string | 아니요 | 소스 파일이 있는 Git 저장소의 URL입니다. |
home | string | 아니요 | 이 엔티티의 홈페이지, 위키 또는 문서의 URL입니다. |
keywords | string[] | 아니요 | UI에서 쉽게 찾을 수 있도록 하는 설명 키워드 목록입니다. |
labels | object | 아니요 | Feature의 덕 타이핑 레이블입니다. 값이 ‘secret’인 예약 레이블 ‘feature.aggrega.ai/kind’는 작성자와 이를 표시하는 도구에 대해 이 Feature를 자격 증명 Feature로 표시합니다. 자격 증명 Feature와 일반 Feature는 같은 연결 표면 아래에서 같은 방식으로 연결됩니다. 연결이 무엇을 생성하는지는 레이블이 아니라 Manifest가 그 타입을 매핑하는 FeatureRecipe가 결정합니다. |
annotations | string 맵 | 아니요 | Domain 2의 플랫폼 아키텍트가 작성하는 불변의 고유한 기능 특성입니다. .context.annotations.catalog 버킷으로 전파됩니다. |
추가 속성은 허용되지 않습니다.
feature.metadata.maintainers[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | |
email | string | 아니요 | |
url | string | 아니요 |
추가 속성은 허용되지 않습니다.
feature.metadata.labels
Feature의 덕 타이핑 레이블입니다. 값이 ‘secret’인 예약 레이블 ‘feature.aggrega.ai/kind’는 작성자와 이를 표시하는 도구에 대해 이 Feature를 자격 증명 Feature로 표시합니다. 자격 증명 Feature와 일반 Feature는 같은 연결 표면 아래에서 같은 방식으로 연결됩니다. 연결이 무엇을 생성하는지는 레이블이 아니라 Manifest가 그 타입을 매핑하는 FeatureRecipe가 결정합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
feature.aggrega.ai/kind | string (enum) | 아니요 | Feature 종류 레이블입니다. 값 ‘secret’은 이것을 자격 증명 Feature로 표시합니다. 허용되는 값: "secret" |
feature.spec
카탈로그 Feature의 검증, 대상 지정 및 상호 운용성 계약입니다. 스키마로 작성하는 자유 형식 축(values, infra, provides), 고정 형식 축(usesSchema 의존성 소켓, featuresSchema 연결 슬롯), 컴포넌트 대상 지정(appliesTo 및 appliesToAnyOf), 그리고 상호 운용성 제어로 구성됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
extends | string | 아니요 | 이 Feature가 상속하는 기반 Feature에 대한 참조입니다. 기반은 Feature가 게시되는 레지스트리 좌표가 아니라 metadata.name으로 지정하며, 모든 카탈로그 참조와 동일한 세 가지 버전 형식을 사용합니다. 사용 가능한 가장 높은 릴리스를 뜻하는 단순 형식(core/queue), 정확한 버전(core/queue:1.0.0), 캐럿 범위(core/queue:^1.0.0)입니다. 상속되는 것은 메타데이터만이 아닙니다. 기반의 metadata.labels와 metadata.annotations, appliesTo와 appliesToAnyOf 셀렉터, interoperability 블록, usesSchema와 featuresSchema가 모두 아래로 병합되며, schema의 JSON Schema 2020-12 선언은 자동 병합됩니다. 공유 키에서는 자식 자신의 값이 우선하며, 식별 필드는 상속되지 않습니다. |
featuresSchema | object 맵 | 아니요 | 선언적 연결 슬롯 정의입니다. 이 Feature가 추가 Feature의 연결을 기대하는 이름 있는 바인딩 지점입니다. 슬롯은 어떤 채움이 슬롯에 바인딩될 수 있는지(selector)와 채움의 자료가 어떻게 전달될 수 있는지(inject)를 제한하며, values 및 infra 계약은 채움 자신의 Feature가 소유합니다. 슬롯을 선언해도 연결 블록이 닫히지는 않습니다. 작성자는 어떤 슬롯도 선언하지 않은 이름으로 Feature를 연결할 수 있습니다. 슬롯은 바인딩 지점이지 의존성 소켓이 아닙니다. 별도의 토폴로지 표면은 usesSchema가 선언합니다. |
appliesTo | string | 아니요 | Components와 매칭되는 Kubernetes 스타일의 레이블 셀렉터 문자열입니다. 쉼표로 구분된 요구 사항은 모두 충족되어야 합니다(AND). 지원되는 형식: key=value, key!=value, key in (v1, v2), key notin (v1, v2), 단순 key(레이블 존재), !key(레이블 부재). 예: “tier in (critical, production), !legacy”. 비어 있거나 없는 셀렉터는 제약을 선언하지 않습니다. 셀렉터는 이 Feature의 연결이 평가될 때마다 이 형식들에 맞춰 읽히며, 형식을 벗어난 요구 사항은 해당 요구 사항을 지목하며 빌드를 중단합니다. 빈 요구 사항(앞, 뒤 또는 중복된 쉼표)이나 공백 또는 = ! ( ) 및 쉼표를 포함한 키가 이에 해당합니다. 따라서 “!tier=frontend”는 거부되며, 값을 제외하려면 tier!=frontend를 사용합니다. 값은 연산자 뒤의 텍스트이며, 어떤 문자를 포함하든 상관없습니다. 이 필드의 패턴은 연결이 평가되기 전에 몇 가지 잘못된 형태만 거부합니다. 패턴: ^(?:[^()]*[()][\s\S]*|[ \t]*(?:![ \t]*[^,]*[^ \t,][^,]*|[^ \t,!][^,]*)?(?:,[ \t]*(?:![ \t]*[^,]*[^ \t,][^,]*|[^ \t,!][^,]*)?)*)$. |
appliesToAnyOf | string 또는 string[]의 map | 아니요 | 셀렉터 목록입니다. 어느 항목이든 하나라도 매칭되면 Feature가 적용됩니다(OR 논리). 각 항목은 레이블 셀렉터 문자열(appliesTo와 동일한 문법이며, 문자열 내부의 요구 사항은 AND로 결합됨)이거나 모든 쌍이 매칭되어야 하는 평면 키-값 map(동등 비교만 가능)입니다. |
interoperability | object | 아니요 | 고급 운영 안전성 및 상호 운용성 제어입니다. |
usesSchema | object 맵 | 아니요 | 이 엔터티가 선언하는 의존성 소켓으로, 소켓 이름을 키로 합니다. 소켓을 통해 연결되는 각 연결은 해당 소켓의 선언, 즉 셀렉터와 허용하는 inject 메커니즘에 대해 검사됩니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$. |
schema | object | 아니요 | 자유 형식 기둥을 다루는 JSON Schema 2020-12 콘텐츠입니다. values(Developer의 영역 — Developer가 Aggregate에서 Feature 연결마다 구성하는 애플리케이션 형태의 매개변수), infra(Operator의 영역 — Release가 제공하는 물리적 크기 조정 값), provides(이 Feature가 토폴로지 파이프를 통해 소비자에게 노출하는 다운스트림 컨텍스트 키)가 이에 해당합니다. 콘텐츠 형태에 따른 분기를 통해 세 가지 작성 모드를 허용합니다. (1) 인라인 콘텐츠(간결한 형식, JSON Schema YAML 또는 혼합 형식을 담은 YAML map), (2) {$import: |
assertions | string 맵 | 아니요 | 빌드 시점 필드 간 검증입니다. 각 항목은 이름 있는 어설션입니다. 키는 오류 메시지에 표시되는 안정적인 규칙 식별자이며, 값은 {{ fail "message" }} 중단 의미를 갖는 Go 템플릿 문자열입니다. 엔티티당 여러 개의 이름 있는 어설션은 인스턴스별로 작성자가 선언한 순서대로 평가되며, 처음 실패한 어설션이 빌드를 중단합니다. Feature 어설션은 해석과 정적 분석 후, 렌더링 전에 평가되며 계약의 아키텍처 불변 조건을 표현합니다. 템플릿 컨텍스트: .values / .infra / .uses / .features / .metadata. 평가기는 missingkey=error를 사용하므로 정의되지 않은 키에 대한 참조는 no-such-key 진단과 함께 중단됩니다. 단순 참조는 어떤 대체값도 실행되기 전에 중단되므로, 이 표면에서 일반 default는 선택 필드의 대체값을 제공하지 않습니다. hasKey로 참조를 보호하거나, 존재 여부를 직접 확인하는 optional 헬퍼를 사용하십시오. index를 통해 키를 읽어도 대체값은 제공되지 않습니다. index는 map에 없는 키에서 해당 키를 지목하며 중단됩니다. |
추가 속성은 허용되지 않습니다.
feature.spec.interoperability
고급 운영 안전성 및 상호 운용성 제어입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
conflictsWith | string[] | 아니요 | 이 Feature와 함께 하나의 component에 도달할 수 없는 Features의 이름이며, 각 이름은 연결의 type이 Feature를 지정하는 방식으로 작성합니다. 하나의 component가 이 Feature와 여기에 지정된 Feature를 함께 갖게 되면, 각각이 component에 연결되었든, 그것을 포함하는 subsystem이나 boundary에 연결되었든, Release component 항목에 연결되었든, 어노테이션 기반 확장으로 연결되었든 관계없이 빌드는 렌더링 전에 중단됩니다. 선언은 한 번으로 충분합니다. 중단을 위해 다른 Feature가 이 Feature를 나열할 필요는 없습니다. 이름은 버전을 제거한 상태로 비교되므로, 항목은 해당 Feature의 모든 버전과 매칭됩니다. component를 공유하지 않는 형제 boundary에 연결된 두 Features는 만나지 않으므로 중단되지 않습니다. |
추가 속성은 허용되지 않습니다.