Workload 라이브러리 가져오기 — `$import`를 통한 공유 Workload 본문
Recipe가 인라인 본문 대신 공유 라이브러리 항목에서 Kubernetes Workload를 합성하는 단일 무상태 웹 서비스입니다. 이는 Recipe에서 spec.workload를 작성하는
세 번째 방식입니다:
- 방식 1(인라인): Recipe에 직접 작성한 Go 템플릿 Workload.
- 방식 2(파일 가져오기):
$import: ./relative/path.yaml— 로컬 파일. - 방식 3(라이브러리 가져오기):
$import: <Library>#/workloads/<Entry>— 순수 이름 식별로 참조하는WorkloadLibrary항목.
여기서 web-service Recipe는 방식 3을 사용합니다:
spec: capability: helm implements: example/compute/web-service workload: $import: BaseWorkloads#/workloads/StatelessService참조는 라이브러리 이름부터 프래그먼트까지 공백이나 줄바꿈이 전혀 없는 하나의 연속된 토큰으로 작성합니다. 공백이 포함된 참조는 잘라내지 않고 거부되며, 빌드가 중단됩니다 —
errors/fatal-halts.md의 “A reference to a library
entry carries whitespace(라이브러리 항목에 대한 참조에 공백이 포함됨)”를 참조하십시오.
BaseWorkloads는 hub 카탈로그(workloadlibrary/base-workloads)에 게시된 WorkloadLibrary입니다. 그 StatelessService 항목은 이 Recipe의 렌더 컨텍스트에서 평가되는 Go 템플릿이므로, .values.image(Component/Aggregate에서 제공)와 .infra.*(replicas, port, compute — Release에서 제공)가 인라인 본문과 똑같이 전달됩니다. Workload를 라이브러리로 분리해도 배포되는 내용은 전혀 달라지지 않습니다. 렌더링된 출력은 동등한 인라인 Workload와 바이트 단위로 동일합니다.
라이브러리의 버전은 Release별 lockfile이 제공하며, 참조에는 레지스트리 호스트가 나타나지 않습니다. aggrega pull 시 BaseWorkloads는 lockfile의 workload_libraries 섹션에 고정되고, aggrega build 시 고정된 라이브러리가 해석되어 그 항목이 렌더링됩니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example workload-library-import그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd workload-library-import빌드
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yaml카탈로그는 .aggrega-config.yaml에 지정된 hub 레지스트리(BaseWorkloads와 helm provider를 제공)와 이 예제의 로컬 catalog/(web-service Component와 Recipe)에서 해석됩니다. Manifests는 dist/app/helm/ 아래에 생성됩니다 — 경계의 directory: 뒤에 provider capability가 붙은 경로입니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고, 폴더를 직접 만들지 마십시오. 작업 영역 폴더에 아직 `workload-library-import` 폴더가 없으면 `example`을 `workload-library-import` 값으로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `workload-library-import` 폴더에 예제가 작성됩니다. 그런 다음 `workspace_root`를 `workload-library-import` 값으로, `release`를 `release.yaml` 값으로, `auto_pull`을 true로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `workload-library-import/dist/` 아래에 있습니다.바이트 동일성 주장 검증
Recipe의 workload: { $import: … }를 StatelessService 본문을 그대로 담은 workload: | 블록으로 바꾸고, 다시 빌드한 뒤 두 dist/ 트리를 diff합니다. 두 트리는 정확히 일치합니다. 라이브러리 참조는 같은 템플릿 텍스트로 해석되어 같은 렌더 컨텍스트에서 평가되므로, 가져오기는 작성 표면을 분리하는 것일 뿐 렌더링된 바이트에는 영향을 주지 않습니다.