Kubernetes 위의 MariaDB — 합성된 helm(StatefulSet), 두 슬롯 자격 증명
외부 차트 없이 helm provider의 Workload
합성으로 Kubernetes에 렌더링되는 단일 MariaDB 데이터베이스입니다. core/datastore/mariadb Component는
helm/mariadb Recipe에 바인딩되며, 이 Recipe는 form: stateful Workload를 선언합니다. helm provider는
이를 StatefulSet, ClusterIP Service, Headless
Service(StatefulSet의 안정적인 네트워크 ID), 그리고 데이터 디렉터리용
volumeClaimTemplate으로 변환합니다.
이 예제의 목적은 합성된 helm 대상에서 MariaDB의 두 슬롯 자격 증명 모델을 보여 주는 것입니다. 두 비밀번호 슬롯은 Component가 서로 다르게 선언하므로 서로 다른 메커니즘으로 전달되며, Recipe는 각 슬롯이 요구하는 방식으로 이를 연결합니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example mariadb-helm-synth그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd mariadb-helm-synth빌드
aggrega build --release release.yaml --auto-pull카탈로그는 .aggrega-config.yaml에 지정된 hub 레지스트리에서 해석되므로 --catalog 플래그가 필요하지 않으며, --auto-pull은 새로 클론한 저장소에 없는 lockfile을 빌드 중에 기록합니다. 네 개의 매니페스트가 dist/helm/helm/ 아래에 생성됩니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 작업 공간 폴더에 아직 `mariadb-helm-synth` 폴더가 없으면 `example`에 `mariadb-helm-synth` 값을 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `mariadb-helm-synth` 폴더에 작성됩니다. 그런 다음 `workspace_root` 값은 `mariadb-helm-synth`, `release` 값은 `release.yaml`, `auto_pull` 값은 true, `write` 값은 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `mariadb-helm-synth/dist/` 아래에 있습니다.root_password — Black-Box, inject 파이프로 전달
root_password는 Black-Box 슬롯입니다. Component의 featuresSchema가
inject: []를 선언하므로 전달 방식은 Recipe가 제어하며 개발자가 이를 지정할 수 없습니다.
Aggregate는 core/secret-value를 연결하고, Manifest는 이를
env-secret에 매핑합니다. 이 FeatureRecipe는 선택한 키로 값을 컴포넌트의 inject 파이프에
넣고, Recipe는 이를
.context.inject.env.MARIADB_ROOT_PASSWORD로 읽어 일반 컨테이너 환경 변수를 생성합니다.
# db-statefulset.yaml (container env)- name: MARIADB_ROOT_PASSWORD value: dev-root-pw-change-meBlack-Box 슬롯은 워크로드 컨테이너의 attachments: 블록에서 절대 참조되지 않으며,
이를 위한 Kubernetes Secret 리소스도 생성되지 않습니다. 값은 inject 파이프를 통해
컨테이너에 직접 전달됩니다.
user_password — 투명, Secret + secretKeyRef로 전달
user_password는 투명 슬롯(inject: [env, file])입니다. Aggregate는
core/referenced-secret를 연결하고, Manifest는 이를
k8s-secret-from-parameter에 매핑합니다. 이 FeatureRecipe는 Kubernetes Secret을 생성하고
Secret의 식별 정보를 provides {name, key}로 게시합니다. Recipe는
containers.attachments를 통해 슬롯을 참조하며, 합성기는 이를
환경 변수 secretKeyRef로 렌더링합니다. 생성된 Secret과 컨테이너의 참조는 둘 다 .features.user_password.provides.name을 읽으므로
동일한 리소스를 가리킵니다. 재유도가 없으며, 양쪽이 합의해야 할 관례도
없습니다. 게시되는
이름은 슬롯 이름의 밑줄을 하이픈으로 정규화하므로, user_password는
유효한 Kubernetes 리소스 이름 db-user-password가 됩니다. 이를 담는 파일 이름은
별도로 유도되며 다르게 표기됩니다. 파일 이름은 연결 자체의 좌표로서
컴포넌트와 슬롯 이름을 접두사로 붙이고, 소문자와 숫자만 허용하는 파일 이름 문자 집합에 맞게
인코딩되므로, 밑줄은 그곳에서 하이픈이 아닌 이스케이프로 나타납니다.
[… omitted: the apiVersion and the Secret kind]metadata: name: db-user-password [… omitted: the labels and annotations every rendered document carries]stringData: MARIADB_PASSWORD: "dev-user-pw-change-me"
# db-statefulset.yaml (container env)- name: MARIADB_PASSWORD valueFrom: secretKeyRef: name: db-user-password # == the Secret's metadata.name key: MARIADB_PASSWORD # == the Secret's data keyuser_password를 연결하지 않은 채로 두는 것도 유효합니다. 이 경우 Recipe는
인라인 개발용 기본값(MARIADB_PASSWORD: apppass)으로 대체되고 Secret은
생성되지 않으므로, 최소 배포도 여전히 렌더링되고 실행됩니다.
운영자 사이징
release.yaml은 환경별로 운영자 사이징 축을 충족합니다. 컨테이너
이미지 태그는 infra.engine_version(mariadb:11.4)에서 오고,
volumeClaimTemplate의 요청량과 스토리지 클래스는 infra.storage
(5Gi, standard)에서 옵니다. 개발자의 Aggregate는 이 필드들을 절대 포함하지 않습니다.