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

Memcached — 하나의 Aggregate, 두 개의 대상, 그리고 거부되는 비밀번호

이 간결한 예제는 개발자가 작성한 하나의 Aggregate에서 단일 Memcached 인메모리 캐시를 두 가지 구현으로 컴파일합니다.

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

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

동일한 aggregate.yaml이 두 구현을 모두 구동합니다. 구현마다 Manifest가 선택하는 Recipe 계층만 바뀝니다. 다른 두 Aggregate는 캐시에 비밀번호를 연결하며, 그 Releases는 실패 예제입니다. 어떤 구현도 Memcached 비밀번호를 강제할 수 없으므로 빌드가 중단됩니다.

파일

파일역할
aggregate.yaml개발자 의도: core/datastore/memcached 유형의 cache 컴포넌트 하나, 자격 증명 없음 — 캐시는 인증 없이 실행됩니다.
aggregate-auth.yaml컴포넌트의 선택적 password 슬롯에 inject-value 비밀번호 자격 증명을 연결한 동일한 캐시(Compose 경로). 이 빌드는 중단됩니다.
aggregate-helm-synth-auth.yaml합성된 helm 경로용으로 참조 가능한 비밀번호 자격 증명을 연결한 동일한 캐시. 이 빌드는 중단됩니다.
manifest-compose.yamlMemcached 유형을 Compose Recipe(compose/memcached)에, 자격 증명을 dotenv-secret에 매핑합니다.
manifest-helm-synth.yamlMemcached 유형을 합성된 helm Recipe(helm/memcached)에, 자격 증명을 k8s-secret-from-parameter에 매핑합니다.
release-compose.yaml / release-helm-synth.yaml두 구현에 대한 운영자 레코드입니다.
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yaml비밀번호가 있는 두 Aggregate에 대한 운영자 레코드. 각 빌드는 실패할 것으로 예상됩니다.

보여 주는 내용

  • 하나의 작성 표면, 여러 대상. 하나의 Aggregate가 스택이 무엇인지에 대한 단일 진실 공급원입니다. 각 Manifest는 이를 어떻게 구현할지를 나타냅니다.
  • 상태 비저장 데이터 저장소. Memcached는 항목을 메모리에 보관하고 아무것도 영구적으로 저장하지 않으므로, 컴포넌트는 stateful-server가 아닌 일반 server로 유형이 지정됩니다. Kubernetes에서 Recipe는 StatefulSet이 아닌 Deployment를 렌더링하며 영구 볼륨을 요청하지 않습니다. Compose에서는 서비스가 데이터 볼륨을 선언하지 않습니다.
  • 워크로드 합성(Kubernetes). 합성된 helm Recipe는 Workload — 공식 memcached 이미지를 실행하는 Deployment와 ClusterIP Service — 를 선언하며, helm 프로바이더가 이를 외부 차트 없이 Kubernetes 매니페스트로 변환합니다. 렌더링된 리소스 집합은 Workload가 선언한 것과 정확히 일치합니다. Compose Recipe와 합성된 helm Recipe가 모두 memcached라는 이름을 가지므로, Manifests는 이를 프로바이더 범위로 compose/memcached와 helm/memcached로 참조합니다.
  • 구현이 제공할 수 없는 보호는 누락되지 않고 거부됩니다. 이 컴포넌트는 선택적 password 슬롯을 선언합니다. memcached 이미지는 비밀번호를 강제하지 않습니다. 이 이미지의 두 가지 인증 모드는 바이너리 프로토콜에서만 쓰이는 SASL과 ASCII 인증 파일이며, 카탈로그의 Memcached 클라이언트는 둘 다 사용하지 않습니다. 연결을 받아들이는 Recipe는 Aggregate가 보호된다고 말하는데도 모든 클라이언트에 응답하는 캐시를 렌더링하게 되므로, 각 Recipe는 대신 슬롯을 지목하며 빌드를 중단합니다.

예제 생성하기

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

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

Terminal window
aggrega scaffold --example memcached-cache

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

Terminal window
cd memcached-cache

빌드

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

Terminal window
# Local development (Docker Compose)
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image)
aggrega build --release release-helm-synth.yaml --auto-pull

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

AI 어시스턴트 사용

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

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

대조군: 캐시가 강제할 수 없는 비밀번호

두 실패 Release는 비밀번호가 있는 Aggregate를 빌드하며, 각 빌드는 실패할 것으로 예상됩니다:

Terminal window
aggrega build --release release-negative-compose-auth.yaml --auto-pull
aggrega build --release release-negative-helm-synth-auth.yaml --auto-pull

각 빌드는 아무것도 기록되기 전에 Memcached Recipe에서 중단되며, 중단은 Recipe 자체의 메시지로 끝납니다:

a password is attached to the password slot of "cache", but the memcached
image this Recipe runs cannot enforce a password: it authenticates only through
SASL over the binary protocol or an ASCII authentication file, which the
catalog's Memcached clients do not use, so the cache would accept every client
anyway; remove the attachment, and restrict who can reach the cache through its
network

거부는 자격 증명이 전달되는 방식이 아니라 연결 자체를 기준으로 하므로, 슬롯을 채울 수 있는 모든 Feature가 같은 방식으로 중단됩니다. 관리형 구현도 마찬가지입니다. Amazon ElastiCache는 Memcached 인증을 제공하지 않으며, 그 Recipes도 연결에서 중단됩니다. 따라서 Memcached 캐시는 누가 접근할 수 있는지, 즉 배치된 네트워크에 의해 보호되며, 빌드할 형태는 기본 aggregate.yaml입니다.