cert-manager — Kubernetes TLS 인증서 수명 주기 컨트롤러
이 예제는 작지만 실제로 쓰이는 스택인 cert-manager 인증서
컨트롤러를 Developer가 작성한 하나의 Aggregate에서 Kubernetes로 컴파일합니다.
개발자는 cert-manager가 무엇인지를 선언하고, 하나의 Ops Recipe가 그 의도를
jetstack 레지스트리의 공식 cert-manager Helm 차트에 매핑하여
Kubernetes 객체를 렌더링합니다.
cert-manager는 클러스터 범위의 Kubernetes 애드온으로, ACME(Let’s
Encrypt), 사설 CA, Vault 같은 발급 소스로부터 X.509 인증서의 발급과 갱신을
자동화합니다. 자체 Certificate, Issuer, ClusterIssuer 커스텀 리소스로
클러스터를 확장합니다. 애플리케이션은 업스트림을 연결하는 방식이 아니라 이러한
리소스를 선언하는 방식으로 인증서를 요청하므로, 이 component는 uses 에지를
갖지 않습니다. 같은 이유로 독립 실행형 로컬 컨테이너 형태가 없으므로 이 제품군은
Helm Recipe만 제공하며, Compose 대상은 없습니다. 이 component가 게시하는 것은
Prometheus 서버가 메트릭을 찾을 위치뿐입니다.
파일
| 파일 | 역할 |
|---|---|
aggregate.yaml | Developer 의도: CRD 설치가 켜진 단일 cert-manager component(core/security/cert-manager). |
manifest.yaml | component 유형을 cert-manager Helm Recipe(cert-manager)에 매핑합니다. |
release.yaml | Kubernetes 대상에 대한 운영자 기록: 컨트롤러/웹훅/CA 인젝터 크기 설정. |
보여 주는 내용
- Ops Recipe로 실현되는 하나의 작성 표면. Aggregate는 cert-manager가 무엇인지에 대한 단일 진실 공급원입니다. Manifest는 component 유형을 이름으로 Recipe에 매핑하여 이를 어떻게 실현할지 정하고, Release는 운영 크기 설정을 제공합니다. Developer 의도와 Ops 매핑은 분리된 상태로 유지됩니다.
- 하나의 component에서 나오는 세 개의 조정된 workload. Recipe는 cert-manager의
세 부분을 모두 렌더링합니다. 인증서 요청을 조정하는 컨트롤러용
Deployment, 커스텀 리소스를 검증하고 기본값을 채우는 웹훅용Deployment, 그리고 웹훅의 CA 번들을 클러스터에 연결하는 CA 인젝터용Deployment입니다. - Certificate API 설치. 개발자의
install_crds값은 차트로 전달되며, 차트는 cert-manager의CustomResourceDefinition(Certificate,Issuer,ClusterIssuer, ACMEOrder/Challenge리소스)을 설치합니다. CRD를 별도로 관리하는 경우에는 이 값을 false로 설정합니다. - 어드미션 연결. 차트는 웹훅이 제공하는
ValidatingWebhookConfiguration과MutatingWebhookConfiguration, 웹훅Service, 그리고 전체 RBAC 세트(컨트롤러 책임마다 하나의ClusterRole/ClusterRoleBinding과 리더 선출용Role)를 생성하여 컨트롤러가 필요한 권한을 갖도록 합니다. - 재현 가능한 이미지. 차트는 해석 가능한 릴리스 태그를 제공하며, Recipe는 컨트롤러, 웹훅, CA 인젝터, ACME 솔버 이미지를 해당 태그로 다시 고정하여 렌더링된 workload가 고정된 버전을 참조하도록 합니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example cert-manager-tls그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd cert-manager-tls빌드
이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다.
aggrega pull --release release.yamlaggrega build --release release.yaml렌더링된 아티팩트는 dist/ 아래에 생성됩니다. 빌드는 aggrega pull 시 OCI
참조로 업스트림 차트를 해석하고 이를 lockfile에 고정합니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 워크스페이스 폴더에 아직 `cert-manager-tls` 폴더가 없으면 `example`에 `cert-manager-tls`를 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `cert-manager-tls` 폴더에 쓰입니다. 그런 다음 `workspace_root`에 `cert-manager-tls`, `release`에 `release.yaml`, `auto_pull`에 true, `write`에 true를 지정하여 `build` 도구를 호출하십시오. 빌드가 어떤 파일을 썼는지 알려 주십시오. 파일은 `cert-manager-tls/dist/` 아래에 있습니다.렌더링 결과
빌드는 전체 cert-manager 스택을 생성합니다. 세 개의 Deployment(컨트롤러, 웹훅, CA 인젝터), install_crds가 켜져 있을 때의 cert-manager CustomResourceDefinition 6개, ValidatingWebhookConfiguration과 MutatingWebhookConfiguration, 웹훅 Service, 컨트롤러 ServiceAccount, 그리고 ClusterRole, ClusterRoleBinding, 리더 선출용 Role 및 RoleBinding으로 이루어진 RBAC 세트입니다. 또한 설치 후 Job(인증서 API가 서비스될 때까지 대기하는 시작 API 검사)과 컨트롤러 및 CA 인젝터 각각의 메트릭 Service도 포함되어 모두 50개의 Kubernetes 객체가 생성됩니다. 컨트롤러, 웹훅, CA 인젝터, ACME 솔버 이미지는 릴리스 태그에 고정되므로 모든 workload가 고정된 이미지 태그를 참조합니다.