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

고급 패턴

이 페이지는 하나의 개념, 즉 컴포넌트 자체의 Recipe 외에 빌드가 무엇을 기록할지 결정하는 곳으로서의 Manifest와 FeatureRecipe를 설명하며, 실행 가능한 워크스페이스가 아닙니다. 인스턴스별 레시피 재정의는 빌드할 수 있는 워크스페이스에서 Manifest 쪽을 보여 줍니다. 다음 명령으로 자신의 폴더에 작성합니다:

Terminal window
aggrega scaffold --example per-instance-recipe-override

그런 다음 이어서 실행할 명령을 출력합니다:

Terminal window
cd per-instance-recipe-override
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

하나의 인스턴스, 그 인스턴스만의 Recipe

Manifest의 type 계층은 한 컴포넌트 유형의 모든 인스턴스를 하나의 Recipe에 바인딩합니다. name 계층은 Aggregate 안의 이름으로 하나의 인스턴스를 다른 Recipe에 바인딩하며, 그곳에 이름이 지정된 인스턴스는 그것을 사용하고 해당 유형의 다른 모든 인스턴스는 type 바인딩을 유지합니다. 예제의 manifest.yaml에서:

spec:
mappings:
components:
type:
example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0
name:
greeter-special: compose/greeter-green:1.0.0

가장 구체적인 항목이 우선합니다:

  1. 인스턴스 이름에 대한 name 항목;
  2. example/compute/greeter:1.0.0처럼 인스턴스의 버전으로 유형을 지정하는 type 항목;
  3. 버전 없이 유형을 지정하는 type 항목;
  4. 항목이 전혀 없으면 빌드는 매핑되지 않은 인스턴스를 지목하며 중단됩니다.

Manifest는 일반 YAML이므로, 반복되는 값은 앵커로 한 번 작성하고 별칭으로 참조할 수 있습니다.

자체 리소스를 가져오는 Feature

FeatureRecipe는 컴포넌트의 Recipe가 렌더링하는 내용을 바꾸는 대신, source:로 지정되고 valuesMapping으로 값을 공급받는 자체 차트로부터 컴포넌트 자체의 리소스 옆에 리소스를 렌더링할 수 있습니다. 표준 라이브러리의 core/public-ingress는 Kubernetes에서 이 방식으로 helm/public-ingress에 의해 구현되며, 이는 연결된 컴포넌트를 위한 Ingress를 렌더링합니다.

컴포넌트가 제공하는 요청 경로는 애플리케이션의 일부이므로 Feature는 이를 values로 받습니다. 호스트 이름은 환경이 컴포넌트에 붙이는 이름이므로, 클러스터를 기술하는 설정과 나란히 infra에 둡니다. 에이전트, 라우터, 그리고 두 개의 업스트림 모델에서는 개발자가 Aggregate에서 이를 연결하고 경로를 작성합니다:

features:
published:
type: core/public-ingress
values:
path: /

그리고 Release는 같은 연결에 호스트를 지정하고, 대상 클러스터에서 ingress 컨트롤러가 실행된다는 것을 확인하며, 이 확인이 없으면 빌드가 중단됩니다. 주석을 생략한 release.yaml에서:

published:
infra:
host: assistant.example.internal
control_plane_present: true

FeatureRecipe는 렌더링하는 리소스의 이름을 .context.rendered_name, 즉 호스트 컴포넌트의 프로바이더가 보고하는 그 이름을 따라 짓습니다. 따라서 Ingress는 컴포넌트 자체의 Recipe가 렌더링하는 Service를 가리킵니다. Aggregate의 values에 작성한 host나 Release의 infra에 작성한 path는 해당 필드를 지목하며 거부됩니다. 각 영역은 닫혀 있으며, 그 필드는 다른 쪽에 속하기 때문입니다. 환경마다 달라지는 경로는 Aggregate가 선언하고 각 Release가 채우는 파라미터입니다.