Aggrega Workload 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 ID: https://aggrega.ai/schemas/workload-v1beta1.schema.json
플랫폼이 소유하는 추상 워크로드 명세입니다. synthesized 모드를 사용하는 Recipe는 workload: 키워드(인라인 블록 스칼라 또는 통합 파일 가져오기 어휘에 따른 workload: { $import:
Workload 엔티티 작성에 대한 설명은 Workload 작성 레퍼런스를 참조하십시오. 이 페이지는 해당 레퍼런스가 설명하는 구조적 스키마를 문서화합니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 예 | 상수: "aggrega.ai/v1beta1" |
kind | const “Workload” | 예 | 상수: "Workload" |
form | string (enum) | 아니요 | 워크로드의 추상적인 컨트롤러 형태 의도입니다. 대상 플랫폼과 무관하게 워크로드가 갖는 런타임 수명 주기의 종류를 선택합니다: stateless(서로 교체 가능한 장기 실행 레플리카), stateful(레플리카별 고정 ID와 레플리카별 스토리지를 갖는 레플리카), daemon(적격 호스트마다 하나의 인스턴스), scheduled(시간에 따라 반복 실행), task(완료될 때까지 한 번 실행), reference(컴퓨트가 없는 외부 엔드포인트 — 컨트롤러 없음; helm은 ExternalName Service를 생성하고, compose는 주입 계약을 통해 엔드포인트를 전달합니다). 비어 있으면 stateless로 취급합니다. 각 대상 provider는 이 form을 자체 네이티브 형태로 매핑하며, form 자체에는 플랫폼 네이티브 리소스 종류가 들어 있지 않습니다. persistentTemplate 볼륨은 stateful에 딸린 것으로, stateful 워크로드에서만 유효합니다. reference 워크로드는 endpoint(및 선택적으로 port)를 선언하고 컨테이너는 선언하지 않으며, 환경 변수 이름은 엔드포인트가 아니라 소비자에 속하므로 자체 자격 증명 필드를 갖지 않습니다. 엔드포인트에 대한 자격 증명이 필요한 소비자는 자신의 Component의 featuresSchema에 슬롯을 선언하고, 해당 슬롯의 inject 목록이 전달을 허용하는 경우 자신의 컨테이너의 attachments 블록에서 그 슬롯을 채웁니다. 허용 값: "stateless", "stateful", "daemon", "scheduled", "task", "reference" 기본값: "stateless" |
endpoint | string | 아니요 | form: reference의 외부 엔드포인트로, 호스트 또는 URL입니다. 컴파일러는 이를 결정적인 포인터 문자열로 그대로 전달하며, 컴파일 타임(AOT)에 해석하지 않습니다. form이 reference일 때 필수이며 그때만 의미가 있습니다. helm은 이를 ExternalName Service의 externalName(호스트 부분)으로 생성하고, compose는 recipe의 provides를 통해 소비자에게 전달합니다. |
port | integer | 아니요 | reference 엔드포인트(form: reference)의 선택적 포트입니다. helm은 이를 ExternalName Service의 포트로 생성합니다. 최솟값: 1. 최댓값: 65535. |
schedule | string | 아니요 | form: scheduled의 cron 일정으로, 표준 5필드 crontab 표현식(예: ‘0 0 * * *’) 또는 매크로 @hourly, @daily, @weekly, @monthly, @yearly 중 하나입니다. form이 scheduled일 때 필수이며 그때만 의미가 있습니다. 대상 provider는 이를 그대로 예약 리소스의 schedule 필드에 전달합니다. |
suspend | 불리언 | 아니요 | form: scheduled 워크로드의 반복 일정을 보류합니다. true이면 예약된 리소스가 일정을 그대로 둔 채 렌더링되지만, 재개될 때까지 그 일정으로 실행이 시작되지 않습니다. 리소스에서 수동으로 실행을 만드는 것은 여전히 가능합니다. Kubernetes에서는 kubectl create job false |
replicas | integer | 아니요 | 레플리카 수입니다. 기본값은 1입니다. compose 대상에서는 이 값이 출력의 어느 부분에도 반영되지 않으며, 명시적인 1을 포함해 작성될 때마다 경고가 이를 보고합니다. 최솟값: 0. 기본값: 1 |
initContainers | container[] | 아니요 | 메인 컨테이너가 시작되기 전에 완료될 때까지 실행되는 컨테이너의 순서 있는 목록입니다. |
containers | container의 맵 | 아니요 | 컨테이너 이름 → 컨테이너 명세의 순서 있는 맵입니다. 항목이 하나 이상 필요합니다. 작성 순서가 보존됩니다. 최소 1개 항목. |
volumes | volume의 맵 | 아니요 | 볼륨 이름 → 볼륨 명세의 순서 있는 맵입니다. 각 볼륨 명세는 ephemeral, configmap, secret, persistent, persistentTemplate 중 정확히 하나를 선언합니다. |
services | service의 맵 | 아니요 | 서비스 이름 → 서비스 명세의 순서 있는 맵입니다. helm에서는 각 항목이 별도의 K8s Service가 되며, type이 Loopback인 항목은 빌드를 중단시킵니다. compose에는 별도의 서비스 기본 요소가 없으므로 항목이 일대일로 매핑되지 않습니다: type이 NodePort 또는 LoadBalancer인 항목은 워크로드 자체 compose 서비스의 모든 호스트 인터페이스에 포트를 게시하고, type이 Loopback인 항목은 그곳에서 호스트의 루프백 주소에만 포트를 게시하며, type이 ClusterIP 또는 Headless인 항목은 아무것도 게시하지 않습니다. 게시된 모든 포트는 호스트 포트가 컨테이너 포트와 일치하는 상태로 그 하나의 서비스 포트 목록에 모입니다. helm에서 각 Service의 이름은 <name>-<key>입니다. 워크로드 자체의 Deployment(또는 다른 컨트롤러)가 가진 이름 뒤에 하이픈과 항목의 키가 붙으므로, services.http를 선언하고 Deployment 이름이 api-server인 Workload는 api-server-http라는 이름의 Service를 렌더링합니다. compose에서는 키가 출력의 어떤 것에도 이름을 붙이지 않습니다. |
scheduling | object | 아니요 | K8s 네이티브 스케줄링 제약 조건입니다. helm에서는 직접 변환됩니다. compose 대상에서는 이 제약 조건이 출력의 어느 부분에도 반영되지 않으며, 블록이 작성되면 경고가 이를 보고합니다. |
podSecurityContext | object | 아니요 | |
serviceAccount | string | 아니요 | 이 워크로드가 실행되는 ServiceAccount의 이름입니다. 실제 RBAC(ServiceAccount/Role/RoleBinding 리소스)는 이 필드가 아니라 Features나 아티팩트를 통해 생성해야 합니다. |
imagePullSecrets | string[] | 아니요 | 프라이빗 레지스트리에서 이미지를 가져오기 위한 image-pull Secret의 이름입니다. helm은 pod.imagePullSecrets를 생성합니다. compose에는 파일 내 대응 요소가 없으며(레지스트리 인증은 docker login을 통해 별도로 구성됨) 이를 생략합니다. |
priorityClassName | string | 아니요 | 이 워크로드의 스케줄링 우선순위를 결정하는 PriorityClass의 이름입니다. helm은 pod.priorityClassName을 생성합니다. compose에는 단일 호스트 스케줄링 우선순위에 대응하는 요소가 없어 이를 생략합니다. |
runtimeClassName | string | 아니요 | 이 워크로드가 실행되는 컨테이너 런타임을 선택하는 RuntimeClass의 이름입니다(예: ‘nvidia’와 같은 GPU 지원 런타임). 컴파일러는 이름을 그대로 전달하며, 클러스터가 스케줄 시점에 이를 구성된 RuntimeClass로 해석합니다. helm은 pod.runtimeClassName을 생성합니다. compose에는 런타임 클래스에 대응하는 요소가 없어 이를 생략합니다. 컴퓨트 전용: reference 워크로드에서는 허용되지 않습니다. |
terminationGracePeriodSeconds | integer | 아니요 | 종료 시 SIGTERM과 SIGKILL 사이의 초 수입니다. helm은 pod.terminationGracePeriodSeconds를, compose는 stop_grace_period를 생성합니다. 최솟값: 0. |
dnsPolicy | string (enum) | 아니요 | 파드 DNS 정책입니다. helm은 pod.dnsPolicy를 생성합니다. compose에는 DNS 정책에 대응하는 요소가 없어 이를 생략합니다(대신 compose는 dnsConfig의 nameservers/searches를 직접 매핑합니다). 허용 값: "Default", "ClusterFirst", "ClusterFirstWithHostNet", "None" |
dnsConfig | object | 아니요 | 사용자 지정 파드 DNS 구성입니다. helm은 pod.dnsConfig를 생성합니다. compose는 nameservers를 dns로, searches를 dns_search로 매핑하며, options는 compose에 대응하는 요소가 없어 그곳에서는 생략됩니다. |
hostAliases | object[] | 아니요 | 파드의 hosts 파일에 주입되는 정적 호스트 이름-IP 매핑입니다. helm은 pod.hostAliases를, compose는 extra_hosts(호스트 이름마다 hostname:ip 항목 하나)를 생성합니다. |
hostNetwork | 불리언 | 아니요 | 워크로드를 격리된 네트워크 네임스페이스가 아니라 호스트 노드 자체의 네트워크 네임스페이스에서 실행합니다. 그러면 워크로드가 여는 포트는 노드 자체 주소에서 접근할 수 있고, 워크로드는 노드의 네트워크 인터페이스를 보게 됩니다. 이 설정은 네트워크 네임스페이스만 선택할 뿐 그 외에는 아무것도 하지 않습니다: 포트를 선언하지 않으며, 워크로드가 여는 모든 포트는 여전히 containers. |
추가 속성은 허용되지 않습니다.
workload.scheduling
K8s 네이티브 스케줄링 제약 조건입니다. helm에서는 직접 변환됩니다. compose 대상에서는 이 제약 조건이 출력의 어느 부분에도 반영되지 않으며, 블록이 작성되면 경고가 이를 보고합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
nodeSelector | string 맵 | 아니요 | |
affinity | object | 아니요 | |
tolerations | object[] | 아니요 | |
topologySpreadConstraints | object[] | 아니요 |
추가 속성은 허용되지 않습니다.
workload.podSecurityContext
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
runAsUser | integer | 아니요 | |
runAsGroup | integer | 아니요 | |
fsGroup | integer | 아니요 | |
supplementalGroups | integer[] | 아니요 |
추가 속성은 허용되지 않습니다.
workload.dnsConfig
사용자 지정 파드 DNS 구성입니다. helm은 pod.dnsConfig를 생성합니다. compose는 nameservers를 dns로, searches를 dns_search로 매핑하며, options는 compose에 대응하는 요소가 없어 그곳에서는 생략됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
nameservers | string[] | 아니요 | |
searches | string[] | 아니요 | |
options | object[] | 아니요 |
추가 속성은 허용되지 않습니다.
workload.hostAliases[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
ip | string | 예 | |
hostnames | string[] | 예 |
추가 속성은 허용되지 않습니다.
정의
container
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 아니요 | 선택적 컨테이너 이름입니다. 위치 기반 initContainers 항목에서는 출력되는 컨테이너 이름을 설정하며, 생략하면 생성된 init- |
image | string | 예 | 컨테이너 이미지 참조입니다(예: ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’). |
imagePullPolicy | string (enum) | 아니요 | 이미지 풀 정책입니다. helm은 이를 container.imagePullPolicy로 출력합니다. compose는 이를 서비스의 pull_policy로 매핑합니다(Always는 always로, Never는 never로, IfNotPresent는 if_not_present로). 허용 값: "Always", "Never", "IfNotPresent" |
command | string[] | 아니요 | 이미지의 entrypoint를 재정의합니다. K8s: .command. Compose: entrypoint. |
args | string[] | 아니요 | command(command가 없으면 이미지 entrypoint)에 전달되는 인수입니다. K8s: .args. Compose: command. |
variables | string 맵 | 아니요 | 문자열 키-값 쌍으로 된 환경 변수입니다. K8s: spec.template.spec.containers[].env[]. Compose: services. |
attachments | containerAttachment의 맵 | 아니요 | env 또는 파일 이름 → { from, as, key?, path?, connection? }의 순서 있는 맵입니다. 각 항목은 Component의 featuresSchema에 선언된 슬롯을 참조하거나, 항목이 connection을 지정하면 해당 connection의 소켓이 선언하는 슬롯을 참조하며, 그 슬롯을 채우는 attachment가 게시한 내용을 전달합니다. ‘as’ 필드는 전달 방식을 선택하며, 이 방식은 슬롯의 inject: 배열에 허용 목록으로 등록되어 있어야 합니다. 블랙박스 슬롯(inject: [])은 여기에 나타날 수 없습니다. |
envFrom | object[] | 아니요 | ConfigMap 또는 Secret 소스에서 가져오는 일괄 환경입니다. helm은 container.envFrom(configMapRef/secretRef)을 출력합니다. compose에는 객체에서 env를 가져오는 프리미티브가 없습니다. 소스 참조는 호스트 파일이 아니므로 env_file로 재해석하면 의미가 조용히 바뀌게 됩니다. 따라서 envFrom을 선언한 워크로드는 compose 대상에서 명시적으로 중단됩니다. |
ports | integer 또는 object의 맵 | 아니요 | 이름이 지정된 컨테이너 포트입니다. 포트는 포트 번호만으로(web: 8080) 작성하거나, 번호와 함께 포트가 전달하는 전송 프로토콜을 담은 객체로(dns: { port: 53, protocol: UDP }) 작성합니다. 프로토콜을 선언하지 않으면 두 형식은 같은 의미입니다. 허용되는 프로토콜 값은 TCP, UDP, SCTP이며, 키를 생략하면 대상 자체의 기본값이 적용됩니다. 포트 이름은 services.*.ports와 http 프로브의 포트 해석에서 참조되며, 서비스 포트는 이름이 해석되는 컨테이너 포트의 전송 방식을 따르므로 전송 방식은 한 번만 선언됩니다. K8s: containerPort이며, 프로토콜이 선언된 경우에만 protocol을 포함합니다. Compose: 컨테이너 포트는 서비스 명세가 게시하는 경우에만 출력에 반영됩니다. 컨테이너 포트 자체에는 별도의 compose 필드가 없으며, 게시된 포트는 선언된 전송 방식을 게시 항목의 /protocol 접미사로 포함합니다. compose가 표기할 수 없는 전송 방식은 다른 전송 방식을 전달하는 포트를 게시하는 대신 빌드를 중단시킵니다. |
resources | object | 아니요 | |
health | object | 아니요 | 컨테이너의 상태 프로브(ready, live, startup)이며, 각각 http, tcp 또는 exec로 선언됩니다. helm에서는 K8s httpGet/tcpSocket/exec로 변환됩니다. compose에서는 서비스가 하나의 healthcheck만 가지므로 http와 tcp는 CMD-SHELL 테스트가 되고 exec는 CMD 테스트가 되며, 둘 이상의 프로브가 선언되면 하나만 유지됩니다. 이때 경고가 변환된 프로브와 제외된 프로브의 이름을 알려 줍니다. |
volumeMounts | object[] | 아니요 | |
restartPolicy | string (enum) | 아니요 | 허용 값: "Always", "OnFailure", "Never" |
lifecycle | object | 아니요 | 컨테이너 라이프사이클 훅입니다. helm에서는 K8s container.lifecycle(postStart/preStop)로 변환됩니다. compose에는 라이프사이클 훅 프리미티브가 없으므로, lifecycle을 선언한 워크로드는 compose 대상에서 훅을 조용히 제외하는 대신 명시적으로 중단됩니다. |
securityContext | object | 아니요 |
추가 속성은 허용되지 않습니다.
container.envFrom[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
configMap | string | 아니요 | 이 Recipe의 artifacts 입력 또는 연결된 Feature가 출력하는 ConfigMap 소스의 이름입니다. |
secret | string | 아니요 | featuresSchema 슬롯의 이름입니다. Component 자체의 슬롯이거나, connection이 설정된 경우 해당 connection의 소켓이 선언하는 슬롯입니다. 가져오는 Secret의 이름은 슬롯의 provides에서 해석됩니다. |
connection | string | 아니요 | 컴포넌트가 사용하는 connection의 별칭으로, Aggregate 또는 Release에서 컴포넌트의 uses 블록에 작성된 이름입니다. 설정하면 secret은 해당 connection이 연결된 소켓이 선언하는 슬롯을 지정하며, 가져오는 Secret은 그 connection이 전달하는 attachment가 해당 슬롯에 게시한 Secret입니다. 따라서 여러 대상에 접근하는 컴포넌트는 각 대상의 고유한 Secret을 가져옵니다. secret과 함께 있을 때만 의미가 있습니다. 컴포넌트가 사용하지 않는 connection이나 소켓이 선언하지 않는 슬롯은 둘 모두의 이름을 밝히며 거부됩니다. |
prefix | string | 아니요 | 가져오는 모든 환경 변수 이름 앞에 붙는 선택적 접두사입니다. |
추가 속성은 허용되지 않습니다.
container.resources
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
requests | resourceList | 아니요 | |
limits | resourceList | 아니요 |
추가 속성은 허용되지 않습니다.
container.health
컨테이너의 상태 프로브(ready, live, startup)이며, 각각 http, tcp 또는 exec로 선언됩니다. helm에서는 K8s httpGet/tcpSocket/exec로 변환됩니다. compose에서는 서비스가 하나의 healthcheck만 가지므로 http와 tcp는 CMD-SHELL 테스트가 되고 exec는 CMD 테스트가 되며, 둘 이상의 프로브가 선언되면 하나만 유지됩니다. 이때 경고가 변환된 프로브와 제외된 프로브의 이름을 알려 줍니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
ready | probe | 아니요 | |
live | probe | 아니요 | |
startup | probe | 아니요 |
추가 속성은 허용되지 않습니다.
container.volumeMounts[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 최상위 volumes: 맵의 키와 일치해야 합니다. |
path | string | 예 | 컨테이너 내부의 마운트 지점입니다. |
subPath | string | 아니요 | 대상 디렉터리의 다른 파일을 가리지 않고, 볼륨의 단일 파일이나 하위 디렉터리를 path에 마운트합니다. |
readonly | 불리언 | 아니요 | 기본값: false |
추가 속성은 허용되지 않습니다.
container.lifecycle
컨테이너 라이프사이클 훅입니다. helm에서는 K8s container.lifecycle(postStart/preStop)로 변환됩니다. compose에는 라이프사이클 훅 프리미티브가 없으므로, lifecycle을 선언한 워크로드는 compose 대상에서 훅을 조용히 제외하는 대신 명시적으로 중단됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
postStart | lifecycleHook | 아니요 | |
preStop | lifecycleHook | 아니요 |
추가 속성은 허용되지 않습니다.
container.securityContext
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
runAsUser | integer | 아니요 | |
runAsGroup | integer | 아니요 | |
runAsNonRoot | 불리언 | 아니요 | |
readOnlyRootFilesystem | 불리언 | 아니요 | |
allowPrivilegeEscalation | 불리언 | 아니요 | |
capabilities | object | 아니요 |
추가 속성은 허용되지 않습니다.
container.securityContext.capabilities
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
add | string[] | 아니요 | |
drop | string[] | 아니요 |
추가 속성은 허용되지 않습니다.
containerAttachment
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
from | string | 예 | Component의 featuresSchema에 선언된 슬롯의 이름이며, connection이 설정된 경우 해당 connection이 연결된 소켓이 선언하는 슬롯의 이름입니다. |
connection | string | 아니요 | 컴포넌트가 사용하는 connection의 별칭으로, Aggregate 또는 Release에서 컴포넌트의 uses 블록에 작성된 이름입니다. 설정하면 from은 해당 connection이 연결된 소켓이 선언하는 슬롯(usesSchema. |
as | string (enum) | 예 | 전달 방식입니다. 슬롯의 inject: 배열에 허용 목록으로 등록되어 있어야 합니다. 허용 값: "env", "file" |
key | string | 아니요 | as: env인 경우, 이 항목이 읽는 참조 슬롯 secret의 특정 데이터 키입니다. 슬롯의 secret에 데이터 키가 여러 개 있을 때 설정하여 이 항목이 이름으로 그중 하나를 선택하게 합니다. 두 항목이 서로 다른 키로 같은 슬롯을 참조하여 하나의 secret에서 여러 키를 읽을 수 있습니다. 생략하면 항목은 슬롯이 게시한 단일 키를 읽습니다. secret 전체를 마운트하는 as: file에서는 무시됩니다. |
path | string | 아니요 | 컨테이너 내부의 파일 경로입니다(as: file인 경우 필수). |
추가 속성은 허용되지 않습니다.
resourceList
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
cpu | string | 아니요 | CPU 수량(예: ‘100m’, ‘0.5’, ‘2’). helm은 이를 resources.{requests,limits}.cpu 아래에 그대로 출력합니다. compose는 이를 deploy.resources.{reservations,limits}.cpus에 소수 코어 단위로 매핑합니다. 밀리CPU 수량은 변환되며(500m은 0.5가 됨), 일반 코어 수량은 그대로 전달됩니다. compose가 변환할 수 없는 수량은 잘못된 값을 출력하는 대신 명시적으로 중단됩니다. |
memory | string | 아니요 | 메모리 수량(예: ‘128Mi’, ‘1Gi’). helm은 이를 resources.{requests,limits}.memory 아래에 그대로 출력합니다. compose는 이를 deploy.resources.{reservations,limits}.memory에 정확한 바이트 수로 매핑합니다. 정수 바이트 수가 되는 수량은 정확히 변환되며(1.5Gi는 1610612736이 됨), 그렇지 않거나 수량이 아닌 값은 반올림하는 대신 명시적으로 중단됩니다. |
추가 키: 완전한 ’^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)+/[A-Za-z0-9]([-A-Za-z0-9_.]*[A-Za-z0-9])?$.
그 밖의 속성은 허용되지 않습니다.
probe
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
http | string | 아니요 | HTTP GET 프로브: 경로는 이름이 알파벳순으로 가장 앞서는 컨테이너 포트에 대해 프로브됩니다. |
tcp | integer | 아니요 | 지정된 컨테이너 포트 번호에 대한 TCP 소켓 프로브. 최솟값: 1. 최댓값: 65535. |
exec | string[] | 아니요 | Exec 프로브 — 컨테이너 안에서 실행할 명령. 최소 1개 항목. |
timeoutSeconds | integer | 아니요 | 최솟값: 1. |
initialDelaySeconds | integer | 아니요 | 최솟값: 0. |
periodSeconds | integer | 아니요 | 최솟값: 1. |
failureThreshold | integer | 아니요 | 최솟값: 1. |
successThreshold | integer | 아니요 | 최솟값: 1. |
추가 속성은 허용되지 않습니다.
lifecycleHook
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
exec | string[] | 아니요 | 최소 1개 항목. |
httpGet | object | 아니요 | K8s 네이티브 httpGet 형태(path, port, scheme, host, httpHeaders). helm에 그대로 전달됩니다. compose 대상에서는 compose에 라이프사이클 훅 기본 요소가 없으므로 라이프사이클 훅을 선언한 워크로드는 중단되며, 훅이 조용히 누락되는 일은 없습니다. |
추가 속성은 허용되지 않습니다.
volume
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
ephemeral | object | 아니요 | |
configmap | object | 아니요 | |
secret | object | 아니요 | |
persistent | object | 아니요 | |
persistentTemplate | object | 아니요 | 레플리카별 클레임 템플릿. form: stateful이 필요합니다. 레플리카별 클레임에 필요한 안정적인 식별자를 각 레플리카에 부여하는 것은 stateful 형태뿐이기 때문입니다. Kubernetes에서는 StatefulSet.volumeClaimTemplates가 됩니다. compose 대상에서는 모든 레플리카가 공유하는 단일 명명된 볼륨으로 격하되며, 경고가 이 격하를 보고합니다. |
추가 속성은 허용되지 않습니다.
volume.ephemeral
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
sizeLimit | string | 아니요 | K8s 수량(예: ‘1Gi’). K8s: emptyDir.sizeLimit. Compose: 볼륨은 크기를 갖지 않는 tmpfs 항목이 되므로 이 값은 출력 어디에도 반영되지 않으며, 작성된 경우 경고가 이를 보고합니다. |
추가 속성은 허용되지 않습니다.
volume.configmap
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
source | string | 예 | ConfigMap의 이름으로, 이 Recipe가 artifacts:를 통해 출력하거나 연결된 Feature가 출력합니다. 다른 Recipe가 출력하는 ConfigMap은 여기에서 참조하지 않습니다. |
items | object[] | 아니요 | 선택적 키-경로 선택. |
추가 속성은 허용되지 않습니다.
volume.secret
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
source | string | 예 | |
items | object[] | 아니요 |
추가 속성은 허용되지 않습니다.
volume.persistent
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
size | string | 예 | K8s 수량(예: ‘10Gi’). |
class | string | 아니요 | StorageClassName. 선택 사항. |
accessModes | string (enum)[] | 아니요 | PVC 접근 모드. helm은 spec.accessModes를 출력하며, 생략하면 [ReadWriteOnce]가 기본값입니다. compose 볼륨에는 접근 모드 개념이 없어 이를 생략합니다. 각 항목에 허용되는 값: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod". |
추가 속성은 허용되지 않습니다.
volume.persistentTemplate
레플리카별 클레임 템플릿. form: stateful이 필요합니다. 레플리카별 클레임에 필요한 안정적인 식별자를 각 레플리카에 부여하는 것은 stateful 형태뿐이기 때문입니다. Kubernetes에서는 StatefulSet.volumeClaimTemplates가 됩니다. compose 대상에서는 모든 레플리카가 공유하는 단일 명명된 볼륨으로 격하되며, 경고가 이 격하를 보고합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
size | string | 예 | |
class | string | 아니요 | |
accessModes | string (enum)[] | 아니요 | 레플리카별 클레임 템플릿의 PVC 접근 모드. helm은 spec.accessModes를 출력하며, 생략하면 [ReadWriteOnce]가 기본값입니다. compose에는 접근 모드 개념이 없어 이를 생략합니다. 각 항목에 허용되는 값: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod". |
추가 속성은 허용되지 않습니다.
service
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
type | string (enum) | 예 | 서비스 타입: 항목의 포트가 도달하는 범위. ClusterIP는 포트를 대상 자체의 네트워크 안에 두어 워크로드의 피어에서 접근할 수 있게 합니다. Headless도 마찬가지이며, helm에서는 clusterIP: None인 K8s Service를 렌더링합니다. NodePort와 LoadBalancer는 포트를 그 네트워크 밖으로 공개합니다. Loopback은 호스트 자체의 루프백 주소에만 포트를 공개하여, 워크로드가 실행되는 머신에서만 접근할 수 있고 다른 곳에서는 접근할 수 없습니다. helm은 ClusterIP, NodePort, LoadBalancer를 같은 이름의 K8s Service 타입으로 렌더링하며, K8s Service에는 호스트의 루프백 주소에 바인딩하는 타입이 없으므로 Loopback 항목은 이름을 지명하여 거부합니다. compose는 ClusterIP와 Headless에 대해 아무것도 공개하지 않고, NodePort와 LoadBalancer 포트는 모든 호스트 인터페이스에 host:container 형식으로 공개하며, Loopback 포트는 IPv4 루프백 주소에 127.0.0.1:host:container 형식으로 공개합니다. NodePort 또는 LoadBalancer 항목도 공개하는 포트는 모든 인터페이스에 공개됩니다. 허용 값: "ClusterIP", "NodePort", "LoadBalancer", "Headless", "Loopback" |
ports | integer의 맵 | 예 | 서비스 포트 이름 → 컨테이너 포트 번호의 맵. 포트 이름은 containers. |
추가 속성은 허용되지 않습니다.