Esquema do Workload do Aggrega
Referência gerada. Não edite à mão — gere novamente a partir do JSON Schema publicado.
ID do esquema: https://aggrega.ai/schemas/workload-v1beta1.schema.json
Especificação abstrata de carga de trabalho, de propriedade da plataforma. Uma Recipe que usa o modo sintetizado declara exatamente um Workload por meio da palavra-chave workload: (escalar de bloco inline ou workload: { $import:
Consulte a referência de autoria do Workload para orientações em prosa sobre como escrever entidades Workload; esta página documenta o esquema estrutural que essa referência descreve.
Tipo de nível superior: object
Propriedades
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sim | Constante: "aggrega.ai/v1beta1" |
kind | const “Workload” | sim | Constante: "Workload" |
form | string (enum) | não | Intenção abstrata sobre o formato do controlador para a carga de trabalho. Escolhe o tipo de ciclo de vida em tempo de execução que a carga de trabalho tem, independentemente de qualquer plataforma de destino: stateless (réplicas intercambiáveis de longa duração), stateful (réplicas com identidade estável e armazenamento próprios de cada réplica), daemon (uma instância por host elegível), scheduled (execuções recorrentes acionadas por tempo), task (uma única execução até a conclusão), reference (um endpoint externo sem computação — nenhum controlador; o helm emite um Service ExternalName, o compose carrega o endpoint pelo contrato de injeção). Um valor vazio é tratado como stateless. Cada provedor de destino mapeia a forma para o seu próprio formato nativo; a forma em si não carrega nenhum tipo de recurso nativo da plataforma. Um volume persistentTemplate é um complemento de stateful e só é válido em uma carga de trabalho stateful. Uma carga de trabalho reference declara endpoint (e opcionalmente port) e nenhum contêiner, e não carrega nenhum campo de credencial próprio, porque o nome da variável de ambiente pertence ao consumidor e não ao endpoint. Um consumidor que precisa de uma credencial para o endpoint declara o slot no featuresSchema do seu próprio Component e o preenche a partir do bloco attachments do seu contêiner, onde a lista inject desse slot permite a entrega. Valores permitidos: "stateless", "stateful", "daemon", "scheduled", "task", "reference" Valor padrão: "stateless" |
endpoint | string | não | Endpoint externo para form: reference — um host ou uma URL. O compilador o repassa como uma string de ponteiro determinística; ele nunca é resolvido em tempo de compilação (AOT). Obrigatório quando form é reference e significativo apenas nesse caso. O helm o emite como o externalName de um Service ExternalName (a parte do host); o compose o leva aos consumidores pelos provides da receita. |
port | integer | não | Porta opcional para o endpoint reference (form: reference). O helm a emite como uma porta no Service ExternalName. Mínimo: 1. Máximo: 65535. |
schedule | string | não | Agendamento cron para form: scheduled — uma expressão crontab padrão de 5 campos (por exemplo ‘0 0 * * *’) ou uma das macros @hourly, @daily, @weekly, @monthly, @yearly. Obrigatório quando form é scheduled e significativo apenas nesse caso; o provedor de destino o repassa sem alterações para o campo schedule do recurso agendado. |
suspend | booleano | não | Suspende o agendamento recorrente de uma carga de trabalho form: scheduled. Quando é true, o recurso agendado é renderizado com o seu agendamento no lugar, mas nenhuma execução começa a partir desse agendamento até que ele seja retomado; ainda é possível criar uma execução à mão a partir do recurso — no Kubernetes, kubectl create job false |
replicas | integer | não | Número de réplicas. Valor padrão 1. Em um destino compose o valor não chega a nenhuma parte da saída, e um aviso o informa sempre que ele é escrito — inclusive um 1 explícito. Mínimo: 0. Valor padrão: 1 |
initContainers | container[] | não | Lista ordenada de contêineres que são executados até a conclusão antes que os contêineres principais iniciem. |
containers | mapa de container | não | Mapa ordenado de nome do contêiner → especificação do contêiner. Pelo menos uma entrada é obrigatória. A ordem do autor é preservada. Pelo menos 1 entrada. |
volumes | mapa de volume | não | Mapa ordenado de nome do volume → especificação do volume. Cada especificação de volume declara exatamente um entre: ephemeral, configmap, secret, persistent, persistentTemplate. |
services | mapa de service | não | Mapa ordenado de nome do serviço → especificação do serviço. No helm cada entrada se torna um Service do K8s separado, e uma entrada cujo type é Loopback interrompe o build. No compose não existe uma primitiva de serviço separada, então as entradas não se mapeiam uma a uma: uma entrada cujo type é NodePort ou LoadBalancer publica suas portas em todas as interfaces do host do serviço do compose próprio da carga de trabalho, uma entrada cujo type é Loopback publica ali suas portas apenas no endereço de loopback do host, uma entrada cujo type é ClusterIP ou Headless não publica nada, e cada porta publicada é reunida na lista de portas desse único serviço, com a porta do host igual à porta do contêiner. No helm cada Service se chama <name>-<key>: o nome que o Deployment (ou outro controlador) próprio da carga de trabalho carrega, depois um hífen e a chave da entrada, de modo que um Workload que declara services.http e cujo Deployment se chama api-server renderiza um Service chamado api-server-http. No compose uma chave não nomeia nada na saída. |
scheduling | object | não | Restrições de agendamento nativas do K8s. Traduzidas diretamente para o helm. Em um destino compose essas restrições não chegam a nenhuma parte da saída, e um aviso informa o bloco quando ele é escrito. |
podSecurityContext | object | não | |
serviceAccount | string | não | Nome da ServiceAccount sob a qual esta carga de trabalho é executada. O RBAC efetivo (recursos ServiceAccount/Role/RoleBinding) deve ser emitido por meio de Features ou artefatos, não por meio deste campo. |
imagePullSecrets | string[] | não | Nomes dos Secrets de pull de imagens para baixar imagens de registros privados. O helm emite pod.imagePullSecrets. O compose não tem um equivalente dentro do arquivo — a autenticação no registro é configurada à parte via docker login — e o omite. |
priorityClassName | string | não | Nome da PriorityClass que rege a prioridade de agendamento desta carga de trabalho. O helm emite pod.priorityClassName. O compose não tem um equivalente de prioridade de agendamento em um único host e o omite. |
runtimeClassName | string | não | Nome da RuntimeClass que seleciona o runtime de contêineres sob o qual esta carga de trabalho é executada (por exemplo, um runtime com GPU como ‘nvidia’). O compilador repassa o nome sem alterações; o cluster o resolve para uma RuntimeClass configurada no momento do agendamento. O helm emite pod.runtimeClassName. O compose não tem um equivalente de classe de runtime e o omite. Somente para computação: não permitido em uma carga de trabalho reference. |
terminationGracePeriodSeconds | integer | não | Segundos entre SIGTERM e SIGKILL no desligamento. O helm emite pod.terminationGracePeriodSeconds; o compose emite stop_grace_period. Mínimo: 0. |
dnsPolicy | string (enum) | não | Política de DNS do pod. O helm emite pod.dnsPolicy. O compose não tem um equivalente de política de DNS e a omite (em vez disso, o compose mapeia diretamente nameservers/searches de dnsConfig). Valores permitidos: "Default", "ClusterFirst", "ClusterFirstWithHostNet", "None" |
dnsConfig | object | não | Configuração de DNS personalizada do pod. O helm emite pod.dnsConfig. O compose mapeia nameservers para dns e searches para dns_search; options não tem equivalente no compose e é omitido ali. |
hostAliases | object[] | não | Mapeamentos estáticos de nome de host para IP injetados no arquivo hosts do pod. O helm emite pod.hostAliases; o compose emite extra_hosts (uma entrada hostname:ip por nome de host). |
hostNetwork | booleano | não | Executa a carga de trabalho no namespace de rede próprio do nó host em vez de em um isolado. As portas que a carga de trabalho abre ficam então acessíveis nos endereços próprios do nó, e a carga de trabalho vê as interfaces de rede do nó. Isso escolhe um namespace de rede e nada mais: não declara nenhuma porta, e cada porta que a carga de trabalho abre continua declarada em containers. |
Não são permitidas propriedades adicionais.
workload.scheduling
Restrições de agendamento nativas do K8s. Traduzidas diretamente para o helm. Em um destino compose essas restrições não chegam a nenhuma parte da saída, e um aviso informa o bloco quando ele é escrito.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
nodeSelector | mapa de string | não | |
affinity | object | não | |
tolerations | object[] | não | |
topologySpreadConstraints | object[] | não |
Não são permitidas propriedades adicionais.
workload.podSecurityContext
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
runAsUser | integer | não | |
runAsGroup | integer | não | |
fsGroup | integer | não | |
supplementalGroups | integer[] | não |
Não são permitidas propriedades adicionais.
workload.dnsConfig
Configuração de DNS personalizada do pod. O helm emite pod.dnsConfig. O compose mapeia nameservers para dns e searches para dns_search; options não tem equivalente no compose e é omitido ali.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
nameservers | string[] | não | |
searches | string[] | não | |
options | object[] | não |
Não são permitidas propriedades adicionais.
workload.hostAliases[]
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
ip | string | sim | |
hostnames | string[] | sim |
Não são permitidas propriedades adicionais.
Definições
container
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | não | Nome opcional do contêiner. Para uma entrada posicional de initContainers, define o nome do contêiner emitido e, quando omitido, recorre a um nome gerado init- |
image | string | sim | Referência à imagem do contêiner (por exemplo, ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’). |
imagePullPolicy | string (enum) | não | Política de pull da imagem. O helm a emite como container.imagePullPolicy. O compose a mapeia para o pull_policy do serviço (Always para always, Never para never, IfNotPresent para if_not_present). Valores permitidos: "Always", "Never", "IfNotPresent" |
command | string[] | não | Substitui o entrypoint da imagem. K8s: .command. Compose: entrypoint. |
args | string[] | não | Argumentos passados para command (ou para o entrypoint da imagem se command estiver ausente). K8s: .args. Compose: command. |
variables | mapa de string | não | Variáveis de ambiente como pares chave-valor de strings. K8s: spec.template.spec.containers[].env[]. Compose: services. |
attachments | mapa de containerAttachment | não | Mapa ordenado de nome de env ou de arquivo → { from, as, key?, path?, connection? }. Cada entrada referencia um slot declarado no featuresSchema do Component — ou, quando a entrada nomeia uma conexão, um slot que o socket dessa conexão declara — e entrega o que a vinculação que preenche esse slot publicou. O campo ‘as’ seleciona o mecanismo de entrega, que precisa estar na lista de permissões do array inject: do slot. Slots blackbox (inject: []) NÃO PODEM aparecer aqui. |
envFrom | object[] | não | Ambiente em bloco importado de uma origem ConfigMap ou Secret. O helm emite container.envFrom (configMapRef/secretRef). O compose não tem uma primitiva env-from-object — uma referência de origem não é um arquivo do host, então reinterpretá-la como env_file mudaria o significado silenciosamente; uma carga de trabalho que declara envFrom interrompe o build de forma explícita em um destino compose. |
ports | mapa de integer ou object | não | Portas do contêiner com nome. Uma porta é escrita como o número de porta simples (web: 8080) ou como um objeto que carrega o número junto com o protocolo de transporte que a porta usa (dns: { port: 53, protocol: UDP }); onde nenhum protocolo é declarado, as duas formas significam a mesma coisa. Os valores de protocolo permitidos são TCP, UDP e SCTP, e omitir a chave mantém em vigor o padrão próprio do destino. Os nomes de porta são referenciados por services.*.ports e pela resolução da porta de uma sonda http, e uma porta de serviço obtém seu transporte da porta do contêiner para a qual seu nome é resolvido, de modo que o transporte é declarado uma única vez. K8s: containerPort, carregando protocol apenas onde um é declarado. Compose: uma porta do contêiner chega à saída apenas onde uma especificação de serviço a publica; a porta do contêiner em si não tem um campo do compose separado, e uma porta publicada carrega um transporte declarado como o sufixo /protocol na entrada publicada — um transporte que o compose não consegue expressar interrompe o build em vez de publicar uma porta que carregaria outro. |
resources | object | não | |
health | object | não | As sondas de integridade do contêiner — ready, live e startup —, cada uma declarada como http, tcp ou exec. Traduzidas para httpGet/tcpSocket/exec do K8s para o helm. Para o compose, um serviço carrega um único healthcheck: http e tcp se tornam testes CMD-SHELL, exec se torna um teste CMD, e onde mais de uma sonda é declarada apenas uma é mantida — um aviso nomeia a sonda traduzida e as descartadas. |
volumeMounts | object[] | não | |
restartPolicy | string (enum) | não | Valores permitidos: "Always", "OnFailure", "Never" |
lifecycle | object | não | Hooks de ciclo de vida do contêiner. Traduzidos para container.lifecycle do K8s (postStart/preStop) para o helm. O compose não tem uma primitiva de hook de ciclo de vida; uma carga de trabalho que declara lifecycle interrompe o build de forma explícita em um destino compose em vez de descartar o hook silenciosamente. |
securityContext | object | não |
Não são permitidas propriedades adicionais.
container.envFrom[]
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
configMap | string | não | Nome de uma origem ConfigMap emitida pela entrada artifacts desta Recipe ou por uma Feature vinculada. |
secret | string | não | Nome de um slot do featuresSchema — o do próprio Component ou, quando connection está definido, um slot que o socket dessa conexão declara; o nome do Secret importado é resolvido a partir dos provides do slot. |
connection | string | não | Alias de uma conexão que o componente traça — o nome sob o qual ela está escrita no bloco uses do componente, no Aggregate ou na Release. Quando definido, secret nomeia um slot que o socket pelo qual essa conexão está conectada declara, e o Secret importado é aquele que a vinculação que essa conexão carrega nesse slot publicou, de modo que um componente que alcança vários destinos importa o Secret próprio de cada um. Significativo apenas junto a secret. Uma conexão que o componente não traça, ou um slot que seu socket não declara, é recusado nomeando ambos. |
prefix | string | não | Prefixo opcional adicionado ao início de cada nome de variável de ambiente importada. |
Não são permitidas propriedades adicionais.
container.resources
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
requests | resourceList | não | |
limits | resourceList | não |
Não são permitidas propriedades adicionais.
container.health
As sondas de integridade do contêiner — ready, live e startup —, cada uma declarada como http, tcp ou exec. Traduzidas para httpGet/tcpSocket/exec do K8s para o helm. Para o compose, um serviço carrega um único healthcheck: http e tcp se tornam testes CMD-SHELL, exec se torna um teste CMD, e onde mais de uma sonda é declarada apenas uma é mantida — um aviso nomeia a sonda traduzida e as descartadas.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
ready | probe | não | |
live | probe | não | |
startup | probe | não |
Não são permitidas propriedades adicionais.
container.volumeMounts[]
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | Precisa corresponder a uma chave do mapa volumes: de nível superior. |
path | string | sim | Ponto de montagem dentro do contêiner. |
subPath | string | não | Monta um único arquivo ou subdiretório do volume em path, sem ocultar outros arquivos no diretório de destino. |
readonly | booleano | não | Valor padrão: false |
Não são permitidas propriedades adicionais.
container.lifecycle
Hooks de ciclo de vida do contêiner. Traduzidos para container.lifecycle do K8s (postStart/preStop) para o helm. O compose não tem uma primitiva de hook de ciclo de vida; uma carga de trabalho que declara lifecycle interrompe o build de forma explícita em um destino compose em vez de descartar o hook silenciosamente.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
postStart | lifecycleHook | não | |
preStop | lifecycleHook | não |
Não são permitidas propriedades adicionais.
container.securityContext
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
runAsUser | integer | não | |
runAsGroup | integer | não | |
runAsNonRoot | booleano | não | |
readOnlyRootFilesystem | booleano | não | |
allowPrivilegeEscalation | booleano | não | |
capabilities | object | não |
Não são permitidas propriedades adicionais.
container.securityContext.capabilities
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
add | string[] | não | |
drop | string[] | não |
Não são permitidas propriedades adicionais.
containerAttachment
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
from | string | sim | Nome de um slot declarado no featuresSchema do Component — ou, quando connection está definido, de um slot que o socket pelo qual essa conexão está conectada declara. |
connection | string | não | Alias de uma conexão que o componente traça — o nome sob o qual ela está escrita no bloco uses do componente, no Aggregate ou na Release. Quando definido, from nomeia um slot que o socket pelo qual essa conexão está conectada declara (usesSchema. |
as | string (enum) | sim | Mecanismo de entrega. Precisa estar na lista de permissões do array inject: do slot. Valores permitidos: "env", "file" |
key | string | não | Para as: env, a chave de dados específica do segredo do slot referenciado que esta entrada lê. Defina-a quando o segredo do slot carregar várias chaves de dados, para que esta entrada selecione uma delas pelo nome; duas entradas podem referenciar o mesmo slot com chaves diferentes para ler várias chaves de um mesmo segredo. Quando omitida, a entrada lê a única chave publicada do slot. Ignorada para as: file, que monta o segredo inteiro. |
path | string | não | Caminho do arquivo dentro do contêiner (obrigatório quando as: file). |
Não são permitidas propriedades adicionais.
resourceList
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
cpu | string | não | Quantidade de CPU (por exemplo, ‘100m’, ‘0.5’, ‘2’). O helm a emite sem alterações em resources.{requests,limits}.cpu. O compose a mapeia para deploy.resources.{reservations,limits}.cpus como núcleos fracionários — uma quantidade em milicpu é convertida (500m se torna 0.5); uma quantidade simples em núcleos passa sem alterações. Uma quantidade que o compose não consegue converter interrompe o build de forma explícita em vez de emitir um valor errado. |
memory | string | não | Quantidade de memória (por exemplo, ‘128Mi’, ‘1Gi’). O helm a emite sem alterações em resources.{requests,limits}.memory. O compose a mapeia para deploy.resources.{reservations,limits}.memory como uma contagem exata de bytes. Uma quantidade que resulta em um número inteiro de bytes é convertida exatamente (1.5Gi se torna 1610612736); uma que não resulta, ou que não é uma quantidade, interrompe o build de forma explícita em vez de ser arredondada. |
Chaves adicionais: Uma quantidade de recurso estendida (com escopo de fabricante ou de domínio), indexada por um nome totalmente qualificado ’^[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])?$.
Nenhuma outra propriedade é permitida.
probe
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
http | string | não | Sonda HTTP GET: o caminho é sondado na porta do contêiner cujo nome vem primeiro em ordem alfabética. |
tcp | integer | não | Sonda de socket TCP no número de porta do contêiner indicado. Mínimo: 1. Máximo: 65535. |
exec | string[] | não | Sonda exec — o comando a executar dentro do contêiner. Pelo menos 1 entrada. |
timeoutSeconds | integer | não | Mínimo: 1. |
initialDelaySeconds | integer | não | Mínimo: 0. |
periodSeconds | integer | não | Mínimo: 1. |
failureThreshold | integer | não | Mínimo: 1. |
successThreshold | integer | não | Mínimo: 1. |
Não são permitidas propriedades adicionais.
lifecycleHook
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
exec | string[] | não | Pelo menos 1 entrada. |
httpGet | object | não | O formato httpGet nativo do K8s (path, port, scheme, host, httpHeaders). Repassado sem alterações ao helm. Em um destino compose, uma carga de trabalho que declara um hook de ciclo de vida interrompe o build, porque o compose não tem uma primitiva de hook de ciclo de vida — o hook nunca é descartado silenciosamente. |
Não são permitidas propriedades adicionais.
volume
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
ephemeral | object | não | |
configmap | object | não | |
secret | object | não | |
persistent | object | não | |
persistentTemplate | object | não | Template de claim por réplica. Requer form: stateful, porque apenas o formato stateful dá a cada réplica a identidade estável de que um claim por réplica precisa. No Kubernetes se torna StatefulSet.volumeClaimTemplates. Em um destino compose é degradado para um único volume nomeado compartilhado por todas as réplicas, e um aviso informa a degradação. |
Não são permitidas propriedades adicionais.
volume.ephemeral
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
sizeLimit | string | não | Quantidade do K8s (por exemplo, ‘1Gi’). K8s: emptyDir.sizeLimit. Compose: o volume se torna uma entrada tmpfs que não carrega tamanho, então este valor não chega a nenhuma parte da saída — um aviso o informa quando ele é escrito. |
Não são permitidas propriedades adicionais.
volume.configmap
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
source | string | sim | Nome da ConfigMap, emitida por esta Recipe via artifacts: ou por uma Feature vinculada; uma ConfigMap que outra Recipe emite não é referenciada aqui. |
items | object[] | não | Seleção opcional de chave para caminho. |
Não são permitidas propriedades adicionais.
volume.secret
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
source | string | sim | |
items | object[] | não |
Não são permitidas propriedades adicionais.
volume.persistent
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
size | string | sim | Quantidade do K8s (por exemplo, ‘10Gi’). |
class | string | não | StorageClassName. Opcional. |
accessModes | string (enum)[] | não | Modos de acesso do PVC. O helm emite spec.accessModes, com [ReadWriteOnce] como padrão quando omitido. Os volumes do compose não têm o conceito de modo de acesso e o omitem. Valores permitidos para cada entrada: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod". |
Não são permitidas propriedades adicionais.
volume.persistentTemplate
Template de claim por réplica. Requer form: stateful, porque apenas o formato stateful dá a cada réplica a identidade estável de que um claim por réplica precisa. No Kubernetes se torna StatefulSet.volumeClaimTemplates. Em um destino compose é degradado para um único volume nomeado compartilhado por todas as réplicas, e um aviso informa a degradação.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
size | string | sim | |
class | string | não | |
accessModes | string (enum)[] | não | Modos de acesso do PVC para o template de claim por réplica. O helm emite spec.accessModes, com [ReadWriteOnce] como padrão quando omitido. O compose não tem o conceito de modo de acesso e o omite. Valores permitidos para cada entrada: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod". |
Não são permitidas propriedades adicionais.
service
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
type | string (enum) | sim | Tipo de serviço: até onde chegam as portas da entrada. ClusterIP as mantém na rede própria do destino, acessíveis pelos pares da carga de trabalho; Headless também, e no helm renderiza um Service do K8s com clusterIP: None; NodePort e LoadBalancer as publicam além dessa rede; Loopback as publica apenas no endereço de loopback próprio do host, acessíveis a partir da máquina em que a carga de trabalho é executada e de nenhum outro lugar. O helm renderiza ClusterIP, NodePort e LoadBalancer como o tipo de Service do K8s de mesmo nome, e recusa pelo nome uma entrada Loopback, porque um Service do K8s não tem nenhum tipo que se vincule ao endereço de loopback de um host. O compose não publica nada para ClusterIP e Headless, publica as portas NodePort e LoadBalancer em todas as interfaces do host como host:container, e publica as portas Loopback no endereço de loopback IPv4 como 127.0.0.1:host:container; uma porta que uma entrada NodePort ou LoadBalancer também publica é publicada em todas as interfaces. Valores permitidos: "ClusterIP", "NodePort", "LoadBalancer", "Headless", "Loopback" |
ports | mapa de integer | sim | Mapa de nome da porta do serviço → número da porta do contêiner. Os nomes de porta precisam corresponder a chaves em containers. |
Não são permitidas propriedades adicionais.