자격 증명 모델
하나의 첨부 계열
Aggrega에서 자격 증명은 Feature입니다. 자격 증명은 다른 모든 Feature와 같은 표면에, 같은 키워드 아래, 같은 형태로 첨부됩니다. 다음 예에서는 개발자가 Aggregate에서 데이터베이스의 자격 증명을 첨부하고, 그 로케이터를 values에 작성합니다.
# the Aggregate — its parameters and the components' own values left outspec: components: api: type: core/compute/server db: type: core/datastore/mariadb features: root_password: # a credential Feature type: core/secret-value:1.0.0 values: key: MARIADB_ROOT_PASSWORD origin: "{{ .parameters.db_root_pass }}"그리고 운영자는 Release에서 서버에 메트릭 스크레이프 대상을 첨부합니다. core/prometheus-exporter가 받는 모든 입력, 즉 스크레이프의 포트, 경로, 간격은 운영에 관한 것이므로 infra에 작성합니다.
# the Release — the api's own infra and the db's entry left outspec: components: api: features: metrics: # an operational Feature type: core/prometheus-exporter:1.0.0 infra: port: http # the named port of the api's Service첨부 키워드는 하나(features:), 렌더 컨텍스트 형태도 하나(.features.<name>, 그리고 연결에 작성된 첨부의 경우 연결 아래의 같은 형태인 .context.uses.<alias>.features.<slot>), 실행 순서도 하나, 출력 좌표 집합도 하나입니다. 컴포넌트에 대한 첨부의 경우 출력 좌표는 첨부된 컴포넌트와 그다음 첨부된 이름이며, 대상의 레이아웃이 이 두 가지를 컴포넌트 자체의 디렉터리 옆에 있는 <component>--<instance>/ 디렉터리로 담든 <component>--<instance>-- 파일 이름 접두사로 담든 마찬가지입니다. 첨부마다 달라지는 것은 무엇을 생성하는가, 즉 주입된 값, 참조 가능한 리소스, 사이드카, 클라우드 ID이며, 선언되는 표면이 아닙니다.
자격 증명 Feature는 카탈로그 엔터티에 feature.aggrega.ai/kind: secret 레이블을 가집니다. 이 레이블은 설명용 메타데이터로, 독자, 카탈로그 사이트, 레이블 셀렉터에게 그 Feature의 용도를 알려 줍니다. 이 레이블을 읽는 컴파일러 분기는 없으며, 이 레이블에 따라 달라지는 동작도 없습니다. 동작은 운영자가 Feature 유형을 매핑하는 FeatureRecipe에서 나옵니다.
한 문장으로 요약한 멘탈 모델: 첨부의 종류는 하나이며, 달라지는 것은 그것이 생성하는 것입니다.
슬롯과 자유 연결
Component 또는 Feature는 featuresSchema에 슬롯을 선언할 수 있습니다:
spec: featuresSchema: root_password: required: true inject: [] # blackbox — the Recipe delivers it selector: "feature.aggrega.ai/kind=secret" user_password: inject: [env, file] # transparent — the developer may dictate delivery인스턴스 이름이 선언된 슬롯과 일치하는 연결은 그 슬롯을 채웁니다. 그 밖의 이름으로 된 연결은 자유 연결입니다. 엔터티가 요청하지 않은 것이며, 엔터티가 요청한 것과 나란히 렌더링됩니다. 선언된 슬롯에 대해 생성되는 스키마는 열린 상태로 유지되므로, 슬롯 하나를 선언해도 블록이 자유 연결에 대해 닫히지 않습니다. 렌더링하지 않고 중단되는 형태가 하나 있습니다. 컴포넌트 자체에 작성된 연결의 Feature가 그곳에서 아무것도 바인딩하지 않은 슬롯의 selector를 충족하는 경우로, 이는 자유 연결이 아니라 잘못된 이름으로 작성된 채우기입니다.
슬롯이 제약할 수 있는 것은 두 가지입니다:
inject— 슬롯을 채우는 것에 대해 Workload가 선택할 수 있는 전달 메커니즘입니다. 빈 목록은 블랙박스 슬롯입니다. Recipe 자체의 배관이 이를 전달하며(예: 차트의existingSecret설정), Workload는 컨테이너에서 이를 참조할 수 없습니다.selector— 슬롯을 채우는 Feature의 레이블이 충족해야 하는 레이블 셀렉터 문자열입니다. 바로 여기서kind=secret레이블이 제 역할을 합니다. 슬롯이 자격 증명으로만 채워지기를 원하는 엔터티 작성자는 셀렉터로 이를 명시하며, 이 검사는 컴파일러가 정적 분석 중에 수행하는 레이블 집합 평가입니다.
슬롯이 할 수 있는 세 번째 일은 결국 바인딩되도록 요구하는 것입니다. required: true는 슬롯의 이름을 필수로 만듭니다. 아무것도 이를 바인딩하지 않으면 컴파일러는 정적 분석 중에 중단하며, 슬롯과 이를 선언한 컴포넌트 타입을 명시하는 진단을 출력합니다. 이 요구는 모든 범위가 캐스케이드된 뒤 컴포넌트가 최종적으로 갖게 되는 연결 집합을 기준으로 판단되므로, 컴포넌트보다 상위에서 제공된 연결도 컴포넌트에 작성된 채우기와 똑같이 슬롯을 바인딩합니다.
두 번째 표면은 다른 요구를 표현합니다. 반복 가능한 Component 어노테이션 features.aggrega.ai/requiredType.<label>은 존재 의무를 선언합니다. 어노테이션이 지정한 Feature 타입을 이름이나 범위에 관계없이 최소 하나의 연결이 가져야 하며, 아무것도 충족하지 않는 의무는 같은 정적 분석 중에 고유한 진단과 함께 중단됩니다. 둘은 서로를 대신하지 않습니다. 슬롯은 이름 붙은 바인딩 지점 하나가 바인딩되었는지를 묻고, 의무는 어떤 연결이 이름 붙은 타입을 가지는지를 묻습니다. 따라서 Recipe가 연결된 것을 읽어야 하는 엔터티는 슬롯을 선언하고, 계약상 단지 어떤 기능이 존재하기만을 요구하는 엔터티는 의무를 선언합니다.
컴파일러가 보장하는 것과 보장하지 않는 것
이 섹션이 이 장의 핵심입니다. Aggrega는 AOT(ahead-of-time) 컴파일러이며, 그 보장 범위는 “secret”이라는 단어가 독자에게 기대하게 만드는 것보다 좁습니다.
컴파일러는 자격 증명을 절대 해석(resolve)하지 않습니다. 클라우드 API로 인증하지 않고, vault를 읽지 않으며, aggrega build 중에 자료를 가져오지 않습니다. 자격 증명 첨부의 values와 infra는 불투명한 스칼라로서 그래프를 거쳐 렌더 컨텍스트로 전달되며, FeatureRecipe는 이를 대상 플랫폼이 기대하는 아티팩트로 렌더링합니다. 해석은 나중에 클러스터나 IaC 상태 관리자에서, 렌더링된 아티팩트가 가리키는 대상을 기준으로 이루어집니다.
컴파일러는 포인터와 실제 자료 값을 구별할 수 없습니다. 컴파일러는 스칼라가 무엇을 의미하는지에 구애받지 않습니다(05-invariants.md 참조). 로케이터에 저장소 좌표(path, key, ARN)를 담은 자격 증명 첨부는 그 좌표에 대한 참조를 렌더링하고, 로케이터에 자료 자체를 담은 자격 증명 첨부는 자료를 그대로 출력 파일에 렌더링합니다. 둘 다 적법하며, 컴파일러는 이를 구별할 방법이 없으므로 동일하게 취급합니다.
따라서 보장을 정직하게 기술하면 다음과 같습니다.
Aggrega는 컴파일러가 어떠한 해석도 수행하지 않음을 보장합니다. 렌더링된 출력에 자료가 포함되지 않음은 보장하지 않습니다. 이는 전적으로 어떤 자격 증명 Feature가 첨부되었는지, 그리고 그 작성자, 즉
values의 개발자나infra의 운영자가 그 안에 무엇을 넣었는지에 달려 있습니다.
새겨 둘 만한 두 가지 결과가 있습니다.
- 렌더링된 아티팩트 트리는 자료를 가장 많이 담은 첨부만큼 민감합니다.
dist/를 그에 맞게 취급하십시오. 어느 첨부든 자료를 인라인으로 담고 있다면 트리에 자료가 들어 있습니다. - 카탈로그 자체의
core/secret-value및core/referenced-secret계열에는 값을 직접 받는 형식이 포함되어 있습니다. 이 형식들은 실제 배포에 로컬 개발 경로가 필요하기 때문에 존재하며, 이 점을 숨기지 않습니다. 제공되는 예제는 렌더링된 예제 속 자료가 실제 자격 증명이 아님이 눈에 보이도록 일부러 명백한 자리 표시자(dev-root-pw-change-me)를 사용합니다. 자료를 담아서는 안 되는 배포에서는 데이터를 내보내는 Feature 대신, FeatureRecipe가 가져오기 리소스(ExternalSecret, vault-fetch 사용자 정의 리소스, provider 고유의 secret 참조)를 내보내는 저장소 기반 자격 증명 Feature를 첨부하십시오.
표준 라이브러리의 관례는 자격 증명을 values 블록에 작성하는 대신 첨부로 요청하는 것이며, 그래서 로컬 개발용 채움을 저장소 기반 채움으로 바꾸는 일이 개발자 의도의 수정이 아니라 Manifest 변경이 됩니다. 이는 카탈로그가 따르는 관례이지, 컴파일러가 강제하는 규칙이 아닙니다.
선언된 민감도
위 절에서 설명했듯이 컴파일러는 포인터와 실제 값을 구별할 수 없습니다. 하지만 작성자는 구별할 수 있고, 그렇다고 밝힐 수 있습니다. Aggrega에서 민감도는 선언에 붙는 주석입니다. 카탈로그 엔터티의 작성자가 무엇이 비밀 자료를 담는지 밝히면, 컴파일러는 그 선언과 이미 구성한 연결을 바탕으로 나머지를 도출합니다. 값으로부터 추론하는 것은 없으며, 필드 이름으로부터 추측하는 것도 없습니다.
민감도는 정확히 두 곳에서 작성되며, 두 곳은 실제로 서로 다른 주장을 담습니다.
스키마 리프에서 — 이 데이터는 비밀 자료입니다. values, infra 또는 provides 리프가 sensitive: true를 선언합니다:
spec: schema: values: origin: type: string required: true sensitive: true # the material key: type: string default: value # a data key — a locator, not material첨부 슬롯에서 — 이 지점에 바인딩되는 것은 무엇이든 비밀 자료를 다룹니다. featuresSchema 슬롯이 sensitive: true를 선언합니다:
spec: featuresSchema: password: selector: "feature.aggrega.ai/kind=secret" sensitive: true inject: [env]두 수준은 편의를 위해 서로를 중복한 것이 아니며, 참조 가능한 자격 증명 형태가 그 이유를 보여 주는 예입니다. 참조 가능한 자격 증명은 provides.name과 provides.key, 즉 리소스의 위치 지정자와 그 안의 데이터 키를 게시하며, 둘 다 민감하지 않습니다. Kubernetes Secret의 이름은 공개되어 있고, 그 안의 키도 마찬가지입니다. 둘 다 소비자 자신의 매니페스트에 secretKeyRef로 평문 그대로 렌더링됩니다. 그런데 그 자격 증명이 채우는 슬롯은 분명히 비밀 자료를 다룹니다. 한 수준만으로는 두 사실을 모두 표현할 수 없습니다. 슬롯을 민감한 것으로 읽히게 하려고 게시된 위치 지정자에 표시를 하면 그것들에 대해 거짓을 말하게 되고, 선언이 읽히는 모든 곳에 그 오류가 따라다니게 됩니다.
이 두 선언으로부터 컴파일러는 첨부마다 그 첨부가 민감하다고 선언된 자료를 다루는지 도출합니다. 첨부된 Feature가 민감한 리프를 선언하거나, 그 첨부가 바인딩하는 슬롯이 민감함을 선언하면 참이며, 어느 한쪽만으로도 충분합니다. 컴파일러는 모든 작성 범위가 합쳐진 뒤의 첨부를 기준으로 이를 도출하므로, 더 좁은 범위의 채움이 대체한 더 넓은 범위의 선언은 남지 않으며, 슬롯의 요구는 실제로 채택된 채움에 적용됩니다. 대상 엔진이 자료를 소유하고 작성자가 아무것도 쓰지 않기 때문에 민감한 리프를 전혀 선언하지 않는 자격 증명 Feature라도, 민감한 슬롯에 바인딩되면 민감한 첨부가 됩니다.
한계를 분명히 말하면
“sensitive”라는 단어는 읽는 사람에게 기밀성 메커니즘을 기대하게 합니다. 하지만 그런 메커니즘이 아니며, 보장은 이름이 암시하는 것보다 다음 다섯 가지 측면에서 더 좁습니다:
- 암호화하지 않습니다. 아무것도 감싸거나 봉인하거나 변환하지 않습니다.
- 한 가지 예외를 제외하고 빌드 결과를 바꾸지 않습니다. 선언이 없다는 이유로 중단되는 빌드는 없으며, 자격 증명 엔터티에 선언이 없는 카탈로그도 성공적으로 빌드됩니다. 선언이 있다는 이유로 값이 수락되거나 거부되지도 않습니다. 다만 CloudFormation Recipe나 FeatureRecipe의
valuesMapping이 소싱된 템플릿의 매개변수를 채우기 위해 민감하다고 선언된 값을 읽는 경우는 예외입니다. 이때는 매핑이 바인딩하는 모든 리터럴이 거부되므로, 선언을 추가하면 성공하던 빌드가 중단될 수 있습니다. A secret bound to a CloudFormation parameter would be written into the template (CloudFormation 매개변수에 바인딩된 비밀이 템플릿에 기록됩니다)를 참조하십시오. 그 밖의 모든 경우에는 기존 카탈로그에 선언을 추가해도 성공하던 모든 빌드가 계속 성공합니다. - 렌더링된 출력에 자료가 없음을 보장하지 않습니다. 위에서 밝힌 보장은 변하지 않습니다. 아티팩트가 자료를 담는지는 어떤 채움이 첨부되었고 그 작성자가 무엇을 넣었는지에 달려 있습니다. 인라인으로 제공된 민감하다고 선언된 값은 빌드가 그것을 렌더링하는 곳이라면 어디서든 선언되지 않은 값과 똑같이 렌더링됩니다. 위의 CloudFormation 거부는 리터럴을 렌더링하는 대신 막는 것이고, 내장 함수는 그 텍스트를 포함해 주어진 그대로 기록됩니다. 그리고
dist/는 여전히 자료를 가장 많이 담은 첨부만큼 민감합니다. - 전달 메커니즘을 강제하지 않습니다. 선언은 인라인 값을 저장소 참조로 바꿀 수 없으며, 슬롯의
inject허용 목록이 허용하는 범위를 좁히지도 않습니다. 전달을 강제한다는 것은 작성자가 선언하지 않은 리소스를 내보낸다는 뜻이며, 이는 바로 유령 인프라 금지 불변식이 금지하는 것입니다. 05-invariants.md를 참조하십시오. - 대부분의 대상에서 렌더링되는 바이트를 하나도 바꾸지 않으며, 그런 대상에서는 앞으로도 바꾸지 않습니다. 제공되는 렌더링 경로 중 두 가지가 생성물에서 선언에 따라 동작합니다(Helm, Helm-Chart, Compose provider도 선언을 읽지만, 표시된 값이 실패 메시지에 나타나지 않게 하기 위해서일 뿐입니다). Terraform provider는 민감하다고 선언된 자료를 담는 벤더링된 모듈의 입력에 Terraform 자체의 민감도 속성을 표시합니다. language-reference/providers/terraform.md의 “Declared-sensitive module inputs”를 참조하십시오. Recipe의
valuesMapping이나 component에 첨부된 Feature의 FeatureRecipe의 매핑이 입력 이름을 만들어 내는 경우에는 어떤 입력도 그 속성을 가질 수 없으며, 빌드가 그렇다고 알리는 권고를 출력합니다. A declared-sensitive value reaches the target through a values mapping (민감하다고 선언된 값이 values 매핑을 통해 대상에 도달합니다)를 참조하십시오. 그리고 CloudFormation provider는 위에서 설명한 리터럴 바인딩을 거부하며, 이는 바이트를 바꾸는 대신 빌드를 중단시킵니다. 그 밖의 모든 경우에는 기존 카탈로그 전반에 선언을 추가해도 렌더링된 모든 아티팩트가 동일하게 유지됩니다. 그 너머의 한계는 무엇이 구현되었느냐의 문제가 아니라 구조적인 것입니다. 선언은 대상 플랫폼 자체의 언어가 민감도 개념, 즉 그 플랫폼이 이해하며 값을 저장하는 방식이 아니라 표시하는 방식을 규정하는 선언을 갖고 있을 때에만 렌더링된 아티팩트에 반영될 수 있습니다. 그런 개념이 없는 대상에서는 선언이 변환될 대상이 없으므로, 동일한 입력은 선언 유무와 상관없이 영구히 동일하게 렌더링됩니다.
선언이 실제로 바꾸는 것 하나는 CLI가 사람이 읽도록 출력하는 내용입니다. 민감하다고 선언된 값은 패스별 추적과 inspect 레이아웃에서 고정된 자리 표시자로 대체되며, 키는 유지하고 값만 숨깁니다. 이는 아무도 배포하지 않는 화면에서의 표시 결정이며, 렌더링된 아티팩트는 배포 대상이므로 그대로 출력됩니다.
컴파일러가 키로 값을 식별할 수 있는 경우, 즉 선언된 리프이거나 선언된 provides 키의 자료를 담는 전달 키인 경우에는 대체가 정확합니다. 템플릿이 이미 다른 문서에 기록한 값에는 대체할 키가 없습니다. 렌더링된 문서는 각 문자가 어떤 선언에서 왔는지 아무것도 기록하지 않으며, 그것을 복구하려면 내용을 검사해야 하기 때문입니다. 그래서 추적은 민감하다고 선언된 데이터가 이미 자리 표시자로 읽히는 컨텍스트에 대해 같은 템플릿을 한 번 더 평가하여 그런 문서를 보여 주며, 그 결과를 렌더링된 것이 아니라 재렌더링한 것으로 표시합니다. 값의 내용에 따라 분기하는 템플릿은 자리 표시자에 대해 다르게 렌더링되며, 어떤 선언도 지정하지 않은 데이터는 변경 없이 그대로 전달됩니다. 이러한 화면, 그 표시 방식, 그리고 그 한계는 language-reference/vocabulary/compact-form-authoring.md의 “Declaring a leaf sensitive”에 있습니다.
따라서 이 축이 제공하는 것을 정직하게 말하면 다음과 같습니다:
민감도 선언은 엔터티와 함께 이동하는 작성자 의도의 진술이므로, 도구와 정책이 배포가 무엇을 다루는지 추론할 수 있습니다. 그것을 보호하는 메커니즘은 아닙니다.
이 장의 나머지 부분에서 설명하듯이, 자료를 보호하는 것은 여전히 비밀 저장소, 클러스터, 그리고 렌더링된 트리를 다루는 파이프라인의 역할입니다.
자격 증명이 컨테이너에 도달하는 방식
전달 형태는 두 가지이며, 개발자가 아니라 첨부의 FeatureRecipe가 선택합니다.
주입된 값. FeatureRecipe는 injectMapping을 선언하고 리소스는 선언하지 않습니다. 그 출력은 기본 Recipe가 렌더링되기 전에 소비하는 컴포넌트의 전달 파이프에 깊은 병합되므로, .context.inject.env.<KEY>를 읽는 Recipe가 그 값을 받습니다. 독립적으로 내보내지는 것은 없습니다.
하나의 키 아래 두 자격 증명이 전달되면 빌드가 두 첨부를 모두 명시하며 중단됩니다. 다른 첨부된 Feature가 자신의 매핑이나 자신의 inject: 블록을 통해 이미 전달한 키를 쓰는 매핑은 병합되지 않고 거부되므로, 한 자격 증명이 다른 자격 증명 대신 제시되는 일은 없습니다. 이 규칙은 어디에서 첨부되었든, 컴포넌트의 슬롯을 채우든 연결의 슬롯을 채우든 모든 첨부에 동일합니다. 컴포넌트 자신의 inject: 블록이나 그 연결 중 하나가 전달한 키를 대체하는 매핑은 라우팅 Features가 의존하는 가로채기이며, 계속 허용됩니다.
참조 가능한 리소스. FeatureRecipe는 source, workload, artifacts 및/또는 valuesMapping을 선언하므로 리소스, 일반적으로 플랫폼 네이티브 Secret을 내보냅니다. 그 리소스의 식별 정보를 자신의 provides를 통해 게시하며, 소비자는 이를 .features.<name>.provides.name / .provides.key로 다시 읽습니다. 리소스 자체의 이름도 같은 게시된 provides에서 파생되므로, 소비자가 읽는 이름과 리소스가 지니는 이름은 어긋날 수 있는 두 파생이 아니라 한 번 평가된 하나의 문자열입니다.
Recipe의 Workload는 컨테이너의 attachments: 맵을 통해 참조 가능한 채움을 소비합니다.
workload: | containers: main: attachments: DB_PASSWORD: from: root_password # a slot the Component declares as: env합성기는 슬롯의 게시된 provides에서 참조를 해석합니다. as: env에는 Kubernetes secretKeyRef를, as: file에는 시크릿 기반 볼륨을 사용합니다. Recipe 작성자는 슬롯 이름과 메커니즘만 작성합니다.
FeatureRecipe는 두 가지를 모두 할 수 있습니다. 전달 파이프를 다시 쓰는 동시에 리소스를 내보낼 수 있습니다. 또한 Wasm 단계의 pipeline을 선언할 수 있으며, 이는 모든 첨부 계열에서 똑같이 실행됩니다. 자격 증명 첨부는 운영 첨부와 똑같이, 초대를 받으면 호스트 컴포넌트의 렌더링된 문서를 변환할 수 있습니다.
자격 증명의 이름을 정하는 주체
자격 증명의 로케이터(시크릿의 이름, 가져올 저장소 항목, 전달할 값)는 그것을 아는 사람이 작성하며, 그 사람이 항상 개발자인 것은 아닙니다. Release가 연결하는 커넥션은 Aggregate에 항목이 없고 Release는 어디에도 values를 작성하지 않으므로, 로케이터를 values에서만 가져오는 자격 증명은 그러한 커넥션에서도, Release가 만드는 어떤 어태치먼트에서도 이름을 지정할 수 없습니다.
따라서 호출자의 로케이터를 담는 표준 라이브러리 자격 증명 Feature, 즉 core/referenced-secret, core/referenced-secret-set, core/secret-value, core/secret-provided는 어느 작성자에게서든 로케이터를 받습니다. 개발자는 Aggregate에서 어태치먼트의 values에, 운영자는 Release에서 어태치먼트의 infra에 작성합니다. 이 리프는 두 축 모두에서 하나의 이름, 하나의 형태, 하나의 sensitive: true 선언을 가지며, 모든 구현은 그것을 담은 축을 읽습니다. Release의 values: 금지는 그대로 유지됩니다. 운영자의 로케이터는 infra이기 때문입니다. 로케이터를 받지 않는 Features인 core/random-password와 core/generated-secret은 영향을 받지 않습니다.
정확히 하나, Feature가 보장합니다. 어태치먼트는 로케이터를 한 축에만 담으며, 두 축 모두에 담거나 어느 축에도 담지 않는 일은 없습니다. 각 축은 따로 검증되므로 어느 축의 스키마도 이를 표현할 수 없습니다. 이를 표현하는 것은 각 Feature 자체의 assertions 블록이며, 이를 위반하는 어태치먼트는 Feature, 어태치먼트, 컴포넌트의 이름을 밝히며 빌드를 중단시킵니다. 이것은 카탈로그 엔터티의 계약이며, 모든 Feature 어서션과 같은 방식으로 유지됩니다. 컴파일러는 Feature 작성자가 작성한 템플릿을 평가할 뿐이며, 자격 증명, 축, 로케이터에 관한 자체 규칙은 갖고 있지 않습니다.
제자리에 남는 것. 그 밖의 모든 필드는 원래의 축을 유지합니다. 참조 가능한 자격 증명의 데이터 키는 여전히 values에 작성되므로 Release만 만드는 어태치먼트는 그 기본값을 읽습니다. 그리고 core/secret-provided는 여전히 어태치먼트 자체의 inject: 블록을 통해서만 전달하며, 이 블록은 Aggregate만 작성하고 커넥션의 어태치먼트는 결코 담지 않습니다.
여러 소비자 간에 하나의 자격 증명 공유
소비자가 자격 증명을 보유할 수 있습니다. 슬롯은 자격 증명이 필요한 엔터티에 속하며, 이는 호출되는 대상보다 호출자인 경우가 많습니다. 외부로 연결할 때 키를 제시하는 컴포넌트는 그 키를 위한 슬롯을 자신의 카탈로그 엔터티, 즉 외부로 연결하는 소켓에 선언하므로, 키는 그것이 제시되는 연결에 보유됩니다. 그리고 uses 엣지의 어떤 부분도 대상이 키를 제공하도록 강제하지 않습니다. core/ai-agent/crewai가 제공되는 형태입니다. 그 model 소켓은 feature.aggrega.ai/kind=secret 선택자, inject: [env], sensitive: true를 갖는 선택적 credential 슬롯을 선언하며, Aggregate는 연결 아래 uses.model.<alias>.features.credential에서 이를 채웁니다. 표준 라이브러리 모델 컴포넌트가 소비자가 읽도록 게시하는 것은 서빙 위치와 모델 이름이지 자격 증명이 아니므로, 에이전트가 해당 엔드포인트를 호출할 때 제시하는 키는 에이전트가 선언하고 그 연결에 보유합니다. 슬롯은 선택 사항이지만, 카탈로그가 component.aggrega.ai/hosting: managed로 레이블을 지정한 모델에 도달하면서 자격 증명을 갖지 않는 연결은 자체 values가 모델에 자격 증명이 필요 없다고(unauthenticated: true) 명시하지 않는 한 빌드를 중단합니다. 이는 에이전트의 카탈로그 엔터티가 갖는 어서션이며, 컴파일러는 다른 어서션과 마찬가지로 레이블을 문자열로 읽어 이를 평가합니다. 연결되는 모델 컴포넌트는 자신의 자체 호출자를 위한 키를 따로 보유할 수 있으며(core/ai-model/vllm은 바로 그 용도로 api_key 슬롯을 선언합니다), 두 슬롯은 별개의 바인딩 지점입니다. 어태치먼트는 슬롯이 선언된 곳, 즉 컴포넌트나 연결에서 이름으로 슬롯을 바인딩하므로, 하나를 채워도 다른 하나에는 아무 영향이 없습니다.
이 배치 덕분에 아래의 두 형태가 비로소 배포 선택지가 됩니다. 슬롯이 소비자에 있으므로, 어떤 빌드는 각 소비자에게 고유한 키를 주고 다른 빌드는 모두에게 같은 키를 줄 수 있으며, 그 사이에 바뀌는 카탈로그 엔터티는 없습니다.
같은 카탈로그 엔터티가 두 형태를 모두 지원하며, 어느 쪽을 쓸지는 작성자가 선택합니다.
- 소비자별. 각 소비자는 자신의 슬롯을 고유한 자격 증명 어태치먼트로 채웁니다. 컴포넌트에, 또는 슬롯이 소켓의 것이라면 그 연결에 채웁니다. 각 소비자는 고유한 렌더링된 리소스를 받습니다.
- 공유. 컴포넌트가 선언한 슬롯의 경우, 하나의 자격 증명을 공유 범위(Aggregate의 서브시스템, Release의 경계)에 한 번 어태치하면 그 범위의 모든 컴포넌트로 전파됩니다. 소켓이 선언한 슬롯은 연결별로 채워지며 연결 안으로는 아무것도 전파되지 않으므로, 이 경우 공유 형태는 각 연결에서 작성됩니다. 모든 연결의 자격 증명이 하나의 파라미터를 읽습니다. 소비자들이 하나의 물리적 리소스를 참조해야 하는 경우 그 파라미터가 리소스를 지정합니다. 기존 Secret 구현에 바인딩된
core/referenced-secret은 모든 연결이 이름으로 하나의 Secret을 가리키게 하며, 생성되는 자격 증명은 아래에서 설명하듯 하나의 요청과 여러 참조로 구성됩니다.
공유 형태의 렌더링은 다르게 가정하기 쉬우므로 정확히 밝혀 둡니다. 공유 어태치먼트는 소비자마다 리소스를 하나씩 렌더링하며, 각 리소스는 하나의 선언에서 나온 같은 내용을 담습니다. 렌더링은 컴포넌트별로 실행되므로 {{ .context.instance_id }}-{{ .attachment_name }}에서 파생된 리소스 이름은 소비자마다 다릅니다. 공유되는 것은 하나의 선언이며, 생성된 리소스가 하나로 중복 제거되지는 않습니다. 각 연결에서 읽는 하나의 파라미터도 리소스를 렌더링하는 구현에서는 같은 방식으로 렌더링됩니다. 연결마다 하나씩 렌더링되며, 어태치먼트 이름은 연결의 별칭, 점, 슬롯으로 구성됩니다.
배포에 여러 소비자가 읽는 물리적 Secret이 정확히 하나 필요하다면, FeatureRecipe가 경계 범위(executionScope: boundary)에서 실행되는 자격 증명 Feature로 표현합니다. 이 경우 컴포넌트마다가 아니라 경계마다 한 번 렌더링됩니다.
연결의 양 끝이 모두 보유하는 키
키를 검사하는 서버와 그 서버를 호출하는 컴포넌트는 각자 자기 쪽에서 그 키를 보유합니다. 서버는 검증할 키를 자신의 Component 슬롯에 보유합니다. core/ai-model/vllm, core/ai-model/tei, core/ai-model/tgi는 각각 api_key를 선언하며, LiteLLM 모델과 게이트웨이도 LiteLLM이 마스터 키라고 부르는 키를 위해 이를 선언합니다. 그리고 서버의 Recipe는 슬롯을 채운 값을 서버가 읽는 변수로 전달합니다. 호출자는 제시할 키를 자기 쪽에 보유합니다. 키를 제시하는 연결에서 소켓이 선언한 슬롯에 보유하거나(core/ai-agent/crewai의 model 소켓이 credential을 선언하듯), Component가 키를 자신에게 선언한 경우에는 그 슬롯에 보유하여 자신이 만드는 모든 연결에 적용합니다. 어느 쪽도 상대의 어태치먼트를 보지 못합니다. 연결의 어태치먼트는 호출자에게만 적용되며, 서버의 렌더링 출력은 도달하는 연결이 무엇을 갖든 동일합니다. 서버는 호출자가 어떤 키를 보유하는지 알지 못하고, 호출자는 서버가 게시하는 주소와 모델 이름만 읽습니다. 두 끝이 일치하는 것은 Aggregate가 하나의 파라미터로 양쪽에 값을 공급하기 때문입니다.
spec: parameters: model_key_secret: { type: string } components: model: type: core/ai-model/vllm values: { model: Qwen/Qwen2.5-0.5B-Instruct } features: api_key: # the key the server verifies type: core/referenced-secret values: origin: "{{ .parameters.model_key_secret }}" key: api-key router: type: local/gateway/model-router # its `models` socket declares a `credential` slot uses: models: local: target: model features: credential: # the key the caller presents type: core/referenced-secret values: origin: "{{ .parameters.model_key_secret }}" key: api-key그것이 하나의 시크릿인지 둘인지는 두 끝이 시크릿을 어디서 확인하는지에 따라 정해집니다. 프로바이더는 시크릿 범위 안에서 참조로 시크릿을 확인합니다. helm에서는 Kubernetes 네임스페이스, compose에서는 Compose 프로젝트, terraform에서는 경계의 루트 구성, cloudformation에서는 배포되는 AWS 계정과 리전의 스택입니다. 두 끝이 한 범위에 있으면 하나의 시크릿 리소스를 참조합니다. 다른 범위에 있으면 각 끝이 같은 저장소 항목으로부터 구현된 자체 시크릿 리소스를 보유합니다. Manifest는 각 끝의 구현을 Feature 유형별로, 또는 하나의 어태치먼트에 대해서는 이름으로 선택하며, 연결의 어태치먼트 이름은 <alias>.<slot>(위의 local.credential)입니다. 하나의 파라미터가 양쪽에 공급되므로, 두 구현은 origin을 같은 종류의 로케이터로 읽습니다. 둘 다 Secret 이름이거나, 둘 다 저장소 항목의 키이거나, 둘 다 값 자체입니다.
helm에서 두 끝이 한 네임스페이스에 있을 때, core/referenced-secret을 helm/k8s-existing-secret에 바인딩하고 그 네임스페이스에 있는 Secret의 이름 model-keys로 파라미터를 채우면, 두 끝이 이름으로 이를 참조하고 Secret은 렌더링되지 않습니다. 서버의 컨테이너에는 다음이 포함됩니다.
- name: VLLM_API_KEY valueFrom: secretKeyRef: name: model-keys key: api-key그리고 라우터의 Recipe는 연결의 .context.uses.local.features.credential.provides에서 같은 이름과 키를 읽습니다. 두 끝이 다른 네임스페이스에 있으면, 이를 helm/k8s-external-secret에 바인딩하고 저장소 항목의 키로 파라미터를 채워 각 끝이 자신의 네임스페이스에 고유한 ExternalSecret을 갖게 하며, 둘 다 같은 항목을 가져옵니다. compose에서는 두 끝이 같은 ${VAR} 참조를 가지며, Docker Compose는 하나의 프로젝트가 시작되는 환경에서 이를 치환합니다. 이 배치는 표준 라이브러리 카탈로그가 따르는 관례이며, 컴파일러는 두 끝 사이에서 아무것도 비교하지 않습니다.
하나의 키가 모든 호출자에게 쓰입니다. vLLM, TEI, TGI는 각각 단일 키만 검사하므로, 모든 호출자가 같은 키를 제시하며 서버는 도달하는 연결이 몇 개든 호출자를 서로 구별할 수 없습니다. 이는 서버 자체의 한계입니다. TGI는 대소문자를 구분하지 않고 키를 비교하므로, 대소문자만 다른 두 키는 TGI에게 하나의 키입니다. LiteLLM 모델과 게이트웨이는 관리 데이터베이스가 어태치되어 있는 동안 자신이 발급한 키도 허용합니다.
대상이 생성하는 자격 증명
Release가 자격 증명을 제공하지 않는 경우, 카탈로그 엔터티는 흔히 개발용 기본값으로 대체합니다. Recipe 안의 인라인 값이나 모듈 매개변수의 기본값이 그 예입니다. 이 값은 카탈로그를 읽는 모든 사람에게 동일하므로 평가 용도로만 허용될 뿐 그 밖의 용도로는 허용되지 않습니다. core/random-password는 이러한 값이 필요 없게 합니다. 대상이 자격 증명을 생성하므로 아무도 자격 증명을 작성하지 않습니다.
빌드는 비밀번호가 만들어지는 곳이 될 수 없습니다. 빌드의 출력은 입력의 순수 함수이며 시크릿의 값을 절대 담지 않으므로, 빌드 시점에 생성된 비밀번호는 빌드할 때마다 바뀌고 렌더링된 파일에 남게 됩니다. 대신 FeatureRecipe는 요청을 렌더링합니다. 이는 자신이 채울 시크릿 리소스를 지정하는 생성기 리소스이며, 대상이 배포 시점에 값을 생성합니다.
helm에서는 클러스터의 컨트롤러입니다.ExternalSecret을 통해 조정되는 External Secrets Operator의 비밀번호 생성기, 또는StringSecret을 조정하는 kubernetes-secret-generator 컨트롤러가 이에 해당합니다.terraform에서는 random provider의random_password이며, 구성이 적용될 때 생성됩니다.cloudformation에서는 스택이 생성할 때 자체 문자열을 생성하는 Secrets Manager 시크릿입니다.
어느 경우든 렌더링된 출력은 생성기와 시크릿 리소스를 지정할 뿐 값을 담지 않습니다. 이는 빌드가 가진 것의 속성이지, 빌드가 추가하는 보호 장치가 아닙니다. 값은 대상이 만들기 전까지 존재하지 않습니다. 이후 대상이 값을 어디에 보관하는지는 대상의 몫입니다. Terraform은 plan과 state에, 클러스터는 Secret에 보관합니다.
대상에서 실행 중이어야 하는 것. 요청은 그것을 채우는 무언가가 있는 곳에서만 채워집니다. helm에서는 그것이 컨트롤러이며, 컴파일러는 컨트롤러가 실행 중인지 알기 위해 클러스터를 검사할 수 없으므로, helm FeatureRecipes는 Release가 첨부에 infra.control_plane_present: true로 전제 조건을 확인하지 않으면 빌드를 중단합니다. terraform과 cloudformation에서는 apply나 스택이 직접 값을 생성하므로 미리 실행 중이어야 하는 것이 없습니다.
사용할 수 없는 곳. Compose는 컨트롤러를 실행하지 않으며 값을 생성하는 리소스도 없으므로, 그곳에서 core/random-password를 실현하는 FeatureRecipe는 없고, compose에서 이를 바인딩하는 빌드는 FeatureRecipe가 없어 중단됩니다. compose를 대상으로 하는 Release는 core/secret-value를 통해 자격 증명을 제공하며, 일반적으로 스택이 시작될 때 Docker Compose가 치환하는 변수 참조로 제공합니다.
소비자가 읽는 방식. core/random-password는 core/referenced-secret과 동일한 provides.name과 provides.key를 게시하고 동일한 feature.aggrega.ai/kind: secret 레이블을 가지므로, 자격 증명 계열을 선택하는 슬롯은 이를 허용하며 소비자는 생성된 자격 증명을 이미 존재하는 자격 증명과 정확히 같은 방식으로 읽습니다.
여러 소비자가 하나를 공유하는 방식. 생성기는 요청마다 새 값을 생성하므로, 앞 절의 공유 규칙이 더 엄격하게 적용됩니다. 공유 범위에 첨부되거나 각 소비자에 첨부된 생성 자격 증명은 소비자마다 요청 하나씩을 렌더링하고, 각 요청은 서로 다른 비밀번호를 생성하므로 데이터베이스와 그 클라이언트가 사용할 수 없습니다. 여러 소비자가 공유하는 하나의 생성 자격 증명은 하나의 요청과 여러 참조로 표현합니다. 한 컴포넌트에는 채울 Secret을 name 값으로 고정한 core/random-password를 두고, 나머지에는 기존 Secret 실현에 바인딩되어 같은 이름을 가리키는 core/referenced-secret을 둡니다. 하나의 매개변수로 작성하면 둘은 어긋날 수 없으며, 렌더링 결과에는 모든 소비자가 참조하는 요청이 정확히 하나 담깁니다.
core/random-password는 core/generated-secret과 다릅니다. 후자의 Feature는 이미 전체 수명 주기를 소유한 엔진(관리형 데이터베이스, 데이터베이스 컨트롤러)에 자격 증명을 넘기며 아무것도 렌더링하지 않습니다. core/random-password는 Recipe가 자격 증명을 전달받을 것으로 예상하는 워크로드를 위해 요청 자체를 렌더링합니다.
연결 우선순위
하나의 연결은 여러 범위에서 동시에 선언될 수 있습니다. 경합하는 필드의 소유권은 다음 세 가지 규칙을 이 순서대로 적용하여 결정됩니다.
- 출처. 명시적으로 작성된 필드는 어노테이션 기반 확장이 기여한 필드보다 우선하며, 각각이 어느 범위에서 왔는지는 상관없습니다.
- 구성 권한. 배포 중인 Aggregate의 선언은 그 Aggregate가 구성하는 Aggregate 내부의 선언보다 우선하며, 구성된 문서가 더 좁은 범위에서 선언한 경우에도 마찬가지입니다.
- 구체성. 하나의 작성 수준 안에서는 더 좁은 범위가 더 넓은 범위를 필드 단위로 세분화합니다. 컴포넌트 수준의 채움은 같은 인스턴스 이름을 가진 서브시스템 전체 또는 경계 전체의 연결을 자신이 언급하는 필드에 대해서만 재정의하며, 생략한 필드는 더 넓은 범위의 값을 유지합니다.
개발자 측은 values를, 운영자 측은 infra를 제공하므로 두 측이 같은 필드를 두고 경합하는 일은 없습니다. 어느 쪽에서든 로케이터를 받는 자격 증명 Feature는 이를 축마다 하나씩 두 개의 필드로 선언하며, 자체 어서션이 두 필드를 모두 가진 연결을 거부하므로 그 경우에도 우선순위가 동률을 가릴 일은 없습니다. 우선순위는 필드 값만 결정하며 평가 순서를 바꾸지 않습니다. 평가는 10-compilation-pipeline.md의 캐스케이드 순서를 따릅니다.
형식화된 문자열을 요구하는 레거시 차트
차트가 자격 증명 자료가 포함된 단일 연결 문자열(oracle://admin:PASSWORD@HOST:1521/DB)을 요구하는 경우가 있습니다. AOT(ahead-of-time) 컴파일러는 자료를 보유하지 않으므로 저장소 좌표로부터 이 문자열을 만들 수 없습니다. 지원되는 경로는 두 가지입니다.
클러스터 측 템플릿. 자격 증명 FeatureRecipe가 vault 오퍼레이터 자체의 템플릿 기능을 사용하여 클러스터 안에서 문자열을 형식화하는 리소스를 내보냅니다. 그러면 애플리케이션은 그 결과로 만들어진 플랫폼 Secret을 이름으로 참조하며, 컴파일러는 자료를 한 번도 보유하지 않은 채 이 관계를 연결합니다.
{ "apiVersion": "external-secrets.io/v1beta1", "kind": "ExternalSecret", "metadata": { "name": "oracle-dsn-secret" }, "spec": { "target": { "name": "oracle-formatted-dsn", "template": { "engineVersion": "v2", "data": { "ORACLE_DSN": "oracle://admin:{{ .password }}@10.0.5.55:1521/PROD_DB" } } }, "data": [ { "secretKey": "password", "remoteRef": { "key": "arn:aws:secretsmanager:prod/oracle" } } ] }}매개변수 호이스팅. Aggregate가 타입이 지정된 매개변수를 선언하고, 이를 둘러싼 CI 파이프라인이 빌드 시점에 Release의 parameters:를 통해 값을 제공합니다. 예를 들어 파이프라인이 파일을 작성하고 Release가 parameters: { $import: ./ci-parameters.yaml }로 그 파일을 가져옵니다. 이것은 명시적인 탈출구이며, 그 대가를 드러냅니다. 이제 자료가 빌드를 거쳐 흐르므로 렌더링된 출력에 자료가 담기게 되고, 출력은 그에 맞게 다뤄야 합니다.
로컬 개발
권장되는 로컬 개발 경로는 개발자의 의도를 그대로 두고 바인딩만 교체합니다. Aggregate는 동일한 자격 증명 Feature 유형을 계속 연결하고, 로컬 Manifest는 그 유형을 저장소 기반 FeatureRecipe 대신 로컬 FeatureRecipe에 매핑합니다. 컴파일러는 여전히 아무것도 가져오지 않습니다. 로컬 FeatureRecipe는 로컬 런타임이 해석하는 provider 고유 구문을 전달할 뿐입니다. Compose의 경우 이는 서비스의 환경에 기록되는 ${SECRET_NAME} 같은 변수 참조이며, Docker Compose는 스택이 시작될 때 이를 셸 환경이나 .env 파일의 값으로 치환합니다. 환경 전환은 Manifest 수정만으로 이루어집니다.
자격 증명을 둘러싼 데이터 거버넌스
Aggrega는 데이터 스키마를 모델링하지 않습니다. 행, 열, 파일은 애플리케이션의 관심사입니다. Aggrega는 레이블로 데이터의 거버넌스 정체성을 모델링하며, 표준 라이브러리의 관례는 다음과 같습니다.
- 데이터는 온톨로지 레이블이 상태 저장형 또는 리소스형으로 표시하는 컴포넌트에 있습니다(
component.aggrega.ai/type: stateful-server,resource). 대기 중인 페이로드를 보유하는 메시지 브로커도 여기에 해당합니다. 자체 디스크를 소유하면stateful-server를, Release가 호스팅된 브로커를 연결하면resource를 가지며, 브로커가 분류되는messaging선반은 별도의component.aggrega.ai/category축입니다. compliance.aggrega.ai/data-class(public,internal,restricted)는 그 데이터에 의미적 정체성을 부여합니다. 이 관례는 키와 그 값을 정할 뿐, 어떤 컴포넌트가 이를 가지는지는 정하지 않습니다. 표준 라이브러리의 어떤 Component도 이를 가지지 않는데, 컴포넌트가 보유한 데이터의 등급은 제품의 속성이 아니라 조직이 그 컴포넌트를 어떻게 사용하는지에 대한 진술이므로, 조직이 자신의 Components에 직접 명시하기 때문입니다. 이는 일반 레이블입니다. 레이블 셀렉터가 이를 평가하며, 운영자가 연결한 거버넌스 플러그인이 이를 읽고 빌드를 거부할 수 있습니다. 컴파일러 자체는 이를 해석하지 않으며 어떤 등급도 다른 등급보다 높게 매기지 않습니다. 어떤 등급이 존재하고 어떻게 순위가 매겨지는지는 연결된 정책 자체의 설정이며, ../language-reference/examples/policy-data-class-route/에서 그 예를 볼 수 있습니다.
data-class와 sensitive는 서로 다른 두 축이며, 이를 하나로 합치면 정보가 손실됩니다. 둘은 나란히 위치하여 하나의 표면으로 착각하기 쉬우므로 구분을 유지해야 합니다.
compliance.aggrega.ai/data-class | sensitive | |
|---|---|---|
| 형태 | 등급형 — public / internal / restricted | 불리언 |
| 세분성 | 노드 전체 | 하나의 스키마 리프 또는 하나의 연결 슬롯 |
| 의미 | 컴포넌트가 보유한 데이터가 어떤 거버넌스 정체성을 갖는지 | 이 데이터가 비밀 자료라는 것, 또는 이 바인딩 지점이 그것을 다룬다는 것 |
| 작성 방식 | metadata.labels의 레이블 | 선언에 붙는 키워드 |
어느 쪽도 다른 쪽을 대신하지 않습니다. 민감성을 등급형 레이블에 억지로 넣으면 순서가 없는 사실에 순서를 부여하게 되고, 데이터 등급을 리프에 억지로 붙이면 분류에 없는 세분성을 부여하게 됩니다. 엔터티는 둘 다 가질 수 있으며, 자격 증명 슬롯이 sensitive로 선언된 restricted 데이터 보유 컴포넌트는 서로 별개인 두 가지 참인 사실을 진술하는 것입니다. 리프 및 슬롯 키워드는 ../language-reference/vocabulary/compact-form-authoring.md의 “Declaring a leaf sensitive”와 ../language-reference/entities/component.md의 “Declaring a slot sensitive”에서 설명합니다.
저장 데이터 암호화는 의도적으로 개발자 의도와 컴파일러의 범위 밖에 있습니다. 이는 상태 저장형 컴포넌트의 Ops Recipe와, 노드의 레이블을 읽고 암호화된 스토리지 구성을 내보내는 렌더링 플러그인의 몫입니다. 이 배치는 해당 관심사가 어디에 속하는지에 대한 설계 지침이며, 컴파일러는 어떤 Recipe가 이를 따르는지 검사하지 않습니다.
여기서 독자적인 것과 그렇지 않은 것
독자가 정확히 판단할 수 있도록, 공개적인 위치 설정은 분명하고 좁게 밝혀 둘 가치가 있습니다.
독자적인 점: 소켓 계약은 인라인으로 선언되지 않고 게시됩니다. 자격 증명이 충족해야 하는 계약, 즉 슬롯, 그 전달 허용 목록, 그 레이블 셀렉터는 그것을 게시한 사람이 카탈로그 엔터티에 작성하며, 제3자가 유지 관리하는 카탈로그에 존재합니다. 소비자는 자신의 구성에서 계약을 인라인으로 기술하지 않습니다. 다른 사람이 게시한 계약을 채우며, 컴파일러는 그 채움을 게시된 선언과 대조하여 검사합니다. 소비자와 계약 작성자는 서로 다른 사람이며, 서로 다른 저장소에서 서로 다른 릴리스 주기로 작업합니다.
독자적인 점: 채움은 레이블 셀렉터로 제약됩니다. 슬롯은 특정 구현을 지명하는 대신 어떤 종류의 것이 자신을 채울 수 있는지를 지정할 수 있습니다(selector: "feature.aggrega.ai/kind=secret"). 검사는 레이블 집합 평가이므로, 엔터티는 들어 본 적 없는 채움의 계열도 받아들일 수 있으며, 새로운 채움은 올바른 레이블을 지니는 것만으로 자격을 얻습니다.
독자적이지 않은 점: inject 매핑. “이 로컬 환경 변수 이름이 저 생성된 값을 받는다”라는 매핑은 잘 알려진 패턴이며, 여러 구성 및 배포 도구가 각자의 구문으로 같은 개념을 표현합니다. Aggrega의 방식은 사전에 평가되어 전달 파이프에 병합되는 매핑이지만, 그 개념은 저희의 것이 아니라 생태계의 것입니다.
독자적이지 않은 점: 사전(ahead-of-time) 정적 생성. 생성 시점에 라이브 클러스터에 접근하지 않고 상위 수준의 기술로부터 배포 아티팩트를 정적으로 생성하는 것은 Aggrega의 발명이 아닙니다. 다른 도구들도 이를 수행하며, Aggrega가 존재하기 전부터 수행해 왔습니다. Aggrega가 더하는 것은 정적 생성 자체가 아니라 그 위에 놓인 게시된 계약 계층입니다.
보안 경계가 아닙니다. 이 장의 어떤 것도 기밀성 메커니즘이 아닙니다. 자격 증명 모델은 연결(wiring) 모델입니다. 포인터나 값이 어디에서 오는지, 누가 그것을 제약할 수 있는지, 그리고 그것이 어떻게 컨테이너에 도달하는지를 결정합니다. 자료를 보호하는 것은 시크릿 저장소, 클러스터, 그리고 렌더링된 트리를 처리하는 파이프라인의 역할입니다.
상호 참조
- 05-invariants.md — 이 장의 기반이 되는 사전(ahead-of-time) 불변 조건과 문자열 파이프 불변 조건.
- 10-compilation-pipeline.md — 파이프라인에서 첨부 해석과 리소스 생성(Resource Generation)이 위치하는 곳.
- ../language-reference/entities/component.md — 슬롯 수준의
sensitive선언,required키워드, 슬롯과 존재 의무(presence mandate)의 항목별 비교를 포함한featuresSchema슬롯 작성. - ../language-reference/vocabulary/compact-form-authoring.md — 리프 수준의
sensitive키워드, 선언이 읽히는 위치, 그리고parameters:의 비대칭성. - ../language-reference/entities/workload.md — 컨테이너
attachments:맵과 그 검증 규칙. - ../language-reference/examples/04-secrets.md — 작성 체크리스트와 transparent / blackbox 실제 예제.
- ../language-reference/examples/05-credential-features.md — 자격 증명 Feature 계열과 처음부터 끝까지의 단계별 안내.
- ../language-reference/examples/model-api-key-sharing/ — 에이전트의 소켓이 선언하는 자격 증명 슬롯을 하나의 카탈로그 엔터티로 각 연결에서 세 가지 방식으로 채우는 예제: 연결마다 키 하나, 모든 연결이 참조하는 Secret 하나, 한 연결이 재정의하는 공유 기본값이며, 각 형식의 렌더링된 출력을 함께 보여 줍니다.