콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

Aggrega로 가져오기

가져오기가 무엇을 읽고 쓰는지, 그리고 어떤 형식을 읽는지는 가져오기에서 설명합니다. 이 페이지에서는 편집기에서 가져오기를 실행하는 방법을 다룹니다.

Aggrega: Import into Aggrega — 다른 도구가 작성한 소스로부터 Aggrega 작성 파일의 초안을 만듭니다. 이 명령은 Commands 패널의 Author 그룹에 있는 Import 버튼이기도 하고, 탐색기에서 파일이나 폴더의 오른쪽 클릭 메뉴에 있는 Import into Aggrega이기도 하며, 후자는 클릭한 파일이나 폴더를 가져옵니다. 셋은 하나의 명령이므로 같은 질문을 같은 순서로, 각각 편집기 자체의 입력란에서 묻습니다. 다만 탐색기 항목은 소스를 묻지 않습니다.

먼저 소스로 File… 또는 **Folder…**를 고르고, 그다음 그 종류에 맞는 편집기의 열기 대화 상자가 나타납니다 — 이 선택이 먼저 오는 이유는 Windows와 Linux에서는 하나의 대화 상자가 둘 다 제공할 수 없기 때문입니다. 그다음 초안을 만들 작업 공간 안의 폴더를 루트 기준 상대 경로로 지정합니다. 비워 두면 --output-dir 없이 실행한 aggrega import처럼 작업 공간 루트 아래에 초안을 만듭니다. 그다음은 옵션으로, Preview, Sync, 둘 다를 선택하거나 아무것도 선택하지 않을 수 있는 목록입니다. Preview는 --dry-run입니다 — 아무것도 기록되지 않으며, 가져오기가 기록할 각 파일이 출력 채널에 표시되고 그 뒤에 내용이 이어집니다 — 그리고 Sync는 --sync로, 이전 가져오기가 만든 초안을 소스에 맞게 최신 상태로 만들되 가져오기가 기록한 것만 변경하며, 최신 상태로 만든 각 부분은 aggrega import --sync가 출력하는 문구로 채널에 나열됩니다. 둘 다 선택하지 않으면 초안 전체를 기록합니다. 마지막으로 Manifest 초안을 만들 공급자 기능으로, 예를 들어 compose 또는 helm이며, 비워 두면 --target 없이 실행한 것처럼 아무 초안도 만들지 않습니다. 비워 둔 답과 선택하지 않은 옵션은 아예 전송되지 않으므로 컴파일러가 자체 기본값을 적용하며, 질문이나 대화 상자를 닫으면 아무것도 전송하지 않고 가져오기가 끝납니다. 작업 공간 밖으로 이어지는 폴더와, 작업 공간의 카탈로그에 있는 어떤 Recipe도 바인딩하지 않는 기능은 무엇이든 기록되기 전에 컴파일러가 자체 문구로 거부합니다.

소스가 파일인지 폴더인지 묻는 가져오기의 첫 질문.

형식은 터미널에서와 마찬가지로 소스 자체의 형태로 인식됩니다. 어떤 형식도 소스를 인식하지 못하거나 둘 이상의 형식이 인식하여 컴파일러가 거부하면, 편집기는 그 거부 — 형식들을 밝히는 거부 — 를 보여 주고 소스를 어떤 형식으로 읽을지 물은 다음 그 형식을 담아 같은 가져오기를 다시 보냅니다. 그 질문을 비워 두면 그 거부로 가져오기가 끝납니다. 지정한 파일, 또는 지정한 디렉터리에서 가져오기 도구가 읽는 파일만 읽으며 그 밖의 파일은 읽지 않습니다. 네트워크에는 접근하지 않습니다. 다만 가져오기 실행에 필요하지만 이 머신에 아직 없는 것을 가져올 때는 예외입니다 — 어떤 형식이 처음 필요로 할 때의 컴파일러 핵심 가져오기 도구 하나와, 카탈로그 폴더를 지정하지 않은 작업 공간에서는 가져오기가 카탈로그로 읽는 게시된 카탈로그 스냅샷이며 — 각각 aggrega import와 마찬가지로 작업 공간의 기본 레지스트리에서 가져와 검증하고 콘텐츠 캐시에 보관합니다. 소스는 작업 공간이 보유한 파일이 아니라 사용자가 가리킨 파일이므로 이 머신의 어디에 있어도 됩니다. 초안은 항상 작업 공간에 놓입니다.

Cancel 버튼과 함께 진행 상황을 표시하며, Cancel을 누르면 편집기의 대기만 멈추는 것이 아니라 변환 자체가 중지됩니다. 가져오기 도구는 컴파일러가 실행 도중에 되돌릴 수 있는 플러그인으로 실행되기 때문입니다.

마지막에는 소스가 무엇으로 인식되었는지, 몇 개의 파일이 초안으로 만들어졌고 어디로 갔는지를 알려 줍니다. 이때 세는 것은 초안이며, 모든 가져오기가 초안 옆에 기록하는, 가져오기가 기록한 내용의 기록인 .aggrega-import.json은 세지 않습니다. 가져오기 도구 자체의 발견 사항과 디스크에 기록된 모든 파일(기록 포함)은 Aggrega 출력 채널로 갑니다. 이들은 사용자가 작성한 문서가 아니라 소스 파일의 위치를 가리키기 때문입니다. 초안을 기록하는 가져오기가 어떤 소스도 담을 수 없는 값을 초안에 남겨 두면, 편집기는 그 값을 물어보겠다고 제안합니다. 자세한 내용은 가져오기가 아직 남긴 값에 답하기에서 설명합니다.

가져오기가 아직 남긴 값에 답하기

초안에 필요한 값 중에는 어떤 소스도 담을 수 없는 값이 있습니다. 예를 들어 직접 작성한 코드가 빌드되어 들어가는 이미지, 소유자 계정의 이메일, 또는 시크릿의 출처입니다. 초안을 기록하는 가져오기가 이런 값을 비워 두면, 편집기는 그 개수를 알려 주는 알림에서 이를 물어보겠다고 한 번 제안합니다. 제안을 닫아도 아무것도 바뀌지 않습니다. 미리 보기에는 아무것도 제안하지 않습니다. aggrega import --dry-run이 아무것도 묻지 않는 것과 같으며, 미리 보기에는 답이 적용되지 않기 때문입니다. 그래도 출력 채널에 표시되는 미리 보기의 발견 사항은 아직 비어 있는 각 값을 알려 줍니다. 제안을 받아들이면 각 값은 초안에 나열된 순서대로 각자의 입력 상자에서 질문됩니다. 상자의 제목에는 초안 파일과 값이 위치한 키가 표시되며, 질문은 컴파일러 자체의 값 설명, 즉 aggrega import가 터미널에서 하는 질문으로 이루어집니다. 시크릿의 상자는 컴파일러 자체의 문구로 시크릿의 출처를 묻고 — 시크릿 자체는 결코 묻지 않습니다 — 입력한 내용을 숨깁니다. 비워 둔 상자의 값은 미해결로 남으며, 나중에 답변 파일에서 답할 수 있습니다. 어느 상자에서든 Escape를 누르면 질문이 끝나고, 이미 입력한 답을 포함해 아무것도 전송되지 않습니다.

그런 다음 편집기는 답을 담아 같은 진행 상황 표시와 Cancel 버튼과 함께 가져오기를 다시 보내며, 그 발견 사항, 파일, 마지막 메시지는 첫 가져오기와 마찬가지로 출력 채널로 갑니다. 초안이 이미 디스크에 있으므로 답은 동기화로 전송됩니다. 컴파일러는 각 답을 초안에 기록하고 aggrega import가 읽는 답변 파일에 보관하므로, 이후 그 소스를 가져오거나 동기화할 때 다시 묻지 않습니다. 그 파일이 이미 답한 값은 아예 묻지 않습니다. 시크릿에 출처를 가리키는 이름이 아닌 다른 것으로 답하면 컴파일러가 자체 문구로 거부하며, 그 값은 미해결로 남습니다. 다시 보낸 가져오기 후에도 초안에 남은 값은 같은 방식으로 제안됩니다.