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

sealed-secrets — Kubernetes SealedSecret 복호화 컨트롤러

이 예제는 작지만 실제로 쓰이는 스택인 sealed-secrets 컨트롤러를 Developer가 작성한 하나의 Aggregate에서 Kubernetes로 컴파일하며, HTTPS 차트 저장소에서 제공되는 공식 sealed-secrets Helm 차트를 기반으로 합니다.

sealed-secrets를 사용하면 암호화된 시크릿 자료를 소스 제어에 안전하게 커밋할 수 있습니다. 공개 키가 시크릿을 SealedSecret 커스텀 리소스로 암호화하고, 대응하는 개인 키를 보유한 클러스터 범위 컨트롤러가 이를 다시 네이티브 Kubernetes Secret으로 복호화합니다. 이 컨트롤러는 애플리케이션이 라우팅하는 서버가 아니라 자체 SealedSecret 커스텀 리소스로 클러스터 API를 확장하므로, uses 엣지를 받지 않으며 소비자에게 아무것도 내보내지 않습니다. 애플리케이션은 SealedSecret 리소스를 선언하여 시크릿을 얻고, 컨트롤러는 해당하는 Kubernetes Secret들을 봉인 해제합니다. 컨트롤러는 런타임에 클러스터 안에서 봉인용 키 쌍을 생성하므로, 렌더링 시점에는 키 자료가 생성되지 않습니다.

파일

파일역할
aggregate.yamlDeveloper 의도: 단일 sealed-secrets 컴포넌트(core/security/sealed-secrets).
manifest.yaml컴포넌트 유형을 공식 소스 기반 Recipe(sealed-secrets)에 매핑합니다.
release.yamlKubernetes 대상에 대한 운영자 레코드: 오퍼레이터의 컴퓨팅 크기 설정.

보여 주는 내용

  • 하나의 작성 표면. 단일 Aggregate가 컨트롤러가 무엇인지에 대한 단일 진실 공급원이며, Manifest는 이를 어떻게 실현할지를 기술합니다.
  • HTTPS로 제공되는 차트. Recipe는 OCI 레지스트리가 아닌 HTTPS 차트 저장소에서 차트를 가져오며, 빌드는 aggrega pull 시 이를 해석하고 고정합니다.
  • 차트의 CRD 디렉터리에 포함된 CRD. SealedSecret CustomResourceDefinition은 템플릿이 아니라 차트의 Helm 네이티브 CRD 디렉터리에 있으며, 릴리스와 함께 무조건 출력에 렌더링됩니다.
  • 클러스터를 확장하는 컨트롤러, 토폴로지 엣지 없음. sealed-secrets는 자체 커스텀 리소스를 클러스터 API에 추가합니다. 소비자는 SealedSecret 리소스를 선언하여 시크릿을 요청하므로, 컴포넌트는 uses 엣지를 연결하지 않으며 아무것도 내보내지 않습니다.
  • 하나의 일관된 컨트롤러. 차트는 RBAC 및 Service와 함께 하나의 컨트롤러를 렌더링하며, 외부 데이터 저장소, 캐시, 브로커는 없습니다. 렌더링된 출력은 동일한 입력으로 여러 번 실행해도 바이트 단위로 동일합니다.
  • 재현 가능한 이미지. Recipe는 컨트롤러 이미지를 해석 가능한 릴리스 태그(docker.io/bitnami/sealed-secrets-controller:0.38.4)로 고정하므로, 렌더링된 워크로드는 고정된 버전을 참조합니다.

예제 생성하기

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

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

Terminal window
aggrega scaffold --example sealed-secrets-controller

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

Terminal window
cd sealed-secrets-controller

빌드

이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다.

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

렌더링된 아티팩트는 dist/ 아래에 생성됩니다. 빌드는 aggrega pull 시 HTTPS 차트 저장소에서 업스트림 차트를 해석하고 이를 잠금 파일에 고정합니다.

AI 어시스턴트 사용

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

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

렌더링 결과

빌드는 sealed-secrets 컨트롤러를 Kubernetes 오브젝트 집합으로 내보냅니다.

  • sealed-secrets API(SealedSecret)용 CustomResourceDefinition 1개,
  • Deployment 1개 — 컨트롤러,
  • 이를 바인딩하는 RBAC: ClusterRole 1개, ClusterRoleBinding 1개, Role 2개, RoleBinding 2개,
  • ServiceAccount 1개,
  • Service 2개 — 컨트롤러 서비스와 메트릭 서비스.

컨트롤러 이미지가 릴리스 태그에 고정되므로, 워크로드는 고정된 이미지 태그를 참조합니다.