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

합성된 helm Deployment의 다중 키 자격 증명

helm provider의 Workload 합성으로 Kubernetes에 렌더링되는 단일 무상태 앱으로, 외부 차트를 사용하지 않습니다. 이 앱은 하나의 secret에서 두 개의 데이터 키를 읽습니다. 사용자 이름과 비밀번호입니다. 하나의 자격 증명 슬롯이 두 키를 모두 뒷받침하며, 이 슬롯은 다중 키 참조 가능 자격 증명으로 채워집니다.

예제 생성하기

아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.

예제 이름을 딴 새 폴더에 예제를 씁니다:

Terminal window
aggrega scaffold --example multikey-secret-synth

그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:

Terminal window
cd multikey-secret-synth

빌드

Terminal window
aggrega build --release release.yaml --auto-pull

카탈로그는 .aggrega-config.yaml에 지정된 두 소스에서 해석됩니다. 하나는 예제 자체의 ./catalog(local/compute/app Component와 그 helm/app 합성 Recipe)이고, 다른 하나는 hub 레지스트리(다중 키 자격 증명 Feature, 그 FeatureRecipe, 그리고 helm Provider)입니다. --auto-pull은 새로 클론한 저장소에 없는 lockfile을 빌드 중에 기록합니다. 세 개의 매니페스트가 dist/helm/helm/ 아래에 생성됩니다.

AI 어시스턴트 사용

Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.

Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 작업 공간 폴더에 아직 `multikey-secret-synth` 폴더가 없으면 `example`에 `multikey-secret-synth` 값을 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `multikey-secret-synth` 폴더에 작성됩니다. 그런 다음 `workspace_root` 값은 `multikey-secret-synth`, `release` 값은 `release.yaml`, `auto_pull` 값은 true, `write` 값은 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `multikey-secret-synth/dist/` 아래에 있습니다.

하나의 슬롯, 두 개의 키

Component는 하나의 투명한 자격 증명 슬롯 app_credentials (inject: [env])를 선언합니다. Aggregate는 이 슬롯을 core/referenced-secret-set으로 채웁니다. 이는 호출자가 제공한 데이터 키 집합을 담은 하나의 Kubernetes Secret을 구체화하고 Secret의 위치 정보(provides.name)만 게시하는 다중 키 참조 가능 자격 증명입니다. 여기서는 호출자가 두 개의 키를 제공합니다.

aggregate.yaml
features:
app_credentials:
type: core/referenced-secret-set
values:
entries:
- key: db_username
value: appuser
- key: db_password
value: dev-pw-change-me

Manifest는 core/referenced-secret-set을 k8s-secret-set FeatureRecipe에 매핑하며, 이 FeatureRecipe는 두 키를 모두 담은 하나의 Secret을 렌더링합니다.

app--app-zucredentials--app-secret-app-app-credentials.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: app-app-credentials
[… omitted: the labels and annotations every rendered document carries]
stringData:
db_username: "appuser"
db_password: "dev-pw-change-me"

각 키로 하나의 슬롯 참조하기

합성 Recipe는 같은 슬롯을 데이터 키마다 한 번씩, 두 번 참조합니다. 각 항목은 key 필드로 읽을 데이터 키를 지정하며, 항목의 맵 키는 환경 변수 이름입니다.

# helm/app recipe workload
attachments:
APP_DB_USER:
from: app_credentials
as: env
key: db_username
APP_DB_PASSWORD:
from: app_credentials
as: env
key: db_password

합성기는 항목마다 env secretKeyRef를 하나씩 렌더링합니다. 두 항목 모두 같은 Secret(provides.name)을 참조하며, 각각 자체 데이터 키를 가집니다.

# app-deployment.yaml (container env)
- name: APP_DB_USER
valueFrom:
secretKeyRef:
name: app-app-credentials # == the Secret's metadata.name
key: db_username
- name: APP_DB_PASSWORD
valueFrom:
secretKeyRef:
name: app-app-credentials # same Secret
key: db_password # different data key
[… omitted: the GREETING variable, set from the Aggregate's greeting value]

key 필드는 합성된 Workload에서 다중 키 secret을 사용할 수 있게 해 줍니다. 항목에 key가 생략되면 대신 슬롯이 게시한 단일 데이터 키를 읽습니다. 이는 위치 정보와 키를 모두 게시하는 단일 키 자격 증명(core/referenced-secret)이 사용하는 형태입니다.

운영자 사이징

release.yaml은 환경별로 운영자 사이징 축을 충족합니다. 컨테이너 이미지 태그는 infra.image_tag(myapp:1.2)에서 가져옵니다. 개발자의 Aggregate는 이 필드를 담지 않습니다.