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

토폴로지 그래프

Topology graph — 선택한 Release의 컴파일된 IR을 대화형 그래프로 렌더링합니다. 경계 및 하위 시스템 컨테이너(다른 경계나 하위 시스템 안에 선언된 경계나 하위 시스템은 그 안에 그려짐), 출처에 따라 스타일이 지정된 에지, 이동 및 확대/축소, 노드를 클릭하여 선택하고 더블 클릭하여 소스 파일을 여는 기능, 에지를 클릭하여 해당 에지가 그리는 연결을 선택하는 기능을 제공합니다.

Release의 토폴로지 그래프: 어떤 경계나 하위 시스템도 선언하지 않는 노드를 담는 상자 안의 세 컴포넌트, web 컴포넌트에서 해당 데이터베이스와 캐시로 향하는 에지, 왼쪽 아래의 범례.

각 컨테이너의 제목은 그룹뿐 아니라 종류도 나타내므로, 둘 다 선언하지 않는 워크스페이스에서도 바깥 상자와 안쪽 상자를 구별해 읽을 수 있습니다. 그렇지 않으면 둘 다 같은 이름을 갖게 됩니다. 아무도 선언하지 않은 그룹, 즉 Release나 Aggregate가 최상위 수준에 나열하는 컴포넌트를 위해 컴파일러가 만드는 그룹에는 아무것도 선언되지 않았음을 나타내는 제목이 붙고, 그 상자는 선언된 그룹의 상자와 다르게(점선의 중립적인 테두리로) 그려지므로 그 이름의 그룹으로 읽히지 않습니다. 직접 선언한 그룹은 default를 포함하여 어떤 이름이든 그 이름을 유지합니다.

각 에지는 가리키는 쪽 끝에 화살촉이 있습니다. 에지는 사용하는 컴포넌트에서 대상으로 향하며, 화살촉은 에지 자체의 색상과 대시 패턴으로 그려집니다. 노드의 상자 크기는 그 안에 그리는 텍스트, 즉 노드 이름과 그 아래의 컴포넌트를 모두 측정하여 정해지므로, 컴포넌트 이름이 아무리 길어도 둘 다 테두리를 넘지 않습니다.

왼쪽 아래의 범례는 각 그룹을 그것을 선언하는 문서로 표시하고(경계는 Release로, 하위 시스템은 Aggregate로), 그림에 있는 경우 어느 그룹에도 속하지 않는 노드를 담는 상자와 그 내용을 표시합니다. 또한 에지의 어느 쪽 끝이 대상인지 알려 주고, 노드의 앞쪽 가장자리를 따라 있는 색상 막대와 그림이 그 막대에 부여하는 각 색상을, 그 색상이 나타내는 component.aggrega.ai/type 값과 나란히 레이블에 쓰인 그대로 표시하며, 그러한 레이블이 없는 노드가 있으면 그 노드들을 위한 행도 표시합니다. 이 색상들이 의미하지 않는 것도 알려 줍니다. 색상은 그래프를 그릴 때마다 할당되므로 한 그래프 안에서는 노드를 유형별로 묶지만, 다른 그래프에서 같은 색상이라고 해서 같은 유형은 아닙니다. 그림에 무엇을 하든 범례는 제자리에 있으므로, 그림이 패널에 맞춰질 때마다(처음 그릴 때와 그래프를 요청할 때마다) 그림은 범례 위의 패널 부분에 맞춰집니다. 즉, 패널의 전체 너비와 범례 위에 남은 높이 안에서 좌우 가운데에 배치되므로, 범례에 행이 아무리 많아도 그림의 어느 부분도 가리지 않습니다. 범례 위에 공간이 전혀 남지 않을 만큼 낮은 패널에서는 그림이 패널 전체에 맞춰집니다.

노드를 선택하면 해당 노드에 첨부된 항목을 나열하는 패널이 열립니다. 각 첨부 항목마다 Feature와 해석된 버전, 채우는 슬롯 또는 선언된 슬롯을 채우지 않는다는 사실, 컴파일된 그래프가 이름을 지정하는 경우 이를 구현하는 FeatureRecipe의 이름과 버전, 출처, 선언하는 레이블, 작성자가 작성한 값이 표시됩니다. 컴포넌트의 연결 중 하나에 작성된 첨부 항목, 즉 Aggregate나 Release에서 uses 항목의 features: 아래에 작성된 항목은 이 목록에 없습니다. 그러한 항목은 컴파일된 그래프가 기록하는 대로 해당 연결 위에 그려지며, 노드의 연결에 첨부 항목이 있으면 노드의 패널이 이를 알려 줍니다.

에지를 클릭하면 해당 에지가 그리는 연결이 선택되고 그 연결에 대한 패널이 열립니다. 패널 제목은 사용하는 컴포넌트와 그 대상이며 소켓과 별칭도 표시되고, 해당 연결의 첨부 항목은 노드의 경우와 같이 표시됩니다(각 항목의 Feature와 해석된 버전, 채우는 슬롯, 컴파일된 그래프가 이름을 지정하는 경우 이를 구현하는 FeatureRecipe, 그리고 값). 아무것도 첨부되어 있지 않으면 그렇다는 문장이 표시됩니다. 노드를 선택하면 선택된 연결이 해제되고 그 반대도 마찬가지입니다. Escape 또는 패널의 닫기 버튼으로 어느 쪽이든 해제할 수 있으며, 다시 그릴 때 재구성된 그래프가 여전히 해당 노드를, 또는 같은 컴포넌트에서 같은 소켓을 거쳐 같은 별칭으로 나가는 연결을 그리는 동안에는 선택이 유지됩니다.

노드의 첨부 항목 아래에 있는 May attach에서 패널은, 패널이 표시하는 Release의 그래프에서 해당 노드의 레이블이 선언된 적용 범위를 충족하는 Features를 나열합니다. 대상은 해당 Release가 읽는 워크스페이스 문서가 선언하는 Features(다른 Releases만 읽는 카탈로그 디렉터리에 있는 것은 제외)와 해당 Release가 빌드 기준으로 삼는 카탈로그 디렉터리에 들어 있는 Features이며, 각각 종류와 함께 그것을 선언하는 워크스페이스 파일 또는 그것을 해석해 온 구성된 카탈로그가 표시됩니다. 이 목록은 그 Features가 적용 대상으로 선언한 것이지, 하나를 첨부하면 빌드가 성공한다는 판정이 아닙니다. 목록이 비어 있으면 어떤 Feature의 선언된 적용 범위도 그 레이블과 일치하지 않는다는 뜻이며, 이는 첨부할 수 있는 것이 없다는 말보다 좁은 진술입니다. 언어 서버가 응답하지 못한 요청은 목록을 비워 두지 않고 목록 대신 그 사실을 표시합니다. 워크스페이스 밖으로 이어지는 링크 뒤에 선언된 Feature(외부 디렉터리로의 링크, 또는 YAML 파일처럼 이름이 붙었지만 외부 파일로 이어지는 링크)는 편집기의 파일 트리에 그 Feature가 표시되더라도 제공되지 않습니다. 언어 서버는 그러한 링크를 통해 어떤 엔터티도 읽지 않기 때문입니다. 워크스페이스에 그러한 링크가 있으면 목록 아래, 또는 빈 목록을 대신하는 문장 아래의 줄이 이를 알려 줍니다. Features reached through this link are not offered, because it leads outside the Aggrega workspace:(이 링크를 통해 도달하는 Features는 Aggrega 워크스페이스 밖으로 이어지므로 제공되지 않습니다:) 뒤에 워크스페이스 기준 상대 경로로 링크의 경로가 오고, 여러 개인 경우에는 Features reached through these links are not offered, because each leads outside the Aggrega workspace:(이 링크들을 통해 도달하는 Features는 각각 Aggrega 워크스페이스 밖으로 이어지므로 제공되지 않습니다:) 뒤에 디렉터리로의 링크부터 먼저 나열됩니다. 이 줄은 Catalog 패널이 선택한 Release를 기준으로 하듯이, 언어 서버가 보고하는 링크를 패널이 표시하는 Release를 기준으로 나열합니다. 그 보고를 읽을 수 없으면 목록은 그 줄 없이 그려지고 이유는 Aggrega 출력 채널에 기록되며, 생성할 수 없었던 목록에는 줄이 붙지 않습니다.

web 컴포넌트가 선택된 토폴로지 그래프와 그 옆의 패널. 패널은 아무것도 첨부되어 있지 않음을 알려 주고 May attach 아래에 첨부할 수 있는 Features를 각각 Attach 컨트롤과 함께 나열합니다.

각 행에는 그 행을 적용하는 Attach 컨트롤이 있습니다. 선택한 컴포넌트를 어느 문서가 선언하는지, 그리고 그 문서 안에서 그러한 첨부 항목이 어디에 들어가야 하는지를 컴파일러에 묻고, 항목은 편집기를 통해 그 위치에 기록됩니다. 따라서 항목은 실행 취소 기록에 포함되고, 디스크에 마지막으로 저장된 버전이 아니라 보고 있는 버퍼에 반영되며, 주변의 주석과 서식은 작성한 그대로 유지됩니다. 사용자를 대신해 저장되는 것은 없습니다. 이 편집은 다른 변경과 같은 변경이며, 컴파일러는 다른 편집 후와 마찬가지로 이를 다시 검증합니다. 그래프는 저장할 때 다시 그려집니다. 토폴로지는 디스크에 있는 그대로의 문서로부터 컴파일되며, 아직 버퍼에만 있는 첨부 항목은 아직 그 일부가 아니기 때문입니다. 첨부 항목의 이름은 Feature를 따르며, 이미 그 이름으로 첨부된 Feature를 첨부하려 하면 두 번 기록되지 않고 거부됩니다. 하위 시스템 안에 선언된 컴포넌트도 최상위 수준에 선언된 컴포넌트와 같은 조작으로 첨부되며, 둘 다 같은 이유로 작동합니다. 그래프는 컴파일된 토폴로지에서의 위치로 컴포넌트를 식별하는데, 그 위치는 컴포넌트 작성자가 어떤 키를 작성했는지 알려 주지 않으므로 확장은 재구성하는 대신 질의합니다. 응답은 문서와 그 안의 블록까지의 경로를 알려 주며, 둘 다 받은 그대로 편집에 반영됩니다. 지정할 그러한 위치가 없는 경우(그래프에 없는 ID, 문서가 기록되지 않은 노드, 또는 작성된 문서 안에서 자신의 블록을 지정할 수 없는 컴포넌트), 패널에 표시되는 것은 이 확장의 자체 문구가 아니라 컴파일러가 제공한 이유입니다.

선택한 연결의 패널에는 자체 May attach 섹션이 있습니다. 그 연결의 socket이 선언하는 슬롯이 컴포넌트가 선언한 순서대로 나열되며, 각 슬롯마다 필수 여부, 그것을 채우는 것이 민감한 자료를 다루는지 여부, 허용하는 전달 방식, 선택기와 설명이 표시됩니다. 각 슬롯 아래에는 언어 서버가 그 연결에서 그 슬롯을 채울 수 있다고 응답한 Features, 즉 선언된 적용 조건을 소비하는 컴포넌트의 레이블이 충족하고 자체 레이블이 슬롯의 선택기를 충족하는 것들이 나열됩니다. 채울 수 있는 슬롯이 없으면 패널은 언어 서버의 용어로 그 이유(Feature가 연결을 그렸거나, socket이 컴포넌트가 선언하지 않은 것이거나, socket이 슬롯을 선언하지 않음)를 알려 주고 첨부할 것을 아무것도 제시하지 않습니다. 슬롯 아래의 Attach를 누르면 Feature가 슬롯의 이름으로, 즉 type:이 그 Feature를 지정하는 <slot>: 항목으로, 연결을 그린 문서 안의 그 연결 항목에 작성됩니다. Release가 그린 연결이면 Release에, 그렇지 않으면 Aggregate에 작성됩니다. Aggrega: Attach a Feature to the connection at the cursor로 문서 안의 항목에서 선택한 연결은 대신 그 문서에 작성되며(Aggregate가 그린 연결에 대한 Release 자체 항목이라면 Release), 이때 May attach 아래의 패널 줄은 명령을 실행한 문서 안의 그 연결 항목에 Feature가 작성된다고 알려 줍니다. 그 항목이 그 문서의 어디에 들어가는지는 컴파일러에 묻고, 문서에 아직 없는 경로 부분은 함께 작성되며, 편집은 노드의 경우와 마찬가지로 저장되지 않은 상태로 편집기에 반영됩니다. 그래프가 그 연결에서 이미 채워져 있다고 표시하는 슬롯은 무엇이든 묻기 전에 거부되며, 컴파일러의 거부는 컴파일러 자신의 말로 표시됩니다.

컴파일러가 민감하다고 보고한 값은 언어 서버가 보내는 그래프에서 제외되고, 그래프가 보기에 전달되기 전에 확장이 다시 한 번 제외하므로, 보기에 표시될 값으로 존재하지 않습니다. 패널은 필드 이름과 제외된 이유를 알려 주며, 민감도 표시가 패널이 인식하지 못하는 형태인 첨부는 추측하지 않고 모든 값을 제외합니다. 연결 위에 그려진 첨부도 노드 위에 그려진 첨부와 정확히 같은 규칙, 같은 설정에 따라 제외됩니다. aggrega.graph.showSensitiveValues는 자신이 작성한 내용을 다시 읽어야 하는 작성자를 위해 제외를 끕니다. 이 설정이 켜져 있는 동안에만 그래프 요청이 언어 서버에 그 값들을 요청하며, 설정 페이지에 그로 인해 무엇이 표시되는지 나와 있습니다.

노드는 Release의 웨이브가 기동되는 순서로 배치되므로, syncWave:를 선언하는 boundary는 그것을 기다리는 boundary보다 앞에 나타납니다. 노드 위에 포인터를 올리면 그 컴포넌트와 확인된 버전, 레이블, 선언된 웨이브, 그리고 카탈로그 엔터티 자체의 메타데이터(라이선스, 저장소, 홈, 키워드, 유지 관리자)가 표시되며, 엔터티가 실제로 선언한 필드만 보여 줍니다.

열려 있는 그래프는 작업 영역에서 작성된 문서가 저장될 때마다 다시 렌더링되므로, 다시 열지 않아도 편집 내용을 따라갑니다. 토폴로지는 디스크에 있는 내용으로 컴파일되므로 키 입력마다가 아니라 저장할 때 다시 그려집니다. 선택한 Release의 잠금 파일이 작성될 때(Aggrega: Pull, Auto pull을 사용한 빌드, 또는 터미널의 aggrega pull로)도 다시 그려지는데, 그래프가 그 잠금 파일에 고정되어 있기 때문입니다. 또한 언어 서버가 다시 응답할 수 있게 되면 다시 그려지므로, 재시작 동안 열어 둔 그래프는 스스로 복구됩니다.

요청하지 않은 다시 그리기는 보기를 사용자가 둔 위치에 그대로 둡니다. 재구성된 토폴로지가 달라지든 아니든 기존의 이동과 확대/축소가 유지되므로, 재구성된 레이아웃이 원래 자리에 둔 노드는 패널의 같은 부분에 남고, 다른 곳에 둔 노드(추가된 컴포넌트가 주변 컴포넌트를 밀어낼 수 있습니다)는 보기를 함께 끌고 가는 대신 유지된 보기 안에서 이동합니다. 그래프가 다른 탭 뒤에 있는 동안 일어난 다시 그리기도 마찬가지이며, 돌아오면 떠날 때의 모습 그대로입니다.

Aggrega: Show topology graph는 그림을 패널에 다시 맞춥니다. 일부를 확대한 뒤 전체 모양으로 돌아가는 방법입니다. 큰 토폴로지는 잘리지 않고 전체가 맞춰지므로, 큰 토폴로지는 작게 표시됩니다. 어떻게 구성되어 있는지 확인하고, 확대하여 이름을 봅니다. 한 상자에 담긴 두 개 이상의 그룹이 너비보다 높이가 크게 배치되는 경우, 한 열로 쌓지 않고 나란히 그려지므로, 큰 토폴로지는 패널의 너비를 활용하고 첫 맞춤에서 한 열일 때보다 크게 그려집니다.

컴파일러가 거부한 재구성은 기존 그림을 비우지 않고 유지합니다. 토폴로지는 여전히 읽을 가치가 있고 여전히 작업하던 곳이기 때문입니다. 대신 그림을 흐리게 표시하여 더 이상 최신이 아닌 그림이 최신 그림으로 오인되지 않게 합니다. 그 위의 알림에는 컴파일러 자신이 밝힌 이유가 담깁니다. 새 그림이 빌드되는 즉시 그림은 원래 선명도로 돌아옵니다. 레이아웃은 보기에서 계산됩니다. 컴파일러는 토폴로지를 제공할 뿐 좌표는 제공하지 않습니다.