provides, inject, uses
주입 계약과 사전 해석된 맵
Aggrega는 AOT(Ahead-of-Time) 정적 컴파일러이므로, 컴파일 중에 실제 인프라에서 거꾸로 흘러 들어오는 데이터는 없습니다. 컴파일러가 물리적 자격 증명(예: AWS 시크릿)을 능동적으로 가져와 개발자의 컨테이너 환경으로 “되돌려” 전달하는 것은 구조적으로 불가능합니다.
그 대신 플랫폼은 진정한 제어 역전에 의존합니다. 개발자가 inject: { env: [{ in: ORACLE_PASSWORD, from: "password" }] }를 작성할 때, 이는 데이터 가져오기를 시작하는 것이 아니라 인프라에 엄격한 계약을 지시하는 것입니다.
- 의도(도메인 1): 개발자는 추상 인터페이스를 선언합니다: “시크릿이 필요합니다. 어디에 있는지는 모릅니다. 카탈로그의
password키에 매핑되는ORACLE_PASSWORD로 제 환경에 주입만 해 주세요.” - 컴파일러 전달(렌더링 시): Go 컴파일러는 항목
{ in: ORACLE_PASSWORD, from: "password" }를 받아 Ops Recipe에 넘깁니다. 물리적 시크릿은 가져오지 않습니다. - Plugin 출력(도메인 3): 자격 증명 FeatureRecipe의 Wasm 파이프라인이 대상 인프라에 필요한 정확히 맞물리는 아티팩트를 생성합니다. 예를 들어 Kubernetes에서는
ExternalSecretCRD(클러스터에 볼트 데이터를 가져오도록 지시)를 출력하고 동시에 대상 Pod에 JSONPatch를 실행하여, 결과로 생성되는 로컬 K8s Secret을 개발자가 요청한"ORACLE_PASSWORD"환경 변수에 정확히 매핑합니다. - 런타임의 현실: 런타임에는 클러스터 내 오퍼레이터가 이렇게 생성된 아티팩트를 실행하여 자격 증명을 가져오고 컨테이너에 물리적으로 마운트할 뿐이며, 이로써 물리적 보안 메커니즘이 AOT 컴파일러와 완전히 분리됩니다.
관심사 분리를 위반하지 않고 이 물리적 현실을 애플리케이션에 전달하기 위해 Aggrega는 주입 계약을 사용합니다. 다만 이 계약은 사용자 정의 애플리케이션 코드와 COTS(Commercial Off-The-Shelf) 인프라를 엄격히 구분합니다:
- 화이트박스(사용자 정의 코드): 컴포넌트가 범용 워커(예: 사용자 정의 Python 에이전트)입니다. Go 컴파일러와 Ops Recipe는 개발자의 사용자 정의 스크립트가 어떤 변수를 기대하는지 전혀 알지 못합니다. 따라서 코드가 해당 Recipe가 기본으로 전달하지 않는 이름을 읽는 곳마다 개발자가
inject:블록을 통해 전달 방식을 지시합니다. 이는 컴포넌트 간 의존성(대상의provides를 참조하는from:과 함께uses[].inject사용)과 컴포넌트 자체 값(value:리터럴 또는 자신의provides를 참조하는from:과 함께 컴포넌트 수준inject사용) 모두에 해당합니다. 허용되는 메커니즘은 표면별로 선언되며 두 선언은 별개입니다. 컴포넌트 자체 값은spec.inject허용 목록(예:inject: ["env", "file"])이 관장하고,uses:엣지는 그 엣지가 연결되는 소켓의 허용 목록인spec.usesSchema.<socket>.inject가 관장합니다. 어느 표면에서든 관장하는 허용 목록에 없는 메커니즘을 지시하면 빌드가 중단됩니다. - 블랙박스(패키지형 컴퓨트): 컴포넌트가 폐쇄형 시스템(예: Redis, 관리형 API Gateway)입니다. Ops Recipe는 시스템이 데이터를 어떻게 소비하는지 이미 정확히 알고 있습니다. 따라서 Component 카탈로그 엔터티는 허용 목록을 생략하며, 이는 지시를 좁히는 것이 아니라 전면 금지합니다.
spec.inject를 생략하면 컴포넌트 수준 자기 주입이 금지되고,inject:허용 목록 없이 선언된 소켓은 그 소켓을 통해 연결된 엣지의 모든inject:블록을 금지합니다. 개발자는uses로 의존성 대상만 제공하면 되고, 플랫폼은 Recipe의valuesMapping을 통해 내부 연결을 기본적으로 처리합니다.
결정적 주소 지정 규칙(내부 네트워크 물리)
Aggrega의 .context.uses 파이프는 컴파일 시점에 대상 문자열을 컨테이너에 동적으로 주입합니다. 핵심 Go 컴파일러는 물리적 네트워킹에 전적으로 구애받지 않으므로, 무엇이 유효한 주소 문자열인지는 컴파일러 기능이 아니라 Platform Ops가 지키는 사회 계약에 전적으로 달려 있습니다. 컴파일러는 Ops Recipe가 생성한 결정적 포인터 문자열을 해석 없이 그대로 하위 템플릿 컨텍스트로 전달합니다.
규칙: Ops Recipe는 결정적이고 안정적인 주소 포인터를 내보내야 합니다. 프로바이더는 IP를 계산하지 않습니다. 대신 대상의 Ops Recipe가 예측 가능한 문자열을 구성하여 자신의 provides: 계약을 통해 노출해야 합니다(예: Kubernetes에서는 provides.internal_host: "http://agent-b.namespace.svc.cluster.local"를 게시하거나, Terraform에서는 모듈이 해당 값에 맞는 output을 선언한 "${module.db.endpoint}" 같은 보간 문자열을 게시함).
프로비저닝 후의 동적 IP를 컴파일러가 가져오기를 기대하는 것은 AOT 실행 모델을 직접 위반합니다. 컴파일러는 클라우드가 실제 컴퓨트를 프로비저닝하기 전에 토폴로지를 평가하므로, 아직 존재하지 않는 데이터를 물리적으로 가져올 수 없습니다. 서비스가 컴퓨트 부팅 후에만 생성되는 임의 IP를 필요로 한다면 컴파일러는 그것을 물리적으로 가져올 수 없습니다. 컴파일러의 유일한 역할은 Ops Recipe가 제공한 결정적 포인터 문자열을 그대로 호출 컨테이너의 환경 변수에 전달하는 것이며, 최종 해석은 클러스터의 DNS나 활성 IaC 상태 관리자에 맡깁니다.
결정적 주소 지정을 강제하면 순환 의존성(예: 에이전트 A가 에이전트 B에 위임하고, 에이전트 B가 다시 에이전트 A에 위임)이 자연스럽게 해결됩니다. 안정적인 URL이나 IaC 포인터는 어느 컨테이너도 실제로 기동하기 전에 문자열로 계산할 수 있으므로, 컴파일러는 시간적 경쟁 조건 없이 두 에이전트를 안전하게 연결합니다.
(참고: 이 규칙은 외부 인그레스에도 적용됩니다. 아키텍처가 공개 API Gateway를 노출하고 그 URL을 내부 컨테이너에 다시 주입해야 하는 경우, Go 컴파일러는 클라우드가 임의로 생성한 URL(예: xyz123.execute-api.aws.com)을 가져올 수 없습니다. 컴파일 시점에는 존재하지 않기 때문입니다. Ops는 결정적인 사용자 정의 도메인(예: api.enterprise.com)을 매핑하거나 네이티브 IaC 보간 문자열을 내보내도록 Recipe를 작성하여, AOT 컴파일러가 안전하게 주입할 수 있는 알려진 참조를 갖도록 해야 합니다).
구현 메커니즘(API 계약으로서의 카탈로그) 개발자와 Ops를 강하게 결합하지 않고 이를 구현하기 위해, Aggrega는 플랫폼 카탈로그(도메인 2)를 엄격한 API 계약으로 사용하며 세 가지 별개의 검증 계층을 활용합니다:
- 자격 증명 Feature 스키마(
feature.aggrega.ai/kind: secret레이블): 볼트 쿼리(path,key)만 검증합니다. 컨테이너가 데이터를 어떻게 소비하는지에는 전적으로 구애받지 않습니다. Component스키마(spec.inject허용 목록):spec.inject필드를 통해 블랙박스/화이트박스 규칙을 강제합니다.spec.inject가 있으면(예:inject: ["env", "file"]) 개발자는 해당 전달 메커니즘으로 컴포넌트 수준 자기 주입을 사용할 수 있습니다.spec.inject가 생략되면 컴파일러가 자기 주입을 구조적으로 금지하며, 블랙박스 컴포넌트는 내부 연결을 전적으로 Recipe의valuesMapping에 의존합니다. 빌드는 Aggregate를 해석할 때 이를 강제하여 컴포넌트의inject:블록을 거부하고 해당 메커니즘을 명시하며, 이는schema:아래의 필러별 내용 검증과는 별개입니다.featuresSchema맵: Component 카탈로그에 정의되며, 개발자가 사용해야 하는(또는 사용할 수 있는) 자격 증명 슬롯을 명시적으로 선언합니다. 각 항목은required(기본값false),inject허용 목록([]= 블랙박스,[env, file]= 투명),description을 지정합니다. 이 키들은 안정적이며 계약으로 보장되므로, Ops 엔지니어는 Go 템플릿에서 결정적 대상을 지시할 때 이를 직접 신뢰할 수 있습니다(예:helm대상에서existingSecret: "{{ .context.rendered_name }}-{{ .locals.secret_target_admin_password }}"). 이때 이름의 접미사는.locals를 통해 명시적으로 내보내며(로컬은.context.rendered_name을 읽을 수 없음), 하위 자격 증명 FeatureRecipe가 같은 두 부분을 결합하여 AOT 실행 순서를 위반하지 않고 요구 사항을 충족합니다. 전체featuresSchema설계는entities/component.md를 참조하십시오.
엄격한 배치 규칙: inject: 메커니즘은 개발자의 Aggregate에서 세 위치에 사용할 수 있습니다:
- 컴포넌트 수준 자기 주입(self-inject): 컴포넌트 인스턴스에서
values:와 직접 형제 관계로 둡니다. 컴포넌트 자신의 리터럴 값이나 자신의provides키를 전달 파이프에 주입합니다. Component 카탈로그가 해당 메커니즘과 함께spec.inject를 선언한 경우에만 허용됩니다. - uses 수준 교차 주입(cross-inject):
uses:블록 안의 명시적 대상 정의 내부에 둡니다. 의존 대상의provides키를 전달 파이프에 주입합니다. - Feature/시크릿 수준 주입: 기능과 시크릿을 연결할 때
values:와 형제 관계로 둡니다. 연결 대상 자신의 해석된provides키(시크릿의 경우 해석된 자격 증명, 기능의 경우 제공된 값)를 전달 파이프에 주입합니다.
세 가지 형태 모두 동일한 .context.inject 파이프를 채웁니다. Recipe는 몇 개의 소스가 기여했는지와 관계없이 하나의 통합된 파이프를 읽습니다.
inject 스키마는 도구 지원을 위해 표준 열거값(env, file, arg)을 정의하지만, additionalProperties를 열어 두므로 사용자 정의 메커니즘을 지정할 수 있습니다(예: AWS Systems Manager Parameter Store용 ssm_param). 한 가지 이름은 이미 사용 중입니다. all은 Recipe가 .context.inject.all에서 읽는 모든 메커니즘을 병합한 뷰이므로, all이라는 메커니즘을 지정하는 inject 블록은 문서 엔벨로프 단계에서 그 사실을 알리며 빌드를 중단시킵니다.
inject 항목 구문: inject 블록 아래에서 각 전달 메커니즘(env, file, arg 또는 사용자 정의 메커니즘)은 항목의 목록이며, 모든 위치에서 같은 항목 형태를 사용합니다. 항목의 문자열이 무엇인지는 항목이 놓인 위치가 아니라 항목이 지닌 키워드가 결정하므로, 항목은 어디에 나타나든 같은 방식으로 읽힙니다. 메커니즘을 목록 대신 맵으로 작성하거나 한 항목에 두 키워드를 모두 쓰면, Aggregate의 문서 엔벨로프 단계에서 빌드가 중단되며 형태가 잘못된 Aggregate 내 경로가 명시됩니다.
항목 키워드(from: 및 value:): 각 항목은 로컬 식별자(환경 변수 이름, 파일 경로, 인수 플래그)에 in 키워드를 사용하고, 여기에 from:(provides 키 참조) 또는 value:(리터럴 문자열) 중 정확히 하나를 더합니다. from:은 그 위치가 가리키는 노드의 provides를 기준으로 해석됩니다. component.inject에서는 컴포넌트 자신의 것, uses[target].inject에서는 대상의 것, features[<name>].inject에서는 attachment 자신의 것입니다:
| 키워드 | 의미 | component.inject에서 허용 | uses[].inject에서 허용 | features[<name>].inject에서 허용 |
|---|---|---|---|---|
from: | provides에 대해 해석 | ✅ 자기 노드의 provides | ✅ 대상 노드의 provides | ✅ 연결 대상 자신의 provides |
value: | 리터럴 문자열(Go 템플릿 지원) | ✅ | ❌ (value:는 uses[].inject에서 유효하지 않으며, 자기 주입에는 컴포넌트 수준 inject를 사용합니다) | ❌ (value:는 연결 대상의 inject에서 빌드를 중단시킵니다. 자기 주입에는 컴포넌트 수준 inject를 사용하십시오) |
예시:
# Component-level self-inject (White-Box custom code)components: my-worker: type: core/python-worker:1.0.0 values: app_token: "xyz" inject: env: - in: MY_TOKEN value: "xyz" # Literal value - in: LOG_LEVEL value: "debug" # Literal value - in: CALLBACK_HOST from: "host" # From own provides (already evaluated) - in: APP_VERSION value: '{{"{{"}} .values.app_token }}' # Go template expanding own values uses: databases: my_db: target: postgres-db inject: env: - in: DB_HOST from: "host" # Provides key from target - in: DB_PORT from: "port" # Provides key from target - in: DB_URL from: "dsn" # From target's providesAPP_VERSION의 value:에 있는 템플릿은 {{가 아니라 {{"{{"}}로 시작합니다. Aggregate의 전체 텍스트는 자기 주입 해석이 실행되기 전에 매개변수 보간을 위해 템플릿으로 한 번 읽히며, 그 시점에는 .values가 존재하지 않으므로, 이 이스케이프가 {{를 되돌려 놓아 자기 주입 해석이 이를 평가하게 합니다. 자체 이중 중괄호를 포함하는 텍스트를 참조하십시오.
Provider별 참고 사항(compose). compose를 대상으로 하는 노드 사이에서 uses: 엣지가 해석되면, compose provider는 해당 엣지에서 depends_on 항목을 도출합니다. 이 항목은 대상의 health: 블록과 관계없이 항상 service_started 의미를 사용하며, 대상의 상태에 따라 이를 제어하는 기능은 구현되어 있지 않습니다. 전체 추론 규칙은 providers/compose.md를 참조하십시오.
inject 키 충돌 규칙: 개발자가 서로 다른 두 소스에서 동일한 전달 키(예: 동일한 환경 변수 이름)를 요청하면 병합되지 않고 치명적 오류가 됩니다. 컴파일러는 충돌을 감지하고 빌드를 중단합니다:
| 소스 A | 소스 B | 결과 |
|---|---|---|
component.inject | uses[].inject | ❌ 치명적 중단 — 중복된 전달 키 |
uses[target_A].inject | uses[target_B].inject | ❌ 치명적 중단 — 중복된 전달 키 |
component.inject | features[<name>].inject | ❌ 치명적 중단 — 중복된 전달 키 |
uses[].inject | features[<name>].inject | ❌ 치명적 중단 — 중복된 전달 키 |
features[A].inject | features[B].inject | ❌ 치명적 중단 — 중복된 전달 키 |
component.inject(같은 키 두 번) | — | ❌ 치명적 중단 — 중복된 전달 키 |
features[A]의 FeatureRecipe injectMapping | features[B]의 FeatureRecipe injectMapping | ❌ 치명적 중단 — 두 연결 대상에 걸친 중복된 전달 키 |
features[A].inject | features[B]의 FeatureRecipe injectMapping | ❌ 치명적 중단 — 두 연결 대상에 걸친 중복된 전달 키 |
component.inject 또는 uses[].inject | FeatureRecipe injectMapping | ✅ 허용 — 설계상의 가로채기: 매핑의 값이 해당 항목을 대체함 |
이 표는 연결된 모든 Feature를, 어디에 연결되었든(컴포넌트, 서브시스템 또는 Release 경계, 어노테이션의 확장, 또는 연결) 같은 방식으로 읽습니다. FeatureRecipe의 injectMapping은 모든 inject: 블록이 전달을 마친 뒤에 렌더링되므로 항상 두 주장 중 나중의 것입니다. 컴포넌트나 그 연결 중 하나가 전달한 것을 다시 쓸 수 있고, 자신의 연결 대상의 inject: 블록이 전달한 것도 다시 쓸 수 있지만, 다른 연결된 Feature가 이미 전달한 키는 둘 모두를 명시하며 빌드를 중단시킵니다.
FeatureRecipe가 경계에 대해 한 번 렌더링되는(executionScope: boundary) Release 경계에 연결된 Feature는 같은 경로를 통해 경계가 포함하는 컴포넌트에 도달합니다. 해당 injectMapping은 각 컴포넌트마다 그 컴포넌트의 컨텍스트에서 한 번씩 실행되며, 다른 매핑과 마찬가지로 위 표의 각 행이 적용됩니다. 게이트웨이를 통해 대상에 도달하도록 소비자의 호스트 변수를 다시 쓰는 compose 브리지가 그러한 매핑 중 하나이므로, 같은 변수를 전달한 다른 연결된 Feature가 있으면 둘 모두를 명시하며 빌드가 중단됩니다.
Recipes에서 Go 템플릿 상용구 코드를 방지하기 위해 컴파일러는 둘 다 제공합니다:
.context.uses: 보강된 토폴로지 엣지 맵(복잡한 로직, 시크릿 참조, 출처 추적용)..context.inject: 컴파일러가 모든 inject 소스(자기 주입 리터럴, 자기 주입 provides 참조, 컴포넌트 간 provides 참조)를 최종 문자열 값으로 이미 해석한 다음, FeatureRecipeinjectMapping가로채기를 적용한, 사전 해석되고 평탄화된 딕셔너리.
이중 상태 주입 컨텍스트(널 안전성 대 의도 순수성) Modifier(자격 증명이든 아니든 모든 연결 대상에 바인딩된 FeatureRecipe)의 구성을 생성할 때, 컴파일러는 Go 템플릿의 널 포인터 안전성, 동적 네트워크 라우팅, 그리고 기능에 구애받지 않는 그래프의 보존 사이에서 균형을 맞춰야 합니다. 이를 위해 컴파일러는 템플릿에 이중 상태 컨텍스트를 제공합니다:
.inject_raw(불변 의도): 개발자가 도메인 1에서 작성한 그대로의 컴포넌트 자체inject:블록을 나타냅니다. 이는 불변입니다. 개발자가 블록을 생략한 경우null로 평가됩니다. Ops는 이를 논리 검사에 특히 활용합니다(예: 대체 동작을 적용하기 위한{{ if not .inject_raw }}). 불변이므로, 라우팅 기능이 물리적 전달 파이프를 가로채 변경하더라도 Ops 템플릿이 거짓 양성을 겪지 않도록 보호합니다..context.inject(사전 수화되고 가로채진 파이프): 물리적 전달 현실을 나타내는, 컴파일러가 생성한 병렬 구조체입니다. 사전 수화된 맵으로 시작합니다(예:API_HOST를 대상의 기본 문자열"backend-instance"에 매핑). 중요한 점은 이 파이프가injectMapping블록을 활용하는 Features(예: 네트워크 라우팅)에 의해 가로채지고 깊은 병합되도록 설계되었다는 것입니다. Base Recipe가 렌더링될 무렵 이 파이프에는 완전히 형식화되고 물리적으로 올바른 문자열(예:"backend-instance.backend-zone.svc.cluster.local"과 같은 올바르고 완전한 네트워크 이름)이 담깁니다. 내용은env,file,arg(그리고 Component의 inject 허용 목록이 허용하는 모든 사용자 정의 전달 메커니즘)로 구성되며, 파이프 전체를 편리하게 직렬화할 수 있도록 모든 메커니즘을 결합한 사전 병합된.all딕셔너리가 함께 제공됩니다..context.self_inject(각 이름이 전달하는 자체 값):.inject_raw와 같은 컴포넌트 수준inject:블록에서,.context.uses.<alias>.inject가 연결의 이름을 제공하는 형태로 읽습니다. 메커니즘별로 개발자가 작성한 각 이름은 해당 항목이 전달하는 컴포넌트 자체 키에 매핑됩니다 —from:항목에는provides.<key>, 컴포넌트 자체 값 중 정확히 하나만 읽고 그 외에는 아무것도 읽지 않는value:템플릿에는values.<key>, 그 밖의 모든 경우(리터럴, 두 개의 값, 값 이외의 것을 읽는 경우)에는 빈 문자열입니다. 이를 통해 개발자 자체 이미지를 실행하는 Recipe는 자체 변수 이름을 기본값으로 취급할 수 있습니다 — 이미values.<key>에 매핑된 항목이 없을 때에만 자체 값을 기본 이름으로 전달하므로, 값 하나의 이름을 바꾼 개발자도 다른 모든 기본값을 유지합니다. 이는 표준 라이브러리 카탈로그의 관례이며 컴파일러 규칙이 아닙니다. 엔터프라이즈 카탈로그는 컴포넌트 자체 값을 원하는 방식으로 전달할 수 있습니다.
Ops는 .context.inject 구조체를 안전한 직렬화(예: {{ toJson .context.inject.all }})와 라우팅 생성에만 사용하여, 물리적 인프라가 완전히 해석된 좌표를 받는 동시에 개발자의 원래 의도는 .inject_raw에 그대로 온전히 유지되도록 합니다.
개발자 YAML 예시(세분화된 맵):
uses: databases: my-postgres-cluster: target: db-main inject: ssm_param: # Agnostic injection paradigm (AWS Systems Manager) - in: MY_DB_HOST # Local identifier from: "host" # Target provides key컴파일러는 이를 컴파일 시점에 해석하여(정적 문자열 또는 내부 DNS 이름으로 매핑) 두 객체를 Recipe에 전달합니다:
"context": { "uses": { ... raw graph ... }, "inject": { "all": { "MY_DB_HOST": "db-main.internal" }, "ssm_param": { "MY_DB_HOST": "db-main.internal" } }}연결 범위 구성(values 및 infra). inject를 통해 대상의 provides를 전달하는 것 외에도, 엣지는 자체 구성을 가질 수 있습니다. 이는 소비하는 Recipe가 보강된 토폴로지 파이프에서 읽는 연결별 설정입니다:
.context.uses.<alias>.values— 개발자가 작성하며, Aggregate의 상세uses항목에 선언되고, 소켓의valueSchema에 대해 검증됩니다..context.uses.<alias>.infra— 운영자가 작성하며, Release에 선언되고, 소켓의infraSchema에 대해 검증됩니다.
소켓(usesSchema[<socket>])은 어떤 연결이 가능하고 그 연결이 어떤 구성을 가질 수 있는지에 대한 Architect의 계약입니다. values와 infra는 컴포넌트의 values/infra 분리와 마찬가지로 그 구성을 작성 도메인별로 나눕니다. 따라서 엣지에는 두 작성자가 있습니다. 개발자는 Aggregate에서 토폴로지를 연결하고 values로 조정하며, 운영자는 Architect가 선언한 소켓 안에서 Release에 연결별 infra를 설정합니다. Release는 선언되었지만 바인딩되지 않은 소켓에 엣지를 기존 컴포넌트로 연결할 수도 있습니다. 다만 개발자가 선언한 엣지의 대상을 바꿀 수는 없습니다. entities/release.md §“Per-edge connection configuration”을 참조하십시오.
엣지별 구성은 소비자 범위입니다. 즉 엣지를 작성한 노드(연결의 출발지)의 컨텍스트에만 나타나며, 대상의 컨텍스트에는 절대 나타나지 않습니다. 따라서 대상 자체의 렌더링 출력은 그에 연결하는 소비자와 무관하게 불변입니다. 대상에 연결된 Feature는 연결을 볼 수 있는 유일한 곳입니다. 그 FeatureRecipe는 .context.used_by에서 어떤 컴포넌트가 대상을 사용하는지 읽습니다. 각 컴포넌트의 식별자, 소켓, 게시된 provides, 배치된 네임스페이스와 경계, 그리고 이를 읽는다고 선언한 FeatureRecipe의 경우 해당 provider가 보고한 렌더 사실을 읽으며, 연결 자체의 values나 infra는 절대 읽지 않습니다. 소비자에 연결된 Feature도 같은 방식으로, FeatureRecipe가 읽는다고 선언한 경우, 각 대상의 렌더가 보고한 내용을 해당 연결의 항목인 .context.uses.<alias>.render_facts에서 읽습니다.
연결 첨부(features). 연결은 자체 첨부도 가질 수 있습니다. 예를 들어 소비자가 이 연결이 도달하는 컴포넌트에 제시하는 자격 증명 같은 것으로, 항목의 features: 아래에 소켓이 featuresSchema에 선언한 슬롯을 키로 하여 둡니다. 같은 두 작성자가 이를 나눕니다. 개발자는 Aggregate의 연결 항목에 type과 values로 첨부하고, 운영자는 Release의 항목에서 그 첨부의 규모를 infra로 정하거나 type과 infra로 자체 첨부를 추가합니다. 연결의 첨부는 자체 inject 블록을 갖지 않으며, 그래서 위의 배치 규칙에 포함되지 않습니다. 개발자가 전달을 지정하는 위치가 아니기 때문입니다.
각 첨부는 <alias>.<slot>이라는 이름의 소비하는 컴포넌트의 첨부가 되므로, 엣지별 구성과 똑같이 소비자 범위입니다. 그 FeatureRecipe는 소비자 측에서 렌더링되며, 대상의 출력은 이에 따라 바뀌지 않습니다. 이 첨부는 컴포넌트 자체 블록이 선언한 첨부만 담는 소비 Recipe의 .features에서 제외되며, Recipe는 대신 해당 연결 아래 .context.uses.<alias>.features.<slot>에서 이를 읽습니다. Feature 첨부가 만들어 내는 연결은 첨부를 갖지 않습니다. entities/aggregate.md §“A connection’s own attachments” 및 entities/component.md §“Topology Sockets”를 참조하십시오.
A. 환경 변수(env) 및 동적 대상 해석
현대 클라우드 네이티브 애플리케이션의 표준 전달 메커니즘입니다. 명시적 토폴로지 엣지(예: Agent가 Database와 통신하는 경우)에 대해 Aggrega는 .context.uses를 사용하여 환경 변수 매핑을 주입합니다.
- 사용 사례: 결정적인 내부 DNS 이름, Infrastructure-as-Code 보간 문자열(예:
${module.db.endpoint}), 또는 정적 Vault 포인터를 받는 경우입니다. 컴파일러는 이러한 정적 참조를 AOT로 연결하여 런타임 인프라 또는 GitOps 컨트롤러가 실제 값을 해석할 수 있게 합니다.
B. 파일 마운트(file)
많은 엔터프라이즈 AI 프레임워크는 환경 변수에 의존하는 대신 구조화된 config.json이나 .pem 인증서가 디스크의 특정 경로에 존재하기를 기대합니다.
-
사용 사례: 복잡한 JSON 구성을 주입하거나 디스크에서 읽는 레거시 SDK를 충족하는 경우입니다.
-
개발자 의도:
features:openai_key:type: core/aws-secrets-managervalues:path: /prod/ai/openaikey: "api_token"inject:file:- in: "/etc/secrets/openai.json" # Local pathfrom: "api_token" # The attachment's provides key -
운영 현실: Ops Recipe는 Vault 데이터를 안전하게 가져와
/etc/secrets/openai.json에 마운트하는 데 필요한 KubernetesVolume,VolumeMount,ExternalSecret을 동적으로 생성합니다.
C. 명령줄 인수(arg)
사전 컴파일된 바이너리(Rust 또는 Go 워커 노드 등)는 환경 변수를 완전히 우회하고, 값이 실행 명령의 런타임 플래그로 전달되기를 기대하는 경우가 많습니다.
-
사용 사례: 컨테이너의 시작 명령에 물리적 현실을 덧붙이는 경우입니다.
-
개발자 의도:
features:public-ingress:type: core/external-ingressinject:arg:- in: "--callback-url=" # Local flagfrom: "hostname" # The attachment's provides key -
운영 현실: 호스트 이름은 해당 컴포넌트에 대한 환경의 이름이므로, 운영자가 Release의 해당 컴포넌트 항목에 있는 이 첨부의
infra에api.enterprise.com을 작성합니다. Feature의 Wasm 플러그인은 Injection Contract를 통해 해석된 공개 URL을 받고, Kubernetesargs배열을 동적으로 덧붙이는 JSONPatch["/app/binary", "--callback-url=https://api.enterprise.com"]를 생성하여 Component의 Base Recipe를 완전히 우회합니다.