합성된 helm Deployment의 다중 키 자격 증명
helm provider의 Workload 합성으로 Kubernetes에 렌더링되는 단일 무상태 앱으로, 외부 차트를 사용하지 않습니다. 이 앱은 하나의 secret에서 두 개의 데이터 키를 읽습니다. 사용자 이름과 비밀번호입니다. 하나의 자격 증명 슬롯이 두 키를 모두 뒷받침하며, 이 슬롯은 다중 키 참조 가능 자격 증명으로 채워집니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example multikey-secret-synth그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd multikey-secret-synth빌드
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)만 게시하는 다중 키 참조 가능 자격 증명입니다. 여기서는 호출자가 두 개의 키를 제공합니다.
features: app_credentials: type: core/referenced-secret-set values: entries: - key: db_username value: appuser - key: db_password value: dev-pw-change-meManifest는 core/referenced-secret-set을 k8s-secret-set
FeatureRecipe에 매핑하며, 이 FeatureRecipe는 두 키를 모두 담은 하나의 Secret을 렌더링합니다.
[… 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 workloadattachments: 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는 이 필드를 담지 않습니다.