O ficheiro de respostas da importação
Há valores que nenhuma fonte consegue conter: a imagem de uma aplicação construída a partir do 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 esboça cada um desses valores como uma cadeia vazia, sob um comentário que diz o que é, e obtém-no do utilizador uma única vez — a partir do ficheiro de respostas ou de uma pergunta num terminal. As respostas são guardadas no ficheiro de respostas, import-answers.yaml, pelo que cada importação posterior da mesma fonte as lê daí e não pergunta nada.
Esta página descreve onde se encontra o ficheiro, o que contém, como os valores lá entram e o que faz uma importação quando ainda falta um valor. Para que serve uma importação, e percursos guiados de uma fonte até um build, encontram-se em Importação.
Que valores estão pendentes
Depois do esboço, a importação valida cada documento esboçado face ao seu próprio esquema e face ao esquema de catálogo de cada Component, Feature e ligação que o documento declara. Um valor está pendente quando ainda está vazio onde esse esquema exige um, ou onde o esquema declara a chave e nada a forneceu. Cada valor pendente é descrito pela descrição que o próprio esquema dá da sua chave; onde o esquema não dá nenhuma, pelo comentário que o esboço escreve acima da chave.
Enquanto houver algum valor pendente, a importação não descarrega as dependências da Release esboçada; descarrega-as assim que todos os valores tiverem resposta (ver Reexecução e --sync).
Onde se encontra o ficheiro
| A origem é | O ficheiro de respostas é |
|---|---|
| um ficheiro | import-answers.yaml no mesmo diretório do ficheiro de origem |
| um diretório | import-answers.yaml dentro do diretório de origem |
--answers <file> indica outro ficheiro. Um caminho relativo é resolvido em relação ao diretório em que o comando é executado. Quando os rascunhos têm valores pendentes e o ficheiro de respostas não é o predefinido ao lado da origem, o registo que a importação escreve ao lado dos rascunhos, .aggrega-import.json, indica-o, de modo que um aggrega import --sync posterior no mesmo diretório o lê sem que seja preciso indicá-lo de novo. O registo nunca contém uma resposta.
A resposta de um segredo é o nome da origem do segredo, nunca o próprio segredo (consulte Segredos), pelo que o ficheiro de respostas pode ser mantido com a origem no controlo de versões.
O que contém
O ficheiro é YAML. As suas chaves de nível superior são os ficheiros gerados como rascunho, pelo caminho em que cada um é gerado. Sob cada uma, uma chave é o caminho de chave com pontos de um valor pendente dentro desse documento, e o 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 ficheiro que não se leia com esta forma interrompe a importação, indicando o ficheiro e o motivo, e nada é escrito.
Por exemplo, a importação do Google ADK gerada com --target helm tem dois valores pendentes na sua Release: a imagem do agente que constrói a partir do seu projeto e a origem da chave de API do Gemini do agente. Com ambos respondidos, o ficheiro 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"Ambas as respostas são suas: ghcr.io/example/support-agent:1.0.0 representa a imagem que constrói e publica, e google-api-key o nome do Secret do Kubernetes que guarda a chave no namespace onde faz a implementação.
Cada resposta é um único valor, e a importação escreve-o no rascunho como cadeia de caracteres, em vez do valor vazio, sem alterar mais nada no rascunho. Uma resposta escrita num Aggregate gerado como rascunho é lida exatamente como foi escrita, {{ incluído. Uma resposta vazia deixa o valor pendente.
Como os valores são introduzidos
A importação responde a cada valor pendente primeiro a partir do ficheiro de respostas. Para cada valor que o ficheiro deixa sem resposta, pergunta-o ao utilizador, uma pergunta de cada vez — mas apenas quando a entrada padrão e a saída padrão são ambas um terminal e --dry-run não é indicado:
- cada pergunta indica o ficheiro gerado 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, pelo que a saída padrão contém apenas o resultado da importação;
- premir Enter deixa o valor para mais tarde, e terminar a entrada interrompe as perguntas.
Cada resposta dada é escrita nos rascunhos e no ficheiro de respostas, e o ficheiro de respostas é indicado entre os ficheiros escritos. Uma execução que não altera nada no ficheiro de respostas não o volta a escrever.
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:
| Resposta | Exemplo |
|---|---|
| um nome de variável | OPENAI_API_KEY |
| uma referência a uma variável | ${OPENAI_API_KEY} |
| o nome de um Secret do Kubernetes | openai-api-key |
A importação verifica se a resposta tem a forma de um destes nomes e recusa qualquer outra coisa:
- num terminal, a resposta é recusada, o motivo é apresentado e a pergunta é feita novamente;
- no ficheiro de respostas, a importação para, indicando o ficheiro de respostas, o ficheiro em rascunho e a chave — nunca a resposta, que pode ser o próprio segredo — e não escreve nada.
A verificação lê a forma da resposta, pelo que 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, através 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 lido o ficheiro de respostas:
- escreve os rascunhos, deixando vazio cada valor devido;
- escreve o ficheiro de respostas com cada chave devida presente e a respetiva resposta vazia;
- indica cada valor devido na saída de erro padrão, como um aviso que indica o ficheiro em rascunho, o caminho da chave e a respetiva descrição;
- não transfere as dependências da Release em rascunho;
- termina com o estado 1 e uma frase que diz 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 againEscreva cada resposta junto da respetiva chave e, em seguida, execute aggrega import <source> --sync no mesmo diretório: este gera os rascunhos para o destino dado à importação anterior, escreve cada resposta nos rascunhos e não pergunta nada. Um aggrega import simples num diretório que já contém o Aggregate em rascunho para, indicando --sync, e não escreve nada. Uma importação para um diretório de saída novo também lê o ficheiro de respostas: o predefinido, ou o indicado por --answers.
A ferramenta de importação do assistente recebe o ficheiro 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 inclui, ao lado dela, o resultado da importação, avisos incluídos. A importação do editor também aceita o ficheiro de respostas, e a mesma frase encerra os respetivos diagnósticos.
Ambos listam também como dados cada valor ainda em dívida, em owed: o ficheiro em rascunho, o caminho da chave como lista de chaves, a pergunta, se o valor é o de um segredo e, para um segredo, o que a sua resposta tem de ser (secretAdvice a partir do editor, secret_advice a partir da ferramenta de importação do assistente). Devolva cada resposta em answered — o ficheiro em rascunho, o caminho da chave e a resposta — com sync, e a importação verifica-a, mantém-na no ficheiro de respostas e escreve-a nos rascunhos, tal como faz com uma resposta introduzida num terminal. A resposta de um segredo que não é um nome não é mantida nem escrita: o valor permanece em owed, com o motivo no lugar da respetiva indicação.
Depois de uma importação que escreve os seus rascunhos, o editor oferece-se para pedir cada valor ainda por responder numa caixa de entrada própria, e envia as respostas desta forma; depois de uma pré-visualização não oferece nada, já que nada é perguntado com --dry-run. Responder aos valores que uma importação ainda fica a dever descreve as perguntas.
Com --dry-run, nada é perguntado e nada é escrito, incluindo o ficheiro de respostas. Cada valor devido continua a ser indicado na saída de erro padrão, e o estado de saída é o da própria execução de teste.
Reexecução e --sync
aggrega import --sync lê o mesmo ficheiro de respostas que a importação anterior: o indicado por --answers, caso contrário o indicado pelo registo junto dos rascunhos, caso contrário o predefinido junto da origem. Escreve cada resposta nos rascunhos no lugar do valor vazio e, quando o ficheiro de respostas responde a todos os valores devidos, não pergunta nada.
Quando nada é devido e o workspace não está offline, a importação transfere as dependências da Release em rascunho tal como faz aggrega pull, escrevendo release.lock, para que aggrega validate e aggrega build funcionem de imediato sobre os rascunhos. Com --offline, nada é transferido, e a importação indica o aggrega pull --release <path> a executar a seguir.
Um ficheiro de respostas para vários destinos
A mesma origem gerada em 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 deve também a origem da chave de API do Gemini do agente. Um único ficheiro de respostas serve ambos:
- a importação adiciona as chaves que os seus rascunhos devem e define as respostas que recebe;
- uma resposta para uma chave que estes rascunhos não devem é mantida no ficheiro e não é aplicada;
- todas as outras chaves e comentários do ficheiro permanecem como estão.
O ficheiro de respostas só é lido onde os rascunhos devem algum valor. Onde devem, uma linha informativa na saída de erro padrão indica 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 ficheiro de respostas que indica também 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 appliedOnde 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 ficheiro de respostas não é lido, nenhuma linha desse tipo é apresentada e o ficheiro fica como está.
Ver também
aggrega import— a referência do comando, com todas as flags.- Importação — o que uma importação gera em rascunho, e um guia passo a passo para cada formato de origem.