가져오기 응답 파일
어떤 소스에도 담을 수 없는 값이 있습니다. 직접 작성한 코드로 빌드한 애플리케이션의 이미지, 소유자 계정의 이메일, 소스가 명시하지 않은 모델, Kubernetes Secret의 이름 등입니다. aggrega import는 이러한 값을 각각 빈 문자열로 초안 작성하고 그것이 무엇인지 알려 주는 주석을 위에 달며, 응답 파일에서 또는 터미널에서의 질문으로 한 번만 받습니다. 응답은 응답 파일 import-answers.yaml에 보관되므로, 같은 소스를 이후에 가져올 때마다 그곳에서 읽고 아무것도 묻지 않습니다.
이 페이지는 파일의 위치, 담는 내용, 값이 들어가는 방식, 그리고 값이 아직 없을 때 가져오기가 하는 일을 설명합니다. 가져오기의 용도와 소스에서 빌드까지의 연습 과정은 가져오기에 있습니다.
제공해야 하는 값
초안 작성 후 가져오기는 초안으로 작성된 모든 문서를 그 문서 자체의 스키마와, 문서가 선언하는 각 Component, Feature 및 연결의 카탈로그 스키마에 대조해 읽습니다. 값은 해당 스키마가 값을 요구하는 곳에서 여전히 비어 있거나, 스키마가 키를 선언했는데 아무것도 그 값을 제공하지 않았을 때 제공해야 하는 값이 됩니다. 제공해야 하는 각 값은 스키마가 그 키에 대해 직접 제공하는 설명으로 기술되며, 스키마에 설명이 없으면 초안이 키 위에 작성하는 주석으로 기술됩니다.
제공해야 하는 값이 남아 있는 동안 가져오기는 초안으로 작성된 Release의 종속성을 가져오지 않으며, 모든 값에 응답이 주어지면 이를 가져옵니다(다시 실행과 --sync 참조).
파일 위치
| 소스가 | 응답 파일은 |
|---|---|
| 파일인 경우 | 소스 파일과 같은 디렉터리의 import-answers.yaml |
| 디렉터리인 경우 | 소스 디렉터리 안의 import-answers.yaml |
--answers <file>는 다른 파일을 지정합니다. 상대 경로는 명령을 실행하는 디렉터리를 기준으로 해석됩니다. 초안에 아직 채워지지 않은 값이 있고 응답 파일이 소스 옆의 기본 파일이 아닌 경우, 가져오기가 초안 옆에 기록하는 레코드 .aggrega-import.json에 해당 파일이 기록되므로, 이후 같은 디렉터리로 실행하는 aggrega import --sync는 다시 지정하지 않아도 그 파일을 읽습니다. 레코드에는 응답이 절대 저장되지 않습니다.
시크릿의 응답은 시크릿을 가져오는 위치의 이름이며, 결코 시크릿 자체가 아닙니다(시크릿 참조). 따라서 응답 파일을 소스와 함께 버전 관리에 보관할 수 있습니다.
포함 내용
이 파일은 YAML입니다. 최상위 키는 초안으로 작성된 파일이며, 각 파일이 작성되는 경로로 나타냅니다. 각 키 아래에서 키는 해당 문서 안에서 채워야 할 값의 점으로 구분된 키 경로이고, 그 값이 응답입니다. 스키마의 키 설명은 키 위에 주석으로 기록됩니다. 비어 있거나 마침표, 공백 또는 따옴표를 포함하는 키 경로 세그먼트는 큰따옴표로 묶어 기록됩니다. 이 형태로 읽히지 않는 파일은 파일과 이유를 밝히며 가져오기를 중지시키고, 아무것도 기록되지 않습니다.
예를 들어 --target helm으로 초안을 작성한 Google ADK 가져오기는 Release에 채워야 할 값이 두 개 있습니다. 프로젝트에서 빌드하는 에이전트의 이미지와, 에이전트의 Gemini API 키를 가져오는 위치입니다. 두 값에 모두 응답하면 소스 디렉터리 support_agent/ 안의 응답 파일은 다음과 같습니다:
# 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"두 응답 모두 직접 정하는 값입니다. ghcr.io/example/support-agent:1.0.0은 빌드하고 푸시하는 이미지를, google-api-key는 배포 대상 네임스페이스에서 키를 보관하는 Kubernetes Secret의 이름을 나타냅니다.
각 응답은 하나의 값이며, 가져오기는 이를 빈 값 대신 문자열로 초안에 기록하고 초안의 다른 부분은 변경하지 않습니다. 초안으로 작성된 Aggregate에 기록된 응답은 {{를 포함해 입력한 그대로 다시 읽힙니다. 빈 응답은 값을 채워지지 않은 상태로 둡니다.
값이 채워지는 방식
가져오기는 채워야 할 각 값을 먼저 응답 파일에서 응답합니다. 파일에서 응답하지 않은 각 값에 대해서는 한 번에 하나씩 질문합니다 — 단, 표준 입력과 표준 출력이 모두 터미널이고 --dry-run이 지정되지 않은 경우에만 해당합니다:
- 각 질문은 초안 파일과 키 경로를 밝히며, 스키마의 설명을 바탕으로 작성됩니다.
- 질문은 표준 오류에 기록되므로 표준 출력에는 가져오기 결과만 출력됩니다.
- Enter 키를 누르면 값을 나중으로 미루고, 입력을 종료하면 질문이 중지됩니다.
입력한 모든 응답은 초안과 응답 파일에 기록되며, 응답 파일은 기록된 파일 목록에 표시됩니다. 응답 파일에서 아무것도 변경하지 않는 실행은 응답 파일을 다시 기록하지 않습니다.
시크릿
시크릿의 값 — 스키마가 민감한 것으로 표시한 값 — 은 시크릿 자체가 아니라 시크릿을 가져오는 위치로 답합니다. 해당 질문은 이를 묻고, 답은 다음 이름 중 하나입니다:
| 답변 | 예 |
|---|---|
| 변수 이름 | OPENAI_API_KEY |
| 변수에 대한 참조 | ${OPENAI_API_KEY} |
| Kubernetes Secret의 이름 | openai-api-key |
가져오기는 답이 이들 이름 중 하나의 형식인지 확인하고, 그 외의 것은 모두 거부합니다:
- 터미널에서는 답이 거부되고, 이유가 표시되며, 질문을 다시 합니다;
- 답변 파일에서는 가져오기가 중단되며, 답변 파일, 초안 파일, 키를 알려 주고 — 답 자체는 시크릿일 수 있으므로 절대 알려 주지 않습니다 — 아무것도 쓰지 않습니다.
이 검사는 답의 형식을 읽으므로, 우연히 이름처럼 보이는 시크릿은 이름과 구별되지 않습니다. 시크릿 자체는 이름이 가리키는 곳, 즉 변수나 Secret에 그대로 있습니다.
터미널이 없을 때
지속적 통합에서, 파이프를 통해, 그리고 어시스턴트의 가져오기 도구(aggrega mcp)에서는 아무것도 묻지 않으며, 편집기의 가져오기도 실행되는 동안에는 아무것도 묻지 않습니다. 답변 파일을 읽은 후에도 아직 필요한 값이 남은 가져오기는 다음과 같이 동작합니다:
- 초안을 쓰고, 필요한 각 값을 비워 둡니다;
- 필요한 모든 키가 있고 그 답이 비어 있는 답변 파일을 씁니다;
- 필요한 각 값을 표준 오류에 초안 파일, 키 경로, 그 설명을 알려 주는 경고로 표시합니다;
- 초안 Release의 종속성을 가져오지(pull) 않습니다;
- 상태 1로 종료하며, 필요한 값이 몇 개인지와 어디에 써야 하는지 알려 주는 한 문장을 출력합니다:
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각 답을 해당 키 옆에 쓴 다음, 같은 디렉터리로 aggrega import <source> --sync를 실행합니다. 이 명령은 이전 가져오기에 지정된 대상에 맞춰 초안을 작성하고, 각 답을 초안에 쓰며, 아무것도 묻지 않습니다. 초안 Aggregate가 이미 있는 디렉터리로 일반 aggrega import를 실행하면 --sync를 안내하며 중단하고 아무것도 쓰지 않습니다. 새 출력 디렉터리로의 가져오기도 답변 파일을 읽습니다: 기본 답변 파일 또는 --answers가 지정한 답변 파일입니다.
어시스턴트의 가져오기 도구는 답변 파일을 answers로 받으며, 작업 공간 루트 기준 상대 경로나 절대 경로로 지정합니다. 아직 필요한 값이 남은 호출은 그 문장으로 실패하고, 경고를 포함한 가져오기 결과를 그 옆에 함께 담습니다. 에디터의 가져오기도 답변 파일을 받으며, 같은 문장이 진단의 마지막 줄이 됩니다.
둘 다 아직 필요한 각 값을 owed 아래에 데이터로도 나열합니다: 초안 파일, 키 목록으로 표현한 키 경로, 질문, 그 값이 시크릿의 값인지 여부, 그리고 시크릿의 경우 그 답이 무엇이어야 하는지(편집기에서는 secretAdvice, 어시스턴트의 가져오기 도구에서는 secret_advice)입니다. 각 답을 answered 아래에 초안 파일, 키 경로, 답과 함께 sync를 붙여 돌려보내면, 가져오기는 이를 검사하고 답변 파일에 보존하며 초안에 씁니다. 터미널에서 입력한 답과 같은 방식입니다. 이름이 아닌 시크릿의 답은 보존되지도 쓰이지도 않습니다: 그 값은 owed에 남고, 안내 대신 이유가 표시됩니다.
초안을 기록하는 가져오기 후에는 편집기가 아직 남은 각 값을 각자의 입력 상자에서 묻겠다고 제안하고, 이 방식으로 답을 다시 보냅니다. 미리 보기 후에는 --dry-run에서 아무것도 묻지 않으므로 아무것도 제안하지 않습니다. 질문은 가져오기가 아직 남긴 값에 답하기에서 설명합니다.
--dry-run에서는 아무것도 묻지 않고, 답변 파일을 포함해 아무것도 쓰지 않습니다. 필요한 각 값은 여전히 표준 오류에 표시되며, 종료 상태는 드라이 런 자체의 상태입니다.
다시 실행하기와 --sync
aggrega import --sync는 이전 가져오기와 같은 답변 파일을 읽습니다: --answers가 지정한 파일, 없으면 초안 옆의 기록이 지정한 파일, 그것도 없으면 소스 옆의 기본 파일입니다. 각 답을 빈 값 대신 초안에 쓰며, 답변 파일이 필요한 모든 값에 답하는 경우 아무것도 묻지 않습니다.
더 이상 필요한 값이 없고 작업 공간이 오프라인이 아니면, 가져오기는 aggrega pull처럼 초안 Release의 종속성을 가져와 release.lock을 쓰므로, aggrega validate와 aggrega build가 초안에서 바로 동작합니다. --offline에서는 아무것도 가져오지 않으며, 가져오기는 다음에 실행할 aggrega pull --release <path>를 알려 줍니다.
여러 대상을 위한 하나의 답변 파일
같은 소스라도 다른 대상으로 초안을 만들면 필요한 값이 다를 수 있습니다: 위의 Google ADK Release는 --target compose로 초안을 만들면 이미지만 필요하지만, 같은 Release를 --target helm으로 초안을 만들면 에이전트의 Gemini API 키를 가져올 위치도 필요합니다. 하나의 답변 파일이 둘 다에 쓰입니다:
- 가져오기는 초안에 필요한 키를 추가하고 받은 답을 설정합니다;
- 이 초안에 필요하지 않은 키에 대한 답은 파일에 유지되지만 적용되지 않습니다;
- 파일의 다른 모든 키와 주석은 그대로 유지됩니다.
답변 파일은 초안에 필요한 값이 있을 때만 읽힙니다. 그런 경우 표준 오류의 정보 줄이 보존되었지만 적용되지 않은 각 답을 알려 줍니다. 여기서는 --target compose로 초안을 작성한 Flowise 가져오기의 예로, 이 가져오기에는 소유자의 이메일만 필요하며, 같은 가져오기가 --target helm에서 필요로 하는 두 Kubernetes Secret도 지정한 답변 파일을 읽습니다:
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초안에 필요한 값이 없으면, 예를 들어 모든 시크릿을 변수에서 읽는, --target compose로 초안을 작성한 Langflow 가져오기의 경우, 답변 파일은 읽히지 않고 그런 줄도 출력되지 않으며 파일은 그대로 남습니다.
참고 항목
aggrega import— 모든 플래그를 포함한 명령 참조.- 가져오기 — 가져오기가 무엇을 초안으로 만드는지, 그리고 각 소스 형식에 대한 단계별 안내.