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

시크릿

이 페이지는 자격 증명이 그것을 필요로 하는 컴포넌트에 어떻게 도달하는지라는 하나의 개념을 설명하며, 실행 가능한 작업 공간이 아닙니다. 고급 플랫폼 — 여러 경계를 가진 Kubernetes 플랫폼은 직접 빌드하는 작업 공간에서 두 가지 전달 모델을 모두 보여 줍니다. 다음 명령으로 자신의 폴더에 작성합니다:

Terminal window
aggrega scaffold --example advanced-platform

그런 다음 이어서 실행할 명령을 출력합니다:

Terminal window
cd advanced-platform
aggrega pull --release release.yaml
aggrega build --release release.yaml

시크릿 전달 체크리스트

자격 증명은 실행 중인 컨테이너에 도달하기 전에 여섯 개의 표면을 거칩니다. 새 자격 증명을 연결할 때 확인할 접점은 다음과 같습니다:

단계보고 위치작업
1Component featuresSchema:자격 증명 슬롯을 선언합니다. 이름, required 여부, 그리고 inject: 허용 목록을 지정합니다. 허용 목록은 첨부가 지정할 수 있는 전달 메커니즘으로, 투명 슬롯에는 [env] 또는 [env, file], 불투명 슬롯에는 []입니다.
2자격 증명 Feature schema:작성자가 제공하는 것을 정의합니다. 표준 라이브러리의 자격 증명 Features는 feature.aggrega.ai/kind: secret 레이블을 가지며, 자격 증명의 로케이터를 origin으로, 데이터 키를 key로 받습니다.
3Aggregate features:다른 모든 Feature와 같은 features: 키워드 아래에서 자격 증명을 요청합니다. 그 type, 그 values, 그리고 투명 슬롯에서만 애플리케이션이 자격 증명을 읽는 방법을 나타내는 inject: 블록을 지정합니다.
4FeatureRecipe대상에 맞게 구현합니다. 컴포넌트가 값을 읽는 위치에 값을 쓰거나, 값을 담은 리소스를 렌더링하거나, 시크릿 저장소에서 값을 가져오는 리소스를 렌더링합니다.
5Manifest mappings.features.type다른 모든 Feature와 같은 계층에서 자격 증명 Feature를 해당 FeatureRecipe에 바인딩합니다.
6Recipe불투명 슬롯에서 자격 증명을 읽습니다. 컴포넌트의 Recipe는 자격 증명이 게시하는 로케이터 .features.<slot>.provides.name을 읽어, 차트의 existingSecret 같은 제품 고유의 메커니즘에 전달합니다.

투명 슬롯은 처음 다섯 개를 사용하고, 불투명 슬롯은 여섯 개를 모두 사용합니다. 후자는 공급업체의 차트 같은 패키지형 인프라에서 일반적인 경우입니다.

투명 슬롯과 불투명 슬롯

투명 슬롯은 애플리케이션이 자격 증명을 읽는 방법을 개발자가 지정할 수 있게 합니다. 불투명 슬롯은 전달을 Recipe에 맡기며, 이 슬롯에 inject: 블록을 작성하는 첨부는 빌드를 중단시킵니다. 예제에서 core/datastore/mariadb는 각각을 하나씩 선언하고, Aggregate는 둘 다 채웁니다. 다음은 주석을 생략한 aggregate.yaml입니다:

db:
type: core/datastore/mariadb
features:
root_password:
type: core/secret-value
values:
key: MARIADB_ROOT_PASSWORD
origin: dev-root-pw-change-me
user_password:
type: core/secret-provided
values:
origin: dev-app-pw-change-me
inject:
env:
- in: MARIADB_PASSWORD
from: value

root_password는 불투명합니다. core/secret-value는 첨부가 지정하는 키 아래에 값을 전달하며, 데이터베이스의 Recipe가 그곳에서 값을 읽습니다. user_password는 투명합니다. core/secret-provided는 값을 value로 게시하고, 첨부 자체의 inject: 블록이 이를 MARIADB_PASSWORD로 전달합니다. 슬롯이 나열하지 않은 메커니즘을 지정하는 inject: 블록은 빌드를 중단시키며, 아무것도 게시하거나 읽지 않는 키를 지정하는 블록도 마찬가지입니다.

참조 가능한 자격 증명으로 채워진 불투명 슬롯의 경우, 컴포넌트의 Recipe는 이름을 유도하는 대신 게시된 로케이터를 읽습니다(existingSecret: "{{ .features.root_password.provides.name }}"). 따라서 FeatureRecipe가 내보내는 Secret과 그에 대한 참조는 하나의 문자열입니다. MariaDB(Bitnami 차트) — 다중 키 자격 증명 Secret 하나는 공급업체의 차트를 대상으로 이 흐름을 구성합니다.

자격 증명 구현: 리소스 또는 2단계 파이프라인

표준 라이브러리의 Kubernetes 구현은 FeatureRecipe 옆에 있는 작은 차트에서 자격 증명의 리소스를 렌더링합니다. helm/k8s-secret-from-parameter는 작성자가 제공한 값을 담은 Secret을, helm/k8s-external-secret은 External Secrets Operator가 시크릿 저장소에서 조정하는 ExternalSecret을 렌더링합니다. 자격 증명 Features에서 각각을 차례로 설명합니다.

대신 FeatureRecipe는 두 단계로 된 pipeline:으로 자격 증명을 구현할 수도 있으며, 각 단계는 플러그인입니다. 첫 번째 단계인 페처는 저장소별 리소스(예: ExternalSecret)를 작성하며, 첨부의 값이 제공하는 저장소 항목을 지정합니다. 두 번째 단계인 인젝터는 컴포넌트의 렌더링된 워크로드를 패치하여, 결과로 생성된 Secret을 첨부의 inject: 블록이 지정하는 변수나 파일 위치에 컨테이너로 마운트하며, 이 단계는 그 위치를 .inject에서 읽습니다. 다른 시크릿 저장소로 옮기면 페처가 바뀌고 인젝터는 그대로 유지됩니다. 단계는 추가하는 리소스를 부수 효과로, 렌더링된 문서에 대한 변경을 패치로 반환합니다. Wasm 플러그인 계약이 둘의 형태를 정의합니다.

Feature 자체의 자격 증명

Feature에도 자체 자격 증명이 필요할 수 있습니다. 업스트림 서비스에 인증하는 가드레일 프록시나 수집 토큰을 가진 로그 전송기가 그 예입니다. Feature는 Component와 똑같이 자신의 featuresSchema에 슬롯을 선언하며, 여기에 바인딩된 FeatureRecipe는 Feature의 워크로드를 렌더링할 때 그 슬롯을 채운 내용을 읽습니다.

첨부는 중첩되지 않습니다. 자격 증명은 같은 컴포넌트에서 Feature 옆에, Feature의 슬롯이 선언한 이름으로 첨부됩니다. 둘을 연결하는 것은 슬롯 이름입니다. 아래의 가드 Feature와 컴포넌트는 작업 공간 자체의 엔터티이며, core/referenced-secret은 표준 라이브러리의 것입니다.

# The Feature declares the slot
kind: Feature
metadata:
name: local/guard
spec:
appliesTo: "component.aggrega.ai/type in (server, worker)"
featuresSchema:
guard_api_key:
selector: "feature.aggrega.ai/kind=secret"
sensitive: true
inject: [env]
---
# The Aggregate fills it beside the Feature
spec:
components:
finance-agent:
type: local/compute/guarded-worker
features:
ai-guard:
type: local/guard
guard_api_key:
type: core/referenced-secret
values:
origin: dev-guard-key-change-me
key: api-key

가드의 FeatureRecipe는 컨테이너가 슬롯을 참조하는 워크로드(attachments: { GUARD_API_KEY: { from: guard_api_key, as: env } })를 렌더링하므로, 참조는 가드의 컨테이너에만 들어가고 다른 곳에는 들어가지 않습니다. 호스트 컴포넌트의 Recipe는 슬롯이 Feature에 속하기 때문에 슬롯을 참조할 수 없습니다. 슬롯에 접근하려는 워크로드는 슬롯 이름을 밝히며 빌드를 중단시킵니다. 아무것도 채우지 않는 슬롯을 지정하는 워크로드 항목도 빌드를 중단시키는데, 확인할 게시된 로케이터가 없기 때문입니다.

Feature가 그리는 연결에도 마찬가지입니다. Feature 자체의 uses: 블록에 있는 연결은 첨부를 갖지 않으므로, 그런 연결에 필요한 자격 증명은 Feature가 선언하는 슬롯이며 Feature 옆에서 채워집니다.

연결 자체의 자격 증명

두 모델에 연결하는 게이트웨이는 각 모델에 서로 다른 키를 제시하거나, 한쪽에만 키를 제시하고 다른 쪽에는 제시하지 않을 수 있습니다. 게이트웨이의 슬롯은 컴포넌트 전체에 대해 하나의 자격 증명만 담으므로, 대신 자격 증명은 연결에 둡니다. 게이트웨이의 소켓은 그 소켓을 통하는 모든 연결이 채울 수 있는 슬롯을 선언하고, 각 연결은 독자적으로 그 슬롯을 채우거나 채우지 않습니다.

spec:
components:
router:
type: core/gateway/litellm
uses:
models:
gpt:
target: gpt
features:
credential: # a slot the models socket declares
type: core/referenced-secret
values:
key: api-key

게이트웨이의 Recipe는 연결에서 .context.uses.gpt.features.credential 위치의 첨부를 읽으므로, 여러 모델에 연결하는 게이트웨이는 각 모델 고유의 키를 읽습니다. core/gateway/litellm은 각 키를 별도의 변수로 전달하며, 그 변수는 라우팅 테이블에 있는 연결의 항목이 지정합니다. 소켓이 슬롯을 선언하지 않은 이름 아래의 첨부는 소켓이 선언한 슬롯들을 밝히며 빌드를 중단시킵니다. Manifest는 인스턴스별 계층에서 <connection>.credential을 키로 하여 한 연결의 자격 증명을 나머지와 다르게 구현할 수 있습니다. 연결의 자격 증명 — 연결마다 하나의 키, 그리고 양 끝에서 하나의 키가 이를 구성합니다. Release도 그런 연결을 배선하고 첨부의 infra에서 시크릿을 지정할 수 있으며, 이는 자격 증명 Features에서 설명합니다.