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

O arquivo de respostas da importação

Alguns valores nenhuma fonte consegue conter: a imagem de uma aplicação construída a partir do seu próprio código, o e-mail de uma conta proprietária, um modelo que a fonte não nomeia, o nome de um Secret do Kubernetes. aggrega import rascunha cada um desses valores como uma string vazia, sob um comentário que diz o que ele é, e o obtém de você uma única vez — do arquivo de respostas ou de uma pergunta em um terminal. As respostas são mantidas no arquivo de respostas, import-answers.yaml, de modo que toda importação posterior da mesma fonte as lê de lá e não pergunta nada.

Esta página descreve onde o arquivo fica, o que ele contém, como os valores chegam a ele e o que uma importação faz quando um valor ainda está faltando. Para que serve uma importação, e roteiros de uma fonte até um build, estão em Importação.

Quais valores estão pendentes

Após o rascunho, a importação valida cada documento rascunhado contra o seu próprio schema e contra o schema de catálogo de cada Component, Feature e conexão que o documento declara. Um valor está pendente quando ainda está vazio onde esse schema exige um, ou onde o schema declara a chave e nada a forneceu. Cada valor pendente é descrito pela própria descrição que o schema dá da sua chave; onde o schema não dá nenhuma, pelo comentário que o rascunho escreve acima da chave.

Enquanto houver algum valor pendente, a importação não baixa as dependências da Release rascunhada; ela as baixa assim que todos os valores forem respondidos (veja Reexecução e --sync).

Onde o arquivo fica

A origem éO arquivo de respostas é
um arquivoimport-answers.yaml no mesmo diretório do arquivo de origem
um diretórioimport-answers.yaml dentro do diretório de origem

--answers <file> indica outro arquivo. Um caminho relativo é resolvido em relação ao diretório em que você executa o comando. Quando os rascunhos têm valores pendentes e o arquivo de respostas não é o padrão ao lado da origem, o registro que a importação grava ao lado dos rascunhos, .aggrega-import.json, o indica, de modo que um aggrega import --sync posterior no mesmo diretório o lê sem precisar ser informado de novo. O registro nunca contém uma resposta.

A resposta de um segredo é o nome de onde o segredo vem, nunca o próprio segredo (veja Segredos), portanto o arquivo de respostas pode ser mantido junto com a origem no controle de versão.

O que ele contém

O arquivo é YAML. Suas chaves de nível superior são os arquivos rascunhados, pelo caminho em que cada um é rascunhado. Abaixo de cada uma, uma chave é o caminho de chave com pontos de um valor pendente dentro daquele documento, e seu valor é a resposta. A descrição da chave dada pelo esquema é escrita como comentário acima dela. Um segmento do caminho de chave que esteja vazio, ou que contenha um ponto final, espaço em branco ou aspas, é escrito entre aspas duplas. Um arquivo que não se lê nesse formato interrompe a importação, indicando o arquivo e o motivo, e nada é gravado.

Por exemplo, a importação do Google ADK rascunhada com --target helm tem dois valores pendentes na sua Release: a imagem do agente que você constrói a partir do seu projeto e de onde vem a chave de API do Gemini do agente. Com ambos respondidos, o arquivo de respostas dentro do diretório de origem support_agent/ fica assim:

# Values the import could not draft from the source, keyed by the drafted file and the key path inside
# it. Write each one beside its key; an import of the same source, and a sync, read them from here and
# ask nothing. A secret is never written here: its key asks where the secret comes from — a variable
# name, ${NAME}, or the name of a Kubernetes Secret.
release.yaml:
# Container image running the application built on ADK, serving its API on infra.port on every
# interface.
spec.components.support-agent.infra.image: "ghcr.io/example/support-agent:1.0.0"
# The origin of the secret value, written by the operator in the Release. Read exactly as
# values.origin is. Write it here or in values.origin, never in both. A secret: name where it comes
# from, never the value.
spec.components.support-agent.uses.model.gemini-2-5-flash.features.credential.infra.origin: "google-api-key"

As duas respostas são suas: ghcr.io/example/support-agent:1.0.0 representa a imagem que você constrói e publica, e google-api-key o nome do Secret do Kubernetes que guarda a chave no namespace em que você faz o deploy.

Cada resposta é um único valor, e a importação o grava no rascunho como string, no lugar do vazio, sem alterar mais nada no rascunho. Uma resposta gravada em um Aggregate rascunhado é lida exatamente como você a digitou, {{ incluído. Uma resposta vazia deixa o valor pendente.

Como os valores entram

A importação responde cada valor pendente primeiro a partir do arquivo de respostas. Para cada valor que o arquivo deixa sem resposta, ela pergunta a você, uma pergunta de cada vez — mas somente quando a entrada padrão e a saída padrão são ambas um terminal e --dry-run não é informado:

  • cada pergunta indica o arquivo rascunhado e o caminho de chave, e é formulada a partir da descrição do esquema;
  • as perguntas são escritas na saída de erro padrão, de modo que a saída padrão traz apenas o resultado da importação;
  • pressionar Enter deixa o valor para depois, e encerrar a entrada interrompe as perguntas.

Cada resposta que você dá é gravada nos rascunhos e no arquivo de respostas, e o arquivo de respostas é listado entre os arquivos gravados. Uma execução que não altera nada no arquivo de respostas não o grava novamente.

Segredos

O valor de um segredo — um valor que o esquema marca como sensível — é respondido com a origem do segredo, nunca com o próprio segredo. A pergunta correspondente pede isso, e a resposta é um destes nomes:

RespostaExemplo
um nome de variávelOPENAI_API_KEY
uma referência a uma variável${OPENAI_API_KEY}
o nome de um Secret do Kubernetesopenai-api-key

A importação verifica se a resposta tem a forma de um desses nomes e recusa qualquer outra coisa:

  • em um terminal, a resposta é recusada, o motivo é exibido e a pergunta é feita novamente;
  • no arquivo de respostas, a importação para, nomeando o arquivo de respostas, o arquivo rascunho e a chave — nunca a resposta, que pode ser o próprio segredo — e não grava nada.

A verificação lê a forma da resposta, então um segredo que por acaso se pareça com um nome não é distinguido de um. O próprio segredo permanece onde o nome aponta: na variável ou no Secret.

Sem terminal

Na integração contínua, por meio de um pipe e a partir da ferramenta de importação do assistente (aggrega mcp), nada é perguntado, e a importação do editor não pergunta nada enquanto é executada. Uma importação que ainda deve valores depois de ler o arquivo de respostas:

  • grava os rascunhos, deixando vazio cada valor devido;
  • grava o arquivo de respostas com cada chave devida presente e sua resposta vazia;
  • nomeia cada valor devido na saída de erro padrão, como um aviso que indica o arquivo rascunho, o caminho da chave e sua descrição;
  • não baixa as dependências da Release rascunho;
  • termina com status 1 e uma frase dizendo quantos valores são devidos e onde escrevê-los:
2 values the drafts leave empty are still owed, listed in the answers file <path>/support_agent/import-answers.yaml: write each beside its key there, then run the import again

Escreva cada resposta ao lado de sua chave e, em seguida, execute aggrega import <source> --sync no mesmo diretório: ele gera os rascunhos para o destino dado à importação anterior, grava cada resposta nos rascunhos e não pergunta nada. Um aggrega import simples em um diretório que já contém o Aggregate rascunho para, nomeando --sync, e não grava nada. Uma importação em um diretório de saída novo também lê o arquivo de respostas: o padrão ou o indicado por --answers.

A ferramenta de importação do assistente recebe o arquivo de respostas como answers, indicado em relação à raiz do workspace ou de forma absoluta. Uma chamada que ainda deve valores falha com essa frase e traz ao lado dela o resultado da importação, avisos incluídos. A importação do editor também aceita o arquivo de respostas, e a mesma frase encerra seus diagnósticos.

Ambos também listam como dados cada valor ainda devido, em owed: o arquivo rascunho, o caminho da chave como uma lista de chaves, a pergunta, se o valor é o de um segredo e, para um segredo, o que sua resposta deve ser (secretAdvice no editor, secret_advice na ferramenta de importação do assistente). Envie cada resposta de volta em answered — o arquivo rascunho, o caminho da chave e a resposta — com sync, e a importação a verifica, a mantém no arquivo de respostas e a grava nos rascunhos, como faz com uma resposta digitada em um terminal. A resposta de um segredo que não é um nome não é mantida nem gravada: o valor permanece em owed, com o motivo no lugar de sua orientação.

Depois de uma importação que grava os seus rascunhos, o editor se oferece para pedir cada valor ainda pendente em uma caixa de entrada própria, e envia as respostas de volta dessa forma; depois de uma prévia, não oferece nada, pois nada é perguntado com --dry-run. Responder aos valores que uma importação ainda deve descreve as perguntas.

Com --dry-run, nada é perguntado e nada é gravado, incluindo o arquivo de respostas. Cada valor devido ainda é nomeado na saída de erro padrão, e o status de saída é o da própria execução de teste.

Reexecução e --sync

aggrega import --sync lê o mesmo arquivo de respostas que a importação anterior: o indicado por --answers, senão o indicado pelo registro ao lado dos rascunhos, senão o padrão ao lado da origem. Ele grava cada resposta nos rascunhos no lugar do valor vazio e, quando o arquivo de respostas responde a todos os valores devidos, não pergunta nada.

Quando nada mais é devido e o workspace não está offline, a importação baixa as dependências da Release rascunho como faz o aggrega pull, gravando release.lock, de modo que aggrega validate e aggrega build funcionam imediatamente sobre os rascunhos. Com --offline, nada é baixado, e a importação indica o aggrega pull --release <path> a executar em seguida.

Um arquivo de respostas para vários destinos

A mesma origem gerada como rascunho para destinos diferentes pode dever valores diferentes: a Release do Google ADK acima, gerada com --target compose, deve apenas a imagem, e a mesma Release gerada com --target helm também deve a origem da chave de API do Gemini do agente. Um único arquivo de respostas atende a ambos:

  • a importação adiciona as chaves que seus rascunhos devem e define as respostas que recebe;
  • uma resposta para uma chave que esses rascunhos não devem é mantida no arquivo e não é aplicada;
  • todas as outras chaves e comentários do arquivo permanecem como estão.

O arquivo de respostas só é lido onde os rascunhos devem algum valor. Onde devem, uma linha informativa na saída de erro padrão nomeia cada resposta mantida e não aplicada — aqui para a importação do Flowise gerada com --target compose, que deve apenas o e-mail do proprietário, lendo um arquivo de respostas que também nomeia os dois Secrets do Kubernetes que a mesma importação deve com --target helm:

info: the answers file <path>/import-answers.yaml also answers spec.components.flowise.features.owner_password.infra.origin in release.yaml, spec.components.flowise.uses.model.chatopenai-0.features.credential.infra.origin in release.yaml, which these drafts do not leave empty; those answers are kept there and not applied

Onde os rascunhos não devem nada — a importação do Langflow gerada com --target compose, por exemplo, que lê cada segredo de uma variável —, o arquivo de respostas não é lido, nenhuma linha desse tipo é impressa e o arquivo fica como está.

Veja também

  • aggrega import — a referência do comando, com todas as flags.
  • Importação — o que uma importação gera como rascunho, e um passo a passo para cada formato de origem.