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

Esquema do socket Wasm de renderização do Provider do Aggrega

Referência gerada. Não editar à mão — gerar novamente a partir do JSON Schema publicado.

ID do esquema: https://aggrega.ai/schemas/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 ficheiros de saída através da sua exportação render_node (de RenderNodeInput para RenderNodeOutput) e, opcionalmente, funde as saídas por nó de uma fronteira num único artefacto montado através da sua exportação assemble_boundary (de AssembleBoundaryInput para AssembleBoundaryOutput). AssembleBoundaryOutput transporta os ficheiros montados e quaisquer diagnósticos; o local onde ficam os ficheiros de cada contribuidor é 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: consome a mesma projeção RenderNodeInput que render_node recebe e devolve um ValidateNodeOutput que transporta apenas diagnósticos — um diagnóstico de severidade halt para 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ó: consome um NameBoundInput que transporta um nome proposto e devolve um NameBoundOutput que transporta um veredicto por cada tipo de nome que o guest derivaria dele. Um veredicto transporta uma restrição — utilizável, ou limitado a um comprimento menor — e nunca um nome que o guest tenha construído, pelo 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: consome um RenderedNameInput que transporta as identidades a partir das quais o destino deriva e os tipos de entrada que a Recipe do nó declara, e devolve um RenderedNameOutput que transporta 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 avalie um nome que o host propõe, enquanto rendered_name reporta um nome que o guest compôs, que o host transporta sem o ler. Um guest também pode declarar carve e reassemble, que dividem a sua própria saída em unidades endereçáveis para um passo de pipeline e voltam a juntar as unidades modificadas por patch, e link_publish e link_resolve, que fazem a cablagem de 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 indica: 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, pelo que uma ferramenta que valida um payload procura aí 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 devolve os bytes serializados de cada ficheiro de saída; o host escreve-os literalmente e não executa nenhum serializador, pelo que o determinismo é responsabilidade do guest: uma entrada idêntica tem de 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, pelo que as três linguagens leem e escrevem o mesmo formato de transmissão; um guest importa-os desses pacotes, ou através 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 indica.

ExportaçãoEntradaSaída
render_nodeRenderNodeInputRenderNodeOutput
validate_node_inputRenderNodeInputValidateNodeOutput
assemble_boundaryAssembleBoundaryInputAssembleBoundaryOutput
carveCarveInputCarveOutput
reassembleReassembleInputReassembleOutput
name_boundNameBoundInputNameBoundOutput
rendered_nameRenderedNameInputRenderedNameOutput
link_publishLinkPublishInputLinkPublishOutput
link_resolveLinkResolveInputLinkResolveOutput

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 artefactos —, cada uma presente apenas quando essa Recipe a declara, e as entradas que indicam unidades renderizadas que o guest deixa de fora de uma renderização de origem.

PropriedadeTipoObrigatóriaDescrição
nodeIRNodeProjectionsimOs dados IR por nó que um guest do Provider renderiza — uma projeção delimitada do nó IR completo que transporta 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, os anexos 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 transportadas separadamente porque respondem a duas perguntas — a que pertence um recurso, e em relação a que é renderizada a origem própria de um autor — e um anexo de Feature que entrega uma origem escrita pelo seu autor é onde as duas respostas diferem. O conteúdo dos ficheiros de origem não é transportado aqui; viaja separadamente na projeção da origem. Cada conjunto de chaves aqui tem uma ordem fixa — features e uses pela ordem do autor, values e a marcação de sensibilidade pela ordem das chaves ordenadas — pelo que o payload transmitido é idêntico byte a byte entre execuções com entrada idêntica.
contextobjetosimO 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 um passo 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 consoante o local 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é ao 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 âmbito de fronteira, que não tem componente host, recebe o contexto que o seu passo de pipeline recebe, mais yaml_indent: parameters; annotations que transporta apenas o compartimento release, que é o conjunto de anotações próprio da fronteira; e um boundary que transporta 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, pelo que uma chave que ambos transportam assume o valor da Release; um fornecedor da biblioteca padrão lê-as desse conjunto em camadas e nunca do compartimento catalog, pelo que um valor do catálogo nunca decide nenhuma delas, e uma FeatureRecipe com âmbito de fronteira, cujo contexto não transporta nenhum compartimento aggregate, renderiza pelos valores da sua fronteira e não pelos de qualquer componente.
source_listingSourceListingnãoA enumeração genérica da origem adquirida que o host entrega ao guest para um fornecedor com origem: a raiz da origem, se essa raiz é um diretório, e as entradas ordenadas relativas à raiz que se encontram sob ela. Aqui o host não lê nenhum conteúdo de ficheiro — 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 através da função do anfitrião pack-source, pelo que toda a inteligência de resolução de origem específica de cada fornecedor reside no guest. Presente para fornecedores com origem; ausente caso contrário.
workload_projectionWorkloadProjectionnãoO workload pré-avaliado que o host entrega ao guest para que este sintetize a partir dele manifestos nativos do fornecedor; presente quando a Recipe associada declara um workload em vez de uma origem de chart, ausente caso contrário.
artifacts_projectionArtifactsProjectionnãoO conjunto de artefactos pré-avaliado que o host entrega ao guest para que este o coloque na saída do nó, presente quando a Recipe associada declara artefactos. O host já leu a origem de cada entrada, avaliou-a como um template Go em relação ao 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 artefacto.
omitsOmitEntry[]nãoAs entradas que indicam unidades renderizadas que o guest deixa de fora da saída deste nó, pela 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 é transportada. O que o kind, o name, o namespace e o subchart de uma entrada selecionam é o contrato documentado próprio deste fornecedor, 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 devolve cada unidade a que uma entrada corresponde — os seus ficheiros, os nomes que declara em derived_keys e os factos que reporta em render_facts — e reporta 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 artefactos nunca as transporta. 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 transporta 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, os anexos 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 transportadas separadamente porque respondem a duas perguntas — a que pertence um recurso, e em relação a que é renderizada a origem própria de um autor — e um anexo de Feature que entrega uma origem escrita pelo seu autor é onde as duas respostas diferem. O conteúdo dos ficheiros de origem não é transportado aqui; viaja separadamente na projeção da origem. Cada conjunto de chaves aqui tem uma ordem fixa — features e uses pela ordem do autor, values e a marcação de sensibilidade pela ordem das chaves ordenadas — pelo que o payload transmitido é idêntico byte a byte entre execuções com entrada idêntica.

PropriedadeTipoObrigatóriaDescrição
idstringsimO id absoluto do nó dentro do grafo de topologia.
typestringsimDeclarado e deliberadamente retido: o host emite-o sempre como string vazia. A etiqueta de tipo de componente do nó é um metadado opaco e não um comutador de comportamento, pelo que transportá-la aqui só convidaria um guest a ramificar com base nela. 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 transporta um tipo próprio, para um propósito diferente.)
resolved_recipestringsimDeclarado e deliberadamente retido: o host emite-o sempre como string vazia. A identidade da Recipe associada já chega ao guest como o nome e a versão da receita que este carimba na proveniência, pelo que o URI resolvido não acrescenta nada a partir do qual um guest renderize. Um guest que precise de atribuir a saída a uma Recipe lê antes esses campos de proveniência.
valuesobjetonãoO dicionário de valores renderizados do nó, o conjunto de chaves a partir do qual o guest renderiza. As chaves chegam ordenadas, não pela 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 impõe-na ele próprio.
featuresobjetonãoOs anexos de feature do nó indexados por alias de feature, transportando a mesma forma de anexo de feature por nó que o IR transporta. Cada entrada transporta os values, o infra e o mapeamento inject do anexo juntamente com a sua marcação de sensibilidade derivada, pelo que um guest lê apenas a partir do payload se um anexo trata material declarado sensível. Preserva a ordem do autor, pelo 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 através do contrato de transmissão do IR.
sensitive_rendered_keysmapa de stringnãoChaves 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. Aquilo que uma chave indica segue a forma que este payload transporta: num payload que transporta os valores do nó, é uma das chaves desse mapa; num payload que transporta um workload, indica uma entrada nos mapas de anexo próprios do workload, onde os valores do nó estão vazios. Uma chave só está presente onde a recuperação é exata, ligando uma declaração a uma identidade renderizada sem nada lido do texto próprio da chave e sem qualquer marcação por nó ou por anexo distribuída por chaves individuais. Uma chave inventada por um template está, por isso, ausente, porque nenhuma declaração a indica: as chaves de saída do valuesMapping de uma receita, e o conteúdo de um artefacto, são escritos por template, pelo que nenhum dos dois produz aqui uma chave — se tal payload foi produzido a partir de um valor declarado sensível é transportado, em vez disso, por sensitive_values e pelo sensitive_content próprio de uma entrada de artefacto. A ausência indica, por isso, que a identidade de nenhuma chave pôde ser recuperada, nunca que nada neste payload transporta material sensível — um guest que lê uma chave ausente como permissão para mostrar ou emitir um valor em claro leu-a 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_valuesbooleananãoVerdadeiro quando os valores que este payload transporta 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 sua, pelo que nenhuma chave dessa saída pode ser rastreada até ao dado de onde veio e, em vez disso, é marcado o mapa inteiro. É 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 passa adiante 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 lido por uma pessoa, uma recusa ou um aviso, mantém todos os valores dos valores do nó fora desse texto quando isto é verdadeiro, e mantém fora o valor sob qualquer chave que sensitive_rendered_keys indique, quer o seja quer não: os dois compõem-se, um indicando as chaves cuja identidade é recuperada exatamente e este cobrindo o mapa onde nenhuma o 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 num payload que não transporta valores. A ausência nunca indica que nenhum valor é sensível.
values_mappedbooleananãoVerdadeiro quando os valores que este payload transporta são a saída do valuesMapping da Recipe ou da FeatureRecipe associada, em vez dos valores do nó passados tal 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 por ler os valores escritos para outra coisa, como os artefactos da Recipe; um guest que liga os valores do nó à sua origem independentemente de como foram produzidos não o lê. Regista como os valores foram produzidos e nunca é derivado do nome de uma chave nem do conteúdo de um valor. Ausente onde nenhum valuesMapping foi executado, e num payload que não transporta valores.
usesmapa de string[]nãoDeclarado e deliberadamente retido: o host nunca o preenche, pelo que o mapa está ausente de todos os payloads 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 transportando os ids ordenados dos nós de destino desse socket pela ordem do autor.
boundary_pathstringnãoO caminho da fronteira do nó, carimbado como a anotação aggrega.ai/boundary-path em cada manifesto emitido que transporta um bloco metadata.
sync_waveintegernãoA wave de implementação herdada da fronteira que contém este nó (predefinição 0; valores negativos permitidos), transportando o valor que o nó IR detém como sync_wave. O que um guest faz com ela é escolha do próprio guest, e registar 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 fornecedores da biblioteca padrão: helm e helm-chart emitem-na como uma anotação argocd.argoproj.io/sync-wave em cada recurso renderizado e, adicionalmente, como helm.sh/hook-weight num recurso que o chart já marca como hook do Helm; compose regista-a como etiqueta de serviço e ordena os serviços do ficheiro no qual renderiza, através de depends_on entre eles; cloudformation ordena o aprovisionamento da stack montada, declarando que cada recurso de uma wave depende dos recursos da wave anterior; terraform ordena os blocos de módulo da configuração raiz na qual uma fronteira é montada, declarando que cada módulo de uma wave depende dos módulos da wave anterior, e também a regista com a proveniência do build do nó.
recipe_namestringnãoO 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_versionstringnãoA 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_idstringnãoA identidade de componente segura para Kubernetes — aquilo a que PERTENCE um recurso que este nó emite, que é o que a proveniência regista e o que um seletor consulta. Quando não está vazia, substitui o id do nó como valor das etiquetas app.kubernetes.io/name e aggrega.ai/component-id; vazia significa que o id do nó já é válido como etiqueta e é usado diretamente. É transportada para cada recurso que um anexo de Feature emite, seja qual for a forma como o anexo os entrega, pelo que os recursos de um anexo se distinguem dos do seu componente host apenas pela etiqueta. Aquilo a partir do qual um guest deriva os seus próprios nomes é transportado separadamente, derived_name_basis, e os dois respondem a perguntas diferentes.
derived_name_basisstringnãoA 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, segundo o qual tal guest também pode nomear os recursos que sintetiza para um componente, e o prefixo dos ficheiros 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 um anexo de Feature por componente: um anexo que entrega um chart ou um fragmento escrito pelo seu autor renderiza-o em relação ao nome do componente HOST, porque os templates próprios do autor nomeiam os recursos segundo esse nome e um nome diferente mudaria o nome de recursos já implementados. Um nó cujo id transporta uma sintaxe de marcador que o alfabeto de nomes de um destino recusa transporta este valor explicitamente em vez disso, pelo que o nome que um guest deriva continua a ser um que o destino aceita. É deliberadamente separada de label_component_id: um guest que CONSTRÓI recursos para um anexo de Feature em vez de renderizar a origem do seu autor nomeia-os segundo a identidade, pelo que os recursos próprios do anexo não podem colidir com os do seu host, enquanto o nome em relação ao qual a origem de um autor é renderizada se mantém. As duas transportam o mesmo valor sempre que a identidade de um nó é também aquilo em relação ao qual a sua origem é renderizada.
output_labelsmapa de stringnãoAs etiquetas de saída declaradas pelo autor da receita que o guest carimba em cada manifesto emitido juntamente com a proveniência da identidade do build, indexadas por nome de etiqueta. Dois blocos escritos pelo autor fundem-se neste único mapa: os pares chave-valor literais que uma receita escreve em outputLabels, e uma entrada para cada chave que uma receita indica em outputComponentLabels, cujo valor é lido dessa chave nas etiquetas próprias do componente renderizado — pelo 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 por via da validação no carregamento (nenhuma chave aggrega.ai/ ou app.kubernetes.io/), pelo que a carimbagem nunca colide com uma etiqueta de proveniência. Uma chave promovida que o componente não declara não carimba nada e gera um aviso em vez de uma etiqueta vazia. Um guest cuja saída não é YAML do Kubernetes transpõe-nas para a sua própria superfície de etiquetas (etiquetas de serviço do Compose) ou ignora-as.
provenanceNodeProvenancesimA proveniência da identidade do build que o guest carimba em cada manifesto emitido como etiquetas 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 etiquetas aggrega.ai. Cada campo é omitido quando vazio, pelo que uma identidade parcial carimba apenas as etiquetas que transporta.

PropriedadeTipoObrigatóriaDescrição
compiler_versionstringnãoA versão do compilador, carimbada como a etiqueta aggrega.ai/compiler-version quando não está vazia.
aggregate_namestringnãoO nome do agregado, carimbado como a etiqueta aggrega.ai/aggregate-name quando não está vazio.
environmentstringnãoO nome do ambiente, carimbado como a etiqueta aggrega.ai/environment quando não está vazio.
provider_namestringnãoO tipo de fornecedor simples, carimbado como a etiqueta aggrega.ai/provider quando não está vazio.
provider_versionstringnãoA versão resolvida do plugin de renderização do fornecedor, carimbada como a etiqueta aggrega.ai/provider-version quando não está vazia.

Não são permitidas propriedades adicionais.

RenderNodeOutput

O payload que um guest do Provider devolve a partir da sua exportação render_node: os bytes serializados de cada ficheiro de saída que o guest emitiu, os nomes que derivou em cada um dos seus próprios espaços de chaves, os factos que reporta sobre o que emitiu, a quantas unidades renderizadas correspondeu cada entrada omits que recebeu, e quaisquer diagnósticos que o guest levantou durante a renderização. O guest devolve os bytes serializados de cada ficheiro; o host escreve-os literalmente e não executa nenhum serializador. O determinismo é responsabilidade do guest: uma entrada idêntica tem de produzir bytes idênticos.

PropriedadeTipoObrigatóriaDescrição
filesRenderedFile[]simOs ficheiros de saída que o guest emitiu, pela ordem de emissão. Cada um indica o seu caminho em disco e transporta os bytes serializados que o host escreve literalmente.
derived_keysmapa de string[]nãoOs nomes que o guest derivou ao renderizar este nó, indexados pelo espaço de chaves no qual os derivou, cada espaço transportando os seus nomes pela 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 ficheiro que o host escreve literalmente, onde o host não o pode ver; declará-lo aqui é a forma como o guest pede ao host que confirme que duas derivações não acabaram 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 si próprio. Dois contribuidores para a mesma saída montada que declaram o mesmo nome no mesmo espaço param o build, e a paragem indica o espaço, o nome e ambos os contribuidores. Tanto os nomes dos espaços como os nomes dentro deles são o vocabulário próprio do guest: um guest que pretenda unicidade num âmbito mais estreito ou mais amplo do que uma saída montada exprime esse âmbito no nome do espaço que declara. Preserva a ordem de declaração, pelo que o payload é idêntico byte a byte entre execuções com entrada idêntica. Ausente quando o guest não deriva nomes que pretenda ver verificados, o que deixa a verificação inerte para esse guest.
render_factsRenderFact[]nãoFactos que o guest reporta sobre o que emitiu para este nó, pela ordem em que o guest os lista. Cada facto associa um nome a um valor, e ambos são o vocabulário próprio do guest: que factos um fornecedor reporta, o que cada nome significa e o que as suas entradas contêm fazem parte do contrato documentado desse fornecedor, não deste socket. O valor de cada facto é uma lista, mesmo quando contém uma única entrada: o host recusa um facto cujo valor seja qualquer outra coisa, indicando o fornecedor e o facto, e para o build. Essa é a única coisa que o host aprende sobre um valor. Indexa os factos por nome e entrega cada lista aos templates que a leem, juntando as listas de um mesmo nome reportadas por mais do que uma renderização do mesmo nó pela ordem em que essas renderizações foram executadas, e nunca aprende o que um nome ou uma entrada significa nem deriva um facto por si próprio — pelo que um fornecedor pode reportar 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. Reportar factos nunca altera o que é escrito: os ficheiros que o host escreve são os ficheiros que o guest devolveu, quer sejam acompanhados de factos quer não. O guest lista os seus factos numa ordem fixa, pelo que o payload é idêntico byte a byte entre execuções com entrada idêntica. Ausente quando o guest não reporta nada, o que é uma resposta completa e não uma resposta em falta.
omittedinteger[]nãoA quantas unidades renderizadas correspondeu cada entrada de omits recebida na entrada: uma contagem por cada entrada que o guest recebeu, pela mesma ordem, cada uma o número de unidades a que essa entrada correspondeu, quer outra entrada também lhes tenha correspondido quer 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 daquilo que o guest devolveu. Ausente quando o guest não recebeu nenhuma entrada.
diagnosticsDiagnostic[]nãoDiagnósticos que o guest levantou durante a renderização. Cada elemento tem a forma de diagnóstico partilhada dos plugins Wasm.
errorstringnãoUma mensagem de falha definida quando o guest foi executado, mas não conseguiu concluir a operação; ausente em caso de sucesso. É distinta de quaisquer diagnósticos que a saída transporte: os diagnósticos reportam problemas encontrados durante uma execução que ainda assim produziu um resultado, enquanto error reporta que a própria operação não foi concluída. O host apresenta um erro presente como uma invocação de plugin falhada.
condition_codestringnãoA identidade descritiva e identificável por máquina da condição que a falha indica — o código sob o qual a condição está registada, no mesmo conjunto aberto em que o compilador regista as suas próprias condições de paragem, e não um membro do catálogo fechado de códigos de erro das funções do anfitrião do qual é retirado o hostfunc_error_code de um envelope de resposta. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não indica nenhuma condição desse tipo. Um guest que se detém reporta aqui o identificador da condição que a sua mensagem indica, pelo 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, pelo que um código que chega a um leitor se resolve sempre; um identificador que não indica nenhuma condição desse tipo, ou um que a numeração retirou, faz parar o build. Um guest sem uma condição precisa a indicar 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 pormenores na sua própria mensagem. Este identificador e condition_short_code são reportados em conjunto, porque indicam uma mesma condição em duas formas: um guest que define um e não o outro indicou uma condição que o host não consegue resolver, e o host reporta então a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem continua a transportar a falha completa.
condition_short_codestringnãoO identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola num 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 indica nenhuma condição desse tipo. O host imprime-o no cabeçalho entre parênteses retos do diagnóstico que produz para esta falha, pelo que uma condição que um guest levanta pode ser citada exatamente como uma que o compilador levanta. O host resolve o valor em relação às condições que o compilador declara em vez de o transportar por confiança: um valor que não indica nenhuma condição desse tipo, um valor que a numeração retirou, ou uma grafia que o registo não transporta faz parar o build e cita o valor em causa, com a mensagem própria do guest ainda reportada. É reportado juntamente com condition_code, pela razão indicada aí.

Não são permitidas propriedades adicionais.

ValidateNodeOutput

O payload que um guest do Provider devolve a partir 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 ficheiro — apenas reporta diagnósticos. Um diagnóstico de severidade halt para o build de forma explícita, indicando o nó e o fornecedor; 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.

PropriedadeTipoObrigatóriaDescrição
diagnosticsDiagnostic[]nãoDiagnósticos que o guest levantou ao validar a entrada do nó. Cada elemento é a forma de diagnóstico partilhada dos plugins Wasm. Vazio quando a entrada passou na verificação estrutural.
errorstringnãoUma mensagem de falha definida quando o guest foi executado, mas não conseguiu concluir a operação; ausente em caso de sucesso. É distinta de quaisquer diagnósticos que a saída transporte: os diagnósticos reportam problemas encontrados durante uma execução que ainda assim produziu um resultado, enquanto error reporta que a própria operação não foi concluída. O host apresenta um erro presente como uma invocação de plugin falhada.
condition_codestringnãoA identidade descritiva e identificável por máquina da condição que a falha indica — o código sob o qual a condição está registada, no mesmo conjunto aberto em que o compilador regista as suas próprias condições de paragem, e não um membro do catálogo fechado de códigos de erro das funções do anfitrião do qual é retirado o hostfunc_error_code de um envelope de resposta. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não indica nenhuma condição desse tipo. Um guest que se detém reporta aqui o identificador da condição que a sua mensagem indica, pelo 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, pelo que um código que chega a um leitor se resolve sempre; um identificador que não indica nenhuma condição desse tipo, ou um que a numeração retirou, faz parar o build. Um guest sem uma condição precisa a indicar 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 pormenores na sua própria mensagem. Este identificador e condition_short_code são reportados em conjunto, porque indicam uma mesma condição em duas formas: um guest que define um e não o outro indicou uma condição que o host não consegue resolver, e o host reporta então a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem continua a transportar a falha completa.
condition_short_codestringnãoO identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola num 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 indica nenhuma condição desse tipo. O host imprime-o no cabeçalho entre parênteses retos do diagnóstico que produz para esta falha, pelo que uma condição que um guest levanta pode ser citada exatamente como uma que o compilador levanta. O host resolve o valor em relação às condições que o compilador declara em vez de o transportar por confiança: um valor que não indica nenhuma condição desse tipo, um valor que a numeração retirou, ou uma grafia que o registo não transporta faz parar o build e cita o valor em causa, com a mensagem própria do guest ainda reportada. É reportado juntamente com condition_code, pela razão indicada aí.

Não são permitidas propriedades adicionais.

RenderedFile

Um ficheiro 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, pelo que a saída em disco é idêntica byte a byte ao que o guest emitiu.

PropriedadeTipoObrigatóriaDescrição
pathstringsimO caminho do ficheiro de saída relativo à raiz de saída do nó (por exemplo, Chart.yaml ou templates/deployment.yaml).
contentstringsimOs bytes serializados do ficheiro exatamente como o guest os produziu; o host escreve esses bytes literalmente e não executa nenhum serializador, pelo que a saída é idêntica byte a byte ao que o guest emitiu. Cada kit transporta-os no seu próprio tipo de campo — em bruto onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest descodifica para os recuperar — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão transporta bytes.
formatstringnãoO formato em que o guest declara que o ficheiro emitido foi renderizado, para que o host possa encaminhar o ficheiro para 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 ficheiro.

Não são permitidas propriedades adicionais.

RenderFact

Um facto que um guest do Provider reporta sobre o que emitiu para um nó: um nome e uma lista de entradas, ambos definidos e documentados pelo fornecedor. O host transporta o facto tal como o guest o escreveu, recusa um facto cujo valor não seja uma lista e não fica a saber mais nada sobre nenhuma das duas metades.

PropriedadeTipoObrigatóriaDescrição
namestringsimO nome do facto, retirado do vocabulário documentado próprio do fornecedor.
valuearraysimO valor do facto: um array JSON — sempre uma lista, mesmo com uma única entrada ou nenhuma — cujas entradas são valores JSON quaisquer na forma que o fornecedor documenta para esse nome. Uma lista é o que permite que um nome seja reportado por mais de uma renderização de um nó: o host junta as listas numa só. É transportado como o documento JSON que o guest escreveu, byte a byte, pelo 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 indica 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 fornecedor documenta o que kind, name, namespace e subchart selecionam no seu próprio formato, e faz ele próprio a correspondência.

PropriedadeTipoObrigatóriaDescrição
kindstringsimO tipo de unidade renderizada que a entrada indica, no vocabulário próprio do fornecedor.
namestringsimO nome da unidade renderizada que a entrada indica, no vocabulário próprio do fornecedor.
namespacestringnãoO namespace em que a unidade indicada se encontra, para um fornecedor cujo formato coloca as unidades num namespace. Ausente quando o autor não escreveu nenhum; aquilo a que corresponde uma entrada sem namespace é o contrato próprio do fornecedor.
subchartstringnãoA origem aninhada de onde veio a unidade indicada, para um fornecedor cuja origem é montada a partir de origens aninhadas, como um chart o é a partir dos seus subcharts. Ausente quando o autor não escreveu nenhuma; aquilo a que corresponde uma entrada sem subchart, e o que faz um fornecedor cuja origem não tem origens aninhadas com uma entrada que indica uma, é o contrato próprio do fornecedor.
sensitivebooleananãoVerdadeiro 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 que remonta a 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 passa 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 indicar o campo, pelo 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 leia — uma recusa, um aviso ou uma linha de registo. 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 ficheiro de uma projeção da origem pré-empacotada: o seu caminho relativo à raiz da origem e os seus bytes em bruto, exatamente como o host os leu da origem local em tempo de compilação.

PropriedadeTipoObrigatóriaDescrição
pathstringsimO caminho do ficheiro relativo à raiz da origem (por exemplo, Chart.yaml ou templates/deployment.yaml).
contentstringsimOs bytes em bruto do ficheiro exatamente como o host os leu da origem local. Cada kit transporta-os no seu próprio tipo de campo — em bruto onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest descodifica para os recuperar — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão transporta bytes.

Não são permitidas propriedades adicionais.

SourceProjection

O conteúdo da origem empacotado (por ex., os ficheiros de um chart do Helm, cada um indicado pelo seu caminho relativo à raiz da origem, pela ordem de percurso) que o host lê e devolve ao guest em resposta a um pedido pack-source, pelo que o guest reconstrói a origem selecionada em memória e não toca em nenhum sistema de ficheiros. É o payload de sucesso da função do anfitrião pack-source.

PropriedadeTipoObrigatóriaDescrição
filesSourceFile[]simOs ficheiros da origem, cada um indicado pelo seu caminho relativo à raiz da origem, pela 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, pelo que uma entrada não transporta bytes.

PropriedadeTipoObrigatóriaDescrição
pathstringsimO caminho da entrada relativo à raiz da origem, separado por barras (por exemplo, Chart.yaml ou templates/deployment.yaml).
is_dirbooleanasimSe a entrada é um diretório. Um guest que resolve a raiz de um chart ou um único ficheiro de origem dentro da listagem lê este campo para distinguir diretórios de ficheiros sem tocar no sistema de ficheiros.

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 fornecedor com origem: a raiz da origem, se essa raiz é um diretório, e as entradas ordenadas relativas à raiz que se encontram sob ela. O host percorre a origem adquirida sem nenhum conhecimento do domínio e não lê nenhum conteúdo de ficheiro — 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 através da função do anfitrião 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.

PropriedadeTipoObrigatóriaDescrição
rootstringsimA localização da origem adquirida que o host enumerou. O guest transporta-a para os seus próprios diagnósticos quando não consegue resolver a origem, pelo que uma paragem por resolução indica a origem que o autor forneceu.
root_is_dirbooleananãoSe a raiz da origem adquirida é um diretório. Falso para uma origem de um único ficheiro (um documento compose isolado, um único ficheiro de módulo, um arquivo), caso em que entries está vazio e o guest empacota a própria raiz.
entriesSourceEntry[]simAs entradas relativas à raiz sob uma raiz da origem que é um diretório, ordenadas por caminho. Vazio para uma raiz da origem de um único ficheiro.

Não são permitidas propriedades adicionais.

SourcePackRequest

A seleção que um guest pede ao host que empacote a partir da origem adquirida através da função do anfitrião pack-source. op indica a forma da seleção e path indica-a em relação à raiz da origem; o host resolve o caminho sob a raiz da origem, rejeitando qualquer fuga acima dela, e devolve os bytes empacotados como um SourceProjection.

PropriedadeTipoObrigatóriaDescrição
opstring (enum)simA forma da seleção: file empacota o único ficheiro em path; dir empacota os ficheiros imediatos do diretório em path; tree empacota recursivamente toda a subárvore com raiz em path, pela ordem de percurso determinística do host. Valores permitidos: "file", "dir", "tree"
pathstringsimA localização da seleção relativa à raiz da origem, separada por barras. A string vazia (ou ”.”) indica a própria raiz da origem, pelo que uma origem de um único ficheiro é empacotada com um caminho vazio.

Não são permitidas propriedades adicionais.

SourcePackResponse

A resposta da função do anfitrião 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 através de um trap, pelo que um guest transporta uma rejeição da sandbox ou uma falha de leitura para os seus próprios diagnósticos como uma falha de renderização determinística.

PropriedadeTipoObrigatóriaDescrição
source_projectionSourceProjectionnãoA origem empacotada em caso de sucesso; ausente em caso de falha.
errorstringnãoA mensagem de erro em caso de falha, indicando a seleção e o motivo; ausente em caso de sucesso.
hostfunc_error_codestring (enum)nãoA identidade da falha identificável por máquina em caso de falha, retirada do catálogo fechado de códigos de erro das funções do anfitrião, 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 como uma função do anfitrião pode falhar, e é um vocabulário diferente das condições de paragem que o compilador regista, cujos identificadores um guest reporta numa saída de socket como condition_code e condition_short_code — o nome da chave indica a qual dos dois pertence um valor, pelo que os dois nunca são lidos como um único conjunto. Um guest ramifica-se 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 ficheiro que um guest pede ao host que execute através da função do anfitrião read-source-file, para um guest cuja lógica de resolução tem de inspecionar o conteúdo de um ficheiro antes de escolher o que empacotar. O host resolve o caminho sob a raiz da origem, rejeitando qualquer fuga acima dela, e devolve os bytes do ficheiro.

PropriedadeTipoObrigatóriaDescrição
pathstringsimA localização do ficheiro relativa à raiz da origem, separada por barras.

Não são permitidas propriedades adicionais.

SourceFileResponse

A resposta da função do anfitrião read-source-file: em caso de sucesso, os bytes do ficheiro; em caso de falha, uma mensagem de erro. Exatamente um dos dois campos é preenchido. A falha é entregue em banda em vez de através de um trap, pelo que um guest transporta uma rejeição da sandbox ou uma falha de leitura para os seus próprios diagnósticos como uma falha de renderização determinística.

PropriedadeTipoObrigatóriaDescrição
contentstringnãoOs bytes em bruto do ficheiro em caso de sucesso; ausentes em caso de falha. Cada kit transporta-os no seu próprio tipo de campo — em bruto onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest descodifica para os recuperar — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão transporta bytes.
errorstringnãoA mensagem de erro em caso de falha, indicando o ficheiro e o motivo; ausente em caso de sucesso.
hostfunc_error_codestring (enum)nãoA identidade da falha identificável por máquina em caso de falha, retirada do catálogo fechado de códigos de erro das funções do anfitrião, 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 como uma função do anfitrião pode falhar, e é um vocabulário diferente das condições de paragem que o compilador regista, cujos identificadores um guest reporta numa saída de socket como condition_code e condition_short_code — o nome da chave indica a qual dos dois pertence um valor, pelo que os dois nunca são lidos como um único conjunto. Um guest ramifica-se 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 do anfitrião fetch-external-input: em caso de sucesso, o conteúdo obtido; em caso de falha, uma mensagem de erro e o respetivo código. Uma resposta que não transporta nenhum dos dois campos de falha é um sucesso, pelo que um payload de comprimento zero é a resposta com todos os campos ausentes. A falha é entregue em banda em vez de através de um trap, pelo que um guest transporta um URL que não é possível resolver ou uma falha de obtenção para os seus próprios diagnósticos como uma falha de renderização determinística. O pedido é uma simples string de URL em vez de um payload estruturado, pelo que apenas a resposta tem uma forma declarada.

PropriedadeTipoObrigatóriaDescrição
contentstringnãoOs bytes em bruto 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 circulam como uma string de bytes, nunca como texto base64. O kit de Go mantém-nos como um slice de bytes; os kits de Rust e TypeScript mantêm-nos como uma string base64, que o wrapper de fetch de cada kit descodifica, pelo que cada wrapper devolve os bytes em bruto do payload.
errorstringnãoA mensagem de erro em caso de falha, indicando o URL e a solução; ausente em caso de sucesso.
hostfunc_error_codestring (enum)nãoA identidade da falha identificável por máquina em caso de falha, retirada do catálogo fechado de códigos de erro das funções do anfitrião, 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 como uma função do anfitrião pode falhar, e é um vocabulário diferente das condições de paragem que o compilador regista, cujos identificadores um guest reporta numa saída de socket como condition_code e condition_short_code — o nome da chave indica a qual dos dois pertence um valor, pelo que os dois nunca são lidos como um único conjunto. Um guest ramifica-se 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 fornecedor, presente quando a Recipe associada declara um workload em vez de uma origem de chart. O determinismo é responsabilidade do guest: uma entrada idêntica tem de produzir bytes idênticos.

PropriedadeTipoObrigatóriaDescrição
workloadobjetosimO 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_workloadbooleananãoVerdadeiro quando o template que produziu workload lê um valor que um autor declarou sensível, ou um valor que remonta a 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 passa 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 transportam nenhuma ligação aos dados que o seu template leu, pelo que este campo marca o documento inteiro: um guest que compõe um texto que uma pessoa leia, uma recusa ou um aviso, mantém fora desse texto todo o valor que o workload transporta quando este campo é verdadeiro, enquanto a forma do documento — as suas chaves e o local onde um valor se encontra — continua legível. As entradas de anexo que sensitive_rendered_keys da projeção do nó indica são marcadas aí, 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_providesobjetonãoCada anexo do nó, projetado sobre os seus provides resolvidos e indexado pelo nome de instância do anexo que uma referência de anexo do workload transporta; ausente quando o nó não transporta nenhum anexo. O host copia as strings sem as interpretar, pelo que o guest lê as entradas dos provides de um anexo de que precise para resolver uma referência ao recurso que esse anexo produziu. Se um anexo 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 artefactos pré-avaliado que o host entrega a um guest do Provider para que este o coloque na saída do nó. O host já resolveu a origem de cada entrada (conteúdo inline ou um ficheiro importado que leu), avaliou-a como um template Go em relação ao contexto de renderização usando o par de delimitadores de template de artefacto declarado pelo guest e calculou os conjuntos de chaves de etiquetas 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.

PropriedadeTipoObrigatóriaDescrição
entriesArtifactProjectionEntry[]simAs entradas de artefacto que o guest posiciona, pela ordem do autor.

Não são permitidas propriedades adicionais.

ArtifactProjectionEntry

Uma entrada de artefacto pré-avaliada que o host entrega a um guest do Provider para que este 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 onde vieram esses bytes lê um valor declarado sensível, e os conjuntos de chaves de etiquetas 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 ficheiro complementar) e onde o ficheiro fica.

PropriedadeTipoObrigatóriaDescrição
namestringsimO nome de saída resolvido pelo host para a entrada: a chave de mapa declarada pelo autor, com um ficheiro 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 fornecedor derivado dele.
originstring (enum)simSe a entrada foi escrita como conteúdo inline ou como ficheiro importado. Um guest que rejeita uma das duas formas (um fornecedor de umbrella chart rejeita conteúdo inline) lê este campo para parar de forma explícita. Valores permitidos: "inline", "import"
contentstringsimOs bytes de conteúdo já avaliados como template que o host produziu a partir do conteúdo inline ou do ficheiro importado da entrada, avaliados em relação ao contexto de renderização usando o par de delimitadores de template de artefacto declarado pelo guest. Cada kit transporta-os no seu próprio tipo de campo — em bruto onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest descodifica para os recuperar — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão transporta bytes.
sensitive_contentbooleananãoVerdadeiro 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 que remonta a 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 passa 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, pelo que nada nele pode ser rastreado até ao dado de onde veio: um guest que compõe um texto que uma pessoa leia, uma recusa ou um aviso, mantém todas as partes 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, pelo que o template de uma entrada ler um valor desse tipo nada diz 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.
labelsobjetonãoO conjunto de chaves da proveniência do build seguro para etiquetas do Kubernetes que o host calculou para o nó, indexado por nome de etiqueta. 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 ignora-as.
annotationsobjetonãoO conjunto de chaves da proveniência do build, calculado pelo host para o nó, que uma etiqueta 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 ignora-as.

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 num único artefacto montado (um umbrella chart, um ficheiro compose fundido). Transporta as saídas de renderização por nó com as suas anotações fundidas e as suas waves de implementação, o caminho de saída do grupo de despacho onde o artefacto montado fica, as arestas uses do grafo para a inferência de dependências por serviço e o contexto do momento da renderização. Nem todos os fornecedores declaram a exportação: os fornecedores que emitem apenas saída plana por nó omitem-na.

PropriedadeTipoObrigatóriaDescrição
rendered_nodesRenderedNode[]simAs saídas de renderização por nó que alimentaram este grupo de despacho, pela ordem dos nós.
contextobjetosimO 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 ficheiros montados são serializados; os restantes membros do contexto não transportam 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_pathstringsimO caminho de saída avaliado do grupo de despacho onde o artefacto montado fica; um montador de fronteira usa-o como identidade alternativa ao nível da fronteira (por exemplo, o nome da rede compose para um nó que não transporta nenhuma anotação namespace).
edgesRenderEdge[]nãoAs arestas uses orientadas 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_chartsSubChart[]nãoO payload por sub-chart que um montador de umbrella chart consome para emitir uma dependência e um âmbito de valores por contribuidor. Cada entrada transporta a identidade do sub-chart, os valores por instância e, para um sub-chart incorporado por vendoring a partir de uma origem de chart, os bytes intactos do ficheiro Chart.yaml desse chart. Presente para a montagem de umbrella chart; um montador que funde de forma plana omite-o.
chart_namestringnãoO nome de chart que um montador de umbrella chart usa para o chart montado quando é fornecido um nome para o grupo de despacho; vazio quando o montador deriva o nome a partir do caminho de saída do grupo de despacho.
aggregate_namestringnãoO nome do agregado de nível superior que um montador de umbrella chart incorpora no 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 numa 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 ficheiros que a exportação render_node produziu para ele — transportados na forma da saída de renderização, com todos os membros dessa forma que não sejam os seus ficheiros deixados ausentes.

PropriedadeTipoObrigatóriaDescrição
idstringsimO id absoluto do nó dentro do grafo de topologia. Um contribuidor que não é um dos nós do grafo — uma Feature anexada a uma fronteira em vez de a um componente — transporta 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 transportou; distingue um contribuidor de outro e não é um nome que algum destino aceite. Aquilo a partir do qual tal contribuidor deriva nomes dentro do artefacto montado é um valor transportado separadamente, derived_name_basis.
typestringsimA etiqueta de tipo de componente do nó, transportada nesta forma — ao contrário da projeção de renderização por nó, que a retém. Metadado opaco e não um comutador de comportamento: está aqui para que um montador possa agrupar e etiquetar os nós que funde, não para que um guest possa ramificar com base nela.
derived_name_basisstringnãoA identidade a partir da qual este contribuidor deriva os seus próprios nomes dentro do artefacto montado — um id lógico que um montador cunha para uma das entradas publicadas do contribuidor, um âmbito por contribuidor num documento fundido, o nome de uma unidade filha posicionada numa 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 transporta este valor explicitamente, pelo que o artefacto 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 num documento que o montador funde, este é o mesmo valor transportado que a chamada render_node para esse contribuidor recebeu, e transportá-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 numa posição própria, esta é a identidade composta para esse contribuidor — para uma Feature anexada a um componente, a sua própria e não a do componente host em relação ao qual a sua renderização foi executada — pelo que uma unidade filha posicionada ao lado do seu host é endereçada separadamente dele.
output_directorystringnãoO diretório onde ficam os ficheiros renderizados deste contribuidor, relativo à posição própria do artefacto montado, sem separador final. Um guest que precise de nomear os ficheiros de um contribuidor a partir do interior do artefacto 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, pelo que o caminho para o qual o artefacto montado aponta é o caminho onde os ficheiros 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 fornecedor que faz a montagem posiciona cada contribuidor sob uma posição própria; um fornecedor que incorpora os seus contribuidores num único documento não posiciona nenhum diretório por contribuidor e não recebe nenhum.
renderedRenderNodeOutputsimO payload que um guest do Provider devolve a partir da sua exportação render_node: os bytes serializados de cada ficheiro de saída que o guest emitiu, os nomes que derivou em cada um dos seus próprios espaços de chaves, os factos que reporta sobre o que emitiu, a quantas unidades renderizadas correspondeu cada entrada omits que recebeu, e quaisquer diagnósticos que o guest levantou durante a renderização. O guest devolve os bytes serializados de cada ficheiro; o host escreve-os literalmente e não executa nenhum serializador. O determinismo é responsabilidade do guest: uma entrada idêntica tem de produzir bytes idênticos.
annotationsmapa de stringnãoAs 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_waveintegernãoA wave de implementação herdada da fronteira que contém este nó (predefiniçã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 transportando a sua própria wave, pelo que a wave viaja aqui com cada nó em vez de uma única vez para todo o payload. Um montador cuja forma de saída não exprime nenhuma ordenação ignora-a.
valuesobjetonãoOs 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 ficheiros transportava um source_listing. Esse é o único caso em que os ficheiros vieram de outro lado e os valores não puderam ser escritos neles, pelo que uma posição fora deles tem de os fornecer: um montador de fronteira posiciona um dicionário presente como as entradas desse contribuidor no próprio artefacto montado, em vez de ao lado dos ficheiros próprios do contribuidor, e onde o artefacto montado é a única posição que o destino avalia, essa é a diferença entre uma entrada que o destino lê e uma que nunca alcança. Um nó renderizado a partir de um workload_projection ou de um artifacts_projection resolveu esses valores nos ficheiros que produziu, pelo que não transporta nenhum aqui e o campo está ausente: fornecê-los uma segunda vez ofereceria ao artefacto montado entradas que os ficheiros próprios desse nó nunca declaram, e que o destino é livre de rejeitar. As chaves chegam ordenadas, não pela 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 impõe-na ele próprio. Um montador cuja forma de saída não transporta entradas por contribuidor ignora o campo.
values_mappedbooleananãoVerdadeiro quando os valores que este nó transporta são a saída do valuesMapping da sua Recipe ou FeatureRecipe associada (a Recipe de um componente, a FeatureRecipe de uma Feature anexada), em vez dos valores do nó passados tal como o autor os escreveu — a mesma marcação que a chamada render_node para este nó transportava na sua projeção do nó, transportada aqui ao lado dos valores que descreve. Ausente onde nenhum valuesMapping foi executado, e sempre 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 que 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ê. Regista como os valores foram produzidos e nunca é derivado do nome de uma chave nem do conteúdo de um valor.

Não são permitidas propriedades adicionais.

RenderEdge

Uma aresta uses orientada do grafo, indicada pelos seus dois ids de nó: source é o nó consumidor e target o consumido. A lista transporta todas as arestas uses do grafo, pelo que qualquer uma das extremidades pode ser um nó fora deste grupo de despacho.

PropriedadeTipoObrigatóriaDescrição
sourcestringsimO id do nó consumidor — a extremidade source de uma aresta uses orientada.
targetstringsimO id do nó consumido — a extremidade target para a qual uma aresta uses orientada 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 por vendoring a partir de uma origem de chart, os bytes intactos do ficheiro Chart.yaml desse chart. Um montador de umbrella chart constrói as dependências e o ficheiro de valores do umbrella apenas a partir dessas vistas de dados puros e não toca em nenhum sistema de ficheiros.

PropriedadeTipoObrigatóriaDescrição
instance_idstringsimA 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, pelo que várias instâncias de um mesmo chart de origem permanecem distintas.
versionstringnãoA versão que o umbrella fixa para o sub-chart. Um sub-chart incorporado por vendoring a partir de uma origem de chart obtém, em vez disso, o nome e a versão da sua dependência a partir do ficheiro Chart.yaml desse chart, para que a dependência se ligue; este valor aplica-se a um sub-chart generativo que não transporta nenhum chart incorporado por vendoring.
valuesobjetonãoOs valores por instância que o umbrella posiciona sob o alias do sub-chart no ficheiro values.yaml do umbrella. As chaves chegam ordenadas, não pela 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 impõe-na ele próprio.
chart_yamlstringnãoOs bytes intactos do Chart.yaml do chart incorporado por vendoring, lidos da origem local no momento da compilação, a partir 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 transporta nenhum chart incorporado por vendoring. Cada kit transporta-os no seu próprio tipo de campo — em bruto onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest descodifica para os recuperar — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão transporta bytes.

Não são permitidas propriedades adicionais.

AssembleBoundaryOutput

O payload que um guest do Provider devolve a partir da sua exportação assemble_boundary: os bytes serializados de cada ficheiro montado e quaisquer diagnósticos que o guest levantou durante a montagem. O local onde ficam os ficheiros por nó do grupo montado não faz parte desta resposta — é uma propriedade estática do fornecedor, declarada uma única vez no seu contrato describe() e disponível antes de qualquer nó ser renderizado. O guest devolve os bytes serializados de cada ficheiro; o host escreve-os literalmente e não executa nenhum serializador. O determinismo é responsabilidade do guest: uma entrada idêntica tem de produzir bytes idênticos.

PropriedadeTipoObrigatóriaDescrição
filesRenderedFile[]simOs ficheiros de saída montados que o guest emitiu, pela ordem de emissão. Cada um indica o seu caminho em disco e transporta os bytes serializados que o host escreve literalmente.
diagnosticsDiagnostic[]nãoDiagnósticos que o guest levantou durante a montagem. Cada elemento é a forma de diagnóstico partilhada dos plugins Wasm.
errorstringnãoUma mensagem de falha definida quando o guest foi executado, mas não conseguiu concluir a operação; ausente em caso de sucesso. É distinta de quaisquer diagnósticos que a saída transporte: os diagnósticos reportam problemas encontrados durante uma execução que ainda assim produziu um resultado, enquanto error reporta que a própria operação não foi concluída. O host apresenta um erro presente como uma invocação de plugin falhada.
condition_codestringnãoA identidade descritiva e identificável por máquina da condição que a falha indica — o código sob o qual a condição está registada, no mesmo conjunto aberto em que o compilador regista as suas próprias condições de paragem, e não um membro do catálogo fechado de códigos de erro das funções do anfitrião do qual é retirado o hostfunc_error_code de um envelope de resposta. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não indica nenhuma condição desse tipo. Um guest que se detém reporta aqui o identificador da condição que a sua mensagem indica, pelo 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, pelo que um código que chega a um leitor se resolve sempre; um identificador que não indica nenhuma condição desse tipo, ou um que a numeração retirou, faz parar o build. Um guest sem uma condição precisa a indicar 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 pormenores na sua própria mensagem. Este identificador e condition_short_code são reportados em conjunto, porque indicam uma mesma condição em duas formas: um guest que define um e não o outro indicou uma condição que o host não consegue resolver, e o host reporta então a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem continua a transportar a falha completa.
condition_short_codestringnãoO identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola num 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 indica nenhuma condição desse tipo. O host imprime-o no cabeçalho entre parênteses retos do diagnóstico que produz para esta falha, pelo que uma condição que um guest levanta pode ser citada exatamente como uma que o compilador levanta. O host resolve o valor em relação às condições que o compilador declara em vez de o transportar por confiança: um valor que não indica nenhuma condição desse tipo, um valor que a numeração retirou, ou uma grafia que o registo não transporta faz parar o build e cita o valor em causa, com a mensagem própria do guest ainda reportada. É reportado juntamente com condition_code, pela razão indicada aí.

Não são permitidas propriedades adicionais.

CarveInput

O payload que um guest do Provider recebe na sua exportação opcional carve: um ficheiro de saída nomeado que a pipeline divide em unidades endereçáveis antes de um passo de FeatureRecipe editar algumas delas. Um fornecedor 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, pelo que o seu próprio conhecimento da forma de saída reside no guest; um fornecedor que omite as exportações recorre ao codec YAML padrão do host.

PropriedadeTipoObrigatóriaDescrição
namestringsimO nome do ficheiro de saída, para que o codec possa aplicar qualquer regra de divisão associada ao nome.
bodystringsimOs bytes do ficheiro de saída a dividir em unidades endereçáveis. Cada kit transporta-os no seu próprio tipo de campo — em bruto onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest descodifica para os recuperar — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão transporta bytes.
yaml_indentintegernãoA largura de indentação que o codec usa quando tem de sintetizar texto estruturado novo; transportada 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 devolve a partir da sua exportação carve: as unidades endereçáveis ordenadas em que dividiu o ficheiro. Uma unidade estruturada transporta uma árvore (um destino de PATCH); uma unidade opaca transporta apenas o seu tipo de media e os seus bytes.

PropriedadeTipoObrigatóriaDescrição
unitsobject[]simAs unidades endereçáveis ordenadas em que o guest dividiu o ficheiro.

Não são permitidas propriedades adicionais.

ReassembleInput

O payload que um guest do Provider recebe na sua exportação opcional reassemble: o ficheiro original mais as suas unidades divididas e as unidades modificadas por patch que um passo 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; num token modificado, apenas os seus intervalos de bytes endereçados são editados.

PropriedadeTipoObrigatóriaDescrição
namestringsimO nome do ficheiro de saída, correspondente ao nome sob o qual o mesmo ficheiro foi dividido.
bodystringsimOs bytes do ficheiro original nos quais a remontagem reinsere as unidades modificadas. Cada kit transporta-os no seu próprio tipo de campo — em bruto onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest descodifica para os recuperar — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão transporta bytes.
segsobject[]nãoAs unidades em que o ficheiro foi dividido, tal como carve as devolveu.
patchedobject[]nãoAs unidades que um passo de pipeline alterou, cada uma transportando o seu token, a árvore modificada e as ops que produziram a alteração.
yaml_indentintegernãoA largura de indentação que o codec usa quando uma op tem de sintetizar texto estruturado novo; transportada 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 devolve a partir da sua exportação reassemble: os bytes do ficheiro com as unidades modificadas reinseridas. A remontagem é fiel byte a byte — todos os bytes que as ops não tocaram sobrevivem literalmente.

PropriedadeTipoObrigatóriaDescrição
bodystringsimOs bytes do ficheiro remontado que o host escreve literalmente. Cada kit transporta-os no seu próprio tipo de campo — em bruto onde esse tipo é um tipo de bytes, codificados em base64 onde é uma string que o guest descodifica para os recuperar — e o codificador gerado converte entre o campo e a forma em que o formato de transmissão transporta 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 avalie em relação a cada nome que derivaria dele para o seu destino, juntamente com os factos do workload resolvido do nó de que alguns desses nomes dependem, quando a identidade é fixada 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 nada sabe, que é exatamente o que fazer a pergunta elimina. Um fornecedor cujo destino limita ou restringe os nomes que aceita anuncia a exportação; um fornecedor cujo destino aceita qualquer nome omite-a e nunca é consultado, e a sua renderização mantém-se inalterada.

PropriedadeTipoObrigatóriaDescrição
proposedstringsimO nome que o host propõe como identidade de componente do nó. O guest deriva dele, em memória, todos os nomes que deriva de uma identidade de componente e reporta se cada um é um nome que o seu destino aceita. Um veredicto diz respeito à PROPOSTA e não ao nó: o host faz uma única pergunta sempre que compõe uma identidade, e não diz para quais nomes desse nó essa identidade acabará por ser a base, pelo 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 facto derivará de algum outro valor transportado é, por isso, avaliado com rigor a mais em vez de com folga a mais.
authoredbooleananãoSe o nome proposto é um que uma pessoa escreveu em vez de um que o compilador compôs a partir de partes escritas pelo autor. É transportado para que um guest possa formular o seu motivo para o leitor que é capaz de agir com base nele. 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_formstringnãoA 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 é fixada depois de esse workload ser resolvido e o workload indica uma forma. É transportada tal como escrita; o host não a interpreta. Um guest cujo destino limita um nome que emite apenas para uma forma — um job agendado, cujo nome o destino mantém mais curto do que os seus outros nomes porque lhe é acrescentado um sufixo a cada execução — lê-a para avaliar esse nome. Ausente significa que o host não transporta nenhuma forma para esta questão: o nó não declara nenhum workload, o seu workload não indica nenhuma, ou a identidade é fixada antes de qualquer workload ser resolvido. Nesse caso, um guest não avalia nenhum nome que dependa da forma e responde exatamente como responderia se o campo não existisse.
service_keysstring[]nãoAs chaves dos Services que o workload resolvido do nó declara, pela ordem em que o workload as declara, transportadas quando a identidade é fixada 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 lê-as para avaliar cada um desses nomes. Uma chave é escrita pelo autor da Recipe ou da FeatureRecipe, e não por quem escreveu a identidade, pelo que 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 questão: o nó não declara nenhum workload, o seu workload não declara nenhum Service, ou a identidade é fixada antes de qualquer workload ser resolvido. Nesse caso, um guest não avalia 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 veredicto 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 aceite — o maior comprimento que o seria. Transporta uma restrição e um motivo, nunca um nome que o guest tenha construído.

PropriedadeTipoObrigatóriaDescrição
kindstringsimO nome próprio do guest para o tipo de nome que este veredicto abrange, 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 contentores. Chega a um leitor literalmente numa recusa, pelo que é escrito para alguém que conhece o destino.
usablebooleanasimSe o nome que o guest derivaria para este tipo a partir da identidade proposta é um que o destino aceita.
boundintegernãoO maior número de caracteres que uma identidade proposta pode transportar para que o nome derivado deste tipo seja um que o destino aceite. Presente apenas numa recusa que uma identidade mais curta satisfaria. AUSENTE significa que o comprimento não é aquilo a que o destino se opôs — ou não existe qualquer limite de comprimento, ou a objeção é uma que nenhum encurtamento corrige, como um carácter que a gramática do destino recusa na posição em que foi parar. A ausência é, por isso, distinta de um limite de zero, que de facto indica um comprimento: que nenhuma identidade de qualquer comprimento produz um nome aceitável deste tipo. O host encurta até um limite presente e volta a perguntar; perante um limite ausente, para, porque não resta nada a tentar.
reasonstringnãoPorque é que o destino não aceita o nome derivado, nos próprios termos do destino, para um leitor que está a decidir o que escrever em seu lugar. Vazio quando o veredicto é utilizável.

Não são permitidas propriedades adicionais.

NameBoundOutput

O payload que um guest do Provider devolve a partir da sua exportação name_bound: um veredicto por cada tipo de nome que derivaria da identidade proposta. Uma proposta é utilizável quando todos os veredictos o são; onde um não o é, o host encurta a proposta até ao menor limite que os veredictos de recusa transportam e pergunta de novo, e para quando um veredicto de recusa não transporta nenhum limite. Uma lista de veredictos vazia significa que o guest não deriva nenhum nome de uma identidade de componente, o que é a mesma resposta que aceitar a proposta.

PropriedadeTipoObrigatóriaDescrição
namesDerivedNameVerdict[]nãoUma entrada por cada tipo de nome que o guest deriva de uma identidade de componente, pela ordem própria do guest. Um guest reporta todos os tipos que derivaria, em vez de apenas os tipos que recusaram, pelo que um leitor vê que nomes foram julgados e um host que lê as entradas não precisa de uma segunda chamada para saber o resto.
errorstringnãoUma 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 veredicto de recusa: um veredicto reporta um nome que o destino não aceitará, enquanto error reporta que não foi possível responder à própria pergunta. O host apresenta um error presente como uma invocação de plugin falhada.
condition_codestringnãoA identidade descritiva e identificável por máquina da condição que a falha indica — o código sob o qual a condição está registada, no mesmo conjunto aberto em que o compilador regista as suas próprias condições de paragem, e não um membro do catálogo fechado de códigos de erro das funções do anfitrião do qual é retirado o hostfunc_error_code de um envelope de resposta. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não indica nenhuma condição desse tipo. Um guest que se detém reporta aqui o identificador da condição que a sua mensagem indica, pelo 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, pelo que um código que chega a um leitor se resolve sempre; um identificador que não indica nenhuma condição desse tipo, ou um que a numeração retirou, faz parar o build. Um guest sem uma condição precisa a indicar 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 pormenores na sua própria mensagem. Este identificador e condition_short_code são reportados em conjunto, porque indicam uma mesma condição em duas formas: um guest que define um e não o outro indicou uma condição que o host não consegue resolver, e o host reporta então a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem continua a transportar a falha completa.
condition_short_codestringnãoO identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola num 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 indica nenhuma condição desse tipo. O host imprime-o no cabeçalho entre parênteses retos do diagnóstico que produz para esta falha, pelo que uma condição que um guest levanta pode ser citada exatamente como uma que o compilador levanta. O host resolve o valor em relação às condições que o compilador declara em vez de o transportar por confiança: um valor que não indica nenhuma condição desse tipo, um valor que a numeração retirou, ou uma grafia que o registo não transporta faz parar o build e cita o valor em causa, com a mensagem própria do guest ainda reportada. É reportado juntamente com condition_code, pela razão indicada aí.

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 a partir das quais um destino deriva os seus próprios nomes, e que 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ó tal como está. Um guest que não deriva nenhum nome desse tipo não reporta nenhum, o que é a resposta honesta para um destino cujos nomes de recursos uma Recipe escreve literalmente, e para um cujo nome é função do local onde os ficheiros são colocados e não do nó. Esta exportação reporta 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.

PropriedadeTipoObrigatóriaDescrição
node_idstringsimA identidade própria do nó, tal como foi escrita. É transportada sem codificação: um destino restringe-a através do seu próprio alfabeto, pelo que codificá-la antes colocaria um escape dentro de outro e escreveria o nome de forma diferente daquele pelo qual o autor de uma receita o prevê.
derived_name_basisstringnãoA 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á.
sourcedbooleananãoSe a Recipe associada do nó declara uma origem fornecida pelo autor, lido a partir do texto que o autor escreveu. É transportado, juntamente com synthesized, para que a pergunta possa ser feita sobre qualquer nó e respondida corretamente: um guest não reporta nenhum nome para um nó que não declara nenhum dos dois, cuja saída é apenas um conjunto de artefactos, porque os recursos de um tal conjunto são nomeados pelos artefactos que o autor escreveu e não por um nome que o guest deriva.
synthesizedbooleananãoSe a Recipe associada do nó declara um workload para o guest sintetizar, lido a partir do texto que o autor escreveu, tal como sourced. Um guest cujo destino nomeia os recursos que sintetiza segundo um nome que deriva, em vez de segundo a identidade do nó tal como está escrita, reporta esse nome para um nó desse tipo, pelo que um endereço que uma Recipe publica para um desses recursos pode ser construído a partir do nome que o recurso transporta.

Não são permitidas propriedades adicionais.

RenderedNameOutput

O payload que um guest do Provider devolve a partir 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 o ler, pelo que nenhum conhecimento da nomenclatura do destino atravessa a fronteira.

PropriedadeTipoObrigatóriaDescrição
namestringnãoO 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.
errorstringnãoUma 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 reportar nenhum nome: nenhum nome é uma resposta sobre o destino, enquanto error reporta que não foi possível responder à própria pergunta. O host apresenta um error presente como uma invocação de plugin falhada.
condition_codestringnãoA identidade descritiva e identificável por máquina da condição que a falha indica — o código sob o qual a condição está registada, no mesmo conjunto aberto em que o compilador regista as suas próprias condições de paragem. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não indica 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, pelo que um código que chega a um leitor se resolve sempre; um identificador que não indica nenhuma condição desse tipo, ou um que a numeração retirou, faz parar o build. Um guest sem uma condição precisa a indicar 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 pormenores na sua própria mensagem. Este identificador e condition_short_code são reportados em conjunto, porque indicam uma mesma condição em duas formas: um guest que define um e não o outro indicou uma condição que o host não consegue resolver, e o host reporta então a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem continua a transportar a falha completa.
condition_short_codestringnãoO identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola num 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 indica nenhuma condição desse tipo. O host imprime-o no cabeçalho entre parênteses retos do diagnóstico que produz para esta falha, pelo que uma condição que um guest levanta pode ser citada exatamente como uma que o compilador levanta. O host resolve o valor em relação às condições que o compilador declara em vez de o transportar por confiança: um valor que não indica nenhuma condição desse tipo, um valor que a numeração retirou, ou uma grafia que o registo não transporta faz parar o build e cita o valor em causa, com a mensagem própria do guest ainda reportada. É reportado juntamente com condition_code, pela razão indicada aí.

Não são permitidas propriedades adicionais.

LinkEndpoint

Um endpoint de uma ligação entre fronteiras: o nó, o caminho da fronteira no qual a sua saída renderizada é montada e o fornecedor que o renderizou. Os dois endpoints de uma ligação indicam as extremidades consumidora e consumida de uma aresta uses cujas extremidades são montadas em grupos de despacho diferentes.

PropriedadeTipoObrigatóriaDescrição
nodestringsimO id absoluto do nó do endpoint dentro do grafo da topologia.
boundarystringsimO caminho da fronteira do endpoint — o grupo de despacho no qual a sua saída renderizada é montada.
providerstringsimO fornecedor que renderizou o endpoint (o nome simples do fornecedor). Ambos os endpoints de uma ligação cablada indicam o mesmo fornecedor; o host não encaminha uma ligação cujos endpoints indicam fornecedores diferentes.
releasestringnãoA Release à qual pertence a saída renderizada do endpoint — o âmbito dentro do qual os seus artefactos montados são nomeados. O host monta-a a partir da Release que o build resolveu e passa-a literalmente; não infere nenhum significado do valor. Um fornecedor lê-a para restringir à Release o âmbito de um nome de referência cruzada. Um valor ausente é a string vazia, que um fornecedor trata como um nome sem âmbito.

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. Transporta 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 liga. Um fornecedor lê-o para produzir a cablagem de referência cruzada nativa do fornecedor de que as duas extremidades precisam; o host monta-o e passa o mapa de anotações como escalares opacos, sem inferir nenhum significado de nenhum valor.

PropriedadeTipoObrigatóriaDescrição
sourceLinkEndpointsimO endpoint consumidor — a extremidade de origem da aresta uses dirigida, em cuja saída montada é injetada a cablagem do lado do consumidor.
targetLinkEndpointsimO endpoint consumido — a extremidade de destino para a qual a aresta uses aponta, cuja saída montada a cablagem do lado do produtor publica.
target_annotationsmapa de stringnãoAs anotações de posicionamento do endpoint consumido (destino) como um mapa escalar opaco, indexado por nome de anotação. O host monta-as a partir das anotações resolvidas do destino e passa-as literalmente; não infere nenhum significado de nenhum valor. Um fornecedor lê-as para decidir como moldar uma referência cruzada (por exemplo, se as duas extremidades partilham 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_annotationsmapa de stringnãoAs anotações de posicionamento do endpoint consumidor (origem) como um mapa escalar opaco, indexado por nome de anotação. O host monta-as a partir das anotações resolvidas da origem e passa-as literalmente; não infere nenhum significado de nenhum valor. Um fornecedor lê-as para comparar o posicionamento das duas extremidades — por exemplo, se a origem e o destino partilham um posicionamento ou se encontram 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.
socketstringsimO alias de socket sob o qual a aresta uses está associada.
providesmapa de stringsimA saída provides do endpoint consumido, um conjunto de chaves pela 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.
injectobjetosimO mapeamento inject do endpoint consumidor, indexado por mecanismo de entrega para um conjunto de chaves pela 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_keysstring[]nãoAs chaves da saída provides do endpoint consumido que os templates do endpoint consumidor leem diretamente através de .context.uses, quer o mapeamento inject também as entregue quer não, pela ordem do autor de provides. Cada entrada é uma das chaves que provides transporta. 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 fornecedor que não recebe nenhuma faz a cablagem da ligação exatamente como faria se o campo não existisse.

Não são permitidas propriedades adicionais.

LinkPatch

Um patch estrutural por ficheiro que um fornecedor devolve como cablagem de artefactos: o ficheiro de saída e as operações estruturais ordenadas a aplicar-lhe. Uma passagem posterior do host divide o ficheiro indicado, aplica as operações e remonta-o com fidelidade byte a byte. A forma da operação é o vocabulário partilhado de operações de patch do pipeline; é opaca nesta camada do esquema, pelo que um guest transporta cada operação literalmente enquanto o host realiza a operação tipada que o seu pipeline aplica.

PropriedadeTipoObrigatóriaDescrição
filestringsimO ficheiro de saída ao qual as operações se aplicam, nomeado tal como o fornecedor o emitiu.
opsany[]simAs operações estruturais ordenadas a aplicar ao ficheiro, pela ordem de aplicação.

Não são permitidas propriedades adicionais.

LinkPublishInput

O payload que um fornecedor recebe na sua exportação link_publish: uma ligação entre fronteiras cuja saída do endpoint consumido é referenciada através de uma fronteira, e os ficheiros montados desse endpoint. A exportação devolve a identidade publicada em relação à qual o consumidor resolve e qualquer cablagem de artefactos do lado do produtor de que a saída do endpoint consumido precise.

PropriedadeTipoObrigatóriaDescrição
edgeLinkEdgesimA ligação entre fronteiras que está a ser publicada, lida do lado do endpoint consumido (destino).
producer_filesRenderedFile[]nãoOs ficheiros montados do endpoint consumido, para que o fornecedor possa ler o que esse endpoint já declara e verificar em relação a eles os nomes que está prestes a publicar. Cada um indica o seu caminho em disco e transporta os bytes montados. Ausente quando o host não tem nenhuma saída montada do produtor para entregar à publicação; um fornecedor que não precisa de nenhum documento para escrever a sua cablagem ignora-o.

Não são permitidas propriedades adicionais.

LinkPublishOutput

O payload que um fornecedor devolve a partir da sua exportação link_publish: o handle da identidade publicada em relação ao qual o consumidor resolve, e a cablagem de artefactos do lado do produtor a aplicar à saída montada do endpoint consumido.

PropriedadeTipoObrigatóriaDescrição
handlemapa de stringsimA 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 resolve-as no momento da implementação. As chaves são serializadas ordenadas para que o payload seja idêntico byte a byte entre execuções com entrada idêntica.
patchesLinkPatch[]nãoA cablagem de artefactos do lado do produtor, um patch estrutural por ficheiro de saída do endpoint consumido que a publicação tem de editar. Vazio quando a saída do endpoint consumido não precisa de nenhuma alteração para a ligação.
errorstringnãoUma mensagem de falha definida quando o guest foi executado mas não conseguiu publicar a ligação; ausente em caso de sucesso. O host apresenta um error presente como uma invocação de plugin falhada. Uma publicação que não pode prosseguir — um nome de export que a stack já declara sob outra entrada, por exemplo — é reportada aqui e não apenas como um crash, pelo que a condição por trás dela pode ser indicada.
condition_codestringnãoA identidade descritiva e identificável por máquina da condição que a falha indica — o código sob o qual a condição está registada, no mesmo conjunto aberto em que o compilador regista as suas próprias condições de paragem, e não um membro do catálogo fechado de códigos de erro das funções do anfitrião do qual é retirado o hostfunc_error_code de um envelope de resposta. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não indica nenhuma condição desse tipo. Um guest que se detém reporta aqui o identificador da condição que a sua mensagem indica, pelo 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, pelo que um código que chega a um leitor se resolve sempre; um identificador que não indica nenhuma condição desse tipo, ou um que a numeração retirou, faz parar o build. Um guest sem uma condição precisa a indicar 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 pormenores na sua própria mensagem. Este identificador e condition_short_code são reportados em conjunto, porque indicam uma mesma condição em duas formas: um guest que define um e não o outro indicou uma condição que o host não consegue resolver, e o host reporta então a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem continua a transportar a falha completa.
condition_short_codestringnãoO identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola num 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 indica nenhuma condição desse tipo. O host imprime-o no cabeçalho entre parênteses retos do diagnóstico que produz para esta falha, pelo que uma condição que um guest levanta pode ser citada exatamente como uma que o compilador levanta. O host resolve o valor em relação às condições que o compilador declara em vez de o transportar por confiança: um valor que não indica nenhuma condição desse tipo, um valor que a numeração retirou, ou uma grafia que o registo não transporta faz parar o build e cita o valor em causa, com a mensagem própria do guest ainda reportada. É reportado juntamente com condition_code, pela razão indicada aí.

Não são permitidas propriedades adicionais.

LinkResolveInput

O payload que um fornecedor recebe na sua exportação link_resolve: uma ligação entre fronteiras, o handle da identidade publicada que o seu endpoint consumido expôs e os ficheiros montados do endpoint consumidor. A exportação devolve a cablagem de artefactos do lado do consumidor que injeta a referência na saída montada do endpoint consumidor.

PropriedadeTipoObrigatóriaDescrição
edgeLinkEdgesimA ligação entre fronteiras que está a ser resolvida, lida do lado do endpoint consumidor (origem).
handlemapa de stringsimO handle da identidade publicada que o link_publish do endpoint consumido devolveu, 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 canaliza-as 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_filesRenderedFile[]nãoOs ficheiros montados do endpoint consumidor, para que o fornecedor possa localizar o marcador de posição que o host carimbou na saída consumidora e escrever a sua substituição no caminho real do marcador de posição. Cada um indica o seu caminho em disco e transporta os bytes montados. Ausente quando o host não tem nenhuma saída montada do consumidor para entregar à resolução; um fornecedor que não precisa de nenhum documento para escrever a sua cablagem ignora-o.

Não são permitidas propriedades adicionais.

LinkResolveOutput

O payload que um fornecedor devolve a partir da sua exportação link_resolve: a cablagem de artefactos do lado do consumidor a aplicar à saída montada do endpoint consumidor, injetando a referência à identidade publicada do endpoint consumido.

PropriedadeTipoObrigatóriaDescrição
patchesLinkPatch[]simA cablagem de artefactos do lado do consumidor, um patch estrutural por ficheiro de saída do endpoint consumidor que a resolução tem de editar.
errorstringnãoUma mensagem de falha definida quando o guest foi executado mas não conseguiu resolver a ligação; ausente em caso de sucesso. O host apresenta um error presente como uma invocação de plugin falhada. Uma resolução que não pode prosseguir — uma referência que o destino só pode transportar como um escalar inteiro, encontrada dentro de uma string maior — é reportada aqui e não apenas como um crash, pelo que a condição por trás dela pode ser indicada.
condition_codestringnãoA identidade descritiva e identificável por máquina da condição que a falha indica — o código sob o qual a condição está registada, no mesmo conjunto aberto em que o compilador regista as suas próprias condições de paragem, e não um membro do catálogo fechado de códigos de erro das funções do anfitrião do qual é retirado o hostfunc_error_code de um envelope de resposta. Definida ao lado da mensagem de erro legível por pessoas; ausente em caso de sucesso, e ausente quando o guest não indica nenhuma condição desse tipo. Um guest que se detém reporta aqui o identificador da condição que a sua mensagem indica, pelo 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, pelo que um código que chega a um leitor se resolve sempre; um identificador que não indica nenhuma condição desse tipo, ou um que a numeração retirou, faz parar o build. Um guest sem uma condição precisa a indicar 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 pormenores na sua própria mensagem. Este identificador e condition_short_code são reportados em conjunto, porque indicam uma mesma condição em duas formas: um guest que define um e não o outro indicou uma condição que o host não consegue resolver, e o host reporta então a sua própria condição genérica de falha de plugin em vez disso, enquanto a mensagem continua a transportar a falha completa.
condition_short_codestringnãoO identificador compacto da mesma condição — a letra E e quatro dígitos, a forma que um leitor cita, pesquisa e cola num 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 indica nenhuma condição desse tipo. O host imprime-o no cabeçalho entre parênteses retos do diagnóstico que produz para esta falha, pelo que uma condição que um guest levanta pode ser citada exatamente como uma que o compilador levanta. O host resolve o valor em relação às condições que o compilador declara em vez de o transportar por confiança: um valor que não indica nenhuma condição desse tipo, um valor que a numeração retirou, ou uma grafia que o registo não transporta faz parar o build e cita o valor em causa, com a mensagem própria do guest ainda reportada. É reportado juntamente com condition_code, pela razão indicada aí.

Não são permitidas propriedades adicionais.