OpenClaw 게이트웨이 블루·그린 롤아웃—두 번째 포트, 헬스 게이트 컷오버, 임대 클라우드 Mac의 launchd(2026-05-08)
2026년 OpenClaw macOS 게이트웨이 이야기는 갈라집니다. 데스크톱 앱이 수명 주기를 조율하고, 장기 데몬은 외부 CLI 설치와 함께 launchd 아래에 둡니다. 이 분리는 블루·그린에 좋습니다. 프로덕션을 127.0.0.1:18764에 두고 후보를 127.0.0.1:18765에서 기동한 뒤 합성 프로브로 준비를 증명하고 루프백 소비자나 상류 프록시만 바꾸면 되며 두 번째 물리 MacLogin 미니를 고안할 필요가 없습니다. 이 2026년 5월 런북은 홍콩·일본·한국·싱가포르·미국 테넌트가 업그레이드 중에도 Webhook 워커·Canvas 훅·CLI 자동화를 안정적으로 유지하는 매트릭스를 정리합니다.
교차 읽기 앱+CLI 인수인계, 헬스 curl 모니터링, 그레이스풀 셧다운·드레인, 허브 OpenClaw 주제 색인. 사이트: 도움말, 가격, VNC.
바쁜 게이트웨이에서 블루·그린이 제자리 재시작보다 나은 이유
작은 패치에는 제자리 launchctl kickstart -k로 충분하지만 Node 메이저 상향·모델 허용 목록 변경·Webhook URL 이전처럼 위험한 업그레이드는 나란히 프로세스가 이득입니다. 블루·그린은 TLS 컨텍스트 컴파일, 모델 캐시 프라임, 워커 큐 검증까지 포함한 따뜻한 전체를 고객 트래픽이 닿기 전에 준비합니다.
포트 계획과 launchd 레이블 매트릭스
| 색 | 리슨 주소 | launchd 레이블(예) | 목적 |
|---|---|---|---|
| 블루(안정) | 127.0.0.1:18764 | ai.openclaw.gateway.blue | 프로덕션 트래픽 |
| 그린(후보) | 127.0.0.1:18765 | ai.openclaw.gateway.green | 스테이징 검증 |
| 관측 | 둘 다 | N/A | 헬스는 루프백에 묶고 공개는 localhost 경화에 따라 제어된 프록시만 |
트래픽을 넘기기 전 헬스 프로브 계약
타협 불가 신호를 정의하세요: /healthz(또는 프로젝트별)에서 HTTP 200, CLI와 일치하는 JSON 버전 필드, 예산 지연 내 모델 ping, 해당 시 Webhook 자체 테스트 에코. 스크랩 간격을 두 번 이상 밟아 느린 누수를 잡습니다.
보조 LaunchAgent plist 패턴(사용자별)
동작 중인 plist를 복제하고 Label, StandardOutPath, StandardErrorPath, 포트와 설정 루트를 고정하는 환경 내보내기를 바꿉니다. ThrottleInterval은 크래시 루프가 syslog를 DOS하지 않을 정도로. 환경 변수 가이드에 맞추면 두 색 모두 올바른 비밀 금고를 물려받습니다.
9단계 컷오버 런북
- 스냅샷: 현재 plist, 바이너리 해시, Node 버전.
- 배포: 후보 비트를 버전 디렉터리에. 안정 경로는 덮어쓰지 않음.
- 설치: 그린 plist를 테넌트 사용자로
launchctl bootstrap. - 검증: 로컬에서 curl, mTLS 켜져 있으면 함께.
- 리플레이: 합성 Webhook 페이로드를 그린에만.
- 드레인: 2026년 4월 드레인 글 순서로 블루 비우기.
- 승격: localhost 포워더 또는 상류 프록시 upstream 블록 재지정.
- 관찰: 승리 선언 전 30~60분 에러 버짓.
- 강등: 블루 바이너리 내리거나 즉시 롤백용으로 웜 유지.
5분 안에 끝내는 롤백 훈련
승격을 역으로 연습하세요: 상류 포인터를 블루로 되돌리고 큐를 드레인한 뒤에만 launchctl bootout으로 그린을 내리고 Webhook 제공자가 5xx 재시도 폭주를 멈출 때까지 로그를 따라갑니다. DNS 대 루프백 대 리버스 프록시 책임을 문서화하지 않으면 사고가 SLA를 넘깁니다.
관측 가능성: 색 사이 JSONL 스트림 차이
두 데몬이 JSON 라인을 내보내면 로거 설정에서 color=blue|green을 태그합니다. 홍콩·일본·한국·싱가포르·미국 시간대를 가로지르는 SIEM도 어떤 프로세스 소음인지 추측하지 않고 오류율을 겹칩니다.
FAQ
이게 Kubernetes를 대체하나요? 아니요—단일 호스트 리스에는 더 단순한 패턴이 맞고 K8s 테넌트는 Pod 블루·그린을 쓰세요.
공개 TLS Webhook은? 이 패턴과 TLS 리버스 프록시 가이드를 짝지어 엣지가 건강한 루프백 포트로 상류를 향하게 하세요.
게이트웨이를 더 분리해서 빌리려면? 시끄러운 워크로드를 위해 JP나 US 용량을 추가하려면 가격에서 시작하세요.
OpenClaw 허브, 도움말, 리전이 중요한 이유
OpenClaw 허브에 내부 런 레이블과 포트 표를 계속 올리면 신입 엔지니어도 같은 매트릭스를 물려받습니다. 도쿄 브로커에 가까운 저지연 자동화라면 리스를 리전에 고정해 Webhook RTT를 예측 가능하게 하면 컷오버 리스크도 줄어듭니다.
