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

자체 웹훅 인증서: 차트가 생성하는 Secret 제외하기

이 예제는 고급 예제입니다. 대부분의 Recipes에는 필요 없는 Recipe 필드 omits:를 다룹니다. 이 필드는 있는 그대로 가져다 쓰는 소스(여기서는 레지스트리에서 가져온 차트)가 Release가 배포해서는 안 되는 문서를 렌더링하는 경우를 위한 것입니다. 그런 경우를 만났을 때 사용하십시오.

이 워크스페이스는 Envoy Gateway가 확장 서버로 호출하는 컨트롤러인 Envoy AI Gateway 컨트롤 플레인을 표준 라이브러리 Recipe helm/envoy-ai-gateway-operator를 통해 웹훅 인증서가 취할 수 있는 두 가지 모드 모두로 빌드합니다. 그중 한 모드에서는 프로젝트의 차트가 렌더링할 때마다 새로 생성하는 키와 인증서를 담은 Secret을 렌더링하며, Recipe의 omits: 항목이 그 Secret을 빌드에서 제외합니다. 추가로 두 개의 Releases가 이 필드와 관련해 만날 수 있는 두 가지 중단을 보여 줍니다. 하나는 이 항목이 막기 위해 존재하는 중단이고, 다른 하나는 더 이상 아무것에도 일치하지 않는 항목이 일으키는 중단입니다.

구성되는 내용

core/gateway/envoy-ai-gateway-operator의 컴포넌트 하나인 ai-controller를 Kubernetes 매니페스트로 컴파일합니다. Aggregate는 모든 Release에서 동일합니다. 각 Release는 컨트롤러를 envoy-ai-gateway-system에 배치하고 인증서 모드를 선택하며, 각 Manifest는 Recipe를 선택합니다.

Release해당 Manifest가 바인딩하는 것인증서 모드결과
release-cert-manager.yaml표준 라이브러리의 helm/envoy-ai-gateway-operatorcert-manager빌드됨
release-own-certificate.yaml표준 라이브러리의 helm/envoy-ai-gateway-operatorSecret ai-gateway-webhook-tls빌드됨, 빌드할 때마다 바이트 단위로 동일
release-negative-without-omits.yaml이 워크스페이스의 helm/envoy-ai-gateway-operator-without-omitsSecret ai-gateway-webhook-tls--verify-determinism으로 빌드하면 E0058로 중단됨
release-negative-stale-omits.yaml이 워크스페이스의 helm/envoy-ai-gateway-operator-stale-omitsSecret ai-gateway-webhook-tlsE0334로 중단됨

이 워크스페이스의 catalog/에 있는 두 Recipes는 표준 라이브러리 Recipe의 학습용 변형입니다. 각각 같은 차트를 같은 릴리스로 가져오고 같은 매핑으로 인증서 모드를 선택합니다. 하나는 omits: 항목이 없고, 다른 하나는 차트가 렌더링하지 않는 Secret을 지정하는 항목을 가집니다. 둘은 고유한 이름을 가지므로 표준 라이브러리 Recipe를 가리지 않고 그 옆에 놓이며, Release가 지정하는 Manifest가 어느 쪽으로 빌드할지 결정합니다.

웹훅에 인증서를 제공하는 두 가지 방법

컨트롤러는 클러스터의 API 서버가 TLS로 호출하는 변경(mutating) 웹훅을 실행하므로, 웹훅은 인증서를 제공합니다. Component는 이를 공급하는 두 가지 방법을 제공하며, 하나의 infra 키인 webhook_tls_secret으로 선택합니다.

  • 설정하지 않음(기본값). 차트는 컨트롤러의 Service 이름에 대한 cert-manager Certificate와 이를 서명하는 자체 서명 Issuer를 렌더링하므로, cert-manager가 클러스터에서 이미 실행 중이어야 합니다.
  • 설정함. 웹훅은 키가 지정하는 Secret의 인증서를 제공합니다. 이 Secret은 배포하는 사람이 컨트롤러의 네임스페이스에 미리 만들어 두며, tls.crt, tls.key, ca.crt를 담습니다. Certificate와 Issuer는 렌더링되지 않으며 cert-manager도 필요하지 않습니다. 컨트롤러가 시작되면 Secret의 ca.crt를 API 서버가 웹훅을 검증하는 데 사용하는 CA 번들로서 웹훅 구성에 기록합니다.

release-own-certificate.yaml이 이 키를 설정합니다.

components:
ai-controller:
annotations:
aggrega.ai/namespace: envoy-ai-gateway-system
infra:
webhook_tls_secret: ai-gateway-webhook-tls

자체 인증서 모드에서 차트가 렌더링하는 것

키가 설정되면 프로젝트의 차트는 그 이름의 Secret을 컨트롤러의 pod에 /certs 경로로 마운트하며, 동시에 같은 이름으로 자체 Secret도 렌더링합니다. 이 Secret에는 렌더링하는 동안 차트가 생성하는 CA 인증서, 인증서, 개인 키가 들어 있습니다. 두 번의 빌드는 서로 다른 두 키를 생성하므로 출력은 빌드마다 바이트 단위로 동일하지 않게 됩니다. 또한 이 출력을 적용하면 운영자가 만든 Secret이 차트가 생성한 Secret으로 대체됩니다.

차트는 프로젝트의 레지스트리에서 가져와 그대로 사용됩니다. Recipe는 가져온 차트를 편집하지 않습니다. 대신 표준 라이브러리 Recipe가 해당 Secret을 제외합니다:

# helm/envoy-ai-gateway-operator:1.0.0, its omits: field
omits:
- kind: Secret
name: "{{ .infra.webhook_tls_secret }}"
when: '{{ ne (optional .infra "webhook_tls_secret" "") "" }}'
  • kind와 name은 차트가 렌더링하는 그대로 문서를 지정합니다: metadata.name이 Release가 설정한 이름인 Secret입니다. name 템플릿은 차트에 전달되는 것과 같은 infra 키를 읽으므로, Release가 어떤 이름을 붙이든 이 항목은 생성된 Secret을 지정합니다.
  • when은 이 항목이 이 모드에서만 적용되도록 합니다. cert-manager 모드에서는 차트가 그러한 Secret을 렌더링하지 않습니다. 그 모드에서는 조건이 거짓이며, when:이 거짓인 항목은 어떤 검사보다도 먼저 제외됩니다. 하나의 Recipe가 두 모드를 모두 지원합니다.

차트의 나머지 부분은 여전히 전부 렌더링되며, 빌드가 기록하는 내용에서 일치하는 문서만 제외됩니다. 여기서 이를 제외하는 것이 올바른 이유는 컨트롤러의 pod가 마운트하는 Secret이 별도로 생성된 운영자 자신의 것이기 때문입니다. 이 필드는 문서를 제외할 뿐이며, 출력의 나머지 부분이 의존하는 것이 다른 곳에 존재하는지는 검사하지 않습니다.

예제 생성하기

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

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

Terminal window
aggrega scaffold --example ai-gateway-own-webhook-certificate

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

Terminal window
cd ai-gateway-own-webhook-certificate

빌드

Terminal window
aggrega build --release release-cert-manager.yaml --auto-pull
aggrega build --release release-own-certificate.yaml --auto-pull
aggrega build --release release-negative-without-omits.yaml --auto-pull --verify-determinism # halts; exits 1
aggrega build --release release-negative-stale-omits.yaml --auto-pull # halts; exits 1

.aggrega-config.yaml은 두 교육용 Recipes를 담은 워크스페이스 자체의 catalog/를 나열하며, Component와 표준 라이브러리 Recipe는 이 파일이 지정하는 기본 레지스트리인 hub.aggrega.ai에서 해석됩니다. 표준 라이브러리 카탈로그의 체크아웃(얻는 곳)이 있으면 그 aggrega-catalog 디렉터리를 --catalog로 지정하십시오. 그러면 모든 엔터티가 이 두 디렉터리에서 해석됩니다.

--auto-pull은 빌드 중에 각 Release의 lockfile을 채웁니다. lockfile과 렌더링된 출력은 생성되는 것이며 함께 배포되지 않습니다. lockfile을 해석하면 Docker Hub에서 컨트롤러의 차트를 가져오므로, 각 Release의 첫 빌드에는 네트워크가 필요합니다.

AI 어시스턴트 사용

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

Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 워크스페이스 폴더에 아직 `ai-gateway-own-webhook-certificate` 폴더가 없으면 `example`에 `ai-gateway-own-webhook-certificate`를 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `ai-gateway-own-webhook-certificate` 폴더에 쓰입니다. 그런 다음 각 Release마다 한 번씩, `release-cert-manager.yaml`, `release-own-certificate.yaml` 순서로 `build` 도구를 호출하십시오. 매번 `workspace_root`에 `ai-gateway-own-webhook-certificate`, `release`에 해당 파일, `auto_pull`에 true, `write`에 true를 지정합니다. 그런 다음 `aggrega build`를 실행하고 그 `--verify-determinism` 플래그를 받는 `cli-build` 도구를, `workspace_root`에 `ai-gateway-own-webhook-certificate`, `release`에 `release-negative-without-omits.yaml`, `auto_pull`에 true, `verify_determinism`에 true를 지정하여 호출하십시오. 이 빌드는 거부되도록 의도된 것이므로 거부 내용을 읽어 주십시오. 그런 다음 처음 두 빌드와 같은 방식으로 `release`에 `release-negative-stale-omits.yaml`을 지정하여 `build` 도구를 호출하십시오. 이 빌드도 거부되도록 의도된 것이므로 그 거부 내용도 읽어 주십시오. 각 빌드가 어떤 파일을 썼는지 알려 주십시오. 파일은 `ai-gateway-own-webhook-certificate/dist/` 아래에 있습니다.

렌더링된 두 가지 인증서 모드

release-cert-manager.yaml을 --auto-pull로 빌드하면 다음과 같이 출력합니다. 여기서 <workspace>는 이 예제의 폴더를 나타냅니다.

Pull complete: release-cert-manager.lock (entities=5, source_artifacts=1, external_inputs=0)
[… omitted: the total build time, which differs per run]
Build completed: 16 files written to <workspace>/dist

이어서 ls dist/helm은 다음을 나열합니다.

ai-controller
ai-controller-certificate-envoy-ai-gateway-system-self-signed-cert-for-mutating-webhook.yaml
ai-controller-clusterrole-ai-controller-envoy-ai-gateway-system.yaml
ai-controller-clusterrole-envoy-ai-gateway-inference-pool-reader-envoy-ai-gateway-system.yaml
ai-controller-clusterrolebinding-ai-controller-envoy-ai-gateway-system.yaml
ai-controller-clusterrolebinding-envoy-ai-gateway-inference-pool-reader-binding-envoy-ai-gateway-system.yaml
ai-controller-deployment-envoy-ai-gateway-system-ai-controller.yaml
ai-controller-issuer-envoy-ai-gateway-system-self-signed-issuer-for-mutating-webhook.yaml
ai-controller-mutatingwebhookconfiguration-envoy-ai-gateway-gateway-pod-mutator-envoy-ai-gateway-system.yaml
ai-controller-service-envoy-ai-gateway-system-ai-controller.yaml
ai-controller-serviceaccount-envoy-ai-gateway-system-ai-controller.yaml

ai-controller 디렉터리에는 Recipe가 차트와 함께 내보내는 AI Gateway 리소스 정의 여섯 개가 들어 있습니다. release-own-certificate.yaml을 같은 방식으로 빌드하면 다음과 같이 출력합니다.

Pull complete: release-own-certificate.lock (entities=5, source_artifacts=1, external_inputs=0)
[… omitted: the total build time, which differs per run]
Build completed: 14 files written to <workspace>/dist

그리고 ls dist/helm은 다음을 나열합니다.

ai-controller
ai-controller-clusterrole-ai-controller-envoy-ai-gateway-system.yaml
ai-controller-clusterrole-envoy-ai-gateway-inference-pool-reader-envoy-ai-gateway-system.yaml
ai-controller-clusterrolebinding-ai-controller-envoy-ai-gateway-system.yaml
ai-controller-clusterrolebinding-envoy-ai-gateway-inference-pool-reader-binding-envoy-ai-gateway-system.yaml
ai-controller-deployment-envoy-ai-gateway-system-ai-controller.yaml
ai-controller-mutatingwebhookconfiguration-envoy-ai-gateway-gateway-pod-mutator-envoy-ai-gateway-system.yaml
ai-controller-service-envoy-ai-gateway-system-ai-controller.yaml
ai-controller-serviceaccount-envoy-ai-gateway-system-ai-controller.yaml

cert-manager 모드의 트리에는 Certificate와 Issuer가 있고 Secret은 없습니다. 자체 인증서 모드의 트리에는 셋 중 어느 것도 없습니다. 차트가 그 모드에서 둘 다 렌더링하지 않으므로 Certificate와 Issuer가 없고, 차트가 렌더링한 하나를 Recipe의 항목이 제외했으므로 Secret도 없습니다. 대신 컨트롤러가 마운트하는 것은 Release가 지정한 Secret입니다.

dist/helm/ai-controller-deployment-envoy-ai-gateway-system-ai-controller.yaml
[… omitted: the chart's licence header, four comment lines]
apiVersion: apps/v1
kind: Deployment
metadata:
name: ai-controller
namespace: envoy-ai-gateway-system
[… omitted: the labels and annotations every rendered document carries]
spec:
[… omitted: the replica count, the selector, and the pod template's labels, service account, host-network setting and security settings]
containers:
- name: ai-gateway-helm
[… omitted: the container's security settings, its image and pull policy, and its ports]
args:
[… omitted: the controller's logging, external-processor, gateway-namespace and endpoint arguments]
- --tlsCertDir=/certs
- --tlsCertName=tls.crt
- --tlsKeyName=tls.key
[… omitted: the controller's webhook-port, leader-election, prefix, cache, namespace, quota and session-encryption arguments]
[… omitted: the probes, the environment and the resources]
volumeMounts:
- mountPath: /certs
name: certs
readOnly: true
volumes:
- name: certs
secret:
secretName: ai-gateway-webhook-tls

컨트롤러는 certs 볼륨인 /certs에서 인증서를 읽으며, 이 볼륨은 Secret ai-gateway-webhook-tls입니다. 이 이름은 빌드가 쓰인 그대로 전달하고 클러스터가 파드가 시작될 때 확인합니다.

빌드마다 동일한 바이트

--verify-determinism으로 한 번 더 빌드하면 release-own-certificate.yaml은 다음을 출력합니다:

[… omitted: the total build time, which differs per run]
Build completed: 14 files written to <workspace>/dist

--verify-determinism은 모든 component를 같은 입력으로 두 번 렌더링하고, 두 렌더링 결과가 다르면 중단합니다. 여기서는 통과하며, 이 빌드가 작성하는 트리는 첫 번째 빌드가 작성한 트리와 바이트 단위로 동일합니다. 두 가지가 모두 성립하는 것은 차트가 매번 새로 생성하는 유일한 문서가 출력에 도달하지 않기 때문입니다.

항목이 없으면: 결정성을 검사하는 빌드가 중단됩니다

release-negative-without-omits.yaml은 omits: 항목이 없는 교육용 Recipe를 바인딩하는 manifest-without-omits.yaml을 통해 배포되는 자체 인증서 Release입니다. --verify-determinism으로 빌드하면 다음과 같습니다:

[… omitted: the pull's lines]
[TRANSLATION_ERROR E0058] instance ai-controller
rendering node "ai-controller"
caused by: wasmengine: node "ai-controller" (provider "helm"): two renders of identical input produced different output: provider render is not deterministic

빌드는 1로 종료됩니다. 차트가 매번 다른 키와 인증서를 생성했기 때문에 컨트롤러의 두 렌더링 결과가 다릅니다. pull도 고정해야 할 외부 입력을 찾기 위해 Release를 렌더링하며, 그곳에서도 같은 중단을 만납니다. 생략된 pull 줄에 같은 문장이 한 번 더 나오는 이유가 이것입니다. lockfile은 그래도 기록됩니다.

플래그 없이 빌드하면 같은 Release가 완료됩니다. 그 트리에는 자체 인증서 Release의 트리가 담는 차트 문서들이 — 교육용 Recipe가 내보내지 않는 리소스 정의는 제외하고 — 들어 있고, 차트가 생성한 Secret 하나가 더 들어 있습니다:

dist/helm/ai-controller-secret-envoy-ai-gateway-system-ai-gateway-webhook-tls.yaml
apiVersion: v1
kind: Secret
metadata:
name: ai-gateway-webhook-tls
namespace: envoy-ai-gateway-system
[… omitted: the labels and annotations every rendered document carries]
data:
[… omitted: the three base64-encoded entries ca.crt, tls.crt and tls.key]

두 번 빌드하면 두 트리는 정확히 이 세 값에서 다릅니다. 일반 빌드는 각 component를 한 번만 렌더링하므로, 생성된 키를 그대로 기록하고 차이를 알아차리지 못합니다. 그 차이를 드러내는 것이 바로 이 검사입니다. 이 파일을 적용하면 운영자가 만든 Secret을 대체하게 됩니다.

이 중단은 A provider rendered the same input twice and produced different output (provider가 같은 입력을 두 번 렌더링하여 다른 출력을 생성했습니다)에 설명되어 있으며, 그 해결 방법은 차이가 소스로 가져온 차트가 생성하는 값일 때의 두 가지 방법을 제시합니다. 차트가 제공하는 설정을 통해 값을 공급하거나, 생성된 문서가 Release가 배포해서는 안 되는 문서라면 omits: 항목으로 제외하는 것입니다. 표준 라이브러리 Recipe가 택하는 방법은 후자입니다.

아무것도 일치하지 않는 항목

release-negative-stale-omits.yaml는 manifest-stale-omits.yaml를 통해 배포되는 자체 인증서 Release이며, 이 매니페스트는 키가 아니라 컨트롤러의 렌더링된 이름을 따라 Secret의 이름을 지정하는 항목을 가진 교육용 Recipe를 바인딩합니다:

# catalog/recipe/helm/envoy-ai-gateway-operator-stale-omits/1.0.0/recipe.yaml, its omits: field
omits:
- kind: Secret
name: "{{ .context.rendered_name }}-webhook-tls"
when: '{{ ne (optional .infra "webhook_tls_secret" "") "" }}'

빌드 결과:

[… omitted: the pull's lines]
[TRANSLATION_ERROR E0334] instance ai-controller
rendering node "ai-controller"
caused by: [CATALOG_ERROR] instance ai-controller
an omits entry left out nothing the source rendered (node "ai-controller", provider "provider/helm:0.8.8-75-g9e6ef4e0", "envoy-ai-gateway-operator-stale-omits" omits[0], kind "Secret", name "ai-controller-webhook-tls"). correct the entry so it names something the source renders, or remove it; a source upgrade that renamed or removed it is the usual cause

프로바이더 이름에는 빌드를 실행한 바이너리의 버전이 붙으므로, 직접 실행하면 그 자리에 사용하는 바이너리의 버전이 표시됩니다.

빌드는 1로 종료되며, 풀(pull)의 줄들은 위와 같은 이유로 같은 문장을 담고 있습니다. 메시지는 왼쪽에서 오른쪽으로 살펴볼 위치를 순서대로 알려 줍니다. 컴포넌트, 그것을 렌더링한 프로바이더, 항목을 선언한 Recipe와 0부터 센 omits: 목록 안의 항목 위치, 그리고 항목이 해석된 kind와 이름입니다. 이 모드에서는 when: 조건이 참이므로 항목이 적용됩니다. 항목의 이름은 ai-controller-webhook-tls로 렌더링되었지만 차트는 Secret의 이름을 ai-gateway-webhook-tls로 지정했으므로, 항목은 아무것도 제외하지 않았습니다.

적용되는 모든 항목은 무언가를 제외해야 하며, 그렇지 않은 항목이 있으면 빌드가 중단됩니다. 아무것도 일치하지 않는 항목은 소스에 대해 더 이상 참이 아닌 진술이기 때문입니다. 흔한 원인은 문서의 이름을 바꾼 소스 업그레이드입니다. 그러면 이름이 바뀐 문서가 새 이름으로 출력에 포함되며 — 바로 그 항목이 제외하려고 작성된 문서입니다 — 중단은 그 문서가 아무도 모르게 배포되는 것을 막아 줍니다. 이 빌드에서는 차트가 생성한 Secret이 바로 그런 문서입니다. 항목은 그것을 제외하려고 작성되었지만 다른 것을 지정합니다. 항목을 수정하려면 소스가 지금 렌더링하는 내용과 비교하십시오. release-negative-without-omits.yaml가 검사 없이 하는 것처럼 항목을 제거한 채 빌드하고, 차트가 작성한 파일에서 이름을 읽으면 됩니다.

E0334는 진단 참조에 omit-matched-nothing으로 등재되어 있으며, An omits entry left out nothing the source rendered (omits 항목이 소스가 렌더링한 것을 아무것도 제외하지 않았습니다)에 설명되어 있습니다. 필드 자체 — 모든 항목 필드, 템플릿 컨텍스트, Release가 항목에 대해 결정할 수 있는 것, 그리고 이를 지원하는 프로바이더 — 는 Recipe → omits: 필드에서 다룹니다.

모든 빌드 검사하기

이 자체 점검은 사용하는 공유 빌드 헬퍼가 들어 있는 문서 저장소의 체크아웃에서 실행됩니다. aggrega scaffold --example로 작성된 사본에는 그 헬퍼가 없습니다.

Terminal window
./check.sh

check.sh는 ./build-release.sh를 통해 네 개의 Releases를 빌드하고 각 결과를 이 페이지가 설명하는 결과와 대조합니다. 통과하는 각 Release는 두 번 빌드하며, 두 번째에는 --verify-determinism을 사용합니다. 두 빌드 모두 0으로 종료하고 바이트 단위로 동일한 파일을 써야 하며, 렌더링된 모든 문서의 kind로 셀 때 트리는 cert-manager 모드에서는 Certificate 하나와 Issuer 하나를 담고 Secret은 담지 않아야 하고, 자체 인증서 모드에서는 세 가지 중 어느 것도 담지 않아야 하며, 컨트롤러 Deployment의 certs 볼륨이 ai-gateway-webhook-tls를 지정해야 합니다. 가드레일 Release는 0이 아닌 값으로 종료해야 하며, 이 페이지가 해당 Release에 대해 보여 주는 짧은 코드와 문장을 담은 중단이 정확히 하나여야 하고, 오래된 항목의 중단은 그 항목을 지정해야 합니다. Release마다 한 줄을 출력하며, 어떤 결과라도 다르면 해당 빌드의 출력을 표시하고 1로 종료합니다.

RELEASE EXIT EXPECTED VERDICT
------------------------------------------------------------------------------------------------
release-cert-manager.yaml 0/0 pass OK: byte-identical twice; Certificate=1 Issuer=1 Secret=0
release-own-certificate.yaml 0/0 pass OK: byte-identical twice; Certificate=0 Issuer=0 Secret=0; certs volume: ai-gateway-webhook-tls
release-negative-without-omits.yaml 1 halt OK: E0058, the expected sentence
release-negative-stale-omits.yaml 1 halt OK: E0334, the expected sentence, naming "envoy-ai-gateway-operator-stale-omits" omits[0]
check: every build ended as expected.

단일 빌드에 필요한 것이 그대로 필요합니다. 즉 표준 라이브러리 카탈로그와 차트를 받기 위한 네트워크입니다. ./build-release.sh가 결정하는 바이너리를 사용하므로 AGGREGA_BIN으로 바이너리를 선택할 수 있으며, -- 뒤의 인수는 모든 빌드에 전달됩니다. 빌드가 쓰는 트리를 비교하기 때문에 이 디렉터리에 dist/가 있으면 시작을 거부하며, 실행 후에는 아무것도 남기지 않습니다. 종료 상태가 곧 전체 판정이므로, 파이프라인은 각 Release를 개별적으로 빌드하는 대신 이 스크립트를 실행할 수 있습니다.

컴파일러가 해석하지 않는 부분

컴파일러는 Secret이 무엇인지, 컨트롤러가 그것으로 무엇을 하는지, 차트가 왜 그것을 생성하는지 알지 못합니다. 컴파일러는 다른 Recipe 템플릿을 평가하듯이 항목의 템플릿을 평가하고, 그 템플릿이 해석되는 kind와 이름을 컴포넌트의 입력과 함께 helm 프로바이더에 넘기며, 프로바이더는 일치하는 렌더링된 문서를 제외하고 각 항목이 몇 개를 제외했는지 보고합니다. 컴파일러는 클러스터에서 ai-gateway-webhook-tls를 찾지 않고, 생성하지도 않으며, 컨트롤러가 읽는 세 항목을 담고 있는지 확인하지도 않습니다. 이 이름은 Release가 제공하는 문자열로, 차트의 values와 항목에 전달될 뿐입니다. 컨트롤러가 시작되기 전에 Secret이 존재하도록 하는 것은 배포하는 쪽이 준비할 일입니다.

파일

  • aggregate.yaml — AI 게이트웨이 컨트롤러, 즉 하나뿐인 컴포넌트이며, 모든 Release에서 동일합니다.
  • manifest.yaml — 컨트롤러를 표준 라이브러리 Recipe에 바인딩하며, 통과하는 두 Releases가 공유합니다.
  • manifest-without-omits.yaml, manifest-stale-omits.yaml — 컨트롤러를 두 교육용 Recipes 중 하나에 바인딩합니다.
  • release-cert-manager.yaml, release-own-certificate.yaml — 두 가지 인증서 모드입니다.
  • release-negative-without-omits.yaml, release-negative-stale-omits.yaml — 각 교육용 Recipe를 통한 자체 인증서 모드이며, 둘 다 중단됩니다.
  • catalog/recipe/helm/envoy-ai-gateway-operator-without-omits/1.0.0/ — omits: 항목이 없는 교육용 Recipe와, 그 차트를 고정하는 entity.lock입니다.
  • catalog/recipe/helm/envoy-ai-gateway-operator-stale-omits/1.0.0/ — 항목이 아무것과도 일치하지 않는 교육용 Recipe와 그 entity.lock입니다.
  • .aggrega-config.yaml — 카탈로그 검색 스택과 레지스트리입니다.
  • build-release.sh — Release 하나를 빌드하며, 이에 해당하는 aggrega build 명령을 출력합니다.
  • check.sh — 네 가지를 모두 빌드하고 각 결과를 확인합니다.