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

Contour 게이트웨이 — Kubernetes 네이티브 인그레스 컨트롤러

이 예제는 작지만 실제로 쓰이는 스택인 Contour 인그레스 게이트웨이를 Developer가 작성한 Aggregate 하나에서 Kubernetes로 컴파일합니다. 개발자는 게이트웨이가 무엇인지를 선언하고, 하나의 Ops Recipe가 그 의도를 공식 project-contour Helm 차트(프로젝트의 HTTPS 차트 저장소에서 제공)에 매핑하여 Kubernetes 객체를 렌더링합니다.

Contour는 Kubernetes 네이티브 인그레스 컨트롤러입니다. 컨트롤 플레인은 클러스터의 Ingress 및 HTTPProxy 리소스를 감시하고 Envoy 데이터 플레인을 구성하며, 데이터 플레인은 클라이언트의 HTTP 및 HTTPS 트래픽을 종료하고 해당 리소스가 지정하는 백엔드 서비스로 부하를 분산합니다. 라우팅 입력은 연결된 업스트림이 아니라 클러스터 자체의 Ingress 객체이므로, 게이트웨이는 uses 엣지를 갖지 않습니다. 애플리케이션은 게이트웨이의 인그레스 클래스를 대상으로 Ingress 리소스를 선언하여 게이트웨이에 도달합니다. 같은 이유로 독립 실행형 로컬 컨테이너 형태가 없으므로, 이 제품군은 Helm Recipe만 제공하며 Compose 대상은 없습니다.

파일

파일역할
aggregate.yaml개발자 의도: 조정하는 인그레스 클래스를 지정하는 단일 gateway 컴포넌트(core/gateway/contour).
manifest.yaml게이트웨이 타입을 project-contour Helm Recipe(contour)에 매핑합니다.
release.yamlKubernetes 대상에 대한 운영자 기록: Envoy 서비스 포트와 컨트롤 플레인/데이터 플레인 크기 설정.

보여 주는 내용

  • Ops Recipe로 구현되는 하나의 작성 표면. Aggregate는 게이트웨이가 무엇인지에 대한 단일 진실 공급원입니다. Manifest는 게이트웨이 타입을 이름으로 Recipe에 매핑하여 어떻게 구현할지를 정하고, Release는 운영상의 크기 설정을 제공합니다. 개발자 의도와 Ops 매핑은 분리된 상태로 유지됩니다.
  • 하나의 컴포넌트에서 나오는 컨트롤 플레인과 데이터 플레인. Recipe는 인그레스 컨트롤러의 두 부분을 모두 렌더링합니다. Contour 컨트롤 플레인을 위한 Deployment와 Envoy 데이터 플레인을 위한 DaemonSet이며, 둘은 차트에 의해 서로 연결됩니다.
  • 인그레스 클래스 소유. 개발자의 ingress_class_name 값은 차트로 전달되며, 차트는 그 이름의 IngressClass를 생성합니다. 애플리케이션은 Ingress 리소스에서 해당 클래스를 참조하여 게이트웨이로 라우팅합니다.
  • CRD 관리. Contour는 자체 CustomResourceDefinitions(HTTPProxy 계열)를 설치하고 관리합니다. Recipe는 CRD 관리를 기본적으로 켜 두며, CRD가 미리 설치된 경우에는 infra.overrides.manage_crds를 통해 비활성화합니다.
  • 데이터 플레인 진입점. Envoy Service는 기본적으로 LoadBalancer로 노출됩니다. 운영자는 infra.port를 통해 HTTP 서비스 포트를 설정하고, infra.overrides.service_type을 통해 서비스 타입을 변경할 수 있습니다.
  • 재현 가능한 이미지. Recipe는 Contour와 Envoy 이미지를 명시적인 릴리스 태그로 다시 고정하여, 렌더링된 워크로드가 고정된 버전을 참조하도록 합니다.

예제 생성하기

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

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

Terminal window
aggrega scaffold --example contour-gateway

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

Terminal window
cd contour-gateway

빌드

이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다.

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

렌더링된 아티팩트는 dist/ 아래에 생성됩니다. 빌드는 aggrega pull 시 업스트림 차트를 해석하고 이를 잠금 파일에 고정합니다.

AI 어시스턴트 사용

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

Aggrega 도구만 사용하고, 폴더는 직접 만들지 마십시오. 작업 영역 폴더에 아직 `contour-gateway` 폴더가 없으면 `example`을 `contour-gateway`로 설정하고 `dir`은 지정하지 않은 채 `scaffold` 도구를 한 번 호출하십시오. 이 도구는 예제를 새 `contour-gateway` 폴더에 씁니다. 그런 다음 `workspace_root`를 `contour-gateway`로, `release`를 `release.yaml`로, `auto_pull`을 true로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 쓴 파일을 알려 주십시오. 파일은 `contour-gateway/dist/` 아래에 있습니다.

렌더링 결과

빌드는 인그레스 컨트롤러 스택 전체를 출력합니다:

  • Contour 컨트롤 플레인을 실행하는 Deployment,
  • Envoy 데이터 플레인을 실행하는 DaemonSet,
  • Contour CustomResourceDefinitions,
  • contour라는 이름의 IngressClass,
  • HTTP 포트 80과 HTTPS 포트 443에서 Envoy 앞단에 위치하는 LoadBalancer Service,

그리고 이를 지원하는 ConfigMap, 인증서 생성 Job, 컨트롤 플레인의 Service, NetworkPolicy, RBAC, ServiceAccount. Contour와 Envoy 이미지는 릴리스 태그로 고정되므로, 모든 워크로드는 고정된 이미지 태그를 참조합니다.