Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

Esquema do Workload do Aggrega

Referência gerada. Não editar à mão — gerar 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, propriedade da plataforma. Uma Recipe que use o modo sintetizado declara exatamente um Workload através da palavra-chave workload: (escalar de bloco inline ou workload: { $import: } segundo o vocabulário unificado de importação de ficheiros). O fornecedor de destino traduz o Workload em manifestos nativos do fornecedor (K8s Deployment/StatefulSet/Services/PVCs para helm; serviços + volumes + redes do compose para compose; etc.). Um Workload não tem metadados próprios — nenhum nome, nenhuma etiqueta, nenhuma anotação. A identidade e a etiquetagem vêm da instância de componente que o declara: o fornecedor de destino deriva dessa instância o nome de cada recurso renderizado e aplica ao recurso as chaves de proveniência aggrega.ai/* desse nó. O tipo Workload NÃO é uma entidade de catálogo — este ficheiro publicado é o JSON Schema canónico do Workload, e o compilador valida um Workload face a ele.

Consulte-se 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

PropriedadeTipoObrigatóriaDescrição
apiVersionconst “aggrega.ai/v1beta1”simConstante: "aggrega.ai/v1beta1"
kindconst “Workload”simConstante: "Workload"
formstring (enum)nãoIntenção abstrata sobre a forma 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 intermutá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 anfitrião elegível), scheduled (execuções recorrentes desencadeadas pelo tempo), task (uma única execução até à conclusão), reference (um endpoint externo sem computação — nenhum controlador; o helm emite um Service ExternalName, o compose transporta o endpoint através do contrato de injeção). Um valor vazio é tratado como stateless. Cada fornecedor de destino faz corresponder a forma à sua própria forma nativa; a forma em si não contém nenhum tipo de recurso nativo da plataforma. Um volume persistentTemplate é um complemento de stateful e só é válido numa carga de trabalho stateful. Uma carga de trabalho reference declara endpoint (e opcionalmente port) e nenhum contentor, e não tem 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 precise de uma credencial para o endpoint declara o slot no featuresSchema do seu próprio Component e preenche-o a partir do bloco attachments do seu contentor, onde a lista inject desse slot permite a entrega. Valores permitidos: "stateless", "stateful", "daemon", "scheduled", "task", "reference" Predefinição: "stateless"
endpointstringnãoEndpoint externo para form: reference — um anfitrião ou um URL. O compilador transmite-o tal como está, como uma cadeia de ponteiro determinística; nunca é resolvido em tempo de compilação (AOT). Obrigatório quando form é reference e só tem significado nesse caso. O helm emite-o como o externalName de um Service ExternalName (a parte do anfitrião); o compose leva-o aos consumidores através dos provides da receita.
portintegernãoPorta opcional para o endpoint reference (form: reference). O helm emite-a como uma porta no Service ExternalName. Mínimo: 1. Máximo: 65535.
schedulestringnãoAgendamento 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 só tem significado nesse caso; o fornecedor de destino transmite-o tal como está para o campo schedule do recurso agendado.
suspendbooleananãoSuspende 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 seja retomado; continua a ser possível criar uma execução à mão a partir do recurso — no Kubernetes, kubectl create job —from=cronjob/. suspend: false é renderizado exatamente como um suspend ausente. Só tem significado com form: scheduled. O helm emite-o como o spec.suspend do CronJob. O compose não tem uma forma agendada e interrompe a compilação perante uma carga de trabalho form: scheduled, esteja ou não suspensa. Predefinição: false
replicasintegernãoNúmero de réplicas. Predefinição 1. Num destino compose o valor não chega a nenhuma parte da saída, e um aviso assinala-o sempre que é escrito — incluindo um 1 explícito. Mínimo: 0. Predefinição: 1
initContainerscontainer[]nãoLista ordenada de contentores que são executados até à conclusão antes de os contentores principais arrancarem.
containersmapa de containernãoMapa ordenado de nome do contentor → especificação do contentor. É obrigatória pelo menos uma entrada. A ordem do autor é preservada. Pelo menos 1 entrada.
volumesmapa de volumenãoMapa ordenado de nome do volume → especificação do volume. Cada especificação de volume declara exatamente um de: ephemeral, configmap, secret, persistent, persistentTemplate.
servicesmapa de servicenãoMapa ordenado de nome do serviço → especificação do serviço. No helm cada entrada torna-se um Service do K8s separado, e uma entrada cujo type é Loopback interrompe a compilação. No compose não existe uma primitiva de serviço separada, pelo que as entradas não correspondem uma a uma: uma entrada cujo type é NodePort ou LoadBalancer publica as suas portas em todas as interfaces do anfitrião do serviço do compose próprio da carga de trabalho, uma entrada cujo type é Loopback publica aí as suas portas apenas no endereço de loopback do anfitrião, 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 anfitrião igual à porta do contentor. No helm cada Service chama-se <name>-<key>: o nome que o Deployment (ou outro controlador) próprio da carga de trabalho tem, depois um hífen e a chave da entrada, pelo 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.
schedulingobjetonãoRestrições de agendamento nativas do K8s. Traduzidas diretamente para o helm. Num destino compose estas restrições não chegam a nenhuma parte da saída, e um aviso assinala o bloco quando é escrito.
podSecurityContextobjetonão
serviceAccountstringnãoNome da ServiceAccount sob a qual esta carga de trabalho é executada. O RBAC efetivo (recursos ServiceAccount/Role/RoleBinding) deve ser emitido através de Features ou artefactos, não através deste campo.
imagePullSecretsstring[]nãoNomes dos Secrets de pull de imagens para obter imagens de registos privados. O helm emite pod.imagePullSecrets. O compose não tem um equivalente dentro do ficheiro — a autenticação no registo configura-se à parte através de docker login — e omite-o.
priorityClassNamestringnãoNome 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 num único anfitrião e omite-o.
runtimeClassNamestringnãoNome da RuntimeClass que seleciona o runtime de contentores sob o qual esta carga de trabalho é executada (por exemplo, um runtime com GPU como ‘nvidia’). O compilador transmite o nome tal como está; o cluster resolve-o 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 omite-o. Apenas para computação: não permitido numa carga de trabalho reference.
terminationGracePeriodSecondsintegernãoSegundos entre SIGTERM e SIGKILL no encerramento. O helm emite pod.terminationGracePeriodSeconds; o compose emite stop_grace_period. Mínimo: 0.
dnsPolicystring (enum)nãoPolítica de DNS do pod. O helm emite pod.dnsPolicy. O compose não tem um equivalente de política de DNS e omite-a (em vez disso, o compose faz corresponder diretamente nameservers/searches de dnsConfig). Valores permitidos: "Default", "ClusterFirst", "ClusterFirstWithHostNet", "None"
dnsConfigobjetonãoConfiguração de DNS personalizada do pod. O helm emite pod.dnsConfig. O compose faz corresponder nameservers a dns e searches a dns_search; options não tem equivalente no compose e é aí omitido.
hostAliasesobject[]nãoCorrespondências estáticas de nome de anfitrião para IP inseridas no ficheiro hosts do pod. O helm emite pod.hostAliases; o compose emite extra_hosts (uma entrada hostname:ip por nome de anfitrião).
hostNetworkbooleananãoExecuta a carga de trabalho no namespace de rede próprio do nó anfitrião em vez de num 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ó. Isto 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..ports. O helm emite pod.hostNetwork. O compose emite network_mode: host no serviço próprio da carga de trabalho; um serviço do compose nesse modo não está ligado à rede da fronteira, pelo que os seus pares o alcançam nos endereços do nó e não pelo nome do serviço, e o serviço de cada contentor de inicialização junta-se à rede da fronteira por si próprio. Apenas para computação: não permitido numa carga de trabalho reference.

Não são permitidas propriedades adicionais.

workload.scheduling

Restrições de agendamento nativas do K8s. Traduzidas diretamente para o helm. Num destino compose estas restrições não chegam a nenhuma parte da saída, e um aviso assinala o bloco quando é escrito.

PropriedadeTipoObrigatóriaDescrição
nodeSelectormapa de stringnão
affinityobjetonão
tolerationsobject[]não
topologySpreadConstraintsobject[]não

Não são permitidas propriedades adicionais.

workload.podSecurityContext

PropriedadeTipoObrigatóriaDescrição
runAsUserintegernão
runAsGroupintegernão
fsGroupintegernão
supplementalGroupsinteger[]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 faz corresponder nameservers a dns e searches a dns_search; options não tem equivalente no compose e é aí omitido.

PropriedadeTipoObrigatóriaDescrição
nameserversstring[]não
searchesstring[]não
optionsobject[]não

Não são permitidas propriedades adicionais.

workload.hostAliases[]

PropriedadeTipoObrigatóriaDescrição
ipstringsim
hostnamesstring[]sim

Não são permitidas propriedades adicionais.

Definições

container

PropriedadeTipoObrigatóriaDescrição
namestringnãoNome opcional do contentor. Para uma entrada posicional de initContainers, define o nome do contentor emitido e, quando omitido, recorre a um nome gerado init- (a posição da entrada na lista). Para uma entrada do mapa containers, a chave do mapa é o nome do contentor e este campo é ignorado.
imagestringsimReferência à imagem do contentor (por exemplo, ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’).
imagePullPolicystring (enum)nãoPolítica de pull da imagem. O helm emite-a como container.imagePullPolicy. O compose fá-la corresponder ao pull_policy do serviço (Always a always, Never a never, IfNotPresent a if_not_present). Valores permitidos: "Always", "Never", "IfNotPresent"
commandstring[]nãoSubstitui o entrypoint da imagem. K8s: .command. Compose: entrypoint.
argsstring[]nãoArgumentos passados a command (ou ao entrypoint da imagem se command estiver ausente). K8s: .args. Compose: command.
variablesmapa de stringnãoVariáveis de ambiente como pares chave-valor de cadeias. K8s: spec.template.spec.containers[].env[]. Compose: services..environment.
attachmentsmapa de containerAttachmentnãoMapa ordenado de nome de env ou de ficheiro → { from, as, key?, path?, connection? }. Cada entrada referencia um slot declarado no featuresSchema do Component — ou, quando a entrada nomeia uma ligação, um slot que o socket dessa ligação declara — e entrega o que o anexo que preenche esse slot publicou. O campo ‘as’ seleciona o mecanismo de entrega, que tem de constar da lista de permissões do array inject: do slot. Os slots blackbox (inject: []) NÃO PODEM aparecer aqui.
envFromobject[]nãoAmbiente 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 ficheiro do anfitrião, pelo que reinterpretá-la como env_file mudaria o significado silenciosamente; uma carga de trabalho que declara envFrom interrompe a compilação de forma explícita num destino compose.
portsmapa de integer ou objectnãoPortas do contentor com nome. Uma porta escreve-se como o número de porta simples (web: 8080) ou como um objeto que contém o número juntamente com o protocolo de transporte que a porta usa (dns: { port: 53, protocol: UDP }); onde não é declarado nenhum protocolo, as duas formas significam o mesmo. Os valores de protocolo permitidos são TCP, UDP e SCTP, e omitir a chave mantém em vigor a predefinição própria 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 o seu transporte da porta do contentor para a qual o seu nome se resolve, pelo que o transporte é declarado uma única vez. K8s: containerPort, com protocol apenas onde é declarado um. Compose: uma porta do contentor chega à saída apenas onde uma especificação de serviço a publica; a porta do contentor em si não tem um campo do compose separado, e uma porta publicada contém um transporte declarado como o sufixo /protocol na entrada publicada — um transporte que o compose não consegue exprimir interrompe a compilação em vez de publicar uma porta que conteria outro.
resourcesobjetonão
healthobjetonãoAs sondas de integridade do contentor — 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 tem um único healthcheck: http e tcp tornam-se testes CMD-SHELL, exec torna-se um teste CMD, e onde é declarada mais de uma sonda apenas uma é mantida — um aviso nomeia a sonda traduzida e as descartadas.
volumeMountsobject[]não
restartPolicystring (enum)nãoValores permitidos: "Always", "OnFailure", "Never"
lifecycleobjetonãoHooks de ciclo de vida do contentor. 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 a compilação de forma explícita num destino compose em vez de descartar o hook silenciosamente.
securityContextobjetonão

Não são permitidas propriedades adicionais.

container.envFrom[]

PropriedadeTipoObrigatóriaDescrição
configMapstringnãoNome de uma origem ConfigMap emitida pela entrada artifacts desta Recipe ou por uma Feature anexada.
secretstringnãoNome de um slot do featuresSchema — o do próprio Component ou, quando connection está definido, um slot que o socket dessa ligação declara; o nome do Secret importado é resolvido a partir dos provides do slot.
connectionstringnãoAlias de uma ligação que o componente traça — o nome sob o qual está escrita no bloco uses do componente, no Aggregate ou na Release. Quando definido, secret nomeia um slot que o socket através do qual essa ligação está ligada declara, e o Secret importado é aquele que o anexo que essa ligação transporta nesse slot publicou, pelo que um componente que alcança vários destinos importa o Secret próprio de cada um. Só tem significado ao lado de secret. Uma ligação que o componente não traça, ou um slot que o seu socket não declara, é recusado nomeando ambos.
prefixstringnãoPrefixo opcional acrescentado ao início de cada nome de variável de ambiente importada.

Não são permitidas propriedades adicionais.

container.resources

PropriedadeTipoObrigatóriaDescrição
requestsresourceListnão
limitsresourceListnão

Não são permitidas propriedades adicionais.

container.health

As sondas de integridade do contentor — 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 tem um único healthcheck: http e tcp tornam-se testes CMD-SHELL, exec torna-se um teste CMD, e onde é declarada mais de uma sonda apenas uma é mantida — um aviso nomeia a sonda traduzida e as descartadas.

PropriedadeTipoObrigatóriaDescrição
readyprobenão
liveprobenão
startupprobenão

Não são permitidas propriedades adicionais.

container.volumeMounts[]

PropriedadeTipoObrigatóriaDescrição
namestringsimTem de corresponder a uma chave do mapa volumes: de nível superior.
pathstringsimPonto de montagem dentro do contentor.
subPathstringnãoMonta um único ficheiro ou subdiretório do volume em path, sem ocultar outros ficheiros no diretório de destino.
readonlybooleananãoPredefinição: false

Não são permitidas propriedades adicionais.

container.lifecycle

Hooks de ciclo de vida do contentor. 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 a compilação de forma explícita num destino compose em vez de descartar o hook silenciosamente.

PropriedadeTipoObrigatóriaDescrição
postStartlifecycleHooknão
preStoplifecycleHooknão

Não são permitidas propriedades adicionais.

container.securityContext

PropriedadeTipoObrigatóriaDescrição
runAsUserintegernão
runAsGroupintegernão
runAsNonRootbooleananão
readOnlyRootFilesystembooleananão
allowPrivilegeEscalationbooleananão
capabilitiesobjetonão

Não são permitidas propriedades adicionais.

container.securityContext.capabilities
PropriedadeTipoObrigatóriaDescrição
addstring[]não
dropstring[]não

Não são permitidas propriedades adicionais.

containerAttachment

PropriedadeTipoObrigatóriaDescrição
fromstringsimNome de um slot declarado no featuresSchema do Component — ou, quando connection está definido, de um slot que o socket através do qual essa ligação está ligada declara.
connectionstringnãoAlias de uma ligação que o componente traça — o nome sob o qual está escrita no bloco uses do componente, no Aggregate ou na Release. Quando definido, from nomeia um slot que o socket através do qual essa ligação está ligada declara (usesSchema..featuresSchema), e a entrada entrega o que o anexo que essa ligação transporta nesse slot publicou, pelo que um componente que alcança vários destinos apresenta a cada um a sua própria credencial. A lista de permissões inject: do slot rege as, exatamente como para um slot que o Component declara. Uma ligação que o componente não traça, ou um slot que o seu socket não declara, é recusado nomeando ambos.
asstring (enum)simMecanismo de entrega. Tem de constar da lista de permissões do array inject: do slot. Valores permitidos: "env", "file"
keystringnãoPara as: env, a chave de dados específica do segredo do slot referenciado que esta entrada lê. Defina-a quando o segredo do slot contiver 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.
pathstringnãoCaminho do ficheiro dentro do contentor (obrigatório quando as: file).

Não são permitidas propriedades adicionais.

resourceList

PropriedadeTipoObrigatóriaDescrição
cpustringnãoQuantidade de CPU (por exemplo, ‘100m’, ‘0.5’, ‘2’). O helm emite-a tal como está em resources.{requests,limits}.cpu. O compose fá-la corresponder a deploy.resources.{reservations,limits}.cpus como núcleos fracionários — uma quantidade em milicpu é convertida (500m passa a 0.5); uma quantidade simples em núcleos passa tal como está. Uma quantidade que o compose não consegue converter interrompe a compilação de forma explícita em vez de emitir um valor errado.
memorystringnãoQuantidade de memória (por exemplo, ‘128Mi’, ‘1Gi’). O helm emite-a tal como está em resources.{requests,limits}.memory. O compose fá-la corresponder a deploy.resources.{reservations,limits}.memory como uma contagem exata de bytes. Uma quantidade que resulta num número inteiro de bytes é convertida exatamente (1.5Gi passa a 1610612736); uma que não resulta, ou que não é uma quantidade, interrompe a compilação de forma explícita em vez de ser arredondada.

Chaves adicionais: Uma quantidade de recurso estendida (com âmbito de fabricante ou de domínio), indexada por um nome totalmente qualificado ’/’ (por exemplo ‘nvidia.com/gpu’: ‘1’, ‘amd.com/gpu’: ‘2’). O segmento de domínio contém pelo menos um ponto, o que distingue uma chave estendida das quantidades cpu/memory simples. O compilador transmite a quantidade tal como está; o plugin de dispositivos do cluster resolve-a e atribui-a no momento do agendamento. O helm emite-a em resources.{requests,limits}.. O compose reserva uma contagem ‘nvidia.com/gpu’ como uma reserva de dispositivos NVIDIA no serviço do contentor — a contagem do limite onde um limite é escrito, caso contrário a do pedido, e nenhuma reserva para uma contagem de 0 — e interrompe a compilação perante uma contagem que não é um número inteiro de dispositivos, ou perante um pedido e um limite que pedem contagens diferentes. O compose não tem equivalente para nenhuma outra chave estendida e omite-a, emitindo um aviso uma vez por cada chave estendida distinta e nomeando essa chave, pelo que a omissão é assinalada em vez de silenciosa. Padrão: ^[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

PropriedadeTipoObrigatóriaDescrição
httpstringnãoSonda HTTP GET: o caminho é sondado na porta do contentor cujo nome vem primeiro por ordem alfabética.
tcpintegernãoSonda de socket TCP no número de porta do contentor indicado. Mínimo: 1. Máximo: 65535.
execstring[]nãoSonda exec — o comando a executar dentro do contentor. Pelo menos 1 entrada.
timeoutSecondsintegernãoMínimo: 1.
initialDelaySecondsintegernãoMínimo: 0.
periodSecondsintegernãoMínimo: 1.
failureThresholdintegernãoMínimo: 1.
successThresholdintegernãoMínimo: 1.

Não são permitidas propriedades adicionais.

lifecycleHook

PropriedadeTipoObrigatóriaDescrição
execstring[]nãoPelo menos 1 entrada.
httpGetobjetonãoA forma httpGet nativa do K8s (path, port, scheme, host, httpHeaders). Transmitida tal como está ao helm. Num destino compose, uma carga de trabalho que declara um hook de ciclo de vida interrompe a compilação, 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

PropriedadeTipoObrigatóriaDescrição
ephemeralobjetonão
configmapobjetonão
secretobjetonão
persistentobjetonão
persistentTemplateobjetonãoTemplate de claim por réplica. Requer form: stateful, porque apenas a forma stateful dá a cada réplica a identidade estável de que um claim por réplica precisa. No Kubernetes torna-se StatefulSet.volumeClaimTemplates. Num destino compose degrada-se num único volume com nome partilhado por todas as réplicas, e um aviso assinala a degradação.

Não são permitidas propriedades adicionais.

volume.ephemeral

PropriedadeTipoObrigatóriaDescrição
sizeLimitstringnãoQuantidade do K8s (por exemplo, ‘1Gi’). K8s: emptyDir.sizeLimit. Compose: o volume torna-se uma entrada tmpfs que não tem tamanho, pelo que este valor não chega a nenhuma parte da saída — um aviso assinala-o quando é escrito.

Não são permitidas propriedades adicionais.

volume.configmap

PropriedadeTipoObrigatóriaDescrição
sourcestringsimNome da ConfigMap, emitida por esta Recipe através de artifacts: ou por uma Feature anexada; uma ConfigMap que outra Recipe emite não é referenciada aqui.
itemsobject[]nãoSeleção opcional de chave para caminho.

Não são permitidas propriedades adicionais.

volume.secret

PropriedadeTipoObrigatóriaDescrição
sourcestringsim
itemsobject[]não

Não são permitidas propriedades adicionais.

volume.persistent

PropriedadeTipoObrigatóriaDescrição
sizestringsimQuantidade do K8s (por exemplo, ‘10Gi’).
classstringnãoStorageClassName. Opcional.
accessModesstring (enum)[]nãoModos de acesso do PVC. O helm emite spec.accessModes, com [ReadWriteOnce] como predefinição quando omitido. Os volumes do compose não têm o conceito de modo de acesso e omitem-no. 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 a forma stateful dá a cada réplica a identidade estável de que um claim por réplica precisa. No Kubernetes torna-se StatefulSet.volumeClaimTemplates. Num destino compose degrada-se num único volume com nome partilhado por todas as réplicas, e um aviso assinala a degradação.

PropriedadeTipoObrigatóriaDescrição
sizestringsim
classstringnão
accessModesstring (enum)[]nãoModos de acesso do PVC para o template de claim por réplica. O helm emite spec.accessModes, com [ReadWriteOnce] como predefinição quando omitido. O compose não tem o conceito de modo de acesso e omite-o. Valores permitidos para cada entrada: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

Não são permitidas propriedades adicionais.

service

PropriedadeTipoObrigatóriaDescrição
typestring (enum)simTipo de serviço: até onde chegam as portas da entrada. ClusterIP mantém-nas 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 publicam-nas para além dessa rede; Loopback publica-as apenas no endereço de loopback próprio do anfitrião, 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 com o mesmo nome, e recusa pelo nome uma entrada Loopback, porque um Service do K8s não tem nenhum tipo que se associe ao endereço de loopback de um anfitrião. O compose não publica nada para ClusterIP e Headless, publica as portas NodePort e LoadBalancer em todas as interfaces do anfitrião 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"
portsmapa de integersimMapa de nome da porta do serviço → número da porta do contentor. Os nomes de porta têm de corresponder a chaves em containers..ports. Uma porta de serviço não tem nenhum protocolo de transporte próprio: obtém o transporte da porta do contentor para a qual o seu nome se resolve, pelo que o transporte de uma porta é declarado uma única vez, na porta do contentor, e a exposição do serviço não pode divergir do que o contentor abriu.

Não são permitidas propriedades adicionais.