Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Esquema del Workload de Aggrega

Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.

ID del esquema: https://aggrega.ai/schemas/workload-v1beta1.schema.json

Especificación abstracta de carga de trabajo, propiedad de la plataforma. Una Recipe que usa el modo sintetizado declara exactamente un Workload mediante la palabra clave workload: (escalar de bloque inline o workload: { $import: } según el vocabulario unificado de importación de archivos). El proveedor de destino traduce el Workload a manifiestos nativos del proveedor (K8s Deployment/StatefulSet/Services/PVCs para helm; servicios + volúmenes + redes de compose para compose; etc.). Un Workload no lleva metadatos propios — ni nombre, ni etiquetas, ni anotaciones. La identidad y el etiquetado provienen de la instancia de componente que lo declara: el proveedor de destino deriva de esa instancia el nombre de cada recurso renderizado y estampa en el recurso las claves de procedencia aggrega.ai/* de ese nodo. El tipo Workload NO es una entidad de catálogo — este archivo publicado es el JSON Schema canónico del Workload, y el compilador valida un Workload con respecto a él.

Consulta la referencia de autoría del Workload para obtener orientación en prosa sobre cómo escribir entidades Workload; esta página documenta el esquema estructural que describe esa referencia.

Tipo de nivel superior: object

Propiedades

PropiedadTipoObligatoriaDescripción
apiVersionconst “aggrega.ai/v1beta1”síConstante: "aggrega.ai/v1beta1"
kindconst “Workload”síConstante: "Workload"
formstring (enum)noIntención abstracta sobre la forma del controlador para la carga de trabajo. Elige el tipo de ciclo de vida en tiempo de ejecución que tiene la carga de trabajo, con independencia de cualquier plataforma de destino: stateless (réplicas intercambiables de larga duración), stateful (réplicas con identidad estable y almacenamiento propios de cada réplica), daemon (una instancia por cada host apto), scheduled (ejecuciones recurrentes activadas por tiempo), task (una sola ejecución hasta completarse), reference (un endpoint externo sin cómputo — sin controlador; helm emite un Service ExternalName, compose lleva el endpoint a través del contrato de inyección). Un valor vacío se trata como stateless. Cada proveedor de destino asigna la forma a su propia forma nativa; la forma no lleva por sí misma ningún tipo de recurso nativo de la plataforma. Un volumen persistentTemplate es un complemento de stateful y solo es válido en una carga de trabajo stateful. Una carga de trabajo reference declara endpoint (y opcionalmente port) y ningún contenedor, y no lleva ningún campo de credencial propio, porque el nombre de la variable de entorno pertenece al consumidor y no al endpoint. Un consumidor que necesita una credencial para el endpoint declara la ranura en el featuresSchema de su propio Component y la llena desde el bloque attachments de su contenedor, donde la lista inject de esa ranura permite la entrega. Valores permitidos: "stateless", "stateful", "daemon", "scheduled", "task", "reference" Valor predeterminado: "stateless"
endpointstringnoEndpoint externo para form: reference — un host o una URL. El compilador lo transmite tal cual como una cadena de puntero determinista; nunca se resuelve en tiempo de compilación (AOT). Obligatorio cuando form es reference y solo tiene sentido en ese caso. helm lo emite como el externalName de un Service ExternalName (la parte del host); compose lo lleva a los consumidores a través de los provides de la receta.
portintegernoPuerto opcional para el endpoint reference (form: reference). helm lo emite como un puerto en el Service ExternalName. Mínimo: 1. Máximo: 65535.
schedulestringnoProgramación cron para form: scheduled — una expresión crontab estándar de 5 campos (por ejemplo ‘0 0 * * *’) o una de las macros @hourly, @daily, @weekly, @monthly, @yearly. Obligatoria cuando form es scheduled y solo tiene sentido en ese caso; el proveedor de destino la transmite tal cual al campo schedule del recurso programado.
suspendbooleanonoSuspende la programación recurrente de una carga de trabajo form: scheduled. Cuando es true, el recurso programado se renderiza con su programación en su sitio, pero ninguna ejecución arranca a partir de esa programación hasta que se reanuda; aún se puede crear una ejecución a mano a partir del recurso — en Kubernetes, kubectl create job —from=cronjob/. suspend: false se renderiza exactamente igual que un suspend ausente. Solo tiene sentido con form: scheduled. helm lo emite como el spec.suspend del CronJob. compose no tiene una forma programada y detiene la compilación ante una carga de trabajo form: scheduled, esté o no suspendida. Valor predeterminado: false
replicasintegernoNúmero de réplicas. Valor predeterminado 1. En un destino compose el valor no llega a ninguna parte de la salida, y una advertencia lo notifica siempre que se escribe — incluido un 1 explícito. Mínimo: 0. Valor predeterminado: 1
initContainerscontainer[]noLista ordenada de contenedores que se ejecutan hasta completarse antes de que arranquen los contenedores principales.
containersmapa de containernoMapa ordenado de nombre de contenedor → especificación de contenedor. Se requiere al menos una entrada. Se conserva el orden del autor. Al menos 1 entrada.
volumesmapa de volumenoMapa ordenado de nombre de volumen → especificación de volumen. Cada especificación de volumen declara exactamente uno de: ephemeral, configmap, secret, persistent, persistentTemplate.
servicesmapa de servicenoMapa ordenado de nombre de servicio → especificación de servicio. En helm cada entrada se convierte en un Service de K8s independiente, y una entrada cuyo type es Loopback detiene la compilación. En compose no existe una primitiva de servicio independiente, por lo que las entradas no se asignan una a una: una entrada cuyo type es NodePort o LoadBalancer publica sus puertos en todas las interfaces del host del servicio de compose propio de la carga de trabajo, una entrada cuyo type es Loopback publica allí sus puertos solo en la dirección de loopback del host, una entrada cuyo type es ClusterIP o Headless no publica nada, y cada puerto publicado se reúne en la lista de puertos de ese único servicio, con el puerto del host igual al puerto del contenedor. En helm cada Service se llama <name>-<key>: el nombre que lleva el Deployment (u otro controlador) propio de la carga de trabajo, después un guion y la clave de la entrada, de modo que un Workload que declara services.http y cuyo Deployment se llama api-server renderiza un Service llamado api-server-http. En compose una clave no nombra nada en la salida.
schedulingobjectnoRestricciones de planificación nativas de K8s. Se traducen directamente para helm. En un destino compose estas restricciones no llegan a ninguna parte de la salida, y una advertencia notifica el bloque cuando se escribe.
podSecurityContextobjectno
serviceAccountstringnoNombre de la ServiceAccount con la que se ejecuta esta carga de trabajo. El RBAC real (recursos ServiceAccount/Role/RoleBinding) debería emitirse mediante Features o artefactos, no mediante este campo.
imagePullSecretsstring[]noNombres de los Secrets de descarga de imágenes para descargar imágenes de registros privados. helm emite pod.imagePullSecrets. compose no tiene un equivalente dentro del archivo — la autenticación en el registro se configura por separado mediante docker login — y lo omite.
priorityClassNamestringnoNombre de la PriorityClass que rige la prioridad de planificación de esta carga de trabajo. helm emite pod.priorityClassName. compose no tiene un equivalente de prioridad de planificación en un solo host y lo omite.
runtimeClassNamestringnoNombre de la RuntimeClass que selecciona el runtime de contenedores con el que se ejecuta esta carga de trabajo (por ejemplo, un runtime con GPU como ‘nvidia’). El compilador transmite el nombre tal cual; el clúster lo resuelve en una RuntimeClass configurada en el momento de la planificación. helm emite pod.runtimeClassName. compose no tiene un equivalente de clase de runtime y lo omite. Solo para cómputo: no se permite en una carga de trabajo reference.
terminationGracePeriodSecondsintegernoSegundos entre SIGTERM y SIGKILL al apagar. helm emite pod.terminationGracePeriodSeconds; compose emite stop_grace_period. Mínimo: 0.
dnsPolicystring (enum)noPolítica DNS del pod. helm emite pod.dnsPolicy. compose no tiene un equivalente de política DNS y la omite (en su lugar, compose asigna directamente nameservers/searches de dnsConfig). Valores permitidos: "Default", "ClusterFirst", "ClusterFirstWithHostNet", "None"
dnsConfigobjectnoConfiguración DNS personalizada del pod. helm emite pod.dnsConfig. compose asigna nameservers a dns y searches a dns_search; options no tiene equivalente en compose y allí se omite.
hostAliasesobject[]noAsignaciones estáticas de nombre de host a IP inyectadas en el archivo hosts del pod. helm emite pod.hostAliases; compose emite extra_hosts (una entrada hostname:ip por cada nombre de host).
hostNetworkbooleanonoEjecuta la carga de trabajo en el espacio de nombres de red propio del nodo host en lugar de en uno aislado. Los puertos que abre la carga de trabajo son entonces accesibles en las direcciones propias del nodo, y la carga de trabajo ve las interfaces de red del nodo. Esto elige un espacio de nombres de red y nada más: no declara ningún puerto, y cada puerto que abre la carga de trabajo se sigue declarando en containers..ports. helm emite pod.hostNetwork. compose emite network_mode: host en el servicio propio de la carga de trabajo; un servicio de compose en ese modo no está conectado a la red del límite, por lo que sus pares lo alcanzan en las direcciones del nodo y no por el nombre del servicio, y el servicio de cada contenedor de inicialización se une a la red del límite por sí mismo. Solo para cómputo: no se permite en una carga de trabajo reference.

No se permiten propiedades adicionales.

workload.scheduling

Restricciones de planificación nativas de K8s. Se traducen directamente para helm. En un destino compose estas restricciones no llegan a ninguna parte de la salida, y una advertencia notifica el bloque cuando se escribe.

PropiedadTipoObligatoriaDescripción
nodeSelectormapa de stringno
affinityobjectno
tolerationsobject[]no
topologySpreadConstraintsobject[]no

No se permiten propiedades adicionales.

workload.podSecurityContext

PropiedadTipoObligatoriaDescripción
runAsUserintegerno
runAsGroupintegerno
fsGroupintegerno
supplementalGroupsinteger[]no

No se permiten propiedades adicionales.

workload.dnsConfig

Configuración DNS personalizada del pod. helm emite pod.dnsConfig. compose asigna nameservers a dns y searches a dns_search; options no tiene equivalente en compose y allí se omite.

PropiedadTipoObligatoriaDescripción
nameserversstring[]no
searchesstring[]no
optionsobject[]no

No se permiten propiedades adicionales.

workload.hostAliases[]

PropiedadTipoObligatoriaDescripción
ipstringsí
hostnamesstring[]sí

No se permiten propiedades adicionales.

Definiciones

container

PropiedadTipoObligatoriaDescripción
namestringnoNombre opcional del contenedor. Para una entrada posicional de initContainers establece el nombre del contenedor emitido y, cuando se omite, recurre a un nombre generado init- (la posición de la entrada en la lista). Para una entrada del mapa containers la clave del mapa es el nombre del contenedor y este campo se ignora.
imagestringsíReferencia a la imagen del contenedor (p. ej., ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’).
imagePullPolicystring (enum)noPolítica de descarga de la imagen. helm la emite como container.imagePullPolicy. compose la asigna al pull_policy del servicio (Always a always, Never a never, IfNotPresent a if_not_present). Valores permitidos: "Always", "Never", "IfNotPresent"
commandstring[]noReemplaza el entrypoint de la imagen. K8s: .command. Compose: entrypoint.
argsstring[]noArgumentos que se pasan a command (o al entrypoint de la imagen si command está ausente). K8s: .args. Compose: command.
variablesmapa de stringnoVariables de entorno como pares clave-valor de cadenas. K8s: spec.template.spec.containers[].env[]. Compose: services..environment.
attachmentsmapa de containerAttachmentnoMapa ordenado de nombre de env o de archivo → { from, as, key?, path?, connection? }. Cada entrada hace referencia a una ranura declarada en el featuresSchema del Component — o, cuando la entrada nombra una conexión, a una ranura que declara el socket de esa conexión — y entrega lo que publicó la vinculación que llena esa ranura. El campo ‘as’ selecciona el mecanismo de entrega, que debe estar en la lista de permitidos del array inject: de la ranura. Las ranuras blackbox (inject: []) NO PUEDEN aparecer aquí.
envFromobject[]noEntorno en bloque importado desde una fuente ConfigMap o Secret. helm emite container.envFrom (configMapRef/secretRef). compose no tiene una primitiva env-from-object — una referencia de fuente no es un archivo del host, por lo que reinterpretarla como env_file cambiaría el significado en silencio; una carga de trabajo que declara envFrom detiene la compilación de forma explícita en un destino compose.
portsmapa de integer u objectnoPuertos del contenedor con nombre. Un puerto se escribe como el número de puerto a secas (web: 8080) o como un objeto que lleva el número junto con el protocolo de transporte que usa el puerto (dns: { port: 53, protocol: UDP }); cuando no se declara ningún protocolo, las dos formas significan lo mismo. Los valores de protocolo permitidos son TCP, UDP y SCTP, y omitir la clave deja en vigor el valor predeterminado propio del destino. Los nombres de puerto los referencian services.*.ports y la resolución del puerto de una sonda http, y un puerto de servicio toma su transporte del puerto del contenedor al que se resuelve su nombre, de modo que el transporte se declara una sola vez. K8s: containerPort, con protocol solo donde se declara uno. Compose: un puerto del contenedor llega a la salida solo donde una especificación de servicio lo publica; el puerto del contenedor en sí no tiene un campo de compose aparte, y un puerto publicado lleva un transporte declarado como el sufijo /protocol en la entrada publicada — un transporte que compose no puede expresar detiene la compilación en lugar de publicar un puerto que llevaría otro distinto.
resourcesobjectno
healthobjectnoLas sondas de salud del contenedor — ready, live y startup —, cada una declarada como http, tcp o exec. Se traducen a httpGet/tcpSocket/exec de K8s para helm. Para compose, un servicio lleva un único healthcheck: http y tcp se convierten en pruebas CMD-SHELL, exec se convierte en una prueba CMD, y cuando se declara más de una sonda solo se conserva una — una advertencia nombra la sonda traducida y las descartadas.
volumeMountsobject[]no
restartPolicystring (enum)noValores permitidos: "Always", "OnFailure", "Never"
lifecycleobjectnoHooks del ciclo de vida del contenedor. Se traducen a container.lifecycle de K8s (postStart/preStop) para helm. compose no tiene una primitiva de hook del ciclo de vida; una carga de trabajo que declara lifecycle detiene la compilación de forma explícita en un destino compose en lugar de descartar el hook en silencio.
securityContextobjectno

No se permiten propiedades adicionales.

container.envFrom[]

PropiedadTipoObligatoriaDescripción
configMapstringnoNombre de una fuente ConfigMap emitida por la entrada artifacts de esta Recipe o por una Feature vinculada.
secretstringnoNombre de una ranura del featuresSchema — la del propio Component o, cuando connection está establecido, una ranura que declara el socket de esa conexión; el nombre del Secret importado se resuelve a partir de los provides de la ranura.
connectionstringnoAlias de una conexión que traza el componente — el nombre con el que está escrita en el bloque uses del componente, en el Aggregate o en la Release. Cuando está establecido, secret nombra una ranura que declara el socket a través del cual está cableada esa conexión, y el Secret importado es el que publicó la vinculación que lleva esa conexión en esa ranura, de modo que un componente que alcanza varios destinos importa el Secret propio de cada uno. Solo tiene sentido junto a secret. Una conexión que el componente no traza, o una ranura que su socket no declara, se rechaza nombrando ambas.
prefixstringnoPrefijo opcional antepuesto a cada nombre de variable de entorno importada.

No se permiten propiedades adicionales.

container.resources

PropiedadTipoObligatoriaDescripción
requestsresourceListno
limitsresourceListno

No se permiten propiedades adicionales.

container.health

Las sondas de salud del contenedor — ready, live y startup —, cada una declarada como http, tcp o exec. Se traducen a httpGet/tcpSocket/exec de K8s para helm. Para compose, un servicio lleva un único healthcheck: http y tcp se convierten en pruebas CMD-SHELL, exec se convierte en una prueba CMD, y cuando se declara más de una sonda solo se conserva una — una advertencia nombra la sonda traducida y las descartadas.

PropiedadTipoObligatoriaDescripción
readyprobeno
liveprobeno
startupprobeno

No se permiten propiedades adicionales.

container.volumeMounts[]

PropiedadTipoObligatoriaDescripción
namestringsíDebe coincidir con una clave del mapa volumes: de nivel superior.
pathstringsíPunto de montaje dentro del contenedor.
subPathstringnoMonta un único archivo o subdirectorio del volumen en path, sin ocultar otros archivos del directorio de destino.
readonlybooleanonoValor predeterminado: false

No se permiten propiedades adicionales.

container.lifecycle

Hooks del ciclo de vida del contenedor. Se traducen a container.lifecycle de K8s (postStart/preStop) para helm. compose no tiene una primitiva de hook del ciclo de vida; una carga de trabajo que declara lifecycle detiene la compilación de forma explícita en un destino compose en lugar de descartar el hook en silencio.

PropiedadTipoObligatoriaDescripción
postStartlifecycleHookno
preStoplifecycleHookno

No se permiten propiedades adicionales.

container.securityContext

PropiedadTipoObligatoriaDescripción
runAsUserintegerno
runAsGroupintegerno
runAsNonRootbooleanono
readOnlyRootFilesystembooleanono
allowPrivilegeEscalationbooleanono
capabilitiesobjectno

No se permiten propiedades adicionales.

container.securityContext.capabilities
PropiedadTipoObligatoriaDescripción
addstring[]no
dropstring[]no

No se permiten propiedades adicionales.

containerAttachment

PropiedadTipoObligatoriaDescripción
fromstringsíNombre de una ranura declarada en el featuresSchema del Component — o, cuando connection está establecido, de una ranura que declara el socket a través del cual está cableada esa conexión.
connectionstringnoAlias de una conexión que traza el componente — el nombre con el que está escrita en el bloque uses del componente, en el Aggregate o en la Release. Cuando está establecido, from nombra una ranura que declara el socket a través del cual está cableada esa conexión (usesSchema..featuresSchema), y la entrada entrega lo que publicó la vinculación que lleva esa conexión en esa ranura, de modo que un componente que alcanza varios destinos presenta a cada uno su propia credencial. La lista de permitidos inject: de la ranura rige as, exactamente igual que para una ranura que declara el Component. Una conexión que el componente no traza, o una ranura que su socket no declara, se rechaza nombrando ambas.
asstring (enum)síMecanismo de entrega. Debe estar en la lista de permitidos del array inject: de la ranura. Valores permitidos: "env", "file"
keystringnoPara as: env, la clave de datos concreta del secreto de la ranura referenciada que lee esta entrada. Establécela cuando el secreto de la ranura lleve varias claves de datos, para que esta entrada seleccione una de ellas por nombre; dos entradas pueden hacer referencia a la misma ranura con claves distintas para leer varias claves de un mismo secreto. Si se omite, la entrada lee la única clave publicada de la ranura. Se ignora para as: file, que monta el secreto completo.
pathstringnoRuta del archivo dentro del contenedor (obligatoria cuando as: file).

No se permiten propiedades adicionales.

resourceList

PropiedadTipoObligatoriaDescripción
cpustringnoCantidad de CPU (p. ej., ‘100m’, ‘0.5’, ‘2’). helm la emite tal cual en resources.{requests,limits}.cpu. compose la asigna a deploy.resources.{reservations,limits}.cpus como núcleos fraccionarios — una cantidad en milicpu se convierte (500m pasa a ser 0.5); una cantidad simple en núcleos pasa tal cual. Una cantidad que compose no puede convertir detiene la compilación de forma explícita en lugar de emitir un valor erróneo.
memorystringnoCantidad de memoria (p. ej., ‘128Mi’, ‘1Gi’). helm la emite tal cual en resources.{requests,limits}.memory. compose la asigna a deploy.resources.{reservations,limits}.memory como un recuento exacto de bytes. Una cantidad que equivale a un número entero de bytes se convierte exactamente (1.5Gi pasa a ser 1610612736); una que no lo es, o que no es una cantidad, detiene la compilación de forma explícita en lugar de redondearse.

Claves adicionales: Una cantidad de recurso extendida (con ámbito de fabricante o de dominio), indexada por un nombre completamente cualificado ’/’ (por ejemplo ‘nvidia.com/gpu’: ‘1’, ‘amd.com/gpu’: ‘2’). El segmento de dominio contiene al menos un punto, lo que distingue una clave extendida de las cantidades cpu/memory simples. El compilador transmite la cantidad tal cual; el plugin de dispositivos del clúster la resuelve y la asigna en el momento de la planificación. helm la emite en resources.{requests,limits}.. compose reserva un recuento ‘nvidia.com/gpu’ como una reserva de dispositivos NVIDIA en el servicio del contenedor — el recuento del límite donde se escribe un límite y, si no, el de la solicitud, y ninguna reserva para un recuento de 0 — y detiene la compilación ante un recuento que no es un número entero de dispositivos, o ante una solicitud y un límite que piden recuentos distintos. compose no tiene equivalente para ninguna otra clave extendida y la omite, con una advertencia por cada clave extendida distinta que nombra esa clave, de modo que la omisión se notifica en lugar de ser silenciosa. Patrón: ^[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])?$.

No se permite ninguna otra propiedad.

probe

PropiedadTipoObligatoriaDescripción
httpstringnoSonda HTTP GET: la ruta se sondea en el puerto del contenedor cuyo nombre va primero en orden alfabético.
tcpintegernoSonda de socket TCP en el número de puerto del contenedor indicado. Mínimo: 1. Máximo: 65535.
execstring[]noSonda exec — el comando que se ejecuta dentro del contenedor. Al menos 1 entrada.
timeoutSecondsintegernoMínimo: 1.
initialDelaySecondsintegernoMínimo: 0.
periodSecondsintegernoMínimo: 1.
failureThresholdintegernoMínimo: 1.
successThresholdintegernoMínimo: 1.

No se permiten propiedades adicionales.

lifecycleHook

PropiedadTipoObligatoriaDescripción
execstring[]noAl menos 1 entrada.
httpGetobjectnoLa forma httpGet nativa de K8s (path, port, scheme, host, httpHeaders). Se transmite tal cual a helm. En un destino compose, una carga de trabajo que declara un hook del ciclo de vida detiene la compilación, porque compose no tiene una primitiva de hook del ciclo de vida — el hook nunca se descarta en silencio.

No se permiten propiedades adicionales.

volume

PropiedadTipoObligatoriaDescripción
ephemeralobjectno
configmapobjectno
secretobjectno
persistentobjectno
persistentTemplateobjectnoPlantilla de claim por réplica. Requiere form: stateful, porque solo la forma stateful da a cada réplica la identidad estable que necesita un claim por réplica. En Kubernetes se convierte en StatefulSet.volumeClaimTemplates. En un destino compose se degrada a un único volumen con nombre compartido por todas las réplicas, y una advertencia notifica la degradación.

No se permiten propiedades adicionales.

volume.ephemeral

PropiedadTipoObligatoriaDescripción
sizeLimitstringnoCantidad de K8s (p. ej., ‘1Gi’). K8s: emptyDir.sizeLimit. Compose: el volumen se convierte en una entrada tmpfs que no lleva tamaño, por lo que este valor no llega a ninguna parte de la salida — una advertencia lo notifica cuando se escribe.

No se permiten propiedades adicionales.

volume.configmap

PropiedadTipoObligatoriaDescripción
sourcestringsíNombre de la ConfigMap, emitida por esta Recipe mediante artifacts: o por una Feature vinculada; aquí no se hace referencia a una ConfigMap que emita otra Recipe.
itemsobject[]noSelección opcional de clave a ruta.

No se permiten propiedades adicionales.

volume.secret

PropiedadTipoObligatoriaDescripción
sourcestringsí
itemsobject[]no

No se permiten propiedades adicionales.

volume.persistent

PropiedadTipoObligatoriaDescripción
sizestringsíCantidad de K8s (p. ej., ‘10Gi’).
classstringnoStorageClassName. Opcional.
accessModesstring (enum)[]noModos de acceso del PVC. helm emite spec.accessModes, con [ReadWriteOnce] como valor predeterminado cuando se omite. Los volúmenes de compose no tienen el concepto de modo de acceso y lo omiten. Valores permitidos para cada entrada: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

No se permiten propiedades adicionales.

volume.persistentTemplate

Plantilla de claim por réplica. Requiere form: stateful, porque solo la forma stateful da a cada réplica la identidad estable que necesita un claim por réplica. En Kubernetes se convierte en StatefulSet.volumeClaimTemplates. En un destino compose se degrada a un único volumen con nombre compartido por todas las réplicas, y una advertencia notifica la degradación.

PropiedadTipoObligatoriaDescripción
sizestringsí
classstringno
accessModesstring (enum)[]noModos de acceso del PVC para la plantilla de claim por réplica. helm emite spec.accessModes, con [ReadWriteOnce] como valor predeterminado cuando se omite. compose no tiene el concepto de modo de acceso y lo omite. Valores permitidos para cada entrada: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

No se permiten propiedades adicionales.

service

PropiedadTipoObligatoriaDescripción
typestring (enum)síTipo de servicio: hasta dónde llegan los puertos de la entrada. ClusterIP los mantiene en la red propia del destino, accesibles desde los pares de la carga de trabajo; Headless también, y en helm renderiza un Service de K8s con clusterIP: None; NodePort y LoadBalancer los publican más allá de esa red; Loopback los publica solo en la dirección de loopback propia del host, accesibles desde la máquina en la que se ejecuta la carga de trabajo y desde ningún otro lugar. helm renderiza ClusterIP, NodePort y LoadBalancer como el tipo de Service de K8s del mismo nombre, y rechaza por nombre una entrada Loopback, porque un Service de K8s no tiene ningún tipo que se vincule a la dirección de loopback de un host. compose no publica nada para ClusterIP y Headless, publica los puertos NodePort y LoadBalancer en todas las interfaces del host como host:container, y publica los puertos Loopback en la dirección de loopback IPv4 como 127.0.0.1:host:container; un puerto que también publica una entrada NodePort o LoadBalancer se publica en todas las interfaces. Valores permitidos: "ClusterIP", "NodePort", "LoadBalancer", "Headless", "Loopback"
portsmapa de integersíMapa de nombre de puerto de servicio → número de puerto del contenedor. Los nombres de puerto deben coincidir con claves de containers..ports. Un puerto de servicio no lleva ningún protocolo de transporte propio: toma el transporte del puerto del contenedor al que se resuelve su nombre, de modo que el transporte de un puerto se declara una sola vez, en el puerto del contenedor, y la exposición del servicio no puede discrepar de lo que abrió el contenedor.

No se permiten propiedades adicionales.