external-secrets — Kubernetes 시크릿 동기화 오퍼레이터
이 예제는 작지만 실제로 쓰이는 스택인 external-secrets 오퍼레이터를
Developer가 작성한 하나의 Aggregate에서 Kubernetes로 컴파일하며, 공식
external-secrets Helm 차트를 기반으로 합니다.
external-secrets는 HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key
Vault 등 외부 시크릿 관리 시스템의 시크릿 데이터를 네이티브 Kubernetes Secret으로
동기화하고, 원본이 변경되면 이를 계속 동기화된 상태로 유지합니다. 이것은 애플리케이션이
요청을 보내는 서버가 아니라 자체 커스텀 리소스로 클러스터 API를 확장하는 클러스터 범위
컨트롤러이므로 uses 엣지를 갖지 않으며, 게시하는 것은 Prometheus 서버가 메트릭을 찾을
위치뿐입니다. 애플리케이션은 ExternalSecret 및 SecretStore 리소스를 선언하여
시크릿을 얻고, 오퍼레이터는 그에 대응하는 Kubernetes Secret을 생성합니다.
파일
| 파일 | 역할 |
|---|---|
aggregate.yaml | Developer 의도: release와 함께 커스텀 리소스 정의를 설치하는 단일 external-secrets component(core/security/external-secrets). |
manifest.yaml | component 타입을 공식 소스 Recipe(external-secrets)에 매핑합니다. |
release.yaml | Kubernetes 대상에 대한 운영자 레코드: 오퍼레이터의 컴퓨팅 크기 설정. |
보여 주는 내용
- 하나의 작성 지점. 단일 Aggregate가 오퍼레이터가 무엇인지에 대한 단일 진실 공급원이며, Manifest는 이를 어떻게 구현할지를 기술합니다.
- 개발자 값이 렌더링까지 전달됩니다. 개발자의
install_crds값은 차트의installCRDs값에 기록되어, release와 함께 external-secrets 커스텀 리소스 정의를 클러스터에 설치합니다. - 클러스터를 확장하는 컨트롤러, 토폴로지 엣지 없음. external-secrets는
클러스터 API에 자체 커스텀 리소스를 추가합니다. 소비자는 이 리소스를 선언하여 시크릿을
요청하므로, component는
uses엣지를 연결하지 않으며 메트릭 위치 외에는 아무것도 내보내지 않습니다. - 하나의 일관된 오퍼레이터. 차트는 컨트롤러, 웹훅, 인증서 컨트롤러를 하나의 오퍼레이터로 렌더링합니다. 번들된 provider 서브차트는 꺼져 있으므로 외부 데이터 저장소, 캐시, 브로커를 가져오지 않습니다. 렌더링된 출력은 동일한 입력에 대해 실행할 때마다 바이트 단위로 동일합니다.
- 재현 가능한 이미지. Recipe는 세 컨테이너 이미지를 모두 해석 가능한 release 태그(
ghcr.io/external-secrets/external-secrets:v2.7.0)에 고정하므로, 렌더링된 워크로드는 고정된 버전을 참조합니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example external-secrets-operator그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd external-secrets-operator빌드
이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다.
aggrega pull --release release.yamlaggrega build --release release.yaml렌더링된 아티팩트는 dist/ 아래에 생성됩니다. 빌드는 aggrega pull 시 OCI
참조로 업스트림 차트를 해석하고 이를 lockfile에 고정합니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고, 폴더는 직접 만들지 마십시오. 작업 영역 폴더에 아직 `external-secrets-operator` 폴더가 없으면 `example`을 `external-secrets-operator`로 설정하고 `dir`은 지정하지 않은 채 `scaffold` 도구를 한 번 호출하십시오. 이 도구는 예제를 새 `external-secrets-operator` 폴더에 씁니다. 그런 다음 `workspace_root`를 `external-secrets-operator`로, `release`를 `release.yaml`로, `auto_pull`을 true로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 쓴 파일을 알려 주십시오. 파일은 `external-secrets-operator/dist/` 아래에 있습니다.렌더링 결과
빌드는 external-secrets 오퍼레이터를 Kubernetes 객체 집합으로 생성합니다.
- external-secrets API를 위한 24개의
CustomResourceDefinition(ExternalSecret,SecretStore,ClusterSecretStore및 관련 push·generator 리소스), - 세 개의
Deployment— 컨트롤러, 웹훅, 인증서 컨트롤러, - 이들을 바인딩하는 RBAC:
ClusterRole,ClusterRoleBinding,Role하나,RoleBinding하나, - 워크로드마다 하나씩, 세 개의
ServiceAccount, - 웹훅용
Service하나, - 두 개의
ValidatingWebhookConfiguration, - 런타임에 인증서 컨트롤러가 웹훅의 서빙 인증서로 채우는
자리 표시자
Secret.
세 컨테이너 이미지는 모두 release 태그에 고정되므로, 워크로드는 고정된 이미지를 참조합니다.