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

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

이 간결한 예제는 Developer가 작성한 하나의 Aggregate에서 단일 Redis 인메모리 캐시(Redis 와이어 프로토콜)를 두 가지 구현으로 컴파일합니다.

  • 로컬 개발용 Docker Compose, 그리고
  • 공식 업스트림 redis 이미지를 Kubernetes에서 직접 실행하는 합성된 helm Recipe (외부 차트 없음).

합성된 helm Recipe는 Kubernetes 경로입니다. 서드파티 차트가 아닌 공식 이미지 태그에만 의존하며, 렌더링되는 리소스 집합은 정확히 워크로드가 선언한 그대로입니다.

동일한 aggregate.yaml이 두 가지를 모두 구동합니다. 구현마다 달라지는 것은 Manifest가 선택하는 Recipe 계층뿐입니다. 두 번째 Aggregate인 aggregate-auth.yaml은 Compose 경로용으로 선택적 비밀번호 자격 증명이 연결된 동일한 캐시를 보여 주며, aggregate-helm-synth-auth.yaml은 합성된 helm 경로용으로 참조 가능한 자격 증명을 연결합니다.

이 예제가 매핑하는 카탈로그의 Redis Recipes인 compose/redis와 helm/redis는 AGPL-3.0 라이선스를 선언합니다. valkey-cache 예제는 같은 와이어 프로토콜을 사용하는 Valkey를 배포하며, 그 helm/valkey Recipe는 BSD-3-Clause를 선언합니다.

파일

파일역할
aggregate.yamlDeveloper 의도: core/datastore/redis 유형의 cache 컴포넌트 하나, 자격 증명 없음 — 캐시는 인증 없이 실행됩니다.
aggregate-auth.yaml컴포넌트의 선택적 password 슬롯에 비밀번호 자격 증명이 연결된 동일한 캐시(Compose 경로).
aggregate-helm-synth-auth.yaml합성된 helm 경로를 위해 참조 가능한 자격 증명을 연결한 동일한 캐시 — 값은 Deployment가 참조하는 Kubernetes Secret으로 구체화됩니다.
manifest-compose.yamlRedis 유형을 Compose Recipe(compose/redis)에, 자격 증명을 dotenv-secret에 매핑합니다.
manifest-helm-synth.yamlRedis 유형을 합성된 helm Recipe(helm/redis)에, 자격 증명을 k8s-secret-from-parameter에 매핑합니다.
release-compose.yaml / release-helm-synth.yaml두 구현을 위한 운영자 레코드, 인증 없음.
release-compose-auth.yaml / release-helm-synth-auth.yaml인증을 활성화하는 운영자 레코드.

보여 주는 내용

  • 하나의 작성 표면, 여러 대상. 하나의 Aggregate가 스택이 무엇인지에 대한 단일 진실 공급원입니다. 각 Manifest는 이를 어떻게 구현할지를 나타냅니다.
  • 캐시 역할의 데이터 저장소. 여기서 Redis는 인메모리 캐시로 사용되며 아무것도 영속적으로 저장하지 않으므로, 컴포넌트는 stateful-server가 아닌 일반 server로 유형이 지정됩니다. Kubernetes에서 합성된 Recipe는 StatefulSet이 아닌 Deployment를 렌더링하고 영구 볼륨을 요청하지 않으며, Compose에서는 서비스가 데이터 볼륨을 선언하지 않습니다.
  • 워크로드 합성(Kubernetes). 합성된 helm Recipe는 Workload — 공식 redis 이미지를 실행하는 Deployment와 ClusterIP Service — 를 선언하며, helm 프로바이더가 이를 외부 차트 없이 Kubernetes 매니페스트로 변환합니다. 렌더링되는 리소스 집합은 정확히 Workload가 선언한 그대로입니다. Compose Recipe와 합성된 helm Recipe가 모두 redis라는 이름을 가지므로, Manifests는 이를 프로바이더 범위로 compose/redis 및 helm/redis로 참조합니다.
  • 자격 증명 슬롯을 통한 선택적 인증. 컴포넌트는 featuresSchema에 선택적 password 슬롯 하나를 선언합니다. 자격 증명이 연결되지 않은 경우(기본 Aggregate), Recipe는 인증이 비활성화된 캐시를 렌더링하며, 이는 슬롯이 없는 Recipe와 바이트 단위로 동일합니다. 자격 증명이 연결되면 두 대상 모두 --requirepass로 Redis를 시작하므로 서버가 비밀번호를 요구합니다. Compose(aggregate-auth.yaml)에서는 값이 그 인수로 서버에 전달되고, 합성된 Kubernetes 경로(aggregate-helm-synth-auth.yaml)에서는 Deployment가 참조하는 Secret으로 구체화됩니다.

예제 생성하기

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

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

Terminal window
aggrega scaffold --example redis-cache

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

Terminal window
cd redis-cache

빌드

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

Terminal window
# Local development (Docker Compose), no authentication
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authentication
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
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 폴더에 아직 `redis-cache` 폴더가 없으면 `example`을 `redis-cache`로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `redis-cache` 폴더에 예제가 작성됩니다. 그런 다음 각 Release마다 `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml`, `release-helm-synth-auth.yaml` 순서로 `build` 도구를 한 번씩 호출하되, 매번 `workspace_root`를 `redis-cache`로, `release`를 해당 파일로, `auto_pull`을 true로, `write`를 true로 설정하십시오. 각 빌드가 작성한 파일을 알려 주십시오. 파일은 `redis-cache/dist/` 아래에 있습니다.

자격 증명 전달 참고

Compose 경로에서 자격 증명은 inject-value 시크릿입니다(aggregate-auth.yaml). 그 값은 컴포넌트의 환경 파이프를 통해 values.key가 지정하는 변수 REDIS_PASSWORD로 전달되고, Recipe는 이를 --requirepass로 서버에 넘깁니다. 공식 redis 이미지는 비밀번호 변수를 읽지 않으므로 값은 인수로 전달되어 서비스의 명령에 나타납니다. Recipe가 읽는 어떤 변수로도 값이 도달하지 않는 연결은 캐시를 열어 두는 대신 슬롯을 지목하며 빌드를 중단시킵니다.

합성된 helm 경로는 참조 가능한 자격 증명을 사용합니다 (aggregate-helm-synth-auth.yaml). 값은 Kubernetes Secret으로 구체화되고, Deployment는 env secretKeyRef를 통해 이를 참조하며, Redis는 해당 환경 변수를 읽는 --requirepass와 함께 시작됩니다. 따라서 평문 비밀번호는 Deployment 매니페스트에 나타나지 않고 Secret에만 존재합니다. 이것이 바로 스스로는 환경 변수에서 비밀번호를 읽지 않는 공식 redis 이미지에서 실제로 인증을 활성화하는 방식입니다.

인증이 적용된 Aggregates의 origin 값은 개발용 자리 표시자입니다. 실제 배포에서는 자격 증명 소스를 통해 실제 값을 제공하십시오.