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:
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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sì | Costante: "aggrega.ai/v1beta1" |
kind | const “Workload” | sì | Costante: "Workload" |
form | string (enum) | no | Intento 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" |
endpoint | string | no | Endpoint 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. |
port | integer | no | Porta opzionale per l’endpoint reference (form: reference). helm la emette come porta sul Service ExternalName. Minimo: 1. Massimo: 65535. |
schedule | string | no | Pianificazione 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. |
suspend | booleana | no | Sospende 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 false |
replicas | integer | no | Numero 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 |
initContainers | container[] | no | Elenco ordinato di container che vengono eseguiti fino al completamento prima che si avviino i container principali. |
containers | mappa di container | no | Mappa ordinata da nome del container → specifica del container. È richiesta almeno una voce. L’ordine dell’autore viene preservato. Almeno 1 voce. |
volumes | mappa di volume | no | Mappa ordinata da nome del volume → specifica del volume. Ogni specifica di volume dichiara esattamente uno tra: ephemeral, configmap, secret, persistent, persistentTemplate. |
services | mappa di service | no | Mappa 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. |
scheduling | object | no | 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. |
podSecurityContext | object | no | |
serviceAccount | string | no | Nome 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. |
imagePullSecrets | string[] | no | Nomi 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. |
priorityClassName | string | no | Nome 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. |
runtimeClassName | string | no | Nome 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. |
terminationGracePeriodSeconds | integer | no | Secondi tra SIGTERM e SIGKILL all’arresto. helm emette pod.terminationGracePeriodSeconds; compose emette stop_grace_period. Minimo: 0. |
dnsPolicy | string (enum) | no | Policy 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" |
dnsConfig | object | no | 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. |
hostAliases | object[] | no | Mappature 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). |
hostNetwork | booleana | no | Esegue 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. |
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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
nodeSelector | mappa di string | no | |
affinity | object | no | |
tolerations | object[] | no | |
topologySpreadConstraints | object[] | no |
Non sono consentite proprietà aggiuntive.
workload.podSecurityContext
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
runAsUser | integer | no | |
runAsGroup | integer | no | |
fsGroup | integer | no | |
supplementalGroups | integer[] | 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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
nameservers | string[] | no | |
searches | string[] | no | |
options | object[] | no |
Non sono consentite proprietà aggiuntive.
workload.hostAliases[]
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
ip | string | sì | |
hostnames | string[] | sì |
Non sono consentite proprietà aggiuntive.
Definizioni
container
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | no | Nome opzionale del container. Per una voce posizionale di initContainers imposta il nome del container emesso, ricadendo su un nome generato init- |
image | string | sì | Riferimento all’immagine del container (ad es. ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’). |
imagePullPolicy | string (enum) | no | Policy 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" |
command | string[] | no | Sostituisce l’entrypoint dell’immagine. K8s: .command. Compose: entrypoint. |
args | string[] | no | Argomenti passati a command (o all’entrypoint dell’immagine se command è assente). K8s: .args. Compose: command. |
variables | mappa di string | no | Variabili d’ambiente come coppie chiave-valore di stringhe. K8s: spec.template.spec.containers[].env[]. Compose: services. |
attachments | mappa di containerAttachment | no | Mappa 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. |
envFrom | object[] | no | Ambiente 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. |
ports | mappa di integer o object | no | Porte 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. |
resources | object | no | |
health | object | no | 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. |
volumeMounts | object[] | no | |
restartPolicy | string (enum) | no | Valori consentiti: "Always", "OnFailure", "Never" |
lifecycle | object | no | 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. |
securityContext | object | no |
Non sono consentite proprietà aggiuntive.
container.envFrom[]
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
configMap | string | no | Nome di una sorgente ConfigMap emessa dall’input artifacts di questa Recipe o da una Feature associata. |
secret | string | no | Nome 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. |
connection | string | no | Alias 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. |
prefix | string | no | Prefisso opzionale anteposto al nome di ogni variabile d’ambiente importata. |
Non sono consentite proprietà aggiuntive.
container.resources
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
requests | resourceList | no | |
limits | resourceList | no |
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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
ready | probe | no | |
live | probe | no | |
startup | probe | no |
Non sono consentite proprietà aggiuntive.
container.volumeMounts[]
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | sì | Deve corrispondere a una chiave della mappa volumes: di primo livello. |
path | string | sì | Punto di montaggio all’interno del container. |
subPath | string | no | Monta un singolo file o una singola sottodirectory dal volume in path, senza mascherare gli altri file nella directory di destinazione. |
readonly | booleana | no | Predefinito: 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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
postStart | lifecycleHook | no | |
preStop | lifecycleHook | no |
Non sono consentite proprietà aggiuntive.
container.securityContext
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
runAsUser | integer | no | |
runAsGroup | integer | no | |
runAsNonRoot | booleana | no | |
readOnlyRootFilesystem | booleana | no | |
allowPrivilegeEscalation | booleana | no | |
capabilities | object | no |
Non sono consentite proprietà aggiuntive.
container.securityContext.capabilities
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
add | string[] | no | |
drop | string[] | no |
Non sono consentite proprietà aggiuntive.
containerAttachment
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
from | string | sì | Nome di uno slot dichiarato nel featuresSchema del Component — oppure, quando connection è impostato, di uno slot dichiarato dal socket attraverso cui quella connessione è collegata. |
connection | string | no | Alias 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. |
as | string (enum) | sì | Meccanismo di consegna. Deve essere nella allowlist dell’array inject: dello slot. Valori consentiti: "env", "file" |
key | string | no | Per 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. |
path | string | no | Percorso del file all’interno del container (obbligatorio quando as: file). |
Non sono consentite proprietà aggiuntive.
resourceList
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
cpu | string | no | Quantità 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. |
memory | string | no | Quantità 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 ’^[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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
http | string | no | Probe HTTP GET: il percorso viene verificato sulla porta del container il cui nome viene per primo in ordine alfabetico. |
tcp | integer | no | Probe di socket TCP sul numero di porta del container indicato. Minimo: 1. Massimo: 65535. |
exec | string[] | no | Probe exec — il comando da eseguire all’interno del container. Almeno 1 voce. |
timeoutSeconds | integer | no | Minimo: 1. |
initialDelaySeconds | integer | no | Minimo: 0. |
periodSeconds | integer | no | Minimo: 1. |
failureThreshold | integer | no | Minimo: 1. |
successThreshold | integer | no | Minimo: 1. |
Non sono consentite proprietà aggiuntive.
lifecycleHook
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
exec | string[] | no | Almeno 1 voce. |
httpGet | object | no | La 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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
ephemeral | object | no | |
configmap | object | no | |
secret | object | no | |
persistent | object | no | |
persistentTemplate | object | no | 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. |
Non sono consentite proprietà aggiuntive.
volume.ephemeral
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
sizeLimit | string | no | Quantità 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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
source | string | sì | 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. |
items | object[] | no | Selezione opzionale da chiave a percorso. |
Non sono consentite proprietà aggiuntive.
volume.secret
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
source | string | sì | |
items | object[] | no |
Non sono consentite proprietà aggiuntive.
volume.persistent
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
size | string | sì | Quantità K8s (ad es. ‘10Gi’). |
class | string | no | StorageClassName. Opzionale. |
accessModes | string (enum)[] | no | Modalità 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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
size | string | sì | |
class | string | no | |
accessModes | string (enum)[] | no | Modalità 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à | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
type | string (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" |
ports | mappa di integer | sì | Mappa da nome della porta del servizio → numero di porta del container. I nomi delle porte devono corrispondere alle chiavi in containers. |
Non sono consentite proprietà aggiuntive.