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

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.yamlDeveloper 의도: release와 함께 커스텀 리소스 정의를 설치하는 단일 external-secrets component(core/security/external-secrets).
manifest.yamlcomponent 타입을 공식 소스 Recipe(external-secrets)에 매핑합니다.
release.yamlKubernetes 대상에 대한 운영자 레코드: 오퍼레이터의 컴퓨팅 크기 설정.

보여 주는 내용

  • 하나의 작성 지점. 단일 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 어시스턴트에게 대신 빌드하게 할 수 있습니다.

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

Terminal window
aggrega scaffold --example external-secrets-operator

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

Terminal window
cd external-secrets-operator

빌드

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

Terminal window
aggrega pull --release release.yaml
aggrega 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 태그에 고정되므로, 워크로드는 고정된 이미지를 참조합니다.