AI 에이전트 3종 CSN 일괄 등록 (새 머신 복제)

GIIP 에이전트 환경을 새 머신에 복제하고, giip-agent·giip-cqe·gissue-scheduler 세 가지 스케줄을 하나의 CSN으로 정합성 있게 등록하는 방법을 안내합니다.

📋 개요

한 대의 머신(컨테이너)은 하나의 CSN에 속하며, 그 안에서 아래 3종이 함께 돌아갑니다.

• giip-agent — 이 머신을 GIIP에 살아있는 서버로 등록하고 매분 상태를 보고합니다.
• giip-cqe — 이 머신에 배분된 명령(CQE)을 주기적으로 가져와 실행합니다.
• gissue-scheduler — 이 CSN의 이슈를 주기적으로 처리합니다.

🔑 핵심 원칙: CSN은 한 곳에만

세 스케줄이 서로 다른 CSN으로 어긋나는 것을 막기 위해, 이 머신의 CSN은 한 곳에만 적습니다.

단일 기준(SSOT): csn-projects.json의 CSN 값

나머지(스케줄러가 처리할 CSN 등)는 이 값을 읽어 자동으로 맞춰집니다. 예전에는 최초 기동 때 넣은 값이 그대로 굳어, 나중에 매핑만 바꾸면 스케줄러가 옛 CSN으로 계속 도는 문제가 있었습니다. 이제는 이 파일을 기준으로 매 기동마다 다시 맞춰집니다.

🚀 새 머신에 등록하기

방법 A — 새로 컨테이너를 띄우는 경우 (권장)

1. 배포 설정에 이 머신의 값을 넣습니다: 로그인 아이디, 시크릿 키, 그리고 CSN.
2. 컨테이너를 기동합니다.
3. 기동 과정에서 CSN 매핑이 자동으로 만들어지고, 그 값으로 3종 스케줄이 등록됩니다.
4. 아래 정합성 확인으로 점검합니다.

방법 B — 기존 환경을 복제하고 CSN만 바꾸는 경우

1. csn-projects.json의 CSN 값을 새 CSN 하나로 바꿉니다.
2. 에이전트 설정의 시크릿 키를 새 머신 값으로 바꾸고, 서버 번호는 비워 새로 발급받게 합니다.
3. 컨테이너를 재기동합니다. 기동 시 csn-projects.json을 기준으로 스케줄이 다시 맞춰집니다.
4. 정합성 확인으로 점검합니다.

✅ 정합성 확인

새 머신에서 아래를 실행하면 3종이 같은 CSN으로 정합한지 한 번에 확인합니다.

bash scripts/gissue/check-csn-consistency.sh

서버 번호가 아직 발급되지 않았다면 자동 등록까지 함께 수행합니다.

bash scripts/gissue/check-csn-consistency.sh --register

모든 항목이 통과(PASS)로 나오면 3종 스케줄이 이 머신의 CSN 하나로 정합성 있게 등록된 것입니다.

🛠️ 문제 해결

증상	원인	조치
스케줄러가 옛 CSN으로 동작	최초 기동 때 값이 남아 있음	컨테이너 재기동(기준값으로 다시 맞춰짐)
CSN 값이 서로 다르다는 경고	설정 값이 예전 것	설정의 CSN을 새 값으로 바꾸고 재기동
CSN이 없거나 여러 개	매핑에 CSN이 0개 또는 2개 이상	CSN을 하나로 정리
서버 번호 미등록	새 CSN으로 아직 자기등록 안 됨	위 --register 옵션으로 실행

📎 관련 가이드

• Linux/WSL 에이전트 설치 가이드
• CQE 스크립트 관리