OpenBao — Kubernetes 시크릿 관리 서버
이 예제는 작지만 실제로 동작하는 스택, 즉 단일 OpenBao 시크릿
서버를 Developer가 작성한 하나의 Aggregate에서 Kubernetes로 컴파일하며,
공식 OpenBao Helm 차트를 기반으로 합니다.
OpenBao는 인증된 HTTP API 뒤에서 토큰, 비밀번호, 인증서 및 기타 시크릿을 저장하고 생성하며 이에 대한 접근을 제어하고, 영구 데이터 볼륨에 저장된 상태를 암호화합니다. 여기서는 내장 파일 스토리지 백엔드에 상태를 보관하는 단일 독립 실행형 서버로 실행되므로, 관리형 클라우드 리소스가 아니라 영구 볼륨을 기반으로 하는 상태 저장 실행 서버로 렌더링됩니다. 서버는 클러스터 내부에서 런타임에 초기화되고 봉인 해제됩니다. 루트 토큰과 봉인 해제 키는 실행 중인 서버가 시작된 후 생성하므로, Aggregate에는 어떤 자격 증명도 선언되지 않으며 빌드 시점에 어떤 시크릿도 구체화되지 않습니다.
파일
| 파일 | 역할 |
|---|---|
aggregate.yaml | Developer 의도: 내장 웹 UI가 켜진 단일 secrets 컴포넌트(core/security/openbao). |
manifest.yaml | 컴포넌트 유형을 공식 소스 Recipe(openbao)에 매핑합니다. |
release.yaml | Kubernetes 대상에 대한 운영자 레코드: 서버의 컴퓨팅 크기와 데이터 볼륨 크기. |
보여 주는 내용
- 하나의 작성 표면. 단일 Aggregate가 시크릿 서버가 무엇인지에 대한 단일 진실 공급원이며, Manifest는 이를 어떻게 구현할지를 기술합니다.
- 개발자 값이 렌더링까지 전달됩니다. 개발자의
ui_enabled값은 차트가 마운트하는 서버 구성에 기록되어 내장 웹 UI의 활성화 여부를 결정합니다. - 영구 볼륨 위의 상태 저장 서버. 소스 Recipe는 파일 스토리지 백엔드를
사용하는 독립 실행형 모드를 구성하므로, 서버는 암호화된 상태를
/openbao/data에 마운트된PersistentVolumeClaim에 보관하며, 그 크기는 운영자의storage.size로 정해집니다. - 렌더링 시점의 자격 증명 없음. OpenBao는 런타임에 스스로 초기화하고 봉인을
해제하므로, 빌드는 어떤 자격 증명도 연결하지 않고
Secret도 생성하지 않습니다. 렌더링된 출력은 같은 입력으로 여러 번 실행해도 바이트 단위로 동일합니다. - 재현 가능한 이미지. Recipe는 서버 이미지를 해석 가능한 릴리스 태그(
quay.io/openbao/openbao:2.5.5)에 고정하므로, 렌더링된 워크로드는 고정된 버전을 참조합니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example openbao-secrets그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd openbao-secrets빌드
이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다.
aggrega pull --release release.yamlaggrega build --release release.yaml렌더링된 아티팩트는 dist/ 아래에 생성됩니다. 빌드는 aggrega pull 시 OCI
참조로 업스트림 차트를 해석하고 이를 lockfile에 고정합니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. Workspace 폴더에 아직 `openbao-secrets` 폴더가 없으면 `example`을 `openbao-secrets`로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `openbao-secrets` 폴더에 예제가 작성됩니다. 그런 다음 `workspace_root`를 `openbao-secrets`로, `release`를 `release.yaml`로, `auto_pull`을 true로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `openbao-secrets/dist/` 아래에 있습니다.렌더링 결과
빌드는 간결한 단일 워크로드 OpenBao 스택을 일곱 개의 Kubernetes 객체로 생성합니다.
- OpenBao 서버용
StatefulSet, - 서버 구성(파일 스토리지 백엔드와 API 리스너)을 담은
ConfigMap, - 두 개의
Service: 기본 API 서비스와, StatefulSet이 안정적인 파드 네트워킹에 사용하는 내부 헤드리스 서비스, - 서버 파드용
ServiceAccount, - 서버가 Kubernetes 서비스 계정을 인증하는 데 사용하는 토큰 검토 권한을
부여하는
ClusterRoleBinding, - 서버 준비 상태를 확인하는
helm.sh/hook: testPod.
CustomResourceDefinition은 없습니다. OpenBao는 클러스터 API를 확장하는 컨트롤러가 아니라 자체 완결형 서버입니다. 서버 이미지는 릴리스 태그에 고정되어 있으므로 워크로드는 고정된 이미지 태그를 참조합니다.