Guida Control

Guida Control은 Guida Complete와 Guida Node를 브라우저에서 운영하기 위한 별도의 독점 alpha 애플리케이션입니다. Remote Ops API로 연결하며 노드의 워크스페이스 파일, 큐, 워크플로 원장, 운영 데이터베이스를 직접 읽지 않습니다.

공개 컨테이너 이미지는 함께 제공되는 라이선스에 따라 Guida 평가와 운영에 사용할 수 있습니다. 이미지가 공개되어 있다는 사실이 Guida Control을 오픈 소스 소프트웨어로 만들지는 않습니다.

운영 화면과 데이터 소유권

Overview와 Command Center는 주의 항목, 기능, 진행 중인 작업, 범위가 제한된 운영 작업을 모아 보여 줍니다. Results는 수집 결과, 내보내기, 전달 기록을 관리합니다. Pipelines와 Extractors에서는 계약, 인증 계획, 초안, 차이, preflight, 보호된 실행을 다룹니다. Workspace, Browser, Workbench, Activity, Nodes가 노드별 확인을 보완하며 Advanced는 선택 사항입니다. Remote View는 브라우저 탭을 스트리밍하고 정책이 허용할 때 제어 기능도 제공합니다.

워크스페이스, 추출기, 파이프라인, 큐, 프로세스, 워크플로 실행, 항목, 이벤트, 복구 정보의 소유자는 Guida 노드입니다. Control은 자체 SQLite 데이터베이스에 노드 등록 정보, 연결 설정, Control 활동 이력, 내보내기와 전달 기록만 저장합니다. 이는 Guida 운영 데이터의 복제본이 아닙니다.

읽기 전용으로 시작

모니터링과 계약 조회에는 원격 제어가 필요하지 않습니다. 상태 변경 작업에는 Control의 GUIDA_CONTROL_REMOTE_CONTROL=1과 선택한 노드의 controlEnabled가 모두 필요합니다. 그래도 최종 결정은 Guida가 내리며 기능, 허용 도메인, 정책, 확인, 크기, 시간 제한을 계속 적용합니다.

현재 MVP에서 Remote Ops는 클라이언트를 직접 인증하지 않습니다. NetBird ACL, 방화벽, 역방향 프록시 정책, localhost 터널, mTLS 같은 외부 수단으로 채널을 보호해야 합니다. Remote Ops 포트를 인터넷에 직접 공개하지 마십시오.

Guida Node의 Remote Ops는 일반적으로 9631 포트를 사용하고 Guida Control의 브라우저 UI는 보통 127.0.0.1:9632에서 제공됩니다. 노드를 등록하거나 가져와서 상태와 호환성을 확인하고, 실제 변경 작업이 필요할 때까지 원격 제어를 꺼 두는 것이 좋습니다.

Control은 압축된 스키마 색인을 읽고 필요한 상세 계약만 요청합니다. 파이프라인 편집은 초안, 차이, 저장 또는 삭제, 검증, preflight, 계획, 미리 보기 순서로 진행합니다. 저장만으로 실행이 시작되지 않습니다. 자세한 내용은 추출기와 시맨틱 파이프라인을 참조하십시오.

이 alpha 버전에서는 운영 작업을 감독해야 합니다. 내장 Enterprise ID, 역할 기반 접근 제어, 설치된 플릿의 자동 적격성 판정은 현재 제공 범위가 아닙니다. 출시된 계약으로 확인되기 전까지는 향후 기능으로 간주해야 합니다.