2026 클라우드 Mac의 OpenClaw 프로덕션 컷오버: 헬스 체크, 스모크 테스트, 롤백 플레이북
임대 Apple Silicon Mac에 OpenClaw Gateway 빌드를 승격하는 플랫폼 팀은 금요일 밤의 «launchd만 재시작» 변경으로 월요일 아침 원격 운영자를 고립시키곤 합니다. 이 플레이북의 결론: 컷오버를 미니 런칭처럼 다루고 구성을 동결하며, 벽시계 기준 최소 15분간 계층형 헬스 프로브를 실행하고 plist diff를 확보하며 프로덕션 트래픽에 손대기 전 롤백 바이너리를 스테이징하세요. 프로브 표, 명시적 수치 목표(포트, 재시작 횟수, 로그 줄 예산)가 있는 여덟 단계, 롤백 트리거, MacLogin 5개 리전에 맞춘 FAQ를 제공합니다.
실행 전 OpenClaw 배포 가이드, 게이트웨이 데몬 문제 해결, install.sh 대 npm global, SSH 터널 설정을 읽으세요. 연결은 도움말, 스탠바이 노드 추가는 요금을 참고하세요.
OpenClaw 리스에서 «컷오버»의 의미
컷오버는 새 게이트웨이 바이너리, Node 런타임 또는 환경 파일이 자동화 훅에 대해 권위를 갖는 구간입니다. Kubernetes 뒤의 상태 비저장 마이크로서비스와 달리 MacLogin 리스는 노트북이 SSH LocalForward로 도달하는 루프백 리스너를 자주 노출하므로 실패 모드에는 조용한 부분 업그레이드가 포함됩니다—launchd는 /usr/local/bin/node를 가리키는데 대화형 셸은 Homebrew Cellar 경로를 계속 해석하는 식입니다. 티켓에 영향 범위를 적으세요: Slack, Telegram 등 채널, 모델, 게이트웨이에 의존하는 cron 일정.
컷오버 전 인벤토리 게이트(건너뛰지 말 것)
- Node 메이저 잠금: 로그인 셸과 plist
EnvironmentVariables모두에서node -v기록. 컷오버 전 일치해야 함. - 포트 맵:
sudo lsof -nP -iTCP -sTCP:LISTEN출력을 캡처하고 게이트웨이 포트(보통 실험 대역 18000–19999—plist 확인)를 강조. - 아티팩트 해시: 롤백을 바이트 검증하려면 이전 게이트웨이 바이너리 또는 npm 패키지 tarball의
shasum -a 256저장. - 운영자 명단: HK와 미국 업무 시간이 겹치는 사람 두 명 지정.
헬스 프로브 매트릭스(계층 신호)
| 층 | 점검 | 통과 기준 | 전형적 실패 |
|---|---|---|---|
| 프로세스 | launchctl print system/your.plist | 상태=실행 중, 마지막 종료=0 | 환경 파일 누락으로 크래시 루프 |
| TCP | nc -vz 127.0.0.1 PORT | 2초 이내 성공 | 오래된 프로세스가 포트 탈취 |
| 애플리케이션 | CLI 상태 또는 HTTP 헬스 | HTTP 200 또는 문서화된 OK JSON | 부분 마이그레이션으로 DB 잠금 잔존 |
| 통합 | 합성 웹훅 전송 또는 드라이런 도구 호출 | E2E 지연 P95 5초 미만 | 아웃바운드 API DNS 드리프트 |
launchctl kickstart -k 사이클을 한 번 포함하세요.8단계 컷오버 런북
- 동결: plist 저장소 병합 동결; 릴리스 태그
oc-cutover-YYYYMMDD. - 스냅샷: 환경 변수 가이드에 나열된 설정 디렉터리를 tar.
- 후보 설치: 승인된 경로(스크립트 또는 npm)로 스테이징 리스에 먼저 적용.
- 병렬 실행(선택): 카나리아를 127.0.0.2 또는 대체 포트에 바인딩해 섀도 트래픽—터널 설정에 문서화.
- plist 전환: ProgramArguments 또는 WorkingDirectory 업데이트;
plutil -lint실행. - 리로드: launchd 킥; 처음 200줄 로그에서 스택 트레이스 감시.
- 표 검증: 헬스 표의 모든 행 실행; 스크린샷 또는 JSON 응답을 티켓에 첨부.
- 소통: 공유 채널에 «컷오버 그린», 타임스탬프, 버전, 롤백 담당자 게시.
롤백 트리거(자동 고/노고)
| 신호 | 임계값 | 조치 |
|---|---|---|
| 종료 루프 | 5분 안 3회 크래시 | 이전 바이너리+plist 복원; 인시던트 개시 |
| 오류율 | 합성 실패 > 5% | 롤백하고 노트북 터널에 트래픽 유지 |
| 지연 | P95 > 기준의 5배 | 롤백; DNS 또는 모델 공급자 조사 |
| 디스크 | 데이터 볼륨 여유 < 10% | 컷오버 중단; 재시도 전 로그 정리 |
FAQ
유지보수 모드가 필요한가요? 사용자 대면 채널에서는 예—티켓 ID를 참조하는 배너 메시지를 올리세요.
프로브를 자동화할 수 있나요? Cron 또는 launchd cron 패턴이 가능. 게이트웨이와 다른 사용자로 실행.
TLS 종료는? 리버스 프록시에서 종료하면 표에 인증서 만료 점검 포함—웹훅 TLS 가이드 참고.
안전한 컷오버를 가속하는 MacLogin의 Mac mini M4
Apple Silicon Mac mini 하드웨어는 게이트웨이 워크로드에 예측 가능한 단일 노드 성능을 제공해 롤백 훈련 중 npm 설치나 네이티브 모듈 재빌드 대기 시간을 줄입니다. 홍콩, 일본, 한국, 싱가포르, 미국에 걸친 MacLogin의 존재는 API 공급자 근처에서 컷오버를 리허설하게 해 왕복 지연 분산이 불안정한 헬스 체크를 가리는 일을 줄입니다. 임대는 «다크» 스페어 노드를 저렴하게 유지해 plist를 복제하고 kickstart 순서를 연습할 수 있게 하고, SSH와 선택적 VNC로 같은 유지보수 창에 GUI 인접 실패도 볼 수 있습니다.
트래픽이 늘면 요금에서 용량을 추가하고 해시, 프로브, 롤백 담당자를 동일 플레이북으로 각 새 리스 ID에 승격하세요.
