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 — 새로 컨테이너를 띄우는 경우 (권장)
- 배포 설정에 이 머신의 값을 넣습니다: 로그인 아이디, 시크릿 키, 그리고 CSN.
- 컨테이너를 기동합니다.
- 기동 과정에서 CSN 매핑이 자동으로 만들어지고, 그 값으로 3종 스케줄이 등록됩니다.
- 아래 정합성 확인으로 점검합니다.
방법 B — 기존 환경을 복제하고 CSN만 바꾸는 경우
csn-projects.json의 CSN 값을 새 CSN 하나로 바꿉니다.- 에이전트 설정의 시크릿 키를 새 머신 값으로 바꾸고, 서버 번호는 비워 새로 발급받게 합니다.
- 컨테이너를 재기동합니다. 기동 시
csn-projects.json을 기준으로 스케줄이 다시 맞춰집니다. - 정합성 확인으로 점검합니다.
✅ 정합성 확인
새 머신에서 아래를 실행하면 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 옵션으로 실행 |