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

MariaDB (Bitnami 차트) — 하나의 다중 키 자격 증명 Secret

Bitnami Helm 차트로 구현되는 단일 MariaDB 데이터베이스로, 비밀번호는 하나의 다중 키 참조 가능 시크릿 (core/referenced-secret-set)이 제공합니다.

Bitnami 차트는 auth.existingSecret이 지정하는 단일 Kubernetes Secret으로 인증하며, 그 Secret이 고정된 데이터 키를 담고 있기를 기대합니다 — mariadb-root-password와, 사용자 지정 사용자가 설정된 경우 mariadb-password입니다 (복제 배포에는 mariadb-replication-password가 추가됩니다). 이 키의 이름을 바꾸는 설정은 없으며, 키는 차트가 고정합니다.

데이터베이스 Recipe가 Secret의 이름을 추측하게 하는 대신, 개발자는 바로 그 고정 키를 담은 다중 키 자격 증명을 연결하고, Recipe는 생성된 Secret의 이름을 .features.root_password.provides.name에서 읽습니다. 참조 이름과 생성된 Secret의 metadata.name은 하나의 값입니다 — 다시 도출하는 과정도, 양쪽이 맞춰야 할 관례도 없습니다.

예제 생성하기

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

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

Terminal window
aggrega scaffold --example mariadb-bitnami-credential-set

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

Terminal window
cd mariadb-bitnami-credential-set

빌드

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

--auto-pull은 새로 클론한 저장소에 없는 lockfile을 빌드 중에 기록합니다.

mariadb-bitnami Recipe는 이 예제 자체의 로컬 catalog/ 사본 — 기업이 작성한 로컬 소스 Recipe — 에서 해석되고, core/datastore/mariadb Component와 자격 증명 기능은 .aggrega-config.yaml이 지정하는 기본 레지스트리인 hub.aggrega.ai에서 해석됩니다. 로컬 catalog/는 그 파일의 catalog_dirs 아래에 나열되어 있습니다. Bitnami 차트는 OCI 소스에서 가져옵니다.

AI 어시스턴트 사용

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

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

자격 증명이 생성하는 것

db 컴포넌트는 필수 root_password 슬롯에 core/referenced-secret-set을 연결하고, 차트의 고정 키 이름을 데이터로 제공합니다. Manifest는 그 자격 증명을 k8s-secret-set에 매핑하며, 이는 하나의 Kubernetes Secret을 구체화하고 그 이름을 provides.name으로 게시합니다:

dist/app/helm/db--root-zupassword--db-secret-db-root-password.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: db-root-password
[… omitted: the labels and annotations every rendered document carries]
stringData:
mariadb-root-password: "dev-root-pw-change-me"
mariadb-password: "dev-user-pw-change-me"

차트가 참조하는 것

mariadb-bitnami Recipe는 슬롯이 게시한 이름으로 auth.existingSecret을 연결하므로, 렌더링된 StatefulSet은 자격 증명이 생성한 동일한 Secret을 마운트합니다 — 양쪽 모두 .features.root_password.provides.name을 읽습니다:

# dist/app/helm/db-statefulset-default-db-mariadb.yaml (credential volume)
- name: mariadb-credentials
secret:
secretName: db-root-password # == the produced Secret's metadata.name
items:
- key: mariadb-root-password # a fixed key the chart reads
path: mariadb-root-password
- key: mariadb-password
path: mariadb-password

auth.existingSecret이 설정되어 있으므로 차트는 자체 Secret을 생성하지 않습니다 — 빌드에 있는 유일한 Secret은 자격 증명이 생성한 것입니다.

단일 키 형제

core/referenced-secret(credential-secretkeyref 예제 참조)은 같은 계열의 단일 키 구성원입니다: 호출자가 이름을 지정한 하나의 데이터 키를 감싸고, secretKeyRef로 하나의 키를 참조하는 소비자를 위해 리소스 이름과 그 키를 모두 게시합니다. 소비하는 대상이 전체로 이름을 지정한 하나의 Secret에서 고정된 키 집합을 읽는 경우에는, Bitnami 차트처럼, 대신 core/referenced-secret-set을 사용합니다.