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

RabbitMQ — 하나의 Aggregate, 두 개의 대상, 선택적 인증

이 예제는 Developer가 작성한 하나의 Aggregate에서 단일 RabbitMQ 메시지 브로커(AMQP)를 두 개의 대상으로 컴파일합니다.

  • 로컬 개발용 Docker Compose, 그리고
  • 공식 업스트림 rabbitmq 이미지를 직접 실행하는 합성된 helm Recipe를 통한 Kubernetes(영구 볼륨이 있는 StatefulSet, 외부 차트 없음).

동일한 aggregate.yaml이 두 대상을 모두 구동합니다. 대상마다 Manifest가 선택하는 Recipe 계층만 바뀝니다. 두 번째 Aggregate인 aggregate-helm-synth-auth.yaml은 참조 가능한 비밀번호 자격 증명이 연결된 동일한 브로커를 Kubernetes에서 보여 줍니다.

파일

파일역할
aggregate.yamlDeveloper 의도: core/messaging/rabbitmq 유형의 broker 컴포넌트 하나, 자격 증명 없음 — Recipe가 결정적인 인라인 개발용 비밀번호를 제공합니다.
aggregate-auth.yaml컴포넌트의 선택적 password 슬롯에 inject-value 비밀번호 자격 증명이 연결된 동일한 브로커입니다(Compose 대상에서 사용).
aggregate-helm-synth-auth.yaml참조 가능한 비밀번호 자격 증명이 연결된 동일한 브로커로, 자격 증명은 Kubernetes Secret으로 구체화되고 StatefulSet이 이를 참조합니다(Kubernetes 대상에서 사용).
manifest-compose.yamlRabbitMQ 유형을 Compose Recipe(compose/rabbitmq)에, 자격 증명을 dotenv-secret에 매핑합니다.
manifest-helm-synth.yamlRabbitMQ 유형을 합성된 helm Recipe(helm/rabbitmq)에, 자격 증명을 k8s-secret-from-parameter에 매핑합니다.
release-compose.yaml / release-helm-synth.yaml두 대상에 대한 Operator 레코드, 인라인 개발용 비밀번호.
release-compose-auth.yaml / release-helm-synth-auth.yaml자격 증명 슬롯을 통해 비밀번호를 제공하는 Operator 레코드.

Manifests의 Recipe 참조는 프로바이더 범위로 지정됩니다(compose/rabbitmq, helm/rabbitmq). 프로바이더마다 같은 이름의 Recipe가 존재하기 때문입니다.

보여 주는 내용

  • 하나의 작성 표면, 여러 대상. 하나의 Aggregate가 스택이 무엇인지에 대한 단일 진실 공급원입니다. 각 Manifest는 이를 어떻게 구현할지를 나타냅니다.
  • 내구성 있는 브로커. RabbitMQ는 큐와 메시지를 영구 저장하므로 컴포넌트는 stateful-server로 유형이 지정됩니다. Kubernetes에서 합성된 Recipe는 RabbitMQ 데이터 디렉터리에 마운트된 레플리카별 영구 볼륨과 안정적인 네트워크 ID를 위한 Headless Service를 갖춘 StatefulSet을 렌더링합니다. Compose 서비스는 로컬 개발을 위해 브로커를 노출합니다.
  • 차트 없는 합성(Kubernetes). Kubernetes 대상은 공식 rabbitmq 이미지를 직접 실행합니다. 컴파일러는 컴포넌트의 infra 크기 설정으로부터 StatefulSet, ClusterIP Service, Headless Service를 합성하므로 가져오거나 추적할 외부 차트가 없습니다. 이미지 태그는 infra.engine_version을 통해 고정되므로 렌더링 결과에 유동 태그가 없습니다.
  • 두 브로커 포트 모두. 이미지에 관리 기능이 활성화되어 있으므로 브로커는 컨테이너와 ClusterIP Service에서 AMQP 포트(5672)와 관리 대시보드(15672)를 노출합니다.
  • 결정적인 자격 증명. RabbitMQ는 항상 인증을 수행합니다. 자격 증명이 연결되지 않은 경우 각 Recipe는 고정된 인라인 개발용 비밀번호를 제공하므로 렌더링 결과는 실행할 때마다 바이트 단위로 동일합니다. 자격 증명이 연결된 경우 주입된 값이 브로커 비밀번호를 설정합니다. Compose에서는 RABBITMQ_DEFAULT_PASS 서비스 환경 변수가 되고, Kubernetes에서는 Secret으로 구체화되어 env secretKeyRef로 참조되므로 평문이 렌더링된 매니페스트에 들어가지 않습니다.

예제 생성하기

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

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

Terminal window
aggrega scaffold --example rabbitmq-broker

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

Terminal window
cd rabbitmq-broker

빌드

이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다. --auto-pull은 새 클론에 없는 lockfile을 빌드 중에 기록합니다.

Terminal window
# Local development (Docker Compose), inline development password
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline password
aggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attached
aggrega build --release release-compose-auth.yaml --auto-pull
aggrega build --release release-helm-synth-auth.yaml --auto-pull

렌더링된 아티팩트는 dist/ 아래에 생성됩니다.

AI 어시스턴트 사용

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

Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. Workspace 폴더에 아직 `rabbitmq-broker` 폴더가 없으면 `example`을 `rabbitmq-broker`로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `rabbitmq-broker` 폴더에 예제가 작성됩니다. 그런 다음 각 Release마다 `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml`, `release-helm-synth-auth.yaml` 순서로 `build` 도구를 한 번씩 호출하되, 매번 `workspace_root`를 `rabbitmq-broker`로, `release`를 해당 파일로, `auto_pull`을 true로, `write`를 true로 설정하십시오. 각 빌드가 작성한 파일을 알려 주십시오. 파일은 `rabbitmq-broker/dist/` 아래에 있습니다.

자격 증명 전달 참고

Compose에서 자격 증명은 inject-value 시크릿입니다. 그 값은 컴포넌트의 환경 파이프로 전달되어 RABBITMQ_DEFAULT_PASS 서비스 환경 변수가 됩니다. Kubernetes에서 자격 증명은 참조 가능합니다. Kubernetes Secret으로 구체화되고 StatefulSet이 env secretKeyRef를 통해 이를 참조하므로 평문 비밀번호는 워크로드 매니페스트에 나타나지 않습니다. 인증 Aggregates의 origin 값은 개발용 자리 표시자입니다. 실제 배포에서는 자격 증명 소스를 통해 실제 값을 제공하십시오. 자격 증명이 연결되지 않았을 때 사용되는 인라인 개발용 비밀번호도 마찬가지로 로컬 용도로만 사용해야 합니다.