Remote
infra/remotes/*.yaml에 정의된 원격 머신을 관리합니다.
참조된 파일은 트리거될 때만 읽습니다.
Guard
bridge-config.yaml에서 remotes.enabled가 true여야 합니다. 그렇지 않으면: 알리고 종료합니다.
인자
| 인자 | 효과 | 기본값 |
|---|---|---|
(없음) | 모든 원격의 대시보드 | — |
{hostname} | 하나의 원격 상세 보기 | — |
health {hostname} | SSH 상태 확인 | — |
logs {hostname} {service} | 최근 로그 표시 | — |
restart {hostname} {service} | 서비스 재시작 | — |
sync {hostname} | 설정 파일 동기화 | — |
wake {hostname} | 웨이크온랜(WoL) | — |
connect {hostname} | SSH / RDP 세션 열기 | — |
shutdown {hostname} | 전원 종료 ([y] 필요) | — |
reboot {hostname} | 머신 재시작 ([y] 필요) | — |
결정 트리
사용자가 원하는 것...
├── 원격 개요 / 대시보드 → references/workflow.md (§ 대시보드) 참조
├── 한 머신의 상세 보기 → references/workflow.md (§ 대시보드, 단일 호스트) 참조
├── 머신 깨우기 / 전원 켜기 → references/fleet.md (§ 3단계 WoL) 참조
├── SSH / RDP 연결 → references/fleet.md (§ 4단계 연결) 참조
├── 재부팅 또는 종료 → references/fleet.md (§ 5단계) 참조
├── 연결 가능 여부 / 온라인 확인? → references/fleet.md (§ 2단계) 참조
├── 변경 후 인벤토리 업데이트 → references/fleet.md (§ 6단계) 참조
├── 머신 상태 확인 → references/workflow.md (§ 상태 확인) 참조
├── 서비스 로그 보기 → references/workflow.md (§ 로그) 참조
├── 서비스 재시작 → references/workflow.md (§ 재시작) 참조
├── 원격에 설정 동기화 → references/workflow.md (§ 동기화) 참조
├── 원격에 서비스 배포 → references/workflow.md (§ 배포) 참조
├── "내 PC" 식별 / 의도만 → references/fleet.md (§ 1단계 + 학습된 라우팅) 참조
└── 원격에 대한 질문 → CLAUDE.md § 원격에서 답변
참조 맵
| 파일 | 소유 |
|---|---|
references/fleet.md | 인벤토리, WoL, 연결, 종료, 연결 가능성, "내 PC" 라우팅 |
references/workflow.md | 서비스 대시보드, 상태, 로그, 재시작, 동기화, 배포 |
하드 규칙 (협상 불가)
- Tailscale 우선, LAN은 대체 수단 — LAN은 VPN 또는 외부 네트워크에서 실패함
- 파괴적 작업(종료, 재부팅, 포맷)은 작업별
[y]확인 없이 수행 금지 - 절대
infra/remotes/*.yaml에 자격 증명을 저장하지 않음 — KeyVault / 1Password URI만 허용 wake_on_lan.enabled: false준수 — 옵트아웃한 머신을 강제로 깨우지 않음- 모든 작업 전에
infra/remotes/{target}.yaml읽음 — 추측 금지