Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

El archivo de respuestas de la importación

Algunos valores no pueden estar en ninguna fuente: la imagen de una aplicación construida a partir de tu propio código, el correo electrónico de una cuenta propietaria, un modelo que la fuente no nombra, el nombre de un Secret de Kubernetes. aggrega import redacta cada uno de esos valores como una cadena vacía, bajo un comentario que dice qué es, y te lo pide una sola vez — desde el archivo de respuestas o con una pregunta en un terminal. Las respuestas se guardan en el archivo de respuestas, import-answers.yaml, de modo que cada importación posterior de la misma fuente las lee de allí y no pregunta nada.

Esta página describe dónde está el archivo, qué contiene, cómo entran en él los valores y qué hace una importación cuando todavía falta un valor. Para qué sirve una importación, y recorridos desde una fuente hasta una compilación, están en Importación.

Qué valores están pendientes

Tras el borrador, la importación valida cada documento redactado contra su propio esquema y contra el esquema de catálogo de cada Component, Feature y conexión que el documento declara. Un valor está pendiente cuando sigue vacío donde ese esquema exige uno, o donde el esquema declara la clave y nada la ha proporcionado. Cada valor pendiente se describe con la descripción que el propio esquema da de su clave; donde el esquema no da ninguna, con el comentario que el borrador escribe encima de la clave.

Mientras haya algún valor pendiente, la importación no descarga las dependencias de la Release redactada; las descarga en cuanto todos los valores tienen respuesta (consulta Volver a ejecutar y --sync).

Dónde se encuentra el archivo

El origen esEl archivo de respuestas es
un archivoimport-answers.yaml en el mismo directorio que el archivo de origen
un directorioimport-answers.yaml dentro del directorio de origen

--answers <file> indica otro archivo. Una ruta relativa se resuelve respecto al directorio en el que ejecutas el comando. Cuando los borradores tienen valores pendientes y el archivo de respuestas no es el predeterminado junto al origen, el registro que la importación escribe junto a los borradores, .aggrega-import.json, lo indica, de modo que un aggrega import --sync posterior en el mismo directorio lo lee sin que haya que indicarlo de nuevo. El registro nunca contiene una respuesta.

La respuesta de un secreto es el nombre del lugar de donde procede el secreto, nunca el secreto en sí (consulta Secretos), por lo que el archivo de respuestas puede conservarse junto con el origen en el control de versiones.

Qué contiene

El archivo es YAML. Sus claves de nivel superior son los archivos generados como borrador, por la ruta en la que se genera cada uno. Bajo cada una, una clave es la ruta de clave con puntos de un valor pendiente dentro de ese documento, y su valor es la respuesta. La descripción de la clave que da el esquema se escribe como comentario encima de ella. Un segmento de la ruta de clave que esté vacío, o que contenga un punto, espacios en blanco o unas comillas, se escribe entre comillas dobles. Un archivo que no se lea con esta forma detiene la importación, indicando el archivo y el motivo, y no se escribe nada.

Por ejemplo, la importación de Google ADK generada con --target helm tiene dos valores pendientes en su Release: la imagen del agente que construyes a partir de tu proyecto y el lugar de donde procede la clave de API de Gemini del agente. Con ambos respondidos, el archivo de respuestas dentro del directorio de origen support_agent/ queda así:

# 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 respuestas son tuyas: ghcr.io/example/support-agent:1.0.0 representa la imagen que construyes y publicas, y google-api-key el nombre del Secret de Kubernetes que contiene la clave en el namespace en el que despliegas.

Cada respuesta es un único valor, y la importación lo escribe en el borrador como cadena, en lugar del vacío, sin cambiar nada más en el borrador. Una respuesta escrita en un Aggregate generado como borrador se lee exactamente como la escribiste, {{ incluido. Una respuesta vacía deja el valor pendiente.

Cómo se introducen los valores

La importación responde primero cada valor pendiente a partir del archivo de respuestas. Por cada valor que el archivo deja sin responder, te lo pregunta, una pregunta cada vez — pero solo cuando la entrada estándar y la salida estándar son ambas un terminal y no se indica --dry-run:

  • cada pregunta indica el archivo generado y la ruta de clave, y se formula a partir de la descripción del esquema;
  • las preguntas se escriben en la salida de error estándar, de modo que la salida estándar solo contiene el resultado de la importación;
  • pulsar Intro deja el valor para más tarde, y terminar la entrada detiene las preguntas.

Cada respuesta que das se escribe en los borradores y en el archivo de respuestas, y el archivo de respuestas figura entre los archivos escritos. Una ejecución que no cambia nada en el archivo de respuestas no lo vuelve a escribir.

Secretos

Al valor de un secreto — uno que su esquema marca como sensible — se responde con el origen del secreto, nunca con el secreto en sí. Su pregunta pide eso, y la respuesta es uno de estos nombres:

RespuestaEjemplo
un nombre de variableOPENAI_API_KEY
una referencia a una variable${OPENAI_API_KEY}
el nombre de un Secret de Kubernetesopenai-api-key

La importación comprueba que la respuesta tenga la forma de uno de estos nombres y rechaza cualquier otra cosa:

  • en un terminal, la respuesta se rechaza, se muestra el motivo y la pregunta se vuelve a hacer;
  • en el archivo de respuestas, la importación se detiene indicando el archivo de respuestas, el archivo borrador y la clave — nunca la respuesta, que puede ser el propio secreto — y no escribe nada.

La comprobación lee la forma de la respuesta, por lo que un secreto que casualmente parece un nombre no se distingue de uno. El secreto en sí permanece donde apunta el nombre: en la variable o en el Secret.

Sin terminal

En integración continua, a través de una tubería y desde la herramienta de importación del asistente (aggrega mcp), no se pregunta nada, y la importación del editor no pregunta nada mientras se ejecuta. Una importación que todavía debe valores una vez leído el archivo de respuestas:

  • escribe los borradores, dejando vacío cada valor debido;
  • escribe el archivo de respuestas con cada clave debida presente y su respuesta vacía;
  • indica cada valor debido en la salida de error estándar, como una advertencia que nombra el archivo borrador, la ruta de la clave y su descripción;
  • no descarga las dependencias de la Release borrador;
  • termina con el estado 1 y una frase que dice cuántos valores se deben y dónde escribirlos:
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

Escribe cada respuesta junto a su clave y luego ejecuta aggrega import <source> --sync en el mismo directorio: genera los borradores para el destino que se dio a la importación anterior, escribe cada respuesta en los borradores y no pregunta nada. Un aggrega import simple en un directorio que ya contiene el Aggregate borrador se detiene, indicando --sync, y no escribe nada. Una importación en un directorio de salida nuevo también lee el archivo de respuestas: el predeterminado o el que indica --answers.

La herramienta de importación del asistente recibe el archivo de respuestas como answers, indicado de forma relativa a la raíz del espacio de trabajo o absoluta. Una llamada que todavía debe valores falla con esa frase y lleva junto a ella el resultado de la importación, advertencias incluidas. La importación del editor también acepta el archivo de respuestas, y la misma frase cierra sus diagnósticos.

Ambos enumeran además como datos cada valor aún pendiente, bajo owed: el archivo borrador, la ruta de la clave como lista de claves, la pregunta, si el valor es el de un secreto y, para un secreto, cuál debe ser su respuesta (secretAdvice desde el editor, secret_advice desde la herramienta de importación del asistente). Devuelve cada respuesta bajo answered — el archivo borrador, la ruta de la clave y la respuesta — con sync, y la importación la comprueba, la conserva en el archivo de respuestas y la escribe en los borradores, como hace con una respuesta escrita en una terminal. La respuesta de un secreto que no es un nombre no se conserva ni se escribe: el valor permanece en owed, con el motivo en lugar de su indicación.

Después de una importación que escribe sus borradores, el editor ofrece pedir cada valor aún pendiente en un cuadro de entrada propio, y devuelve las respuestas de esta manera; después de una vista previa no ofrece nada, ya que con --dry-run no se pregunta nada. Responder a los valores que una importación aún debe describe las preguntas.

Con --dry-run no se pregunta nada ni se escribe nada, incluido el archivo de respuestas. Cada valor debido se sigue indicando en la salida de error estándar, y el estado de salida es el de la propia ejecución en seco.

Reejecución y --sync

aggrega import --sync lee el mismo archivo de respuestas que la importación anterior: el que indica --answers, si no el que indica el registro junto a los borradores, si no el predeterminado junto al origen. Escribe cada respuesta en los borradores en lugar del valor vacío y, cuando el archivo de respuestas responde a todos los valores debidos, no pregunta nada.

Una vez que no se debe nada y el espacio de trabajo no está sin conexión, la importación descarga las dependencias de la Release borrador como lo hace aggrega pull, escribiendo release.lock, de modo que aggrega validate y aggrega build funcionan de inmediato sobre los borradores. Con --offline no se descarga nada, y la importación indica el aggrega pull --release <path> que se debe ejecutar a continuación.

Un archivo de respuestas para varios destinos

El mismo origen generado como borrador para destinos distintos puede deber valores distintos: la Release de Google ADK anterior, generada con --target compose, solo debe la imagen, y la misma Release generada con --target helm también debe el origen de la clave de API de Gemini del agente. Un solo archivo de respuestas sirve para ambos:

  • la importación añade las claves que deben sus borradores y establece las respuestas que recibe;
  • una respuesta para una clave que estos borradores no deben se conserva en el archivo sin aplicarse;
  • todas las demás claves y comentarios del archivo quedan como están.

El archivo de respuestas solo se lee donde los borradores deben algún valor. Donde lo deben, una línea informativa en la salida de error estándar indica cada respuesta conservada y no aplicada — aquí para la importación de Flowise generada con --target compose, que solo debe el correo electrónico del propietario, leyendo un archivo de respuestas que también indica los dos Secrets de Kubernetes que la misma importación debe con --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

Donde los borradores no deben nada — la importación de Langflow generada con --target compose, por ejemplo, que lee cada secreto de una variable —, el archivo de respuestas no se lee, no se imprime ninguna línea de ese tipo y el archivo se deja como está.

Véase también

  • aggrega import — la referencia del comando, con todos sus flags.
  • Importación — lo que genera una importación como borrador, y un recorrido paso a paso para cada formato de origen.