Esquema do socket Wasm de renderização do Provider 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/wasm-provider-v1beta1.schema.json
As formas de transmissão que um socket de plugin de renderização do Provider consome e emite. Um guest do Provider renderiza um nó IR em arquivos de saída por meio da sua exportação render_node (de RenderNodeInput para RenderNodeOutput) e, opcionalmente, funde as saídas por nó de uma fronteira em um único artefato montado por meio da sua exportação assemble_boundary (de AssembleBoundaryInput para AssembleBoundaryOutput). AssembleBoundaryOutput carrega os arquivos montados e quaisquer diagnósticos; onde ficam os arquivos de cada contribuinte é declarado uma única vez no contrato describe() do guest em vez de nesta resposta. Um guest também pode declarar uma exportação opcional validate_node_input que verifica estruturalmente a entrada resolvida de um nó antes do despacho da renderização: ela consome a mesma projeção RenderNodeInput que render_node recebe e retorna um ValidateNodeOutput que carrega apenas diagnósticos — um diagnóstico de severidade halt interrompe o build de forma explícita, um diagnóstico de severidade warn é apresentado no resultado do build. Um guest cujo destino limita ou restringe os nomes que aceita também pode declarar uma exportação opcional name_bound, que o host consulta antes de fixar a identidade de componente de um nó: ela consome um NameBoundInput que carrega um nome proposto e retorna um NameBoundOutput que carrega um veredito por tipo de nome que o guest derivaria dele. Um veredito carrega uma restrição — utilizável, ou limitado a um comprimento menor — e nunca um nome que o guest construiu, de modo que o conhecimento do que o destino aceita permanece no guest. Separadamente, um guest cujo destino deriva um nome próprio para os recursos que renderiza — a partir de uma origem fornecida pelo autor, ou de um workload que sintetiza — pode declarar uma exportação opcional rendered_name, que o host consulta para que o autor de uma Recipe possa ler esse nome e publicar um endereço construído a partir dele: ela consome um RenderedNameInput que carrega as identidades das quais o destino deriva e os tipos de entrada que a Recipe do nó declara, e retorna um RenderedNameOutput que carrega o nome sob o qual o próprio guest vai renderizar, ou nenhum nome quando não deriva nenhum. As duas exportações são direções opostas de um mesmo assunto e nenhuma substitui a outra — name_bound pede ao guest que julgue um nome que o host propõe, enquanto rendered_name informa um nome que o guest compôs, que o host carrega sem ler. Um guest também pode declarar carve e reassemble, que dividem a sua própria saída em unidades endereçáveis para uma etapa de pipeline e reúnem de volta as unidades modificadas por patch, e link_publish e link_resolve, que cabeiam uma aresta uses cujas extremidades são montadas em grupos de despacho diferentes. A forma de cada payload é a definição que a sua exportação nomeia: a tabela x-aggrega-exports mapeia cada exportação com que o host chama um guest — carve e reassemble incluídas — para a definição da sua entrada e a definição da sua saída, cada uma como um JSON Pointer nos $defs deste documento, de modo que uma ferramenta que valida um payload procura ali a sua definição. A raiz do documento não declara nenhuma forma própria, porque um mesmo documento pode ser um payload válido de várias exportações (um objeto vazio é uma resposta válida de validate_node_input, name_bound e rendered_name igualmente). O guest retorna os bytes serializados de cada arquivo de saída; o host os escreve literalmente e não executa nenhum serializador, de modo que o determinismo é responsabilidade do guest: uma entrada idêntica deve produzir bytes idênticos. Os tipos de payload de Go, Rust e TypeScript são gerados a partir deste esquema nos pacotes da ABI de plugins, de modo que as três linguagens leem e escrevem o mesmo formato de transmissão; um guest os importa desses pacotes, ou por meio do seu kit de plugins quando o kit os reexporta.
Exportações
A tabela x-aggrega-exports do esquema mapeia cada exportação com que o host chama um guest para a definição da sua entrada e a definição da sua saída. A forma de um payload é a definição que a sua exportação nomeia.
| Exportação | Entrada | Saída |
|---|---|---|
render_node | RenderNodeInput | RenderNodeOutput |
validate_node_input | RenderNodeInput | ValidateNodeOutput |
assemble_boundary | AssembleBoundaryInput | AssembleBoundaryOutput |
carve | CarveInput | CarveOutput |
reassemble | ReassembleInput | ReassembleOutput |
name_bound | NameBoundInput | NameBoundOutput |
rendered_name | RenderedNameInput | RenderedNameOutput |
link_publish | LinkPublishInput | LinkPublishOutput |
link_resolve | LinkResolveInput | LinkResolveOutput |
Definições
RenderNodeInput
O payload que um guest do Provider recebe na sua exportação render_node: a projeção IR por nó que o guest renderiza, o contexto do momento da renderização, as entradas pré-avaliadas que a Recipe associada ao nó declara — uma listagem da origem adquirida, um workload, um conjunto de artefatos —, cada uma presente apenas quando essa Recipe a declara, e as entradas que nomeiam unidades renderizadas que o guest deixa de fora de uma renderização de origem.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
node | IRNodeProjection | sim | Os dados IR por nó que um guest do Provider renderiza — uma projeção delimitada do nó IR completo que carrega a identidade por nó e a proveniência que o guest carimba em cada manifesto emitido: o seu id, o tipo, a receita resolvida, os valores, se um mapeamento de valores produziu esses valores, as vinculações de feature, a marcação de sensibilidade sobre as suas chaves renderizadas e sobre os valores como um todo, as arestas uses de saída, o caminho da fronteira, a sync wave, a identidade da Recipe, a substituição do id do componente, a base do nome derivado e a proveniência do build. A identidade e a base do nome derivado são carregadas separadamente porque respondem a duas perguntas — a que um recurso pertence, e contra o que a origem própria de um autor é renderizada — e uma vinculação de Feature que entrega uma origem escrita pelo seu autor é onde as duas respostas diferem. O conteúdo dos arquivos de origem não é carregado aqui; ele viaja separadamente na projeção da origem. Todo conjunto de chaves aqui tem uma ordem fixa — features e uses na ordem do autor, values e a marcação de sensibilidade na ordem das chaves ordenadas — de modo que o payload transmitido é idêntico byte a byte entre execuções com entrada idêntica. |
context | object | sim | O contexto do momento da renderização que o host entrega ao guest, transportado como os bytes do seu documento JSON; este esquema deixa o objeto não declarado. É o contexto que uma etapa de pipeline do mesmo nó recebe, mais a largura de indentação: parameters, os valores de parâmetros da Release ordenados por nome, ausentes quando não há nenhum; annotations, as anotações do nó divididas conforme onde cada uma foi escrita, em aggregate, release e catalog, cada um ausente quando vazio; boundary, a fronteira em que o nó se encontra: name, path (os seus segmentos), sync_wave (ausente quando 0), directory, sub_directory (ausente quando não há nenhum) e annotations (o conjunto que as fronteiras da Release propagam em cascata até o nó, com a sua própria entrada da Release aplicada por último; ausente quando vazio); e yaml_indent, a largura de indentação de toda a renderização com a qual o guest serializa a sua saída. A renderização de uma FeatureRecipe com escopo de fronteira, que não tem componente host, recebe o contexto que a sua etapa de pipeline recebe, mais yaml_indent: parameters; annotations carregando apenas o compartimento release, que é o conjunto de anotações próprio da fronteira; e um boundary carregando o seu name, o seu path e esse mesmo conjunto como as suas annotations. As anotações conhecidas aggrega.ai/* são lidas do compartimento aggregate com o compartimento release escrito por cima, de modo que uma chave que ambos carregam assume o valor da Release; um provedor da biblioteca padrão as lê desse conjunto em camadas e nunca do compartimento catalog, de modo que um valor do catálogo nunca decide nenhuma delas, e uma FeatureRecipe com escopo de fronteira, cujo contexto não carrega nenhum compartimento aggregate, renderiza pelos valores da sua fronteira e não pelos de qualquer componente. |
source_listing | SourceListing | não | A enumeração genérica da origem adquirida que o host entrega ao guest para um provedor com origem: a raiz da origem, se essa raiz é um diretório, e as entradas ordenadas relativas à raiz que estão sob ela. Aqui o host não lê nenhum conteúdo de arquivo — ele lista apenas nomes. O guest aplica a sua própria lógica de resolução sobre a listagem e pede ao host que empacote uma seleção escolhida por meio da função de host pack-source, de modo que toda a inteligência de resolução de origem específica de cada provedor fica no guest. Presente para provedores com origem; ausente caso contrário. |
workload_projection | WorkloadProjection | não | O workload pré-avaliado que o host entrega ao guest para que ele sintetize a partir dele manifestos nativos do provedor; presente quando a Recipe associada declara um workload em vez de uma origem de chart, ausente caso contrário. |
artifacts_projection | ArtifactsProjection | não | O conjunto de artefatos pré-avaliado que o host entrega ao guest para que ele o coloque na saída do nó, presente quando a Recipe associada declara artefatos. O host já leu a origem de cada entrada, avaliou-a como um template Go contra o contexto de renderização e calculou os conjuntos de chaves da proveniência do build; o guest decide o formato de saída, o posicionamento da proveniência, o caminho em disco e os bytes finais. Ausente quando o nó não declara nenhum artefato. |
omits | OmitEntry[] | não | As entradas que nomeiam unidades renderizadas que o guest deixa de fora da saída deste nó, na ordem em que o autor as declarou. Cada entrada chega resolvida, com os seus campos como strings simples, e uma entrada que não se aplica a este build não é carregada. O que o kind, o name, o namespace e o subchart de uma entrada selecionam é o contrato documentado próprio deste provedor, não deste socket: o guest compara cada entrada com o que renderizou nos termos do seu próprio formato, deixa de fora de tudo o que retorna cada unidade à qual uma entrada corresponde — os seus arquivos, os nomes que declara em derived_keys e os fatos que informa em render_facts — e informa em omitted da saída a quantas unidades cada entrada correspondeu. As entradas acompanham uma listagem de origem e nenhuma outra entrada: uma renderização de um workload sintetizado ou de um conjunto de artefatos nunca as carrega. Ausente quando não há entradas, e um guest que não recebe nenhuma renderiza exatamente como faria se o campo não existisse. |
Não são permitidas propriedades adicionais.
IRNodeProjection
Os dados IR por nó que um guest do Provider renderiza — uma projeção delimitada do nó IR completo que carrega a identidade por nó e a proveniência que o guest carimba em cada manifesto emitido: o seu id, o tipo, a receita resolvida, os valores, se um mapeamento de valores produziu esses valores, as vinculações de feature, a marcação de sensibilidade sobre as suas chaves renderizadas e sobre os valores como um todo, as arestas uses de saída, o caminho da fronteira, a sync wave, a identidade da Recipe, a substituição do id do componente, a base do nome derivado e a proveniência do build. A identidade e a base do nome derivado são carregadas separadamente porque respondem a duas perguntas — a que um recurso pertence, e contra o que a origem própria de um autor é renderizada — e uma vinculação de Feature que entrega uma origem escrita pelo seu autor é onde as duas respostas diferem. O conteúdo dos arquivos de origem não é carregado aqui; ele viaja separadamente na projeção da origem. Todo conjunto de chaves aqui tem uma ordem fixa — features e uses na ordem do autor, values e a marcação de sensibilidade na ordem das chaves ordenadas — de modo que o payload transmitido é idêntico byte a byte entre execuções com entrada idêntica.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
id | string | sim | O id absoluto do nó dentro do grafo de topologia. |
type | string | sim | Declarado e deliberadamente retido: o host sempre o emite como string vazia. O rótulo de tipo de componente do nó é um metadado opaco e não uma chave de comportamento, de modo que carregá-lo aqui só convidaria um guest a ramificar com base nele. Um guest lê uma string vazia e não deve interpretá-la como um nó cujo tipo de componente não está definido. (A forma de nó de montagem de fronteira carrega um tipo próprio, para um propósito diferente.) |
resolved_recipe | string | sim | Declarado e deliberadamente retido: o host sempre o emite como string vazia. A identidade da Recipe associada já chega ao guest como o nome e a versão da receita que ele carimba na proveniência, de modo que o URI resolvido não acrescenta nada a partir do qual um guest renderize. Um guest que precisa atribuir a saída a uma Recipe lê esses campos de proveniência em vez disso. |
values | object | não | O dicionário de valores renderizados do nó, o conjunto de chaves a partir do qual o guest renderiza. As chaves chegam ordenadas, não na ordem do autor, e é essa ordenação que torna o payload idêntico byte a byte entre execuções com entrada idêntica; um guest que precise de qualquer outra ordenação a impõe ele mesmo. |
features | object | não | As vinculações de feature do nó indexadas por alias de feature, carregando a mesma forma de vinculação de feature por nó que o IR carrega. Cada entrada carrega os values, o infra e o mapeamento inject da vinculação junto com a sua marcação de sensibilidade derivada, de modo que um guest lê apenas a partir do payload se uma vinculação lida com material declarado sensível. Preserva a ordem do autor, de modo que o payload é idêntico byte a byte entre execuções com entrada idêntica. Opaco nesta camada do esquema; o guest lê a forma da entrada de feature por meio do contrato de transmissão do IR. |
sensitive_rendered_keys | mapa de string | não | Chaves renderizadas cuja identidade é recuperada a partir de um dado que um autor declarou sensível, cada uma mapeada para a declaração da qual herdou essa sensibilidade. Viaja do host para o guest na entrada de renderização — a direção oposta à dos nomes que um guest declara na saída de renderização. O que uma chave nomeia segue a forma que este payload carrega: em um payload que carrega os valores do nó, ela é uma das chaves desse mapa; em um payload que carrega um workload, ela nomeia uma entrada nos mapas de vinculação próprios do workload, onde os valores do nó estão vazios. Uma chave está presente apenas onde a recuperação é exata, ligando uma declaração a uma identidade renderizada sem nada lido do texto próprio da chave e sem nenhuma marcação por nó ou por vinculação espalhada por chaves individuais. Uma chave inventada por um template está, portanto, ausente, porque nenhuma declaração a nomeia: as chaves de saída do valuesMapping de uma receita e o conteúdo de um artefato são escritos por template, de modo que nenhum dos dois produz uma chave aqui — se tal payload foi produzido a partir de um valor declarado sensível é carregado, em vez disso, por sensitive_values e pelo sensitive_content próprio de uma entrada de artefato. A ausência indica, portanto, que a identidade de nenhuma chave pôde ser recuperada, nunca que nada neste payload carregue material sensível — um guest que lê uma chave ausente como permissão para exibir ou emitir um valor em claro a leu ao contrário. As chaves chegam ordenadas, e é isso que torna o payload idêntico byte a byte entre execuções com entrada idêntica. |
sensitive_values | booleano | não | Verdadeiro quando os valores que este payload carrega foram produzidos por um template que lê um valor que um autor declarou sensível, ou um valor rastreado até um deles: o valuesMapping de uma Recipe ou de uma FeatureRecipe, um único template cujas chaves e valores de saída são invenção dele, de modo que nenhuma chave dessa saída pode ser rastreada até o dado de onde veio e, em vez disso, o mapa inteiro é marcado. Ele é lido a partir das referências próprias do template em relação às declarações — uma referência que alcança um valor declarado, o template que repassa a totalidade dos seus dados ou um template que não pode ser analisado contam todos — e nunca a partir do conteúdo de um valor ou do nome de uma chave. Um guest que compõe um texto que uma pessoa lê, uma recusa ou um aviso, mantém todo valor dos valores do nó fora desse texto quando isto é verdadeiro, e mantém fora o valor sob qualquer chave que sensitive_rendered_keys nomeie, seja ou não: os dois se compõem, um nomeando as chaves cuja identidade é recuperada exatamente e este cobrindo o mapa onde nenhuma pode ser. Ausente quando nenhum template desse tipo leu tal valor, o que inclui valores que são eles próprios as folhas declaradas, marcados em vez disso por chave em sensitive_rendered_keys, e ausente em um payload que não carrega valores. A ausência nunca indica que nenhum valor seja sensível. |
values_mapped | booleano | não | Verdadeiro quando os valores que este payload carrega são a saída do valuesMapping da Recipe ou da FeatureRecipe associada, em vez dos valores do nó repassados como o autor os escreveu. Um guest cujo próprio contrato liga às entradas que a sua origem declara apenas os valores que um mapeamento produziu lê este campo e deixa sem ler os valores escritos para outra coisa, como os artefatos da Recipe; um guest que liga os valores do nó à sua origem independentemente de como foram produzidos não o lê. Ele registra como os valores foram produzidos e nunca é derivado do nome de uma chave ou do conteúdo de um valor. Ausente onde nenhum valuesMapping foi executado, e em um payload que não carrega valores. |
uses | mapa de string[] | não | Declarado e deliberadamente retido: o host nunca o preenche, de modo que o mapa está ausente de todo payload de renderização. Uma aresta de saída é consumida antes do despacho — os valores publicados da aresta são reidratados no pipe inject próprio do nó, que a Recipe já avaliou nos valores e no workload que o guest recebe — e um guest que monta uma fronteira recebe, em vez disso, a lista de arestas na sua própria entrada. Se fosse preenchido, indexaria as arestas uses de saída do nó por alias de socket, cada uma carregando os ids ordenados dos nós de destino desse socket na ordem do autor. |
boundary_path | string | não | O caminho da fronteira do nó, carimbado como a anotação aggrega.ai/boundary-path em cada manifesto emitido que carrega um bloco metadata. |
sync_wave | integer | não | A onda de implantação herdada da fronteira que contém este nó (padrão 0; valores negativos permitidos), carregando o valor que o nó IR mantém como sync_wave. O que um guest faz com ela é escolha do próprio guest, e registrar o valor e ordenar com base nele são independentes, e não alternativas — um guest pode fazer uma coisa ou outra, ambas ou nenhuma. Entre os provedores da biblioteca padrão: helm e helm-chart a emitem como uma anotação argocd.argoproj.io/sync-wave em cada recurso renderizado e, adicionalmente, como helm.sh/hook-weight em um recurso que o chart já marca como hook do Helm; compose a registra como rótulo de serviço e ordena os serviços do arquivo no qual renderiza, por meio de depends_on entre eles; cloudformation ordena o provisionamento da stack montada, declarando que cada recurso de uma onda depende dos recursos da onda anterior; terraform ordena os blocos de módulo da configuração raiz na qual uma fronteira é montada, declarando que cada módulo de uma onda depende dos módulos da onda anterior, e também a registra com a proveniência do build do nó. |
recipe_name | string | não | O nome da Recipe associada, combinado com recipe_version para formar a anotação aggrega.ai/recipe-uri; quando qualquer uma das metades está vazia, a anotação não é carimbada. |
recipe_version | string | não | A versão da Recipe associada, combinada com recipe_name para formar a anotação aggrega.ai/recipe-uri; quando qualquer uma das metades está vazia, a anotação não é carimbada. |
label_component_id | string | não | A identidade de componente segura para Kubernetes — aquilo a que PERTENCE um recurso que este nó emite, que é o que a proveniência registra e o que um seletor consulta. Quando não está vazia, ela substitui o id do nó como valor dos rótulos app.kubernetes.io/name e aggrega.ai/component-id; vazia significa que o id do nó já é válido como rótulo e é usado diretamente. Ela é carregada para cada recurso que uma vinculação de Feature emite, seja qual for a forma como a vinculação os entrega, de modo que os recursos de uma vinculação podem ser distinguidos dos do seu componente host apenas pelo rótulo. Aquilo a partir do que um guest deriva os seus próprios nomes é carregado separadamente, derived_name_basis, e os dois respondem a perguntas diferentes. |
derived_name_basis | string | não | A identidade a partir da qual um guest deriva os seus próprios nomes — o nome de release que os templates de um instalador de charts leem, a partir do qual tal guest também pode nomear os recursos que sintetiza para um componente, e o prefixo dos arquivos que uma renderização de origem emite. Vazia significa que o id do nó é usado diretamente, que é o valor para um componente comum e para uma vinculação de Feature por componente: uma vinculação que entrega um chart ou um fragmento escrito pelo seu autor o renderiza contra o nome do componente HOST, porque os templates próprios do autor nomeiam os recursos segundo esse nome e um nome diferente renomearia recursos já implantados. Um nó cujo id carrega uma sintaxe de marcador que o alfabeto de nomes de um destino recusa carrega este valor explicitamente em vez disso, de modo que o nome que um guest deriva continua sendo um que o destino aceita. Ela é deliberadamente separada de label_component_id: um guest que CONSTRÓI recursos para uma vinculação de Feature em vez de renderizar a origem do seu autor os nomeia segundo a identidade, de modo que os recursos próprios da vinculação não podem colidir com os do seu host, enquanto o nome contra o qual a origem de um autor é renderizada permanece o mesmo. As duas carregam o mesmo valor onde quer que a identidade de um nó seja também aquilo contra o qual a sua origem é renderizada. |
output_labels | mapa de string | não | Os rótulos de saída declarados pelo autor da receita que o guest carimba em cada manifesto emitido junto com a proveniência da identidade do build, indexados por nome de rótulo. Dois blocos escritos pelo autor se fundem neste único mapa: os pares chave-valor literais que uma receita escreve em outputLabels, e uma entrada para cada chave que uma receita nomeia em outputComponentLabels, cujo valor é lido dessa chave nos rótulos próprios do componente renderizado — de modo que um valor promovido acompanha o componente de onde veio em vez de ser repetido na receita. Ambos os blocos são disjuntos do espaço de chaves da proveniência pela validação no momento do carregamento (nenhuma chave aggrega.ai/ ou app.kubernetes.io/), de modo que a carimbagem nunca colide com um rótulo de proveniência. Uma chave promovida que o componente não declara não carimba nada e gera um aviso em vez de um rótulo vazio. Um guest cuja saída não é YAML do Kubernetes os traduz para a sua própria superfície de rótulos (rótulos de serviço do Compose) ou os ignora. |
provenance | NodeProvenance | sim | A proveniência da identidade do build que o guest carimba em cada manifesto emitido como rótulos aggrega.ai. |
Não são permitidas propriedades adicionais.
NodeProvenance
A proveniência da identidade do build para um nó — a identidade do compilador, do agregado e do ambiente que o guest carimba em cada manifesto emitido como rótulos aggrega.ai. Cada campo é omitido quando vazio, de modo que uma identidade parcial carimba apenas os rótulos que carrega.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
compiler_version | string | não | A versão do compilador, carimbada como o rótulo aggrega.ai/compiler-version quando não está vazia. |
aggregate_name | string | não | O nome do agregado, carimbado como o rótulo aggrega.ai/aggregate-name quando não está vazio. |
environment | string | não | O nome do ambiente, carimbado como o rótulo aggrega.ai/environment quando não está vazio. |
provider_name | string | não | O tipo de provedor puro, carimbado como o rótulo aggrega.ai/provider quando não está vazio. |
provider_version | string | não | A versão resolvida do plugin de renderização do provedor, carimbada como o rótulo aggrega.ai/provider-version quando não está vazia. |
Não são permitidas propriedades adicionais.
RenderNodeOutput
O payload que um guest do Provider retorna da sua exportação render_node: os bytes serializados de cada arquivo de saída que o guest emitiu, os nomes que derivou em cada um dos seus próprios espaços de chaves, os fatos que informa sobre o que emitiu, a quantas unidades renderizadas cada entrada omits que recebeu correspondeu, e quaisquer diagnósticos que o guest gerou durante a renderização. O guest retorna os bytes serializados de cada arquivo; o host os escreve literalmente e não executa nenhum serializador. O determinismo é responsabilidade do guest: uma entrada idêntica deve produzir bytes idênticos.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
files | RenderedFile[] | sim | Os arquivos de saída que o guest emitiu, na ordem de emissão. Cada um nomeia o seu caminho em disco e carrega os bytes serializados que o host escreve literalmente. |
derived_keys | mapa de string[] | não | Os nomes que o guest derivou ao renderizar este nó, indexados pelo espaço de chaves no qual os derivou, cada espaço carregando os seus nomes na ordem de derivação. Um guest que deriva o nome pelo qual a sua saída endereça um recurso colocou esse nome dentro dos bytes do arquivo que o host escreve literalmente, onde o host não pode vê-lo; declará-lo aqui é a forma como o guest pede ao host que confirme que duas derivações não caíram no mesmo nome. O host compara a igualdade dos nomes declarados dentro de um espaço declarado e não faz mais nada — não analisa um nome, não aprende o que um espaço ou um nome significa e nunca deriva um por conta própria. Dois contribuidores para a mesma saída montada que declaram o mesmo nome no mesmo espaço interrompem o build, e a interrupção nomeia o espaço, o nome e ambos os contribuidores. Tanto os nomes dos espaços quanto os nomes dentro deles são o vocabulário próprio do guest: um guest que deseja unicidade em um escopo mais estreito ou mais amplo do que uma saída montada expressa esse escopo no nome do espaço que declara. Preserva a ordem de declaração, de modo que o payload é idêntico byte a byte entre execuções com entrada idêntica. Ausente quando o guest não deriva nomes que queira verificar, o que deixa a verificação inerte para esse guest. |
render_facts | RenderFact[] | não | Fatos que o guest informa sobre o que emitiu para este nó, na ordem em que o guest os lista. Cada fato combina um nome com um valor, e ambos são o vocabulário próprio do guest: quais fatos um provedor informa, o que cada nome significa e o que as suas entradas contêm fazem parte do contrato documentado desse provedor, não deste socket. O valor de todo fato é uma lista, mesmo quando contém uma única entrada: o host recusa um fato cujo valor seja qualquer outra coisa, nomeando o provedor e o fato, e interrompe o build. Essa é a única coisa que o host aprende sobre um valor. Ele indexa os fatos por nome e entrega cada lista aos templates que a leem, juntando as listas de um mesmo nome informadas por mais de uma renderização do mesmo nó na ordem em que essas renderizações foram executadas, e nunca aprende o que um nome ou uma entrada significa nem deriva um fato por conta própria — de modo que um provedor pode informar algo que só o seu próprio conhecimento do formato consegue ver, como uma propriedade dos documentos que escreveu, sem que o host aprenda esse formato. Informar fatos nunca muda o que é escrito: os arquivos que o host escreve são os arquivos que o guest retornou, acompanhados ou não de fatos. O guest lista os seus fatos em uma ordem fixa, de modo que o payload é idêntico byte a byte entre execuções com entrada idêntica. Ausente quando o guest não informa nada, o que é uma resposta completa, e não uma resposta ausente. |
omitted | integer[] | não | A quantas unidades renderizadas cada entrada de omits recebida na entrada correspondeu: uma contagem por entrada que o guest recebeu, na mesma ordem, cada uma o número de unidades às quais essa entrada correspondeu, quer outra entrada também tenha correspondido a elas ou não. Uma contagem de zero é uma resposta completa — a entrada não correspondeu a nada que o guest renderizou. As contagens são tudo o que o socket traz de volta sobre o que foi deixado de fora: as próprias unidades estão simplesmente ausentes do que o guest retornou. Ausente quando o guest não recebeu nenhuma entrada. |
diagnostics | Diagnostic[] | não | Diagnósticos que o guest gerou durante a renderização. Cada elemento tem a forma de diagnóstico compartilhada dos plugins Wasm. |
error | string | não | Uma mensagem de falha definida quando o guest foi executado, mas não conseguiu concluir a operação; ausente em caso de sucesso. Ela é distinta de quaisquer diagnósticos que a saída carregue: os diagnósticos informam problemas encontrados durante uma execução que ainda assim produziu um resultado, enquanto error informa que a própria operação não foi concluída. O host apresenta um erro presente como uma invocação de plugin com falha. |
condition_code | string | não | A identidade descritiva e identificável por máquina da condição que a falha nomeia — o código sob o qual a condição está registrada, no mesmo conjunto aberto em que o compilador registra as suas próprias condições de interrupção, e não um membro do catálogo fechado de códigos de erro das funções de host do qual o hostfunc_error_code de um envelope de resposta é extraído. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. Um guest que interrompe a execução informa aqui o identificador da condição que a sua mensagem nomeia, de modo que um consumidor se ramifica com base nele em vez de recuperar uma identidade lendo a mensagem. O host resolve este identificador em relação às condições que o compilador declara e publica os identificadores próprios da condição resolvida no diagnóstico estruturado, de modo que um código que chega a um leitor sempre se resolve; um identificador que não nomeia nenhuma condição desse tipo, ou um que a numeração retirou, interrompe o build. Um guest sem uma condição precisa a nomear recorre, em vez disso, a uma das condições genéricas de falha de plugin que o compilador declara para esse fim, e coloca os detalhes na sua própria mensagem. Este identificador e condition_short_code são informados juntos, porque nomeiam uma mesma condição em duas formas: um guest que define um e não o outro nomeou uma condição que o host não consegue resolver, e o host então informa a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem ainda carrega a falha completa. |
condition_short_code | string | não | O identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola em um relatório — definido ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. O host o imprime no cabeçalho entre colchetes do diagnóstico que produz para essa falha, de modo que uma condição que um guest gera pode ser citada exatamente como uma que o compilador gera. O host resolve o valor em relação às condições que o compilador declara em vez de carregá-lo por confiança: um valor que não nomeia nenhuma condição desse tipo, um valor que a numeração retirou ou uma grafia que o registro não carrega interrompe o build e cita o valor problemático, com a mensagem própria do guest ainda informada. Ele é informado junto com condition_code, pelo motivo indicado lá. |
Não são permitidas propriedades adicionais.
ValidateNodeOutput
O payload que um guest do Provider retorna da sua exportação opcional validate_node_input: os diagnósticos levantados por uma verificação estrutural da entrada resolvida do nó. A exportação consome a mesma projeção RenderNodeInput que render_node recebe e não emite nenhum arquivo — apenas informa diagnósticos. Um diagnóstico de severidade halt interrompe o build de forma explícita, nomeando o nó e o provedor; um diagnóstico de severidade warn ou info é apresentado no resultado do build sem alterar a saída renderizada. Uma lista de diagnósticos vazia significa que a entrada passou na verificação estrutural.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
diagnostics | Diagnostic[] | não | Diagnósticos que o guest levantou ao validar a entrada do nó. Cada elemento é a forma de diagnóstico compartilhada dos plugins Wasm. Vazio quando a entrada passou na verificação estrutural. |
error | string | não | Uma mensagem de falha definida quando o guest foi executado, mas não conseguiu concluir a operação; ausente em caso de sucesso. Ela é distinta de quaisquer diagnósticos que a saída carregue: os diagnósticos informam problemas encontrados durante uma execução que ainda assim produziu um resultado, enquanto error informa que a própria operação não foi concluída. O host apresenta um erro presente como uma invocação de plugin com falha. |
condition_code | string | não | A identidade descritiva e identificável por máquina da condição que a falha nomeia — o código sob o qual a condição está registrada, no mesmo conjunto aberto em que o compilador registra as suas próprias condições de interrupção, e não um membro do catálogo fechado de códigos de erro das funções de host do qual o hostfunc_error_code de um envelope de resposta é extraído. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. Um guest que interrompe a execução informa aqui o identificador da condição que a sua mensagem nomeia, de modo que um consumidor se ramifica com base nele em vez de recuperar uma identidade lendo a mensagem. O host resolve este identificador em relação às condições que o compilador declara e publica os identificadores próprios da condição resolvida no diagnóstico estruturado, de modo que um código que chega a um leitor sempre se resolve; um identificador que não nomeia nenhuma condição desse tipo, ou um que a numeração retirou, interrompe o build. Um guest sem uma condição precisa a nomear recorre, em vez disso, a uma das condições genéricas de falha de plugin que o compilador declara para esse fim, e coloca os detalhes na sua própria mensagem. Este identificador e condition_short_code são informados juntos, porque nomeiam uma mesma condição em duas formas: um guest que define um e não o outro nomeou uma condição que o host não consegue resolver, e o host então informa a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem ainda carrega a falha completa. |
condition_short_code | string | não | O identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola em um relatório — definido ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. O host o imprime no cabeçalho entre colchetes do diagnóstico que produz para essa falha, de modo que uma condição que um guest gera pode ser citada exatamente como uma que o compilador gera. O host resolve o valor em relação às condições que o compilador declara em vez de carregá-lo por confiança: um valor que não nomeia nenhuma condição desse tipo, um valor que a numeração retirou ou uma grafia que o registro não carrega interrompe o build e cita o valor problemático, com a mensagem própria do guest ainda informada. Ele é informado junto com condition_code, pelo motivo indicado lá. |
Não são permitidas propriedades adicionais.
RenderedFile
Um arquivo de saída que um guest do Provider emitiu: o seu caminho em disco relativo à raiz de saída do nó e os seus bytes serializados exatamente como o guest os produziu. O host escreve esses bytes literalmente e não executa nenhum serializador, de modo que a saída em disco é idêntica byte a byte ao que o guest emitiu.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
path | string | sim | O caminho do arquivo de saída relativo à raiz de saída do nó (por exemplo, Chart.yaml ou templates/deployment.yaml). |
content | string | sim | Os bytes serializados do arquivo exatamente como o guest os produziu; o host escreve esses bytes literalmente e não executa nenhum serializador, de modo que a saída é idêntica byte a byte ao que o guest emitiu. Cada kit os carrega no seu próprio tipo de campo — brutos onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest decodifica para recuperá-los — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão carrega bytes. |
format | string | não | O formato em que o guest declara que o arquivo emitido foi renderizado, para que o host possa encaminhar o arquivo a um analisador correspondente. Ausente quando o guest não declara nenhum formato, caso em que o host infere o formato a partir da extensão do arquivo. |
Não são permitidas propriedades adicionais.
RenderFact
Um fato que um guest do Provider informa sobre o que emitiu para um nó: um nome e uma lista de entradas, ambos definidos e documentados pelo provedor. O host carrega o fato como o guest o escreveu, recusa um fato cujo valor não seja uma lista e não aprende mais nada sobre nenhuma das duas metades.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | O nome do fato, tirado do vocabulário documentado próprio do provedor. |
value | array | sim | O valor do fato: um array JSON — sempre uma lista, mesmo com uma única entrada ou nenhuma — cujas entradas são valores JSON quaisquer na forma que o provedor documenta para esse nome. Uma lista é o que permite que um nome seja informado por mais de uma renderização de um nó: o host junta as listas em uma só. Ele é carregado como o documento JSON que o guest escreveu, byte a byte, de modo que a ordem das entradas da lista e das chaves de cada objeto é a do próprio guest. |
Não são permitidas propriedades adicionais.
OmitEntry
Uma entrada que nomeia unidades renderizadas que um guest do Provider deixa de fora da saída de um nó, com os seus campos já resolvidos como strings simples e marcados onde algum deles foi produzido a partir de um valor declarado sensível. O socket não lhes atribui nenhum significado: cada provedor documenta o que kind, name, namespace e subchart selecionam no seu próprio formato, e faz ele mesmo a correspondência.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
kind | string | sim | O tipo de unidade renderizada que a entrada nomeia, no vocabulário próprio do provedor. |
name | string | sim | O nome da unidade renderizada que a entrada nomeia, no vocabulário próprio do provedor. |
namespace | string | não | O namespace em que a unidade nomeada se encontra, para um provedor cujo formato coloca as unidades em um namespace. Ausente quando o autor não escreveu nenhum; ao que uma entrada sem namespace corresponde é o contrato próprio do provedor. |
subchart | string | não | A origem aninhada da qual a unidade nomeada veio, para um provedor cuja origem é montada a partir de origens aninhadas, como um chart a partir dos seus subcharts. Ausente quando o autor não escreveu nenhuma; ao que uma entrada sem subchart corresponde, e o que um provedor cuja origem não tem origens aninhadas faz com uma entrada que nomeia uma, é o contrato próprio do provedor. |
sensitive | booleano | não | Verdadeiro quando o template que produziu qualquer um dos campos kind, name, namespace ou subchart da entrada lê um valor que um autor declarou sensível, ou um valor rastreado até um deles. É lido a partir do template de cada campo em relação às declarações — uma referência que alcança um valor declarado, o template que repassa a totalidade dos seus dados ou um template que não pode ser analisado contam todos — e nunca a partir das strings resolvidas. A marcação cobre a entrada inteira em vez de nomear o campo, de modo que um guest trata uma entrada marcada como trata qualquer outro valor marcado na sua entrada: continua a fazer a correspondência e a contagem da entrada pelos seus campos, que é para o que a entrada serve, e mantém cada um dos seus campos fora de qualquer texto que uma pessoa lê — uma recusa, um aviso ou uma linha de log. Ausente quando o template de nenhum campo lê um valor desse tipo; a ausência nunca afirma que nenhum campo é sensível. |
Não são permitidas propriedades adicionais.
SourceFile
Um arquivo de uma projeção da origem pré-empacotada: o seu caminho relativo à raiz da origem e os seus bytes brutos, exatamente como o host os leu da origem local em tempo de compilação.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
path | string | sim | O caminho do arquivo relativo à raiz da origem (por exemplo, Chart.yaml ou templates/deployment.yaml). |
content | string | sim | Os bytes brutos do arquivo exatamente como o host os leu da origem local. Cada kit os carrega no seu próprio tipo de campo — brutos onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest decodifica para recuperá-los — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão carrega bytes. |
Não são permitidas propriedades adicionais.
SourceProjection
O conteúdo da origem empacotado (por ex., os arquivos de um chart do Helm, cada um nomeado pelo seu caminho relativo à raiz da origem, em ordem de percurso) que o host lê e retorna ao guest em resposta a uma solicitação pack-source, de modo que o guest reconstrói a origem selecionada em memória e não toca em nenhum sistema de arquivos. É o payload de sucesso da função de host pack-source.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
files | SourceFile[] | sim | Os arquivos da origem, cada um nomeado pelo seu caminho relativo à raiz da origem, na ordem de percurso determinística do host. |
Não são permitidas propriedades adicionais.
SourceEntry
Uma entrada de uma listagem da origem: o seu caminho relativo à raiz da origem e se é um diretório. O host lista apenas nomes e não lê nenhum conteúdo, de modo que uma entrada não carrega bytes.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
path | string | sim | O caminho da entrada relativo à raiz da origem, separado por barras (por exemplo, Chart.yaml ou templates/deployment.yaml). |
is_dir | booleano | sim | Se a entrada é um diretório. Um guest que resolve a raiz de um chart ou um único arquivo de origem dentro da listagem lê este campo para distinguir diretórios de arquivos sem tocar no sistema de arquivos. |
Não são permitidas propriedades adicionais.
SourceListing
A enumeração genérica de uma origem adquirida que o host entrega ao guest de um provedor com origem: a raiz da origem, se essa raiz é um diretório, e as entradas ordenadas relativas à raiz que estão sob ela. O host percorre a origem adquirida sem nenhum conhecimento do domínio e não lê nenhum conteúdo de arquivo — ele lista apenas nomes. O guest aplica a sua própria lógica de resolução sobre a listagem (localizando a raiz de um chart, selecionando um único documento compose, fazendo vendoring de uma árvore de módulos) e pede ao host que empacote uma seleção escolhida por meio da função de host pack-source. As entradas são ordenadas por caminho para que a listagem seja idêntica byte a byte entre execuções com entrada idêntica.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
root | string | sim | A localização da origem adquirida que o host enumerou. O guest a leva para os seus próprios diagnósticos quando não consegue resolver a origem, de modo que uma interrupção por resolução nomeia a origem que o autor forneceu. |
root_is_dir | booleano | não | Se a raiz da origem adquirida é um diretório. Falso para uma origem de um único arquivo (um documento compose isolado, um único arquivo de módulo, um arquivo compactado), caso em que entries fica vazio e o guest empacota a própria raiz. |
entries | SourceEntry[] | sim | As entradas relativas à raiz sob uma raiz da origem que é um diretório, ordenadas por caminho. Vazio para uma raiz da origem de um único arquivo. |
Não são permitidas propriedades adicionais.
SourcePackRequest
A seleção que um guest pede ao host que empacote a partir da origem adquirida por meio da função de host pack-source. op nomeia a forma da seleção e path a nomeia em relação à raiz da origem; o host resolve o caminho sob a raiz da origem, rejeitando qualquer escape acima dela, e retorna os bytes empacotados como um SourceProjection.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
op | string (enum) | sim | A forma da seleção: file empacota o único arquivo em path; dir empacota os arquivos imediatos do diretório em path; tree empacota recursivamente toda a subárvore com raiz em path, na ordem de percurso determinística do host. Valores permitidos: "file", "dir", "tree" |
path | string | sim | A localização da seleção relativa à raiz da origem, separada por barras. A string vazia (ou ”.”) nomeia a própria raiz da origem, de modo que uma origem de um único arquivo é empacotada com um caminho vazio. |
Não são permitidas propriedades adicionais.
SourcePackResponse
A resposta da função de host pack-source: em caso de sucesso, a origem empacotada; em caso de falha, uma mensagem de erro. Exatamente um dos dois campos é preenchido. A falha é entregue em banda em vez de por trap, de modo que um guest leva uma rejeição do sandbox ou uma falha de leitura para os seus próprios diagnósticos como uma falha de renderização determinística.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
source_projection | SourceProjection | não | A origem empacotada em caso de sucesso; ausente em caso de falha. |
error | string | não | A mensagem de erro em caso de falha, nomeando a seleção e o motivo; ausente em caso de sucesso. |
hostfunc_error_code | string (enum) | não | A identidade da falha identificável por máquina em caso de falha, extraída do catálogo fechado de códigos de erro das funções de host, definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso. Esse catálogo é um vocabulário fixo que nomeia as formas pelas quais uma função de host pode falhar, e é um vocabulário diferente das condições de interrupção que o compilador registra, cujos identificadores um guest informa em uma saída de socket como condition_code e condition_short_code — o nome da chave diz a qual dos dois um valor pertence, de modo que os dois nunca são lidos como um único conjunto. Um guest se ramifica com base neste código sem analisar a mensagem, tolerando um código ausente (host mais antigo) ou um não reconhecido (host mais recente) ao recorrer à mensagem. Valores permitidos: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed" |
Não são permitidas propriedades adicionais.
SourceFileRequest
A leitura do conteúdo de um único arquivo que um guest pede ao host que execute por meio da função de host read-source-file, para um guest cuja lógica de resolução precisa inspecionar o conteúdo de um arquivo antes de escolher o que empacotar. O host resolve o caminho sob a raiz da origem, rejeitando qualquer escape acima dela, e retorna os bytes do arquivo.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
path | string | sim | A localização do arquivo relativa à raiz da origem, separada por barras. |
Não são permitidas propriedades adicionais.
SourceFileResponse
A resposta da função de host read-source-file: em caso de sucesso, os bytes do arquivo; em caso de falha, uma mensagem de erro. Exatamente um dos dois campos é preenchido. A falha é entregue em banda em vez de por trap, de modo que um guest leva uma rejeição do sandbox ou uma falha de leitura para os seus próprios diagnósticos como uma falha de renderização determinística.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
content | string | não | Os bytes brutos do arquivo em caso de sucesso; ausentes em caso de falha. Cada kit os carrega no seu próprio tipo de campo — brutos onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest decodifica para recuperá-los — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão carrega bytes. |
error | string | não | A mensagem de erro em caso de falha, nomeando o arquivo e o motivo; ausente em caso de sucesso. |
hostfunc_error_code | string (enum) | não | A identidade da falha identificável por máquina em caso de falha, extraída do catálogo fechado de códigos de erro das funções de host, definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso. Esse catálogo é um vocabulário fixo que nomeia as formas pelas quais uma função de host pode falhar, e é um vocabulário diferente das condições de interrupção que o compilador registra, cujos identificadores um guest informa em uma saída de socket como condition_code e condition_short_code — o nome da chave diz a qual dos dois um valor pertence, de modo que os dois nunca são lidos como um único conjunto. Um guest se ramifica com base neste código sem analisar a mensagem, tolerando um código ausente (host mais antigo) ou um não reconhecido (host mais recente) ao recorrer à mensagem. Valores permitidos: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed" |
Não são permitidas propriedades adicionais.
FetchExternalInputResponse
A resposta da função de host fetch-external-input: em caso de sucesso, o conteúdo obtido; em caso de falha, uma mensagem de erro e o seu código. Uma resposta que não carrega nenhum dos dois campos de falha é um sucesso, de modo que um payload de comprimento zero é a resposta com todos os campos ausentes. A falha é entregue em banda em vez de por trap, de modo que um guest leva uma URL que não pode ser resolvida ou uma falha de obtenção para os seus próprios diagnósticos como uma falha de renderização determinística. A solicitação é uma simples string de URL em vez de um payload estruturado, de modo que apenas a resposta tem uma forma declarada.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
content | string | não | Os bytes brutos do payload obtido em caso de sucesso; ausentes em caso de falha, e ausentes quando o payload está vazio. No formato de transmissão, os bytes trafegam como uma string de bytes, nunca como texto base64. O kit de Go os mantém como um slice de bytes; os kits de Rust e TypeScript os mantêm como uma string base64, que o wrapper de fetch de cada kit decodifica, de modo que todo wrapper retorna os bytes brutos do payload. |
error | string | não | A mensagem de erro em caso de falha, nomeando a URL e a solução; ausente em caso de sucesso. |
hostfunc_error_code | string (enum) | não | A identidade da falha identificável por máquina em caso de falha, extraída do catálogo fechado de códigos de erro das funções de host, definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso. Esse catálogo é um vocabulário fixo que nomeia as formas pelas quais uma função de host pode falhar, e é um vocabulário diferente das condições de interrupção que o compilador registra, cujos identificadores um guest informa em uma saída de socket como condition_code e condition_short_code — o nome da chave diz a qual dos dois um valor pertence, de modo que os dois nunca são lidos como um único conjunto. Um guest se ramifica com base neste código sem analisar a mensagem, tolerando um código ausente (host mais antigo) ou um não reconhecido (host mais recente) ao recorrer à mensagem. Valores permitidos: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed" |
Não são permitidas propriedades adicionais.
WorkloadProjection
O conteúdo do workload pré-avaliado que o host entrega a um guest do Provider para que o guest sintetize a partir dele, em memória, manifestos nativos do provedor, presente quando a Recipe associada declara um workload em vez de uma origem de chart. O determinismo é responsabilidade do guest: uma entrada idêntica deve produzir bytes idênticos.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
workload | object | sim | O Workload avaliado pelo host, pós-validação, que o guest sintetiza; opaco nesta camada do esquema para que o esquema do socket não redefina o contrato da entidade Workload. |
sensitive_workload | booleano | não | Verdadeiro quando o template que produziu workload lê um valor que um autor declarou sensível, ou um valor rastreado até um deles. É lido a partir das referências próprias do template em relação às declarações — uma referência que alcança um valor declarado, o template que repassa a totalidade dos seus dados ou um template que não pode ser analisado contam todos — e nunca a partir do conteúdo de qualquer campo. Os campos de um workload renderizado não carregam nenhum vínculo com os dados que o seu template leu, de modo que este campo marca o documento inteiro: um guest que compõe um texto que uma pessoa lê, uma recusa ou um aviso, mantém fora desse texto todo valor que o workload carrega quando este campo é verdadeiro, enquanto a forma do documento — as suas chaves e onde um valor se encontra — continua legível. As entradas de vinculação que sensitive_rendered_keys da projeção do nó nomeia são marcadas lá, esteja este campo definido ou não. Ausente quando o template não lê nenhum valor desse tipo; a ausência nunca afirma que nenhum campo é sensível. |
attachment_provides | object | não | Cada vinculação do nó, projetada sobre os seus provides resolvidos e indexada pelo nome de instância da vinculação que uma referência de vinculação do workload carrega; ausente quando o nó não carrega nenhuma vinculação. O host copia as strings sem interpretá-las, de modo que o guest lê as entradas dos provides de uma vinculação de que precise para resolver uma referência ao recurso que essa vinculação produziu. Se uma vinculação lida com material declarado sensível não é repetido aqui: isso viaja na entrada de feature correspondente da projeção do nó, que um guest lê pelo mesmo nome de instância. |
Não são permitidas propriedades adicionais.
ArtifactsProjection
O conjunto de artefatos pré-avaliado que o host entrega a um guest do Provider para que ele o coloque na saída do nó. O host já resolveu a origem de cada entrada (conteúdo inline ou um arquivo importado que leu), avaliou-a como um template Go contra o contexto de renderização usando o par de delimitadores de template de artefato declarado pelo guest e calculou os conjuntos de chaves de rótulos e anotações da proveniência do build. O guest é responsável pela decisão de formato, pelo posicionamento da proveniência, pelo caminho em disco e pelos bytes finais. As entradas preservam a ordem do autor para que a saída posicionada seja idêntica byte a byte entre execuções com entrada idêntica.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
entries | ArtifactProjectionEntry[] | sim | As entradas de artefato que o guest posiciona, na ordem do autor. |
Não são permitidas propriedades adicionais.
ArtifactProjectionEntry
Uma entrada de artefato pré-avaliada que o host entrega a um guest do Provider para que ele a posicione: o seu nome de saída resolvido pelo host, o seu tipo de origem, os bytes de conteúdo já avaliados como template, se o template de que esses bytes vieram lê um valor declarado sensível, e os conjuntos de chaves de rótulos e anotações da proveniência do build que o host calculou para o nó. O guest decide como posicionar a proveniência (inserindo-a nos metadados de um manifesto, antepondo-a como comentário ou emitindo um arquivo complementar) e onde o arquivo vai parar.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | O nome de saída resolvido pelo host para a entrada: a chave de mapa declarada pelo autor, com um arquivo fornecido por um bundle de biblioteca aninhado sob essa chave. O guest posiciona a entrada com esse nome ou sob um subcaminho específico do provedor derivado dele. |
origin | string (enum) | sim | Se a entrada foi escrita como conteúdo inline ou como arquivo importado. Um guest que rejeita uma das duas formas (um provedor de umbrella chart rejeita conteúdo inline) lê este campo para interromper de forma explícita. Valores permitidos: "inline", "import" |
content | string | sim | Os bytes de conteúdo já avaliados como template que o host produziu a partir do conteúdo inline ou do arquivo importado da entrada, avaliados contra o contexto de renderização usando o par de delimitadores de template de artefato declarado pelo guest. Cada kit os carrega no seu próprio tipo de campo — brutos onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest decodifica para recuperá-los — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão carrega bytes. |
sensitive_content | booleano | não | Verdadeiro quando o template a partir do qual o conteúdo desta entrada foi avaliado lê um valor que um autor declarou sensível, ou um valor rastreado até um deles. É lido a partir das referências próprias do template em relação às declarações, com o par de delimitadores com que o conteúdo foi avaliado — uma referência que alcança um valor declarado, o template que repassa a totalidade dos seus dados ou um template que não pode ser analisado contam todos — e nunca a partir do próprio conteúdo. O conteúdo é a saída desse template, de modo que nada nele pode ser rastreado até o dado de que veio: um guest que compõe um texto que uma pessoa lê, uma recusa ou um aviso, mantém toda parte do conteúdo fora desse texto quando este campo é verdadeiro, incluindo a própria mensagem de um analisador sobre o conteúdo. É definido por entrada, de modo que o template de uma entrada ler um valor desse tipo não diz nada sobre o de outra. Ausente quando o template não lê nenhum valor desse tipo; a ausência nunca afirma que o conteúdo não é sensível. |
labels | object | não | O conjunto de chaves da proveniência do build seguro para rótulos do Kubernetes que o host calculou para o nó, indexado por nome de rótulo. Um guest que carimba a proveniência em metadata.labels de um manifesto insere essas chaves; um guest cuja saída não é YAML do Kubernetes as ignora. |
annotations | object | não | O conjunto de chaves da proveniência do build, calculado pelo host para o nó, que um rótulo do Kubernetes não consegue representar, indexado por nome de anotação. Um guest que carimba a proveniência em metadata.annotations de um manifesto insere essas chaves; um guest cuja saída não é YAML do Kubernetes as ignora. |
Não são permitidas propriedades adicionais.
AssembleBoundaryInput
O payload que um guest do Provider recebe na sua exportação assemble_boundary — a exportação que funde as saídas de renderização por nó de um grupo de despacho em um único artefato montado (um umbrella chart, um arquivo compose fundido). Ele carrega as saídas de renderização por nó com as suas anotações fundidas e as suas ondas de implantação, o caminho de saída do grupo de despacho em que o artefato montado vai parar, as arestas uses do grafo para a inferência de dependências por serviço e o contexto do momento da renderização. Nem todo provedor declara a exportação: os provedores que emitem apenas saída plana por nó a omitem.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
rendered_nodes | RenderedNode[] | sim | As saídas de renderização por nó que alimentaram este grupo de despacho, na ordem dos nós. |
context | object | sim | O contexto do momento da renderização, transportado como os bytes do seu documento JSON. Nesta exportação o host define apenas yaml_indent, a largura de indentação de toda a renderização com a qual os arquivos montados são serializados; os demais membros do contexto não carregam nada aqui, porque uma montagem funde contribuidores cujas anotações e fronteiras diferem, e as anotações de cada contribuidor chegam, em vez disso, na sua entrada de rendered_nodes. |
boundary_path | string | sim | O caminho de saída avaliado do grupo de despacho em que o artefato montado vai parar; um montador de fronteira o usa como identidade alternativa no nível da fronteira (por exemplo, o nome da rede compose para um nó que não carrega nenhuma anotação namespace). |
edges | RenderEdge[] | não | As arestas uses direcionadas do grafo, para que um montador de fronteira possa inferir a ordenação/as dependências por serviço entre os contribuidores do grupo de despacho (por exemplo, depends_on do compose). |
sub_charts | SubChart[] | não | O payload por sub-chart que um montador de umbrella chart consome para emitir uma dependência e um escopo de valores por contribuidor. Cada entrada carrega a identidade do sub-chart, os valores por instância e, para um sub-chart incorporado via vendoring a partir de uma origem de chart, os bytes intactos do arquivo Chart.yaml desse chart. Presente para a montagem de umbrella chart; um montador que funde de forma plana o omite. |
chart_name | string | não | O nome de chart que um montador de umbrella chart usa para o chart montado quando um nome é fornecido para o grupo de despacho; vazio quando o montador deriva o nome do caminho de saída do grupo de despacho. |
aggregate_name | string | não | O nome do agregado de nível superior que um montador de umbrella chart incorpora ao nome derivado do chart montado; vazio quando nenhuma identidade de agregado contribui para o nome. |
Não são permitidas propriedades adicionais.
RenderedNode
A saída de renderização de um nó tal como aparece em uma entrada de assemble_boundary: o id do nó, o seu tipo, as suas anotações fundidas, a sua sync wave, os valores que o compilador resolveu para ele onde cabe ao compilador fornecê-los e se um mapeamento de valores os produziu, e os arquivos que a exportação render_node produziu para ele — carregados na forma da saída de renderização, com todo membro dessa forma que não seja os seus arquivos deixado ausente.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
id | string | sim | O id absoluto do nó dentro do grafo de topologia. Um contribuidor que não é um dos nós do grafo — uma Feature vinculada a uma fronteira em vez de a um componente — carrega aqui, em vez disso, a identidade de despacho própria do compilador para ele, que é a mesma identidade que a chamada render_node para esse contribuidor carregou; ela distingue um contribuidor de outro e não é um nome que algum destino aceite. Aquilo a partir do que tal contribuidor deriva nomes dentro do artefato montado é um valor carregado separadamente, derived_name_basis. |
type | string | sim | O rótulo de tipo de componente do nó, carregado nesta forma — ao contrário da projeção de renderização por nó, que o retém. Metadado opaco e não uma chave de comportamento: ele está aqui para que um montador possa agrupar e rotular os nós que funde, não para que um guest possa ramificar com base nele. |
derived_name_basis | string | não | A identidade a partir da qual este contribuidor deriva os seus próprios nomes dentro do artefato montado — um id lógico que um montador cunha para uma das entradas publicadas do contribuidor, um escopo por contribuidor em um documento fundido, o nome de uma unidade filha posicionada em uma posição própria. Vazia significa que o id é usado diretamente, que é o valor para um componente comum. Um contribuidor cujo id é uma identidade de despacho que o alfabeto de nomes de um destino recusa carrega este valor explicitamente, de modo que o artefato montado endereça o seu conteúdo por um nome que o destino aceita, e dois contribuidores que um autor consegue distinguir não podem chegar sob um só. Onde o conteúdo do contribuidor é incorporado a um documento que o montador funde, este é o mesmo valor carregado que a chamada render_node para esse contribuidor recebeu, e carregá-lo em ambos é o que mantém as duas respostas iguais: um nome que o contribuidor declarou durante a renderização e o nome pelo qual o documento fundido endereça esse conteúdo são derivados de uma única identidade em vez de duas que por acaso coincidem. Onde, em vez disso, o contribuidor é posicionado em uma posição própria, esta é a identidade composta para esse contribuidor — para uma Feature vinculada a um componente, a sua própria e não a do componente host contra o qual a sua renderização foi executada — de modo que uma unidade filha posicionada ao lado do seu host é endereçada separadamente dele. |
output_directory | string | não | O diretório em que ficam os arquivos renderizados deste contribuidor, relativo à posição própria do artefato montado, sem separador final. Um guest que precisa nomear os arquivos de um contribuidor de dentro do artefato montado — o caminho de origem de um bloco de módulo, uma diretiva include — lê a posição daqui em vez de compor uma a partir da identidade do contribuidor, de modo que o caminho para o qual o artefato montado aponta é o caminho em que os arquivos foram escritos. Os dois nem sempre estão a um diretório de distância: um contribuidor que o host posicionou dentro da posição de outro contribuidor fica mais fundo do que os contribuidores posicionados diretamente sob a montagem. Presente apenas onde o provedor que faz a montagem posiciona cada contribuidor sob uma posição própria; um provedor que incorpora os seus contribuidores em um único documento não posiciona nenhum diretório por contribuidor e não recebe nenhum. |
rendered | RenderNodeOutput | sim | O payload que um guest do Provider retorna da sua exportação render_node: os bytes serializados de cada arquivo de saída que o guest emitiu, os nomes que derivou em cada um dos seus próprios espaços de chaves, os fatos que informa sobre o que emitiu, a quantas unidades renderizadas cada entrada omits que recebeu correspondeu, e quaisquer diagnósticos que o guest gerou durante a renderização. O guest retorna os bytes serializados de cada arquivo; o host os escreve literalmente e não executa nenhum serializador. O determinismo é responsabilidade do guest: uma entrada idêntica deve produzir bytes idênticos. |
annotations | mapa de string | não | As anotações fundidas do nó, para que um montador de fronteira possa atribuir o posicionamento por nó (por exemplo, a rede compose derivada da anotação aggrega.ai/namespace). |
sync_wave | integer | não | A onda de implantação herdada da fronteira que contém este nó (padrão 0; valores negativos permitidos), para que um montador de fronteira possa ordenar uns em relação aos outros os contribuidores que funde. Um grupo de despacho pode fundir contribuidores de várias fronteiras, cada um carregando a sua própria onda, de modo que a onda viaja aqui com cada nó em vez de uma única vez para todo o payload. Um montador cuja forma de saída não expressa nenhuma ordenação a ignora. |
values | object | não | Os valores que o compilador resolveu para este nó, presentes apenas para um nó renderizado a partir de uma origem — a chamada render_node que produziu os seus arquivos carregava um source_listing. Esse é o único caso em que os arquivos vieram de outro lugar e os valores não puderam ser escritos neles, de modo que uma posição fora deles precisa fornecê-los: um montador de fronteira posiciona um dicionário presente como as entradas desse contribuidor no próprio artefato montado, em vez de ao lado dos arquivos próprios do contribuidor, e onde o artefato montado é a única posição que o destino avalia, essa é a diferença entre uma entrada que o destino lê e uma que ele nunca alcança. Um nó renderizado a partir de um workload_projection ou de um artifacts_projection resolveu esses valores nos arquivos que produziu, de modo que não carrega nenhum aqui e o campo está ausente: fornecê-los uma segunda vez ofereceria ao artefato montado entradas que os arquivos próprios desse nó nunca declaram, e que o destino é livre para rejeitar. As chaves chegam ordenadas, não na ordem do autor, e é essa ordenação que torna o payload idêntico byte a byte entre execuções com entrada idêntica; um guest que precise de qualquer outra ordenação a impõe ele mesmo. Um montador cuja forma de saída não carrega entradas por contribuidor ignora o campo. |
values_mapped | booleano | não | Verdadeiro quando os valores que este nó carrega são a saída do valuesMapping da sua Recipe ou FeatureRecipe associada (a Recipe de um componente, a FeatureRecipe de uma Feature vinculada), em vez dos valores do nó repassados como o autor os escreveu — a mesma marcação que a chamada render_node para este nó carregava na sua projeção do nó, carregada aqui ao lado dos valores que descreve. Ausente onde nenhum valuesMapping foi executado, e onde quer que values esteja ausente. Se um montador o lê é o contrato próprio desse montador: um cujo render_node liga os valores de um nó mapeado às entradas que a sua origem declara pode saber por ele quais nomes essa ligação preencheu, enquanto um que posiciona os valores de um nó como as suas entradas independentemente de como foram produzidos não o lê. Ele registra como os valores foram produzidos e nunca é derivado do nome de uma chave ou do conteúdo de um valor. |
Não são permitidas propriedades adicionais.
RenderEdge
Uma aresta uses direcionada do grafo, nomeada pelos seus dois ids de nó: source é o nó consumidor e target o consumido. A lista carrega toda aresta uses do grafo, de modo que qualquer uma das extremidades pode ser um nó fora deste grupo de despacho.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
source | string | sim | O id do nó consumidor — a extremidade source de uma aresta uses direcionada. |
target | string | sim | O id do nó consumido — a extremidade target para a qual uma aresta uses direcionada aponta. |
Não são permitidas propriedades adicionais.
SubChart
Um sub-chart que contribui para um umbrella chart: a sua identidade de instância, a versão que o umbrella fixa, os valores por instância que o umbrella posiciona sob o alias do sub-chart e, para um sub-chart incorporado via vendoring a partir de uma origem de chart, os bytes intactos do arquivo Chart.yaml desse chart. Um montador de umbrella chart constrói as dependências e o arquivo de valores do umbrella apenas a partir dessas visões de dados puros e não toca em nenhum sistema de arquivos.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
instance_id | string | sim | A identidade de instância do sub-chart dentro do grupo de despacho; o umbrella posiciona sob ela o alias de dependência do sub-chart e os seus valores, de modo que várias instâncias de um mesmo chart de origem permanecem distintas. |
version | string | não | A versão que o umbrella fixa para o sub-chart. Um sub-chart incorporado via vendoring a partir de uma origem de chart obtém, em vez disso, o nome e a versão da sua dependência do arquivo Chart.yaml desse chart, para que a dependência se ligue; este valor se aplica a um sub-chart generativo que não carrega nenhum chart incorporado via vendoring. |
values | object | não | Os valores por instância que o umbrella posiciona sob o alias do sub-chart no arquivo values.yaml do umbrella. As chaves chegam ordenadas, não na ordem do autor, e é essa ordenação que torna o payload idêntico byte a byte entre execuções com entrada idêntica; um guest que precise de qualquer outra ordenação a impõe ele mesmo. |
chart_yaml | string | não | Os bytes intactos do Chart.yaml do chart incorporado via vendoring, lidos da origem local no momento da compilação, dos quais o umbrella obtém o nome e a versão da dependência do sub-chart. Vazio para um sub-chart generativo que não carrega nenhum chart incorporado via vendoring. Cada kit os carrega no seu próprio tipo de campo — brutos onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest decodifica para recuperá-los — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão carrega bytes. |
Não são permitidas propriedades adicionais.
AssembleBoundaryOutput
O payload que um guest do Provider retorna da sua exportação assemble_boundary: os bytes serializados de cada arquivo montado e quaisquer diagnósticos que o guest gerou durante a montagem. Onde ficam os arquivos por nó do grupo montado não faz parte desta resposta — é uma propriedade estática do provedor, declarada uma única vez no seu contrato describe() e disponível antes que qualquer nó seja renderizado. O guest retorna os bytes serializados de cada arquivo; o host os escreve literalmente e não executa nenhum serializador. O determinismo é responsabilidade do guest: uma entrada idêntica deve produzir bytes idênticos.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
files | RenderedFile[] | sim | Os arquivos de saída montados que o guest emitiu, na ordem de emissão. Cada um nomeia o seu caminho em disco e carrega os bytes serializados que o host escreve literalmente. |
diagnostics | Diagnostic[] | não | Diagnósticos que o guest gerou durante a montagem. Cada elemento é a forma de diagnóstico compartilhada dos plugins Wasm. |
error | string | não | Uma mensagem de falha definida quando o guest foi executado, mas não conseguiu concluir a operação; ausente em caso de sucesso. Ela é distinta de quaisquer diagnósticos que a saída carregue: os diagnósticos informam problemas encontrados durante uma execução que ainda assim produziu um resultado, enquanto error informa que a própria operação não foi concluída. O host apresenta um erro presente como uma invocação de plugin com falha. |
condition_code | string | não | A identidade descritiva e identificável por máquina da condição que a falha nomeia — o código sob o qual a condição está registrada, no mesmo conjunto aberto em que o compilador registra as suas próprias condições de interrupção, e não um membro do catálogo fechado de códigos de erro das funções de host do qual o hostfunc_error_code de um envelope de resposta é extraído. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. Um guest que interrompe a execução informa aqui o identificador da condição que a sua mensagem nomeia, de modo que um consumidor se ramifica com base nele em vez de recuperar uma identidade lendo a mensagem. O host resolve este identificador em relação às condições que o compilador declara e publica os identificadores próprios da condição resolvida no diagnóstico estruturado, de modo que um código que chega a um leitor sempre se resolve; um identificador que não nomeia nenhuma condição desse tipo, ou um que a numeração retirou, interrompe o build. Um guest sem uma condição precisa a nomear recorre, em vez disso, a uma das condições genéricas de falha de plugin que o compilador declara para esse fim, e coloca os detalhes na sua própria mensagem. Este identificador e condition_short_code são informados juntos, porque nomeiam uma mesma condição em duas formas: um guest que define um e não o outro nomeou uma condição que o host não consegue resolver, e o host então informa a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem ainda carrega a falha completa. |
condition_short_code | string | não | O identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola em um relatório — definido ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. O host o imprime no cabeçalho entre colchetes do diagnóstico que produz para essa falha, de modo que uma condição que um guest gera pode ser citada exatamente como uma que o compilador gera. O host resolve o valor em relação às condições que o compilador declara em vez de carregá-lo por confiança: um valor que não nomeia nenhuma condição desse tipo, um valor que a numeração retirou ou uma grafia que o registro não carrega interrompe o build e cita o valor problemático, com a mensagem própria do guest ainda informada. Ele é informado junto com condition_code, pelo motivo indicado lá. |
Não são permitidas propriedades adicionais.
CarveInput
O payload que um guest do Provider recebe na sua exportação opcional carve: um arquivo de saída nomeado que a pipeline divide em unidades endereçáveis antes que uma etapa de FeatureRecipe edite algumas delas. Um provedor cuja forma de saída o codec YAML padrão não consegue dividir diretamente (um chart baseado em templates, por exemplo) anuncia carve e reassemble, de modo que o seu próprio conhecimento da forma de saída fica no guest; um provedor que omite as exportações recorre ao codec YAML padrão do host.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | O nome do arquivo de saída, para que o codec possa aplicar qualquer regra de divisão vinculada ao nome. |
body | string | sim | Os bytes do arquivo de saída a dividir em unidades endereçáveis. Cada kit os carrega no seu próprio tipo de campo — brutos onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest decodifica para recuperá-los — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão carrega bytes. |
yaml_indent | integer | não | A largura de indentação que o codec usa quando precisa sintetizar texto estruturado novo; carregada para que a divisão do guest corresponda à indentação de toda a renderização. |
Não são permitidas propriedades adicionais.
CarveOutput
O payload que um guest do Provider retorna da sua exportação carve: as unidades endereçáveis ordenadas em que ele dividiu o arquivo. Uma unidade estruturada carrega uma árvore (um destino de PATCH); uma unidade opaca carrega apenas o seu tipo de mídia e os seus bytes.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
units | object[] | sim | As unidades endereçáveis ordenadas em que o guest dividiu o arquivo. |
Não são permitidas propriedades adicionais.
ReassembleInput
O payload que um guest do Provider recebe na sua exportação opcional reassemble: o arquivo original mais as suas unidades divididas e as unidades modificadas por patch que uma etapa de pipeline produziu, para que o guest reinsira cirurgicamente as alterações nos bytes originais. Um token ausente do conjunto modificado é reunido literalmente a partir dos seus bytes originais; em um token modificado, apenas os seus intervalos de bytes endereçados são editados.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | O nome do arquivo de saída, correspondente ao nome sob o qual o mesmo arquivo foi dividido. |
body | string | sim | Os bytes do arquivo original nos quais a remontagem reinsere as unidades modificadas. Cada kit os carrega no seu próprio tipo de campo — brutos onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest decodifica para recuperá-los — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão carrega bytes. |
segs | object[] | não | As unidades em que o arquivo foi dividido, tal como carve as retornou. |
patched | object[] | não | As unidades que uma etapa de pipeline alterou, cada uma carregando o seu token, a árvore modificada e as ops que produziram a alteração. |
yaml_indent | integer | não | A largura de indentação que o codec usa quando uma op precisa sintetizar texto estruturado novo; carregada para que a remontagem corresponda à indentação de toda a renderização. |
Não são permitidas propriedades adicionais.
ReassembleOutput
O payload que um guest do Provider retorna da sua exportação reassemble: os bytes do arquivo com as unidades modificadas reinseridas. A remontagem é fiel byte a byte — todo byte que as ops não tocaram sobrevive literalmente.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
body | string | sim | Os bytes do arquivo remontado que o host escreve literalmente. Cada kit os carrega no seu próprio tipo de campo — brutos onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest decodifica para recuperá-los — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão carrega bytes. |
Não são permitidas propriedades adicionais.
NameBoundInput
O payload que um guest do Provider recebe na sua exportação opcional name_bound: um nome que o host propõe usar como identidade de componente de um nó, para que o guest o julgue em relação a cada nome que derivaria dele para o seu destino, junto com os fatos do workload resolvido do nó dos quais alguns desses nomes dependem, quando a identidade é definida depois de esse workload ser resolvido. O guest responde com uma restrição em vez de com um nome próprio — um nome derivado que voltasse colocaria o host na tarefa de compor nomes para um destino sobre o qual ele nada sabe, que é exatamente o que fazer a pergunta elimina. Um provedor cujo destino limita ou restringe os nomes que aceita anuncia a exportação; um provedor cujo destino aceita qualquer nome a omite e nunca é consultado, e a sua renderização permanece inalterada.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
proposed | string | sim | O nome que o host propõe como identidade de componente do nó. O guest deriva dele, em memória, todo nome que deriva de uma identidade de componente e informa se cada um é um nome que o seu destino aceita. Um veredito diz respeito à PROPOSTA e não ao nó: o host faz uma única pergunta onde quer que componha uma identidade, e não diz para quais nomes desse nó essa identidade acabará sendo a base, de modo que um guest responde como se ela fosse a base de todos eles. Essa é a direção conservadora, porque o host apenas encurta com base na resposta e nunca alonga — um nome que o nó de fato derivará de algum outro valor carregado é, portanto, julgado com rigor demais em vez de com folga demais. |
authored | booleano | não | Se o nome proposto é um que uma pessoa escreveu em vez de um que o compilador compôs a partir de partes escritas pelo autor. Ele é carregado para que um guest possa formular o seu motivo para o leitor que é capaz de agir com base nele. Ele não decide o que uma recusa faz: um nome escrito pelo autor é recusado e um composto é encurtado, e essa decisão cabe ao host. |
workload_form | string | não | A forma do workload em que a Recipe ou a FeatureRecipe do nó se resolve, tal como o seu template de workload a produziu, transportada quando a identidade é definida depois de esse workload ser resolvido e o workload declara uma forma. Ela é transportada como escrita; o host não a interpreta. Um guest cujo destino limita um nome que ele emite para uma única forma — um job agendado, cujo nome o destino mantém mais curto que os seus outros nomes porque um sufixo é acrescentado a ele a cada execução — a lê para julgar esse nome. Ausente significa que o host não transporta nenhuma forma para esta pergunta: o nó não declara nenhum workload, o seu workload não declara nenhuma forma, ou a identidade é definida antes de qualquer workload ser resolvido. Nesse caso, um guest não julga nenhum nome que dependa da forma e responde exatamente como responderia se o campo não existisse. |
service_keys | string[] | não | As chaves dos Services que o workload resolvido do nó declara, na ordem em que o workload as declara, transportadas quando a identidade é definida depois de esse workload ser resolvido e o workload declara algum. Um guest cujo destino nomeia cada Service que emite para o nó a partir da identidade de componente e da chave do Service as lê para julgar cada um desses nomes. Uma chave é escrita pelo autor da Recipe ou da FeatureRecipe, e não por quem escreveu a identidade, então um guest redige a recusa que uma chave causa também para esse autor. Ausente significa que o host não transporta nenhuma chave para esta pergunta: o nó não declara nenhum workload, o seu workload não declara nenhum Service, ou a identidade é definida antes de qualquer workload ser resolvido. Nesse caso, um guest não julga nenhum nome construído a partir de uma chave de Service e responde exatamente como responderia se o campo não existisse. |
Não são permitidas propriedades adicionais.
DerivedNameVerdict
O veredito de um tipo de nome sobre uma identidade proposta: se o nome que o guest derivaria para esse tipo é um que o seu destino aceita e — onde uma identidade mais curta seria aceita — o maior comprimento que o seria. Ele carrega uma restrição e um motivo, nunca um nome que o guest construiu.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
kind | string | sim | O nome próprio do guest para o tipo de nome que este veredito cobre, escrito no vocabulário do destino e não no do compilador — o nome de release de um instalador de charts, o nome de serviço de um orquestrador de contêineres. Ele chega a um leitor literalmente em uma recusa, de modo que é escrito para alguém que conhece o destino. |
usable | booleano | sim | Se o nome que o guest derivaria para este tipo a partir da identidade proposta é um que o destino aceita. |
bound | integer | não | O maior número de caracteres que uma identidade proposta pode carregar para que o nome derivado deste tipo seja um que o destino aceite. Presente apenas em uma recusa que uma identidade mais curta satisfaria. AUSENTE significa que o comprimento não é aquilo a que o destino objetou — ou não há nenhum limite de comprimento, ou a objeção é uma que nenhum encurtamento corrige, como um caractere que a gramática do destino recusa na posição em que foi parar. A ausência é, portanto, distinta de um limite de zero, que de fato indica um comprimento: que nenhuma identidade de nenhum comprimento produz um nome aceitável deste tipo. O host encurta até um limite presente e pergunta novamente; diante de um limite ausente, ele para, porque não resta nada a tentar. |
reason | string | não | Por que o destino não aceita o nome derivado, nos próprios termos do destino, para um leitor que está decidindo o que escrever em seu lugar. Vazio quando o veredito é utilizável. |
Não são permitidas propriedades adicionais.
NameBoundOutput
O payload que um guest do Provider retorna da sua exportação name_bound: um veredito por tipo de nome que ele derivaria da identidade proposta. Uma proposta é utilizável quando todo veredito o é; onde um não o é, o host encurta a proposta até o menor limite que os vereditos de recusa carregam e pergunta de novo, e para quando um veredito de recusa não carrega nenhum limite. Uma lista de vereditos vazia significa que o guest não deriva nenhum nome de uma identidade de componente, o que é a mesma resposta que aceitar a proposta.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
names | DerivedNameVerdict[] | não | Uma entrada por tipo de nome que o guest deriva de uma identidade de componente, na ordem própria do guest. Um guest informa todo tipo que derivaria, em vez de apenas os tipos que recusaram, de modo que um leitor vê quais nomes foram julgados e um host que lê as entradas não precisa de uma segunda chamada para saber o restante. |
error | string | não | Uma mensagem de falha definida quando o guest foi executado, mas não conseguiu concluir a operação; ausente em caso de sucesso. É distinta de um veredito de recusa: um veredito informa um nome que o destino não aceitará, enquanto error informa que a própria pergunta não pôde ser respondida. O host apresenta um error presente como uma invocação de plugin com falha. |
condition_code | string | não | A identidade descritiva e identificável por máquina da condição que a falha nomeia — o código sob o qual a condição está registrada, no mesmo conjunto aberto em que o compilador registra as suas próprias condições de interrupção, e não um membro do catálogo fechado de códigos de erro das funções de host do qual o hostfunc_error_code de um envelope de resposta é extraído. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. Um guest que interrompe a execução informa aqui o identificador da condição que a sua mensagem nomeia, de modo que um consumidor se ramifica com base nele em vez de recuperar uma identidade lendo a mensagem. O host resolve este identificador em relação às condições que o compilador declara e publica os identificadores próprios da condição resolvida no diagnóstico estruturado, de modo que um código que chega a um leitor sempre se resolve; um identificador que não nomeia nenhuma condição desse tipo, ou um que a numeração retirou, interrompe o build. Um guest sem uma condição precisa a nomear recorre, em vez disso, a uma das condições genéricas de falha de plugin que o compilador declara para esse fim, e coloca os detalhes na sua própria mensagem. Este identificador e condition_short_code são informados juntos, porque nomeiam uma mesma condição em duas formas: um guest que define um e não o outro nomeou uma condição que o host não consegue resolver, e o host então informa a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem ainda carrega a falha completa. |
condition_short_code | string | não | O identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola em um relatório — definido ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. O host o imprime no cabeçalho entre colchetes do diagnóstico que produz para essa falha, de modo que uma condição que um guest gera pode ser citada exatamente como uma que o compilador gera. O host resolve o valor em relação às condições que o compilador declara em vez de carregá-lo por confiança: um valor que não nomeia nenhuma condição desse tipo, um valor que a numeração retirou ou uma grafia que o registro não carrega interrompe o build e cita o valor problemático, com a mensagem própria do guest ainda informada. Ele é informado junto com condition_code, pelo motivo indicado lá. |
Não são permitidas propriedades adicionais.
RenderedNameInput
O payload que um guest do Provider recebe na sua exportação opcional rendered_name: as duas identidades das quais um destino deriva os seus próprios nomes, e quais tipos de entrada a Recipe do nó declara — uma origem fornecida pelo autor, um workload que o guest sintetiza. O guest responde com o nome que o seu destino dará aos recursos que renderiza para esse nó: para uma origem fornecida, o nome em relação ao qual os próprios templates do autor são renderizados, como o nome de release que um chart lê; para um workload sintetizado, o nome que o guest dá aos recursos que constrói, onde deriva um em vez de escrever a identidade do nó como está. Um guest que não deriva nenhum nome desse tipo não informa nenhum, o que é a resposta honesta para um destino cujos nomes de recursos uma Recipe escreve literalmente, e para um cujo nome é função de onde os arquivos são colocados, e não do nó. Esta exportação informa um nome que o próprio guest compõe e não é a troca que pede ao guest que julgue um nome proposto pelo host; são perguntas diferentes, e cada uma tem a sua própria exportação.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
node_id | string | sim | A identidade própria do nó, como foi escrita. É carregada sem codificação: um destino a restringe por meio do seu próprio alfabeto, de modo que codificá-la antes colocaria um escape dentro de outro e grafaria o nome de forma diferente daquele pelo qual o autor de uma receita o prevê. |
derived_name_basis | string | não | A identidade em relação à qual a origem própria de um contribuidor é renderizada quando não é a do próprio nó — definida para um contribuidor cuja identidade o alfabeto de nomes de um destino recusa, ausente caso contrário. Um guest resolve o par da mesma forma que qualquer outra superfície: este valor quando está presente, o id do nó quando não está. |
sourced | booleano | não | Se a Recipe associada do nó declara uma origem fornecida pelo autor, lido a partir do texto que o autor escreveu. É carregado, junto com synthesized, para que a pergunta possa ser feita sobre qualquer nó e respondida corretamente: um guest não informa nenhum nome para um nó que não declara nenhum dos dois, cuja saída é apenas um conjunto de artefatos, porque os recursos de um conjunto assim são nomeados pelos artefatos que o autor escreveu, e não por um nome que o guest deriva. |
synthesized | booleano | não | Se a Recipe associada do nó declara um workload para o guest sintetizar, lido a partir do texto que o autor escreveu, assim como sourced. Um guest cujo destino nomeia os recursos que sintetiza segundo um nome que deriva, em vez de segundo a identidade do nó como está escrita, informa esse nome para um nó assim, de modo que um endereço que uma Recipe publica para um desses recursos possa ser construído a partir do nome que o recurso carrega. |
Não são permitidas propriedades adicionais.
RenderedNameOutput
O payload que um guest do Provider retorna da sua exportação rendered_name: o nome que o seu destino dá aos recursos que renderiza para o nó — a partir da origem do nó fornecida pelo autor, ou do workload que sintetiza — ou nenhum nome. Um nome ausente ou vazio é uma resposta positiva, e não uma falha — diz que este destino não deriva nenhum nome desse tipo — e o host usa o que lhe foi dito sem lê-lo, de modo que nenhum conhecimento da nomenclatura do destino atravessa a fronteira.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | não | O nome sob o qual o guest renderiza a origem deste nó fornecida pelo autor, ou que dá aos recursos que sintetiza para o nó, já escrito no alfabeto que o seu destino aceita nessa posição. Vazio ou ausente significa que o guest não deriva nenhum nome desse tipo. |
error | string | não | Uma mensagem de falha definida quando o guest foi executado, mas não conseguiu concluir a operação; ausente em caso de sucesso. É distinta de não informar nenhum nome: nenhum nome é uma resposta sobre o destino, enquanto error informa que a própria pergunta não pôde ser respondida. O host apresenta um error presente como uma invocação de plugin com falha. |
condition_code | string | não | A identidade descritiva e identificável por máquina da condição que a falha nomeia — o código sob o qual a condição está registrada, no mesmo conjunto aberto em que o compilador registra as suas próprias condições de interrupção. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. O host resolve este identificador em relação às condições que o compilador declara e publica os identificadores próprios da condição resolvida no diagnóstico estruturado, de modo que um código que chega a um leitor sempre se resolve; um identificador que não nomeia nenhuma condição desse tipo, ou um que a numeração retirou, interrompe o build. Um guest sem uma condição precisa a nomear recorre, em vez disso, a uma das condições genéricas de falha de plugin que o compilador declara para esse fim, e coloca os detalhes na sua própria mensagem. Este identificador e condition_short_code são informados juntos, porque nomeiam uma mesma condição em duas formas: um guest que define um e não o outro nomeou uma condição que o host não consegue resolver, e o host então informa a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem ainda carrega a falha completa. |
condition_short_code | string | não | O identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola em um relatório — definido ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. O host o imprime no cabeçalho entre colchetes do diagnóstico que produz para essa falha, de modo que uma condição que um guest gera pode ser citada exatamente como uma que o compilador gera. O host resolve o valor em relação às condições que o compilador declara em vez de carregá-lo por confiança: um valor que não nomeia nenhuma condição desse tipo, um valor que a numeração retirou ou uma grafia que o registro não carrega interrompe o build e cita o valor problemático, com a mensagem própria do guest ainda informada. Ele é informado junto com condition_code, pelo motivo indicado lá. |
Não são permitidas propriedades adicionais.
LinkEndpoint
Um endpoint de um link entre fronteiras: o nó, o caminho da fronteira no qual a sua saída renderizada é montada e o provedor que o renderizou. Os dois endpoints de um link nomeiam as extremidades consumidora e consumida de uma aresta uses cujas extremidades são montadas em grupos de despacho diferentes.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
node | string | sim | O id absoluto do nó do endpoint dentro do grafo da topologia. |
boundary | string | sim | O caminho da fronteira do endpoint — o grupo de despacho no qual a sua saída renderizada é montada. |
provider | string | sim | O provedor que renderizou o endpoint (o nome simples do provedor). Ambos os endpoints de um link conectado nomeiam o mesmo provedor; o host não roteia um link cujos endpoints nomeiam provedores diferentes. |
release | string | não | A Release à qual pertence a saída renderizada do endpoint — o escopo dentro do qual os seus artefatos montados são nomeados. O host a monta a partir da Release que o build resolveu e a repassa literalmente; ele não infere nenhum significado do valor. Um provedor a lê para restringir à Release o escopo de um nome de referência cruzada. Um valor ausente é a string vazia, que um provedor trata como um nome sem escopo. |
Não são permitidas propriedades adicionais.
LinkEdge
O payload por aresta generalizado e agnóstico em relação ao domínio que o host monta para uma aresta uses cujas extremidades consumidora e consumida são montadas em grupos de despacho diferentes. Ele carrega ambos os endpoints, as anotações de posicionamento de ambos os endpoints como mapas escalares opacos que o host não interpreta, a saída provides do endpoint consumido, e o socket e o mapeamento inject que a aresta conecta. Um provedor o lê para produzir a fiação de referência cruzada nativa do provedor de que as duas extremidades precisam; o host o monta e repassa o mapa de anotações como escalares opacos, sem inferir nenhum significado de nenhum valor.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
source | LinkEndpoint | sim | O endpoint consumidor — a extremidade de origem da aresta uses direcionada, em cuja saída montada a fiação do lado do consumidor é injetada. |
target | LinkEndpoint | sim | O endpoint consumido — a extremidade de destino para a qual a aresta uses aponta, cuja saída montada a fiação do lado do produtor publica. |
target_annotations | mapa de string | não | As anotações de posicionamento do endpoint consumido (destino) como um mapa escalar opaco, indexado por nome de anotação. O host as monta a partir das anotações resolvidas do destino e as repassa literalmente; ele não infere nenhum significado de nenhum valor. Um provedor as lê para decidir como moldar uma referência cruzada (por exemplo, se as duas extremidades compartilham um posicionamento ou precisam de uma referência entre posicionamentos). As chaves são serializadas ordenadas para que o payload seja idêntico byte a byte entre execuções com entrada idêntica. |
source_annotations | mapa de string | não | As anotações de posicionamento do endpoint consumidor (origem) como um mapa escalar opaco, indexado por nome de anotação. O host as monta a partir das anotações resolvidas da origem e as repassa literalmente; ele não infere nenhum significado de nenhum valor. Um provedor as lê para comparar o posicionamento das duas extremidades — por exemplo, se a origem e o destino compartilham um posicionamento ou ficam em posicionamentos diferentes. As chaves são serializadas ordenadas para que o payload seja idêntico byte a byte entre execuções com entrada idêntica. |
socket | string | sim | O alias de socket sob o qual a aresta uses está associada. |
provides | mapa de string | sim | A saída provides do endpoint consumido, um conjunto de chaves na ordem do autor que expõe as saídas declaradas do destino. Preserva a ordem do autor para que o payload seja idêntico byte a byte entre execuções com entrada idêntica. |
inject | object | sim | O mapeamento inject do endpoint consumidor, indexado por mecanismo de entrega para um conjunto de chaves na ordem do autor, que descreve como a extremidade consumidora recebe a saída do endpoint consumido. Preserva a ordem do autor para que o payload seja idêntico byte a byte entre execuções com entrada idêntica. |
read_provides_keys | string[] | não | As chaves da saída provides do endpoint consumido que os templates do endpoint consumidor leem diretamente por meio de .context.uses, quer o mapeamento inject também as entregue ou não, na ordem do autor de provides. Cada entrada é uma das chaves que provides carrega. A lista viaja na aresta para que a publicação do lado do produtor e a resolução do lado do consumidor leiam uma mesma lista. Ausente quando o endpoint consumidor não leu diretamente nenhuma chave de provides, e um provedor que não recebe nenhuma faz a fiação do link exatamente como faria se o campo não existisse. |
Não são permitidas propriedades adicionais.
LinkPatch
Um patch estrutural por arquivo que um provedor retorna como fiação de artefatos: o arquivo de saída e as operações estruturais ordenadas a aplicar a ele. Uma passagem posterior do host divide o arquivo nomeado, aplica as operações e o remonta com fidelidade byte a byte. A forma da operação é o vocabulário compartilhado de operações de patch do pipeline; ela é opaca nesta camada do esquema, de modo que um guest carrega cada operação literalmente enquanto o host realiza a operação tipada que o seu pipeline aplica.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
file | string | sim | O arquivo de saída ao qual as operações se aplicam, nomeado como o provedor o emitiu. |
ops | any[] | sim | As operações estruturais ordenadas a aplicar ao arquivo, na ordem de aplicação. |
Não são permitidas propriedades adicionais.
LinkPublishInput
O payload que um provedor recebe na sua exportação link_publish: um link entre fronteiras cuja saída do endpoint consumido é referenciada através de uma fronteira, e os arquivos montados desse endpoint. A exportação retorna a identidade publicada em relação à qual o consumidor resolve e qualquer fiação de artefatos do lado do produtor de que a saída do endpoint consumido precise.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
edge | LinkEdge | sim | O link entre fronteiras que está sendo publicado, lido do lado do endpoint consumido (destino). |
producer_files | RenderedFile[] | não | Os arquivos montados do endpoint consumido, para que o provedor possa ler o que esse endpoint já declara e verificar em relação a eles os nomes que está prestes a publicar. Cada um nomeia o seu caminho em disco e carrega os bytes montados. Ausente quando o host não tem nenhuma saída montada do produtor para entregar à publicação; um provedor que não precisa de nenhum documento para escrever a sua fiação o ignora. |
Não são permitidas propriedades adicionais.
LinkPublishOutput
O payload que um provedor retorna da sua exportação link_publish: o handle da identidade publicada em relação ao qual o consumidor resolve, e a fiação de artefatos do lado do produtor a aplicar à saída montada do endpoint consumido.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
handle | mapa de string | sim | A identidade publicada que o endpoint consumido expõe para o consumidor resolver em relação a ela, um mapa opaco de strings de ponteiro determinísticas indexado por nome de campo (por exemplo, um nome de export, um nome de stack, uma região, uma referência de função). Os valores são strings de ponteiro determinísticas que o compilador canaliza e nunca resolve; o ambiente de runtime as resolve no momento da implantação. As chaves são serializadas ordenadas para que o payload seja idêntico byte a byte entre execuções com entrada idêntica. |
patches | LinkPatch[] | não | A fiação de artefatos do lado do produtor, um patch estrutural por arquivo de saída do endpoint consumido que a publicação precisa editar. Vazio quando a saída do endpoint consumido não precisa de nenhuma alteração para o link. |
error | string | não | Uma mensagem de falha definida quando o guest foi executado, mas não conseguiu publicar o link; ausente em caso de sucesso. O host apresenta um error presente como uma invocação de plugin com falha. Uma publicação que não pode prosseguir — um nome de export que o stack já declara sob outra entrada, por exemplo — é informada aqui, e não apenas como um crash, de modo que a condição por trás dela possa ser nomeada. |
condition_code | string | não | A identidade descritiva e identificável por máquina da condição que a falha nomeia — o código sob o qual a condição está registrada, no mesmo conjunto aberto em que o compilador registra as suas próprias condições de interrupção, e não um membro do catálogo fechado de códigos de erro das funções de host do qual o hostfunc_error_code de um envelope de resposta é extraído. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. Um guest que interrompe a execução informa aqui o identificador da condição que a sua mensagem nomeia, de modo que um consumidor se ramifica com base nele em vez de recuperar uma identidade lendo a mensagem. O host resolve este identificador em relação às condições que o compilador declara e publica os identificadores próprios da condição resolvida no diagnóstico estruturado, de modo que um código que chega a um leitor sempre se resolve; um identificador que não nomeia nenhuma condição desse tipo, ou um que a numeração retirou, interrompe o build. Um guest sem uma condição precisa a nomear recorre, em vez disso, a uma das condições genéricas de falha de plugin que o compilador declara para esse fim, e coloca os detalhes na sua própria mensagem. Este identificador e condition_short_code são informados juntos, porque nomeiam uma mesma condição em duas formas: um guest que define um e não o outro nomeou uma condição que o host não consegue resolver, e o host então informa a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem ainda carrega a falha completa. |
condition_short_code | string | não | O identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola em um relatório — definido ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. O host o imprime no cabeçalho entre colchetes do diagnóstico que produz para essa falha, de modo que uma condição que um guest gera pode ser citada exatamente como uma que o compilador gera. O host resolve o valor em relação às condições que o compilador declara em vez de carregá-lo por confiança: um valor que não nomeia nenhuma condição desse tipo, um valor que a numeração retirou ou uma grafia que o registro não carrega interrompe o build e cita o valor problemático, com a mensagem própria do guest ainda informada. Ele é informado junto com condition_code, pelo motivo indicado lá. |
Não são permitidas propriedades adicionais.
LinkResolveInput
O payload que um provedor recebe na sua exportação link_resolve: um link entre fronteiras, o handle da identidade publicada que o seu endpoint consumido expôs e os arquivos montados do endpoint consumidor. A exportação retorna a fiação de artefatos do lado do consumidor que injeta a referência na saída montada do endpoint consumidor.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
edge | LinkEdge | sim | O link entre fronteiras que está sendo resolvido, lido do lado do endpoint consumidor (origem). |
handle | mapa de string | sim | O handle da identidade publicada que o link_publish do endpoint consumido retornou, em relação ao qual o consumidor resolve a sua referência. Strings de ponteiro determinísticas opacas indexadas por nome de campo; o compilador as canaliza e nunca as resolve. As chaves são serializadas ordenadas para que o payload seja idêntico byte a byte entre execuções com entrada idêntica. |
consumer_files | RenderedFile[] | não | Os arquivos montados do endpoint consumidor, para que o provedor possa localizar o placeholder que o host carimbou na saída consumidora e escrever a sua substituição no caminho real do placeholder. Cada um nomeia o seu caminho em disco e carrega os bytes montados. Ausente quando o host não tem nenhuma saída montada do consumidor para entregar à resolução; um provedor que não precisa de nenhum documento para escrever a sua fiação o ignora. |
Não são permitidas propriedades adicionais.
LinkResolveOutput
O payload que um provedor retorna da sua exportação link_resolve: a fiação de artefatos do lado do consumidor a aplicar à saída montada do endpoint consumidor, injetando a referência à identidade publicada do endpoint consumido.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
patches | LinkPatch[] | sim | A fiação de artefatos do lado do consumidor, um patch estrutural por arquivo de saída do endpoint consumidor que a resolução precisa editar. |
error | string | não | Uma mensagem de falha definida quando o guest foi executado, mas não conseguiu resolver o link; ausente em caso de sucesso. O host apresenta um error presente como uma invocação de plugin com falha. Uma resolução que não pode prosseguir — uma referência que o destino só pode carregar como um escalar inteiro, encontrada dentro de uma string maior — é informada aqui, e não apenas como um crash, de modo que a condição por trás dela possa ser nomeada. |
condition_code | string | não | A identidade descritiva e identificável por máquina da condição que a falha nomeia — o código sob o qual a condição está registrada, no mesmo conjunto aberto em que o compilador registra as suas próprias condições de interrupção, e não um membro do catálogo fechado de códigos de erro das funções de host do qual o hostfunc_error_code de um envelope de resposta é extraído. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. Um guest que interrompe a execução informa aqui o identificador da condição que a sua mensagem nomeia, de modo que um consumidor se ramifica com base nele em vez de recuperar uma identidade lendo a mensagem. O host resolve este identificador em relação às condições que o compilador declara e publica os identificadores próprios da condição resolvida no diagnóstico estruturado, de modo que um código que chega a um leitor sempre se resolve; um identificador que não nomeia nenhuma condição desse tipo, ou um que a numeração retirou, interrompe o build. Um guest sem uma condição precisa a nomear recorre, em vez disso, a uma das condições genéricas de falha de plugin que o compilador declara para esse fim, e coloca os detalhes na sua própria mensagem. Este identificador e condition_short_code são informados juntos, porque nomeiam uma mesma condição em duas formas: um guest que define um e não o outro nomeou uma condição que o host não consegue resolver, e o host então informa a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem ainda carrega a falha completa. |
condition_short_code | string | não | O identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola em um relatório — definido ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não nomeia nenhuma condição desse tipo. O host o imprime no cabeçalho entre colchetes do diagnóstico que produz para essa falha, de modo que uma condição que um guest gera pode ser citada exatamente como uma que o compilador gera. O host resolve o valor em relação às condições que o compilador declara em vez de carregá-lo por confiança: um valor que não nomeia nenhuma condição desse tipo, um valor que a numeração retirou ou uma grafia que o registro não carrega interrompe o build e cita o valor problemático, com a mensagem própria do guest ainda informada. Ele é informado junto com condition_code, pelo motivo indicado lá. |
Não são permitidas propriedades adicionais.