Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Schema del Workload di Aggrega

Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.

Id dello schema: https://aggrega.ai/schemas/workload-v1beta1.schema.json

Specifica astratta del carico di lavoro, di proprietà della piattaforma. Una Recipe che usa la modalità sintetizzata dichiara esattamente un Workload tramite la parola chiave workload: (scalare a blocco inline oppure workload: { $import: } secondo il vocabolario unificato dell’importazione da file). Il provider di destinazione traduce il Workload in manifest nativi del provider (K8s Deployment/StatefulSet/Services/PVCs per helm; servizi + volumi + reti di compose per compose; ecc.). Un Workload non porta metadati propri — nessun nome, nessuna etichetta, nessuna annotazione. L’identità e le etichette provengono dall’istanza di componente che lo dichiara: il provider di destinazione deriva da quell’istanza il nome di ciascuna risorsa renderizzata e appone sulla risorsa le chiavi di provenienza aggrega.ai/* di quel nodo. Il tipo Workload NON è un’entità del catalogo — questo file pubblicato è il JSON Schema canonico del Workload, e il compilatore convalida un Workload rispetto a esso.

Consulta il riferimento per l’authoring del Workload per una guida in prosa sulla scrittura delle entità Workload; questa pagina documenta lo schema strutturale descritto da quel riferimento.

Tipo di primo livello: object

Proprietà

ProprietàTipoObbligatoriaDescrizione
apiVersionconst “aggrega.ai/v1beta1”sìCostante: "aggrega.ai/v1beta1"
kindconst “Workload”sìCostante: "Workload"
formstring (enum)noIntento astratto sulla forma del controller per il carico di lavoro. Sceglie il tipo di ciclo di vita a runtime che ha il carico di lavoro, indipendentemente da qualsiasi piattaforma di destinazione: stateless (repliche intercambiabili a lunga esecuzione), stateful (repliche con un’identità stabile e uno storage propri di ciascuna replica), daemon (un’istanza per ogni host idoneo), scheduled (esecuzioni ricorrenti attivate in base al tempo), task (una singola esecuzione fino al completamento), reference (un endpoint esterno senza risorse di calcolo — nessun controller; helm emette un Service ExternalName, compose porta l’endpoint attraverso il contratto di iniezione). Un valore vuoto viene trattato come stateless. Ogni provider di destinazione mappa la forma sulla propria forma nativa; la forma di per sé non porta alcun tipo di risorsa nativo della piattaforma. Un volume persistentTemplate è un complemento di stateful ed è valido solo su un carico di lavoro stateful. Un carico di lavoro reference dichiara endpoint (e facoltativamente port) e nessun container, e non porta alcun campo di credenziale proprio, perché il nome della variabile d’ambiente appartiene al consumatore anziché all’endpoint. Un consumatore che ha bisogno di una credenziale per l’endpoint dichiara lo slot nel featuresSchema del proprio Component e lo riempie dal blocco attachments del proprio container, dove la lista inject di quello slot consente la consegna. Valori consentiti: "stateless", "stateful", "daemon", "scheduled", "task", "reference" Predefinito: "stateless"
endpointstringnoEndpoint esterno per form: reference — un host o un URL. Il compilatore lo passa così com’è come stringa puntatore deterministica; non viene mai risolto in fase di compilazione (AOT). Obbligatorio quando form è reference e significativo solo in quel caso. helm lo emette come externalName di un Service ExternalName (la parte host); compose lo porta ai consumatori attraverso i provides della ricetta.
portintegernoPorta opzionale per l’endpoint reference (form: reference). helm la emette come porta sul Service ExternalName. Minimo: 1. Massimo: 65535.
schedulestringnoPianificazione cron per form: scheduled — un’espressione crontab standard a 5 campi (ad esempio ‘0 0 * * *’) oppure una delle macro @hourly, @daily, @weekly, @monthly, @yearly. Obbligatoria quando form è scheduled e significativa solo in quel caso; il provider di destinazione la passa così com’è nel campo schedule della risorsa pianificata.
suspendbooleananoSospende la pianificazione ricorrente di un carico di lavoro form: scheduled. Quando è true, la risorsa pianificata viene renderizzata con la sua pianificazione al suo posto, ma nessuna esecuzione parte da quella pianificazione finché non viene ripresa; un’esecuzione può comunque essere creata a mano dalla risorsa — su Kubernetes, kubectl create job —from=cronjob/. suspend: false viene renderizzato esattamente come un suspend assente. Significativo solo con form: scheduled. helm lo emette come spec.suspend del CronJob. compose non ha una forma pianificata e provoca un arresto su un carico di lavoro form: scheduled, che sia sospeso o no. Predefinito: false
replicasintegernoNumero di repliche. Predefinito 1. Su una destinazione compose il valore non raggiunge alcuna parte dell’output, e un avviso lo segnala ogni volta che viene scritto — incluso un 1 esplicito. Minimo: 0. Predefinito: 1
initContainerscontainer[]noElenco ordinato di container che vengono eseguiti fino al completamento prima che si avviino i container principali.
containersmappa di containernoMappa ordinata da nome del container → specifica del container. È richiesta almeno una voce. L’ordine dell’autore viene preservato. Almeno 1 voce.
volumesmappa di volumenoMappa ordinata da nome del volume → specifica del volume. Ogni specifica di volume dichiara esattamente uno tra: ephemeral, configmap, secret, persistent, persistentTemplate.
servicesmappa di servicenoMappa ordinata da nome del servizio → specifica del servizio. Su helm ogni voce diventa un Service K8s separato, e una voce il cui type è Loopback arresta la build. Su compose non esiste una primitiva di servizio separata, quindi le voci non si mappano una a una: una voce il cui type è NodePort o LoadBalancer pubblica le proprie porte su ogni interfaccia host del servizio compose proprio del carico di lavoro, una voce il cui type è Loopback vi pubblica le proprie porte solo sull’indirizzo di loopback dell’host, una voce il cui type è ClusterIP o Headless non pubblica nulla, e ogni porta pubblicata viene raccolta nell’elenco delle porte di quell’unico servizio, con la porta host uguale alla porta del container. Su helm ogni Service si chiama <name>-<key>: il nome che porta il Deployment (o altro controller) proprio del carico di lavoro, poi un trattino e la chiave della voce, quindi un Workload che dichiara services.http e il cui Deployment si chiama api-server renderizza un Service chiamato api-server-http. Su compose una chiave non nomina nulla nell’output.
schedulingobjectnoVincoli di pianificazione nativi di K8s. Tradotti direttamente per helm. Su una destinazione compose questi vincoli non raggiungono alcuna parte dell’output, e un avviso segnala il blocco quando viene scritto.
podSecurityContextobjectno
serviceAccountstringnoNome del ServiceAccount con cui viene eseguito questo carico di lavoro. L’RBAC effettivo (risorse ServiceAccount/Role/RoleBinding) dovrebbe essere emesso tramite Features o artefatti, non tramite questo campo.
imagePullSecretsstring[]noNomi dei Secret di pull delle immagini per scaricare immagini da registry privati. helm emette pod.imagePullSecrets. compose non ha un analogo all’interno del file — l’autenticazione al registry si configura a parte tramite docker login — e lo omette.
priorityClassNamestringnoNome della PriorityClass che governa la priorità di pianificazione di questo carico di lavoro. helm emette pod.priorityClassName. compose non ha un analogo della priorità di pianificazione su un singolo host e lo omette.
runtimeClassNamestringnoNome della RuntimeClass che seleziona il runtime dei container con cui viene eseguito questo carico di lavoro (ad esempio un runtime abilitato per GPU come ‘nvidia’). Il compilatore passa il nome così com’è; il cluster lo risolve in una RuntimeClass configurata al momento della pianificazione. helm emette pod.runtimeClassName. compose non ha un analogo della classe di runtime e lo omette. Solo con risorse di calcolo: non consentito su un carico di lavoro reference.
terminationGracePeriodSecondsintegernoSecondi tra SIGTERM e SIGKILL all’arresto. helm emette pod.terminationGracePeriodSeconds; compose emette stop_grace_period. Minimo: 0.
dnsPolicystring (enum)noPolicy DNS del pod. helm emette pod.dnsPolicy. compose non ha un analogo della policy DNS e la omette (compose mappa invece direttamente nameservers/searches di dnsConfig). Valori consentiti: "Default", "ClusterFirst", "ClusterFirstWithHostNet", "None"
dnsConfigobjectnoConfigurazione DNS personalizzata del pod. helm emette pod.dnsConfig. compose mappa nameservers su dns e searches su dns_search; options non ha un analogo in compose e lì viene omesso.
hostAliasesobject[]noMappature statiche da hostname a IP inserite nel file hosts del pod. helm emette pod.hostAliases; compose emette extra_hosts (una voce hostname:ip per ogni hostname).
hostNetworkbooleananoEsegue il carico di lavoro nel namespace di rete proprio del nodo host anziché in uno isolato. Le porte che il carico di lavoro apre sono quindi raggiungibili sugli indirizzi propri del nodo, e il carico di lavoro vede le interfacce di rete del nodo. Questo sceglie un namespace di rete e nient’altro: non dichiara alcuna porta, e ogni porta che il carico di lavoro apre resta dichiarata sotto containers..ports. helm emette pod.hostNetwork. compose emette network_mode: host sul servizio proprio del carico di lavoro; un servizio compose in quella modalità non è collegato alla rete del confine, quindi i suoi peer lo raggiungono sugli indirizzi del nodo anziché tramite il nome del servizio, e il servizio di ciascun container di init si unisce alla rete del confine per conto proprio. Solo con risorse di calcolo: non consentito su un carico di lavoro reference.

Non sono consentite proprietà aggiuntive.

workload.scheduling

Vincoli di pianificazione nativi di K8s. Tradotti direttamente per helm. Su una destinazione compose questi vincoli non raggiungono alcuna parte dell’output, e un avviso segnala il blocco quando viene scritto.

ProprietàTipoObbligatoriaDescrizione
nodeSelectormappa di stringno
affinityobjectno
tolerationsobject[]no
topologySpreadConstraintsobject[]no

Non sono consentite proprietà aggiuntive.

workload.podSecurityContext

ProprietàTipoObbligatoriaDescrizione
runAsUserintegerno
runAsGroupintegerno
fsGroupintegerno
supplementalGroupsinteger[]no

Non sono consentite proprietà aggiuntive.

workload.dnsConfig

Configurazione DNS personalizzata del pod. helm emette pod.dnsConfig. compose mappa nameservers su dns e searches su dns_search; options non ha un analogo in compose e lì viene omesso.

ProprietàTipoObbligatoriaDescrizione
nameserversstring[]no
searchesstring[]no
optionsobject[]no

Non sono consentite proprietà aggiuntive.

workload.hostAliases[]

ProprietàTipoObbligatoriaDescrizione
ipstringsì
hostnamesstring[]sì

Non sono consentite proprietà aggiuntive.

Definizioni

container

ProprietàTipoObbligatoriaDescrizione
namestringnoNome opzionale del container. Per una voce posizionale di initContainers imposta il nome del container emesso, ricadendo su un nome generato init- (la posizione della voce nell’elenco) quando è omesso. Per una voce della mappa containers la chiave della mappa è il nome del container e questo campo viene ignorato.
imagestringsìRiferimento all’immagine del container (ad es. ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’).
imagePullPolicystring (enum)noPolicy di pull dell’immagine. helm la emette come container.imagePullPolicy. compose la mappa sul pull_policy del servizio (Always su always, Never su never, IfNotPresent su if_not_present). Valori consentiti: "Always", "Never", "IfNotPresent"
commandstring[]noSostituisce l’entrypoint dell’immagine. K8s: .command. Compose: entrypoint.
argsstring[]noArgomenti passati a command (o all’entrypoint dell’immagine se command è assente). K8s: .args. Compose: command.
variablesmappa di stringnoVariabili d’ambiente come coppie chiave-valore di stringhe. K8s: spec.template.spec.containers[].env[]. Compose: services..environment.
attachmentsmappa di containerAttachmentnoMappa ordinata da nome di env o di file → { from, as, key?, path?, connection? }. Ogni voce fa riferimento a uno slot dichiarato nel featuresSchema del Component — oppure, quando la voce nomina una connessione, a uno slot dichiarato dal socket di quella connessione — e consegna ciò che ha pubblicato l’associazione che riempie quello slot. Il campo ‘as’ seleziona il meccanismo di consegna, che deve essere nella allowlist dell’array inject: dello slot. Gli slot blackbox (inject: []) NON POSSONO comparire qui.
envFromobject[]noAmbiente in blocco importato da una sorgente ConfigMap o Secret. helm emette container.envFrom (configMapRef/secretRef). compose non ha una primitiva env-from-object — un riferimento a una sorgente non è un file dell’host, quindi reinterpretarlo come env_file cambierebbe silenziosamente il significato; un carico di lavoro che dichiara envFrom provoca un arresto esplicito su una destinazione compose.
portsmappa di integer o objectnoPorte del container con nome. Una porta si scrive come semplice numero di porta (web: 8080) oppure come oggetto che porta il numero insieme al protocollo di trasporto che la porta trasporta (dns: { port: 53, protocol: UDP }); dove non è dichiarato alcun protocollo le due forme significano la stessa cosa. I valori di protocollo consentiti sono TCP, UDP e SCTP, e omettere la chiave lascia in vigore il valore predefinito proprio della destinazione. I nomi delle porte sono referenziati da services.*.ports e dalla risoluzione della porta di una probe http, e una porta di servizio prende il trasporto dalla porta del container in cui si risolve il suo nome, quindi il trasporto si dichiara una sola volta. K8s: containerPort, con protocol solo dove ne è dichiarato uno. Compose: una porta del container raggiunge l’output solo dove una specifica di servizio la pubblica; la porta del container in sé non ha un campo compose separato, e una porta pubblicata porta un trasporto dichiarato come suffisso /protocol sulla voce pubblicata — un trasporto che compose non sa esprimere arresta la build anziché pubblicare una porta che ne porterebbe uno diverso.
resourcesobjectno
healthobjectnoLe probe di salute del container — ready, live e startup — ciascuna dichiarata come http, tcp o exec. Tradotte in httpGet/tcpSocket/exec di K8s per helm. Per compose, un servizio porta un unico healthcheck: http e tcp diventano test CMD-SHELL, exec diventa un test CMD, e dove è dichiarata più di una probe ne viene mantenuta una sola — un avviso nomina la probe tradotta e quelle scartate.
volumeMountsobject[]no
restartPolicystring (enum)noValori consentiti: "Always", "OnFailure", "Never"
lifecycleobjectnoHook del ciclo di vita del container. Tradotti in container.lifecycle di K8s (postStart/preStop) per helm. compose non ha una primitiva di hook del ciclo di vita; un carico di lavoro che dichiara lifecycle provoca un arresto esplicito su una destinazione compose anziché scartare silenziosamente l’hook.
securityContextobjectno

Non sono consentite proprietà aggiuntive.

container.envFrom[]

ProprietàTipoObbligatoriaDescrizione
configMapstringnoNome di una sorgente ConfigMap emessa dall’input artifacts di questa Recipe o da una Feature associata.
secretstringnoNome di uno slot del featuresSchema — quello proprio del Component oppure, quando connection è impostato, uno slot dichiarato dal socket di quella connessione; il nome del Secret importato viene risolto dai provides dello slot.
connectionstringnoAlias di una connessione che il componente traccia — il nome con cui è scritta nel blocco uses del componente, sull’Aggregate o sulla Release. Quando è impostato, secret nomina uno slot dichiarato dal socket attraverso cui quella connessione è collegata, e il Secret importato è quello pubblicato dall’associazione che quella connessione porta in quello slot, così un componente che raggiunge più destinazioni importa il Secret proprio di ciascuna. Significativo solo accanto a secret. Una connessione che il componente non traccia, o uno slot che il suo socket non dichiara, viene rifiutato nominando entrambi.
prefixstringnoPrefisso opzionale anteposto al nome di ogni variabile d’ambiente importata.

Non sono consentite proprietà aggiuntive.

container.resources

ProprietàTipoObbligatoriaDescrizione
requestsresourceListno
limitsresourceListno

Non sono consentite proprietà aggiuntive.

container.health

Le probe di salute del container — ready, live e startup — ciascuna dichiarata come http, tcp o exec. Tradotte in httpGet/tcpSocket/exec di K8s per helm. Per compose, un servizio porta un unico healthcheck: http e tcp diventano test CMD-SHELL, exec diventa un test CMD, e dove è dichiarata più di una probe ne viene mantenuta una sola — un avviso nomina la probe tradotta e quelle scartate.

ProprietàTipoObbligatoriaDescrizione
readyprobeno
liveprobeno
startupprobeno

Non sono consentite proprietà aggiuntive.

container.volumeMounts[]

ProprietàTipoObbligatoriaDescrizione
namestringsìDeve corrispondere a una chiave della mappa volumes: di primo livello.
pathstringsìPunto di montaggio all’interno del container.
subPathstringnoMonta un singolo file o una singola sottodirectory dal volume in path, senza mascherare gli altri file nella directory di destinazione.
readonlybooleananoPredefinito: false

Non sono consentite proprietà aggiuntive.

container.lifecycle

Hook del ciclo di vita del container. Tradotti in container.lifecycle di K8s (postStart/preStop) per helm. compose non ha una primitiva di hook del ciclo di vita; un carico di lavoro che dichiara lifecycle provoca un arresto esplicito su una destinazione compose anziché scartare silenziosamente l’hook.

ProprietàTipoObbligatoriaDescrizione
postStartlifecycleHookno
preStoplifecycleHookno

Non sono consentite proprietà aggiuntive.

container.securityContext

ProprietàTipoObbligatoriaDescrizione
runAsUserintegerno
runAsGroupintegerno
runAsNonRootbooleanano
readOnlyRootFilesystembooleanano
allowPrivilegeEscalationbooleanano
capabilitiesobjectno

Non sono consentite proprietà aggiuntive.

container.securityContext.capabilities
ProprietàTipoObbligatoriaDescrizione
addstring[]no
dropstring[]no

Non sono consentite proprietà aggiuntive.

containerAttachment

ProprietàTipoObbligatoriaDescrizione
fromstringsìNome di uno slot dichiarato nel featuresSchema del Component — oppure, quando connection è impostato, di uno slot dichiarato dal socket attraverso cui quella connessione è collegata.
connectionstringnoAlias di una connessione che il componente traccia — il nome con cui è scritta nel blocco uses del componente, sull’Aggregate o sulla Release. Quando è impostato, from nomina uno slot dichiarato dal socket attraverso cui quella connessione è collegata (usesSchema..featuresSchema), e la voce consegna ciò che ha pubblicato l’associazione che quella connessione porta in quello slot, così un componente che raggiunge più destinazioni presenta a ciascuna la propria credenziale. La allowlist inject: dello slot governa as, esattamente come per uno slot dichiarato dal Component. Una connessione che il componente non traccia, o uno slot che il suo socket non dichiara, viene rifiutato nominando entrambi.
asstring (enum)sìMeccanismo di consegna. Deve essere nella allowlist dell’array inject: dello slot. Valori consentiti: "env", "file"
keystringnoPer as: env, la specifica chiave di dati del secret dello slot referenziato che questa voce legge. Impostala quando il secret dello slot porta più chiavi di dati, così questa voce ne seleziona una per nome; due voci possono fare riferimento allo stesso slot con chiavi diverse per leggere più chiavi da un unico secret. Se omessa, la voce legge l’unica chiave pubblicata dello slot. Ignorata per as: file, che monta l’intero secret.
pathstringnoPercorso del file all’interno del container (obbligatorio quando as: file).

Non sono consentite proprietà aggiuntive.

resourceList

ProprietàTipoObbligatoriaDescrizione
cpustringnoQuantità di CPU (ad es. ‘100m’, ‘0.5’, ‘2’). helm la emette così com’è sotto resources.{requests,limits}.cpu. compose la mappa su deploy.resources.{reservations,limits}.cpus come core frazionari — una quantità in millicpu viene convertita (500m diventa 0.5); una quantità in core semplici passa invariata. Una quantità che compose non può convertire provoca un arresto esplicito anziché emettere un valore errato.
memorystringnoQuantità di memoria (ad es. ‘128Mi’, ‘1Gi’). helm la emette così com’è sotto resources.{requests,limits}.memory. compose la mappa su deploy.resources.{reservations,limits}.memory come conteggio esatto di byte. Una quantità che corrisponde a un numero intero di byte viene convertita esattamente (1.5Gi diventa 1610612736); una che non lo fa, o che non è una quantità, provoca un arresto esplicito anziché arrotondare.

Chiavi aggiuntive: Una quantità di risorsa estesa (con ambito di produttore/dominio), indicizzata da un nome completamente qualificato ’/’ (ad esempio ‘nvidia.com/gpu’: ‘1’, ‘amd.com/gpu’: ‘2’). Il segmento di dominio contiene almeno un punto, il che distingue una chiave estesa dalle semplici quantità cpu/memory. Il compilatore passa la quantità così com’è; il device plugin del cluster la risolve e la alloca al momento della pianificazione. helm la emette sotto resources.{requests,limits}.. compose riserva un conteggio ‘nvidia.com/gpu’ come prenotazione di dispositivi NVIDIA sul servizio del container — il conteggio del limite dove è scritto un limite, altrimenti quello della richiesta, e nessuna prenotazione per un conteggio pari a 0 — e provoca un arresto su un conteggio che non è un numero intero di dispositivi, oppure su una richiesta e un limite che chiedono conteggi diversi. compose non ha un analogo per nessun’altra chiave estesa e la omette, emettendo un avviso una volta per ogni chiave estesa distinta e nominando quella chiave, così l’omissione viene segnalata anziché restare silenziosa. Pattern: ^[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])?$.

Nessun’altra proprietà è consentita.

probe

ProprietàTipoObbligatoriaDescrizione
httpstringnoProbe HTTP GET: il percorso viene verificato sulla porta del container il cui nome viene per primo in ordine alfabetico.
tcpintegernoProbe di socket TCP sul numero di porta del container indicato. Minimo: 1. Massimo: 65535.
execstring[]noProbe exec — il comando da eseguire all’interno del container. Almeno 1 voce.
timeoutSecondsintegernoMinimo: 1.
initialDelaySecondsintegernoMinimo: 0.
periodSecondsintegernoMinimo: 1.
failureThresholdintegernoMinimo: 1.
successThresholdintegernoMinimo: 1.

Non sono consentite proprietà aggiuntive.

lifecycleHook

ProprietàTipoObbligatoriaDescrizione
execstring[]noAlmeno 1 voce.
httpGetobjectnoLa forma httpGet nativa di K8s (path, port, scheme, host, httpHeaders). Passata così com’è a helm. Su una destinazione compose un carico di lavoro che dichiara un hook del ciclo di vita provoca un arresto, perché compose non ha una primitiva di hook del ciclo di vita — l’hook non viene mai scartato silenziosamente.

Non sono consentite proprietà aggiuntive.

volume

ProprietàTipoObbligatoriaDescrizione
ephemeralobjectno
configmapobjectno
secretobjectno
persistentobjectno
persistentTemplateobjectnoTemplate di claim per replica. Richiede form: stateful, perché solo la forma stateful dà a ciascuna replica l’identità stabile di cui ha bisogno un claim per replica. Su Kubernetes diventa StatefulSet.volumeClaimTemplates. Su una destinazione compose si degrada in un unico volume con nome condiviso da tutte le repliche, e un avviso segnala il degrado.

Non sono consentite proprietà aggiuntive.

volume.ephemeral

ProprietàTipoObbligatoriaDescrizione
sizeLimitstringnoQuantità K8s (ad es. ‘1Gi’). K8s: emptyDir.sizeLimit. Compose: il volume diventa una voce tmpfs che non porta alcuna dimensione, quindi questo valore non raggiunge alcuna parte dell’output — un avviso lo segnala quando viene scritto.

Non sono consentite proprietà aggiuntive.

volume.configmap

ProprietàTipoObbligatoriaDescrizione
sourcestringsìNome della ConfigMap, emessa da questa Recipe tramite artifacts: o da una Feature associata; una ConfigMap emessa da un’altra Recipe non viene referenziata qui.
itemsobject[]noSelezione opzionale da chiave a percorso.

Non sono consentite proprietà aggiuntive.

volume.secret

ProprietàTipoObbligatoriaDescrizione
sourcestringsì
itemsobject[]no

Non sono consentite proprietà aggiuntive.

volume.persistent

ProprietàTipoObbligatoriaDescrizione
sizestringsìQuantità K8s (ad es. ‘10Gi’).
classstringnoStorageClassName. Opzionale.
accessModesstring (enum)[]noModalità di accesso del PVC. helm emette spec.accessModes, con [ReadWriteOnce] come valore predefinito quando è omesso. I volumi compose non hanno il concetto di modalità di accesso e lo omettono. Valori consentiti per ogni voce: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

Non sono consentite proprietà aggiuntive.

volume.persistentTemplate

Template di claim per replica. Richiede form: stateful, perché solo la forma stateful dà a ciascuna replica l’identità stabile di cui ha bisogno un claim per replica. Su Kubernetes diventa StatefulSet.volumeClaimTemplates. Su una destinazione compose si degrada in un unico volume con nome condiviso da tutte le repliche, e un avviso segnala il degrado.

ProprietàTipoObbligatoriaDescrizione
sizestringsì
classstringno
accessModesstring (enum)[]noModalità di accesso del PVC per il template di claim per replica. helm emette spec.accessModes, con [ReadWriteOnce] come valore predefinito quando è omesso. compose non ha il concetto di modalità di accesso e lo omette. Valori consentiti per ogni voce: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

Non sono consentite proprietà aggiuntive.

service

ProprietàTipoObbligatoriaDescrizione
typestring (enum)sìTipo di servizio: fin dove arrivano le porte della voce. ClusterIP le mantiene sulla rete propria della destinazione, raggiungibili dai peer del carico di lavoro; Headless fa lo stesso, e su helm renderizza un Service K8s con clusterIP: None; NodePort e LoadBalancer le pubblicano oltre quella rete; Loopback le pubblica solo sull’indirizzo di loopback proprio dell’host, raggiungibili dalla macchina su cui gira il carico di lavoro e da nessun’altra parte. helm renderizza ClusterIP, NodePort e LoadBalancer come il tipo di Service K8s con lo stesso nome, e rifiuta per nome una voce Loopback, perché un Service K8s non ha alcun tipo che si leghi all’indirizzo di loopback di un host. compose non pubblica nulla per ClusterIP e Headless, pubblica le porte NodePort e LoadBalancer su ogni interfaccia host come host:container, e pubblica le porte Loopback sull’indirizzo di loopback IPv4 come 127.0.0.1:host:container; una porta pubblicata anche da una voce NodePort o LoadBalancer viene pubblicata su ogni interfaccia. Valori consentiti: "ClusterIP", "NodePort", "LoadBalancer", "Headless", "Loopback"
portsmappa di integersìMappa da nome della porta del servizio → numero di porta del container. I nomi delle porte devono corrispondere alle chiavi in containers..ports. Una porta di servizio non porta alcun protocollo di trasporto proprio: prende il trasporto della porta del container in cui si risolve il suo nome, quindi il trasporto di una porta si dichiara una sola volta, sulla porta del container, e l’esposizione del servizio non può discordare da ciò che il container ha aperto.

Non sono consentite proprietà aggiuntive.