Core와 Agent 연결

역할

Core는 중앙 작업 관리 프로세스이고 Rust Agent는 테스트 장비의 독립 실행기입니다. Core는 작업·Agent 요구 조건을 비교하며 Agent는 배정된 단계만 실행합니다. Studio만 켜서 원격 테스트가 준비되지는 않습니다.

사용자가 확인할 것

1. 관리자가 제공한 Core 주소와 Studio 인증 설정을 사용합니다.
2. Agents 화면에서 연결 상태와 Agent의 idle/busy·OS·runtime capability를 확인합니다.
3. 테스트가 요구하는 OS·Node·Git·브라우저 조건과 Agent 정보를 비교합니다.
4. 조건이 맞지 않으면 Queue 대기 이유를 확인하고 관리자에게 장비·도구를 요청합니다.

관리자용 개발 실행 예시

현재 소스 기준 Node24와 package.json의 pnpm 버전을 사용합니다. 이는 설치본 서비스 등록 안내가 아닙니다. 준비된 개발 저장소에서 실행하며 Secret 값은 이 문서에 기록하지 않습니다.

pnpm core:start

Core는 기본127.0.0.1:4340을 사용합니다. 실행 전 관리자는 CORE_AGENT_TOKEN과 CORE_STUDIO_TOKEN을 안전한 환경 설정에 제공해야 합니다. Agent 쪽 TASTEDEV_AGENT_TOKEN은 Core의 Agent 인증 값과 일치해야 합니다. 원격 주소·Origin·LAN 허용·TLS는 운영자가 승인한 네트워크 계약에 맞춰 설정합니다. 공개 포트와 인증 없는 접근을 기본으로 허용하지 마세요.

Agent 설정 예시의 tokenEnv는 값이 아니라 환경 변수 이름입니다. workspaceRoot는 Agent 전용 폴더로 바꾸세요.

{
  "endpoint": "ws://127.0.0.1:4340/agent",
  "name": "QA-local",
  "workspaceRoot": "D:/TASTESTUDIO/agent-workspaces",
  "tokenEnv": "TASTEDEV_AGENT_TOKEN"
}

tastedev-agent --config agent-config.json

빌드 바이너리 이름은 tastedev-agent이며 배포 패키지가 tastestudio-agent로 제공하면 해당 실제 실행 파일 이름을 사용하세요. Linux에서는 workspaceRoot를 해당 장비의 절대 경로로 바꿉니다. Agent는 heartbeat와 실행 결과를 Core에 전달합니다.

종료와 재시작 주의

현재 Core Run·Queue·등록 Protocol·여러 실행 이력은 메모리 수명에 묶입니다. Schedule 정의는 파일에 저장되지만 Core 재시작 후 프로젝트의 저장된 Protocol을 다시 동기화해야 합니다. Windows 서비스·Linux daemon 자동 설치와 전체 복구는 계획 기능입니다.