Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Schéma du Workload d’Aggrega

Référence générée. Ne pas modifier à la main — régénérer à partir du JSON Schema publié.

Identifiant du schéma : https://aggrega.ai/schemas/workload-v1beta1.schema.json

Spécification abstraite de charge de travail, détenue par la plateforme. Une Recipe qui utilise le mode synthétisé déclare exactement un Workload via le mot-clé workload: (scalaire de bloc inline ou workload: { $import: } selon le vocabulaire unifié d’import de fichier). Le fournisseur cible traduit le Workload en manifestes natifs du fournisseur (K8s Deployment/StatefulSet/Services/PVCs pour helm ; services + volumes + réseaux compose pour compose ; etc.). Un Workload ne porte aucune métadonnée propre — ni nom, ni labels, ni annotations. L’identité et l’étiquetage proviennent de l’instance de composant qui le déclare : le fournisseur cible dérive de cette instance le nom de chaque ressource rendue et appose sur la ressource les clés de provenance aggrega.ai/* de ce nœud. Le type Workload n’est PAS une entité de catalogue — ce fichier publié est le JSON Schema canonique du Workload, et le compilateur valide un Workload par rapport à lui.

Consultez la référence de rédaction du Workload pour des conseils rédigés sur l’écriture des entités Workload ; cette page documente le schéma structurel que décrit cette référence.

Type de premier niveau : object

Propriétés

PropriétéTypeObligatoireDescription
apiVersionconst “aggrega.ai/v1beta1”ouiConstante : "aggrega.ai/v1beta1"
kindconst “Workload”ouiConstante : "Workload"
formstring (enum)nonIntention abstraite de forme de contrôleur pour la charge de travail. Choisit le type de cycle de vie d’exécution qu’a la charge de travail, indépendamment de toute plateforme cible : stateless (réplicas interchangeables de longue durée), stateful (réplicas dotés d’une identité stable et d’un stockage propres à chaque réplica), daemon (une instance par hôte éligible), scheduled (exécutions récurrentes déclenchées dans le temps), task (une seule exécution jusqu’à son terme), reference (un point de terminaison externe sans ressources de calcul — pas de contrôleur ; helm émet un Service ExternalName, compose transporte le point de terminaison par le contrat d’injection). Une valeur vide est traitée comme stateless. Chaque fournisseur cible associe la forme à sa propre forme native ; la forme elle-même ne porte aucun type de ressource natif de la plateforme. Un volume persistentTemplate est un compagnon de stateful et n’est valide que sur une charge de travail stateful. Une charge de travail reference déclare endpoint (et éventuellement port) et aucun conteneur, et ne porte aucun champ d’identifiants qui lui soit propre, car le nom de la variable d’environnement appartient au consommateur plutôt qu’au point de terminaison. Un consommateur qui a besoin d’identifiants pour le point de terminaison déclare l’emplacement dans le featuresSchema de son propre Component et le remplit à partir du bloc attachments de son conteneur, là où la liste inject de cet emplacement autorise la livraison. Valeurs autorisées : "stateless", "stateful", "daemon", "scheduled", "task", "reference" Par défaut : "stateless"
endpointstringnonPoint de terminaison externe pour form: reference — un hôte ou une URL. Le compilateur le transmet tel quel sous forme de chaîne de pointeur déterministe ; il n’est jamais résolu au moment de la compilation (AOT). Obligatoire lorsque form vaut reference, et significatif uniquement dans ce cas. helm l’émet comme externalName d’un Service ExternalName (la partie hôte) ; compose le transmet aux consommateurs par les provides de la recette.
portintegernonPort facultatif pour le point de terminaison reference (form: reference). helm l’émet comme port sur le Service ExternalName. Minimum : 1. Maximum : 65535.
schedulestringnonPlanification cron pour form: scheduled — une expression crontab standard à 5 champs (par exemple ‘0 0 * * *’) ou l’une des macros @hourly, @daily, @weekly, @monthly, @yearly. Obligatoire lorsque form vaut scheduled, et significative uniquement dans ce cas ; le fournisseur cible la transmet telle quelle dans le champ schedule de la ressource planifiée.
suspendbooléennonSuspend la planification récurrente d’une charge de travail form: scheduled. Lorsqu’il vaut true, la ressource planifiée est rendue avec sa planification en place, mais aucune exécution ne démarre à partir de cette planification tant qu’elle n’est pas reprise ; une exécution peut toujours être créée manuellement à partir de la ressource — sur Kubernetes, kubectl create job —from=cronjob/. suspend: false est rendu exactement comme un suspend absent. Significatif uniquement avec form: scheduled. helm l’émet comme spec.suspend du CronJob. compose n’a pas de forme planifiée et provoque un arrêt sur une charge de travail form: scheduled, qu’elle soit suspendue ou non. Par défaut : false
replicasintegernonNombre de réplicas. 1 par défaut. Sur une cible compose, la valeur n’atteint aucune partie de la sortie, et un avertissement la signale chaque fois qu’elle est rédigée — y compris un 1 explicite. Minimum : 0. Par défaut : 1
initContainerscontainer[]nonListe ordonnée de conteneurs qui s’exécutent jusqu’à leur terme avant le démarrage des conteneurs principaux.
containersmap de containernonMap ordonnée nom de conteneur → spécification de conteneur. Au moins une entrée est requise. L’ordre de l’auteur est préservé. Au moins 1 entrée.
volumesmap de volumenonMap ordonnée nom de volume → spécification de volume. Chaque spécification de volume déclare exactement un élément parmi : ephemeral, configmap, secret, persistent, persistentTemplate.
servicesmap de servicenonMap ordonnée nom de service → spécification de service. Sur helm, chaque entrée devient un Service K8s distinct, et une entrée dont le type vaut Loopback interrompt le build. Sur compose, il n’existe pas de primitive de service distincte, de sorte que les entrées ne correspondent pas une à une : une entrée dont le type vaut NodePort ou LoadBalancer publie ses ports sur chaque interface de l’hôte du service compose propre à la charge de travail, une entrée dont le type vaut Loopback y publie ses ports uniquement sur l’adresse de loopback de l’hôte, une entrée dont le type vaut ClusterIP ou Headless ne publie rien, et chaque port publié est rassemblé dans la liste de ports de cet unique service, le port de l’hôte correspondant au port du conteneur. Sur helm, chaque Service est nommé <name>-<key> : le nom que porte le Deployment (ou autre contrôleur) propre à la charge de travail, puis un trait d’union et la clé de l’entrée, de sorte qu’un Workload déclarant services.http dont le Deployment est nommé api-server rend un Service nommé api-server-http. Sur compose, une clé ne nomme rien dans la sortie.
schedulingobjectnonContraintes d’ordonnancement natives de K8s. Traduites directement pour helm. Sur une cible compose, ces contraintes n’atteignent aucune partie de la sortie, et un avertissement signale le bloc lorsqu’il est rédigé.
podSecurityContextobjectnon
serviceAccountstringnonNom du ServiceAccount sous lequel s’exécute cette charge de travail. Le RBAC effectif (ressources ServiceAccount/Role/RoleBinding) devrait être émis via des Features ou des artefacts, et non via ce champ.
imagePullSecretsstring[]nonNoms des Secrets de récupération d’images servant à récupérer des images depuis des registres privés. helm émet pod.imagePullSecrets. compose n’a pas d’équivalent dans le fichier — l’authentification au registre se configure séparément via docker login — et l’omet.
priorityClassNamestringnonNom de la PriorityClass qui régit la priorité d’ordonnancement de cette charge de travail. helm émet pod.priorityClassName. compose n’a pas d’équivalent de priorité d’ordonnancement sur un hôte unique et l’omet.
runtimeClassNamestringnonNom de la RuntimeClass qui sélectionne le runtime de conteneurs sous lequel s’exécute cette charge de travail (par exemple un runtime compatible GPU tel que ‘nvidia’). Le compilateur transmet le nom tel quel ; le cluster le résout en une RuntimeClass configurée au moment de l’ordonnancement. helm émet pod.runtimeClassName. compose n’a pas d’équivalent de classe de runtime et l’omet. Réservé au calcul : non autorisé sur une charge de travail reference.
terminationGracePeriodSecondsintegernonSecondes entre SIGTERM et SIGKILL lors de l’arrêt. helm émet pod.terminationGracePeriodSeconds ; compose émet stop_grace_period. Minimum : 0.
dnsPolicystring (enum)nonPolitique DNS du pod. helm émet pod.dnsPolicy. compose n’a pas d’équivalent de politique DNS et l’omet (compose associe directement à la place les nameservers/searches de dnsConfig). Valeurs autorisées : "Default", "ClusterFirst", "ClusterFirstWithHostNet", "None"
dnsConfigobjectnonConfiguration DNS personnalisée du pod. helm émet pod.dnsConfig. compose associe nameservers à dns et searches à dns_search ; options n’a pas d’équivalent dans compose et y est omis.
hostAliasesobject[]nonCorrespondances statiques de nom d’hôte vers IP injectées dans le fichier hosts du pod. helm émet pod.hostAliases ; compose émet extra_hosts (une entrée hostname:ip par nom d’hôte).
hostNetworkbooléennonExécute la charge de travail dans l’espace de noms réseau propre au nœud hôte plutôt que dans un espace isolé. Les ports que la charge de travail ouvre sont alors joignables sur les adresses propres au nœud, et la charge de travail voit les interfaces réseau du nœud. Cela choisit un espace de noms réseau et rien d’autre : aucun port n’est déclaré, et chaque port que la charge de travail ouvre reste déclaré sous containers..ports. helm émet pod.hostNetwork. compose émet network_mode: host sur le service propre à la charge de travail ; un service compose dans ce mode n’est pas connecté au réseau de la frontière, de sorte que ses pairs le joignent sur les adresses du nœud plutôt que par le nom du service, et le service de chaque conteneur d’initialisation rejoint le réseau de la frontière de son propre chef. Réservé au calcul : non autorisé sur une charge de travail reference.

Les propriétés supplémentaires ne sont pas autorisées.

workload.scheduling

Contraintes d’ordonnancement natives de K8s. Traduites directement pour helm. Sur une cible compose, ces contraintes n’atteignent aucune partie de la sortie, et un avertissement signale le bloc lorsqu’il est rédigé.

PropriétéTypeObligatoireDescription
nodeSelectormap de stringnon
affinityobjectnon
tolerationsobject[]non
topologySpreadConstraintsobject[]non

Les propriétés supplémentaires ne sont pas autorisées.

workload.podSecurityContext

PropriétéTypeObligatoireDescription
runAsUserintegernon
runAsGroupintegernon
fsGroupintegernon
supplementalGroupsinteger[]non

Les propriétés supplémentaires ne sont pas autorisées.

workload.dnsConfig

Configuration DNS personnalisée du pod. helm émet pod.dnsConfig. compose associe nameservers à dns et searches à dns_search ; options n’a pas d’équivalent dans compose et y est omis.

PropriétéTypeObligatoireDescription
nameserversstring[]non
searchesstring[]non
optionsobject[]non

Les propriétés supplémentaires ne sont pas autorisées.

workload.hostAliases[]

PropriétéTypeObligatoireDescription
ipstringoui
hostnamesstring[]oui

Les propriétés supplémentaires ne sont pas autorisées.

Définitions

container

PropriétéTypeObligatoireDescription
namestringnonNom de conteneur facultatif. Pour une entrée positionnelle de initContainers, il définit le nom du conteneur émis, avec repli sur un nom généré init- (la position de l’entrée dans la liste) lorsqu’il est omis. Pour une entrée de la map containers, la clé de la map est le nom du conteneur et ce champ est ignoré.
imagestringouiRéférence de l’image du conteneur (par ex. ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’).
imagePullPolicystring (enum)nonPolitique de récupération de l’image. helm l’émet comme container.imagePullPolicy. compose l’associe au pull_policy du service (Always à always, Never à never, IfNotPresent à if_not_present). Valeurs autorisées : "Always", "Never", "IfNotPresent"
commandstring[]nonRemplace le point d’entrée de l’image. K8s : .command. Compose : entrypoint.
argsstring[]nonArguments passés à command (ou au point d’entrée de l’image si command est absent). K8s : .args. Compose : command.
variablesmap de stringnonVariables d’environnement sous forme de paires clé-valeur de chaînes. K8s : spec.template.spec.containers[].env[]. Compose : services..environment.
attachmentsmap de containerAttachmentnonMap ordonnée nom d’env ou de fichier → { from, as, key?, path?, connection? }. Chaque entrée référence un emplacement déclaré dans le featuresSchema du Component — ou, lorsque l’entrée nomme une connexion, un emplacement que déclare le socket de cette connexion — et livre ce qu’a publié le rattachement qui remplit cet emplacement. Le champ ‘as’ sélectionne le mécanisme de livraison, qui doit figurer dans la liste d’autorisation du tableau inject: de l’emplacement. Les emplacements boîte noire (inject: []) NE PEUVENT PAS apparaître ici.
envFromobject[]nonEnvironnement importé en bloc depuis une source ConfigMap ou Secret. helm émet container.envFrom (configMapRef/secretRef). compose n’a pas de primitive env-from-object — une référence de source n’est pas un fichier de l’hôte, si bien qu’une réinterprétation en env_file changerait silencieusement le sens ; une charge de travail qui déclare envFrom provoque un arrêt explicite sur une cible compose.
portsmap de integer ou objectnonPorts de conteneur nommés. Un port s’écrit soit comme simple numéro de port (web: 8080), soit comme objet portant le numéro avec le protocole de transport qu’utilise le port (dns: { port: 53, protocol: UDP }) ; lorsqu’aucun protocole n’est déclaré, les deux formes signifient la même chose. Les valeurs de protocole autorisées sont TCP, UDP et SCTP, et omettre la clé laisse en vigueur la valeur par défaut propre à la cible. Les noms de ports sont référencés par services.*.ports et par la résolution du port d’une sonde http, et un port de service prend son transport du port de conteneur vers lequel son nom se résout, de sorte que le transport est déclaré une seule fois. K8s : containerPort, portant protocol uniquement là où un protocole est déclaré. Compose : un port de conteneur n’atteint la sortie que là où une spécification de service le publie ; le port de conteneur lui-même n’a pas de champ compose distinct, et un port publié porte un transport déclaré sous la forme du suffixe /protocol sur l’entrée publiée — un transport que compose ne sait pas écrire interrompt le build plutôt que de publier un port qui en porterait un autre.
resourcesobjectnon
healthobjectnonLes sondes de santé du conteneur — ready, live et startup — chacune déclarée comme http, tcp ou exec. Traduites en httpGet/tcpSocket/exec de K8s pour helm. Pour compose, un service porte un seul healthcheck : http et tcp deviennent des tests CMD-SHELL, exec devient un test CMD, et lorsque plusieurs sondes sont déclarées, une seule est conservée — un avertissement nomme la sonde traduite et celles qui sont écartées.
volumeMountsobject[]non
restartPolicystring (enum)nonValeurs autorisées : "Always", "OnFailure", "Never"
lifecycleobjectnonHooks de cycle de vie du conteneur. Traduits en container.lifecycle de K8s (postStart/preStop) pour helm. compose n’a pas de primitive de hook de cycle de vie ; une charge de travail qui déclare lifecycle provoque un arrêt explicite sur une cible compose plutôt que d’écarter silencieusement le hook.
securityContextobjectnon

Les propriétés supplémentaires ne sont pas autorisées.

container.envFrom[]

PropriétéTypeObligatoireDescription
configMapstringnonNom d’une source ConfigMap émise par l’entrée artifacts de cette Recipe ou par une Feature rattachée.
secretstringnonNom d’un emplacement du featuresSchema — celui du Component lui-même ou, lorsque connection est défini, un emplacement que déclare le socket de cette connexion ; le nom du Secret importé est résolu à partir des provides de l’emplacement.
connectionstringnonAlias d’une connexion que trace le composant — le nom sous lequel elle est écrite dans le bloc uses du composant, sur l’Aggregate ou sur la Release. Lorsqu’il est défini, secret nomme un emplacement que déclare le socket par lequel cette connexion est câblée, et le Secret importé est celui qu’a publié le rattachement que porte cette connexion dans cet emplacement, de sorte qu’un composant qui atteint plusieurs cibles importe le Secret propre à chacune. Significatif uniquement à côté de secret. Une connexion que le composant ne trace pas, ou un emplacement que son socket ne déclare pas, est refusé en nommant les deux.
prefixstringnonPréfixe facultatif ajouté devant chaque nom de variable d’environnement importée.

Les propriétés supplémentaires ne sont pas autorisées.

container.resources

PropriétéTypeObligatoireDescription
requestsresourceListnon
limitsresourceListnon

Les propriétés supplémentaires ne sont pas autorisées.

container.health

Les sondes de santé du conteneur — ready, live et startup — chacune déclarée comme http, tcp ou exec. Traduites en httpGet/tcpSocket/exec de K8s pour helm. Pour compose, un service porte un seul healthcheck : http et tcp deviennent des tests CMD-SHELL, exec devient un test CMD, et lorsque plusieurs sondes sont déclarées, une seule est conservée — un avertissement nomme la sonde traduite et celles qui sont écartées.

PropriétéTypeObligatoireDescription
readyprobenon
liveprobenon
startupprobenon

Les propriétés supplémentaires ne sont pas autorisées.

container.volumeMounts[]

PropriétéTypeObligatoireDescription
namestringouiDoit correspondre à une clé de la map volumes: de premier niveau.
pathstringouiPoint de montage à l’intérieur du conteneur.
subPathstringnonMonte un seul fichier ou un seul sous-répertoire du volume sous path, sans masquer les autres fichiers du répertoire cible.
readonlybooléennonPar défaut : false

Les propriétés supplémentaires ne sont pas autorisées.

container.lifecycle

Hooks de cycle de vie du conteneur. Traduits en container.lifecycle de K8s (postStart/preStop) pour helm. compose n’a pas de primitive de hook de cycle de vie ; une charge de travail qui déclare lifecycle provoque un arrêt explicite sur une cible compose plutôt que d’écarter silencieusement le hook.

PropriétéTypeObligatoireDescription
postStartlifecycleHooknon
preStoplifecycleHooknon

Les propriétés supplémentaires ne sont pas autorisées.

container.securityContext

PropriétéTypeObligatoireDescription
runAsUserintegernon
runAsGroupintegernon
runAsNonRootbooléennon
readOnlyRootFilesystembooléennon
allowPrivilegeEscalationbooléennon
capabilitiesobjectnon

Les propriétés supplémentaires ne sont pas autorisées.

container.securityContext.capabilities
PropriétéTypeObligatoireDescription
addstring[]non
dropstring[]non

Les propriétés supplémentaires ne sont pas autorisées.

containerAttachment

PropriétéTypeObligatoireDescription
fromstringouiNom d’un emplacement déclaré dans le featuresSchema du Component — ou, lorsque connection est défini, d’un emplacement que déclare le socket par lequel cette connexion est câblée.
connectionstringnonAlias d’une connexion que trace le composant — le nom sous lequel elle est écrite dans le bloc uses du composant, sur l’Aggregate ou sur la Release. Lorsqu’il est défini, from nomme un emplacement que déclare le socket par lequel cette connexion est câblée (usesSchema..featuresSchema), et l’entrée livre ce qu’a publié le rattachement que porte cette connexion dans cet emplacement, de sorte qu’un composant qui atteint plusieurs cibles présente à chacune ses propres identifiants. La liste d’autorisation inject: de l’emplacement régit as, exactement comme pour un emplacement que déclare le Component. Une connexion que le composant ne trace pas, ou un emplacement que son socket ne déclare pas, est refusé en nommant les deux.
asstring (enum)ouiMécanisme de livraison. Doit figurer dans la liste d’autorisation du tableau inject: de l’emplacement. Valeurs autorisées : "env", "file"
keystringnonPour as: env, la clé de données précise du secret de l’emplacement référencé que lit cette entrée. Définissez-la lorsque le secret de l’emplacement porte plusieurs clés de données, afin que cette entrée en sélectionne une par son nom ; deux entrées peuvent référencer le même emplacement avec des clés différentes pour lire plusieurs clés d’un même secret. Lorsqu’elle est omise, l’entrée lit l’unique clé publiée de l’emplacement. Ignorée pour as: file, qui monte le secret entier.
pathstringnonChemin du fichier à l’intérieur du conteneur (obligatoire lorsque as: file).

Les propriétés supplémentaires ne sont pas autorisées.

resourceList

PropriétéTypeObligatoireDescription
cpustringnonQuantité de CPU (par ex. ‘100m’, ‘0.5’, ‘2’). helm l’émet telle quelle sous resources.{requests,limits}.cpu. compose l’associe à deploy.resources.{reservations,limits}.cpus en cœurs fractionnaires — une quantité en millicpu est convertie (500m devient 0.5) ; une quantité en cœurs simple passe telle quelle. Une quantité que compose ne peut pas convertir provoque un arrêt explicite plutôt que d’émettre une valeur erronée.
memorystringnonQuantité de mémoire (par ex. ‘128Mi’, ‘1Gi’). helm l’émet telle quelle sous resources.{requests,limits}.memory. compose l’associe à deploy.resources.{reservations,limits}.memory sous forme de nombre exact d’octets. Une quantité qui correspond à un nombre entier d’octets est convertie exactement (1.5Gi devient 1610612736) ; une quantité qui ne l’est pas, ou qui n’est pas une quantité, provoque un arrêt explicite plutôt que d’être arrondie.

Clés supplémentaires : Une quantité de ressource étendue (propre à un fabricant ou à un domaine), indexée par un nom pleinement qualifié ’/’ (par exemple ‘nvidia.com/gpu’: ‘1’, ‘amd.com/gpu’: ‘2’). Le segment de domaine contient au moins un point, ce qui distingue une clé étendue des simples quantités cpu/memory. Le compilateur transmet la quantité telle quelle ; le plugin de périphérique du cluster la résout et l’alloue au moment de l’ordonnancement. helm l’émet sous resources.{requests,limits}.. compose réserve un nombre ‘nvidia.com/gpu’ sous forme de réservation de périphériques NVIDIA sur le service du conteneur — le nombre de la limite là où une limite est écrite, sinon celui de la demande, et aucune réservation pour un nombre égal à 0 — et provoque un arrêt sur un nombre qui n’est pas un nombre entier de périphériques, ou sur une demande et une limite qui demandent des nombres différents. compose n’a d’équivalent pour aucune autre clé étendue et l’omet, en émettant un avertissement une fois par clé étendue distincte et en nommant cette clé, de sorte que l’omission est signalée plutôt que silencieuse. Motif : ^[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])?$.

Aucune autre propriété n’est autorisée.

probe

PropriétéTypeObligatoireDescription
httpstringnonSonde HTTP GET : le chemin est sondé sur le port de conteneur dont le nom arrive en premier dans l’ordre alphabétique.
tcpintegernonSonde de socket TCP sur le numéro de port de conteneur indiqué. Minimum : 1. Maximum : 65535.
execstring[]nonSonde exec — la commande à exécuter à l’intérieur du conteneur. Au moins 1 entrée.
timeoutSecondsintegernonMinimum : 1.
initialDelaySecondsintegernonMinimum : 0.
periodSecondsintegernonMinimum : 1.
failureThresholdintegernonMinimum : 1.
successThresholdintegernonMinimum : 1.

Les propriétés supplémentaires ne sont pas autorisées.

lifecycleHook

PropriétéTypeObligatoireDescription
execstring[]nonAu moins 1 entrée.
httpGetobjectnonLa forme httpGet native de K8s (path, port, scheme, host, httpHeaders). Transmise telle quelle à helm. Sur une cible compose, une charge de travail qui déclare un hook de cycle de vie provoque un arrêt, car compose n’a pas de primitive de hook de cycle de vie — le hook n’est jamais écarté silencieusement.

Les propriétés supplémentaires ne sont pas autorisées.

volume

PropriétéTypeObligatoireDescription
ephemeralobjectnon
configmapobjectnon
secretobjectnon
persistentobjectnon
persistentTemplateobjectnonTemplate de claim par réplica. Requiert form: stateful, car seule la forme stateful donne à chaque réplica l’identité stable dont un claim par réplica a besoin. Sur Kubernetes, il devient StatefulSet.volumeClaimTemplates. Sur une cible compose, il se dégrade en un seul volume nommé partagé par tous les réplicas, et un avertissement signale la dégradation.

Les propriétés supplémentaires ne sont pas autorisées.

volume.ephemeral

PropriétéTypeObligatoireDescription
sizeLimitstringnonQuantité K8s (par ex. ‘1Gi’). K8s : emptyDir.sizeLimit. Compose : le volume devient une entrée tmpfs qui ne porte aucune taille, de sorte que cette valeur n’atteint aucune partie de la sortie — un avertissement la signale lorsqu’elle est rédigée.

Les propriétés supplémentaires ne sont pas autorisées.

volume.configmap

PropriétéTypeObligatoireDescription
sourcestringouiNom de la ConfigMap, émise par cette Recipe via artifacts: ou par une Feature rattachée ; une ConfigMap émise par une autre Recipe n’est pas référencée ici.
itemsobject[]nonSélection facultative de clé vers chemin.

Les propriétés supplémentaires ne sont pas autorisées.

volume.secret

PropriétéTypeObligatoireDescription
sourcestringoui
itemsobject[]non

Les propriétés supplémentaires ne sont pas autorisées.

volume.persistent

PropriétéTypeObligatoireDescription
sizestringouiQuantité K8s (par ex. ‘10Gi’).
classstringnonStorageClassName. Facultatif.
accessModesstring (enum)[]nonModes d’accès du PVC. helm émet spec.accessModes, avec [ReadWriteOnce] par défaut lorsqu’il est omis. Les volumes compose n’ont pas de notion de mode d’accès et l’omettent. Valeurs autorisées pour chaque entrée : "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

Les propriétés supplémentaires ne sont pas autorisées.

volume.persistentTemplate

Template de claim par réplica. Requiert form: stateful, car seule la forme stateful donne à chaque réplica l’identité stable dont un claim par réplica a besoin. Sur Kubernetes, il devient StatefulSet.volumeClaimTemplates. Sur une cible compose, il se dégrade en un seul volume nommé partagé par tous les réplicas, et un avertissement signale la dégradation.

PropriétéTypeObligatoireDescription
sizestringoui
classstringnon
accessModesstring (enum)[]nonModes d’accès du PVC pour le template de claim par réplica. helm émet spec.accessModes, avec [ReadWriteOnce] par défaut lorsqu’il est omis. compose n’a pas de notion de mode d’accès et l’omet. Valeurs autorisées pour chaque entrée : "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

Les propriétés supplémentaires ne sont pas autorisées.

service

PropriétéTypeObligatoireDescription
typestring (enum)ouiType de service : jusqu’où vont les ports de l’entrée. ClusterIP les garde sur le réseau propre à la cible, joignables par les pairs de la charge de travail ; Headless aussi, et sur helm rend un Service K8s avec clusterIP: None ; NodePort et LoadBalancer les publient au-delà de ce réseau ; Loopback les publie uniquement sur l’adresse de loopback propre à l’hôte, joignables depuis la machine sur laquelle s’exécute la charge de travail et de nulle part ailleurs. helm rend ClusterIP, NodePort et LoadBalancer comme le type de Service K8s du même nom, et refuse nommément une entrée Loopback, car un Service K8s n’a aucun type qui se lie à l’adresse de loopback d’un hôte. compose ne publie rien pour ClusterIP et Headless, publie les ports NodePort et LoadBalancer sur chaque interface de l’hôte sous la forme host:container, et publie les ports Loopback sur l’adresse de loopback IPv4 sous la forme 127.0.0.1:host:container ; un port qu’une entrée NodePort ou LoadBalancer publie aussi est publié sur chaque interface. Valeurs autorisées : "ClusterIP", "NodePort", "LoadBalancer", "Headless", "Loopback"
portsmap de integerouiMap nom de port de service → numéro de port de conteneur. Les noms de ports doivent correspondre à des clés de containers..ports. Un port de service ne porte aucun protocole de transport propre : il prend le transport du port de conteneur vers lequel son nom se résout, de sorte que le transport d’un port est déclaré une seule fois, sur le port de conteneur, et l’exposition du service ne peut pas diverger de ce que le conteneur a ouvert.

Les propriétés supplémentaires ne sont pas autorisées.