NATS — 하나의 Aggregate, 두 개의 대상, 선택적 인증
이 예제는 Developer가 작성한 하나의 Aggregate로부터 단일 NATS 메시징 서버(pub-sub, request-reply, 큐잉)를 두 가지 구현으로 컴파일합니다.
- 로컬 개발용 Docker Compose, 그리고
- 공식 업스트림
nats이미지를 Kubernetes에서 직접 실행하는 합성된 helm Recipe (외부 차트 없음).
합성된 helm Recipe는 권장되는 Kubernetes 경로입니다. 서드파티 차트가 아닌 공식 이미지 태그에만 의존하며, 렌더링된 리소스 집합은 워크로드가 선언한 것과 정확히 일치합니다.
동일한 aggregate.yaml이 두 가지를 모두 구동합니다. 구현마다 달라지는 것은
Manifest가 선택하는 Recipe 계층뿐입니다. 두 번째 Aggregate인 aggregate-auth.yaml은
Compose 경로용으로 inject-value 비밀번호 자격 증명이 연결된 동일한 서버를 보여 주며,
aggregate-helm-synth-auth.yaml은 합성된 helm 경로용으로 참조 가능한
자격 증명을 연결합니다.
파일
| 파일 | 역할 |
|---|---|
aggregate.yaml | Developer 의도: core/messaging/nats 유형의 bus 컴포넌트 하나, 자격 증명 없음 — 서버는 인증 없이 실행됩니다. |
aggregate-auth.yaml | 컴포넌트의 선택적 password 슬롯에 inject-value 비밀번호 자격 증명이 연결된 동일한 서버(Compose 경로). |
aggregate-helm-synth-auth.yaml | 합성된 helm 경로용 참조 가능한 자격 증명이 연결된 동일한 서버 — 값은 Deployment가 참조하는 Kubernetes Secret으로 구체화됩니다. |
manifest-compose.yaml | NATS 유형을 Compose Recipe(compose/nats)에, 자격 증명을 dotenv-secret에 매핑합니다. |
manifest-helm-synth.yaml | NATS 유형을 합성된 helm Recipe(helm/nats)에, 자격 증명을 k8s-secret-from-parameter에 매핑합니다. |
release-compose.yaml / release-helm-synth.yaml | 두 구현을 위한 운영자 레코드, 인증 없음. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | 인증을 활성화하는 운영자 레코드. |
보여 주는 내용
- 하나의 작성 표면, 여러 대상. 하나의 Aggregate가 스택이 무엇인지에 대한 단일 진실 공급원입니다. 각 Manifest는 이를 어떻게 구현할지를 나타냅니다.
- 상태 비저장 메시징 서버. 이 간결한 형태에서 NATS는 JetStream 파일 스토리지를 비활성화한 채
메모리에서 subject를 라우팅하므로, 컴포넌트의 유형은
server입니다. Kubernetes에서 합성된 Recipe는 영구 볼륨이 없는 단일 레플리카 Deployment를 렌더링하며, Compose 서비스는 로컬 개발용으로 서버를 노출합니다. - Workload 합성(Kubernetes). 합성된 helm Recipe는 공식
nats이미지를 실행하는 Deployment와 ClusterIP Service로 이루어진 Workload를 선언하며, helm provider는 이를 외부 차트 없이 Kubernetes 매니페스트로 변환합니다. 렌더링된 리소스 집합은 Workload가 선언한 것과 정확히 같습니다. Compose Recipe와 합성된 helm Recipe가 모두nats라는 이름을 가지므로, Manifests는 이를 provider 범위로compose/nats및helm/nats로 참조합니다. - 선택적 인증, 어느 경우든 결정적. NATS 인증은 기본적으로 꺼져 있습니다. 자격 증명이 연결되지 않으면 어느 구현도 인증을 활성화하지 않으며 렌더링 결과는 실행마다 바이트 단위로 동일합니다. 자격 증명이 연결되면 주입된 값이 두 구현 모두에서 사용자/비밀번호 인증을 활성화합니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example nats-messaging그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd nats-messaging빌드
이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다. --auto-pull은 새 클론에 없는 lockfile을 빌드 중에 기록합니다.
# Local development (Docker Compose), no authenticationaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authenticationaggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabledaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pull렌더링된 아티팩트는 dist/ 아래에 생성됩니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 작업 공간 폴더에 아직 `nats-messaging` 폴더가 없으면 `example`에 `nats-messaging` 값을 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `nats-messaging` 폴더에 작성됩니다. 그런 다음 각 Release마다 `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml`, `release-helm-synth-auth.yaml` 순서로 `build` 도구를 한 번씩 호출하되, 매번 `workspace_root` 값은 `nats-messaging`, `release` 값은 해당 파일, `auto_pull` 값은 true, `write` 값은 true로 설정하십시오. 각 빌드가 작성한 파일을 알려 주십시오. 파일은 `nats-messaging/dist/` 아래에 있습니다.자격 증명 전달 참고
Compose 경로에서 자격 증명은 inject-value 시크릿입니다
(aggregate-auth.yaml). 그 값은 컴포넌트의 환경
파이프로 전달되며 서버는 사용자/비밀번호 인증 플래그와 함께 시작됩니다.
합성된 helm 경로는 참조 가능한 자격 증명을 사용합니다
(aggregate-helm-synth-auth.yaml). 값은 Kubernetes
Secret으로 구체화되고, Deployment는 env secretKeyRef를 통해 이를 참조하며,
서버는 해당 환경 변수를 읽는 --user/--pass 플래그와 함께 시작됩니다.
따라서 평문 비밀번호는 Deployment
매니페스트에 나타나지 않고 Secret에만 존재합니다.
인증이 적용된 Aggregates의 origin 값은 개발용 자리 표시자입니다.
실제 배포에서는 자격 증명 소스를 통해 실제 값을 제공하십시오.