멀티 AZ 가이드와 역할을 나누고, 여기서는 조각 규약·버전 핀·Doctor·웹훅 요약·토큰 순환에 집중합니다. 아티팩트는 rsync 매트릭스, 목록은 블로그 홈입니다.
- 조각 표류: 노드마다 다른 우선순위면 카나리가 거짓 음성.
- 버전 스큐: Doctor 정상과 실제 트래픽 불일치.
- 알림 폭주: 재시도가 그대로 슬랙에 쌓임.
| 패턴 | 채택 시점 | 리스크 |
|---|---|---|
| 단일 거대 파일 | 데모·단일 테넌트. | 충돌·전면 롤백. |
| 조각+병합 | 팀·리전 오버라이드 증가. | CI에 순서표 고정. |
| 신호 분리 | 감사 로그가 무거울 때. | 중복 알림. |
디렉터리 규약
base.d 공통, tenants/슬러그/fragments 델타, merge.d 합성본. 덮어쓰기 규칙 한 장만 허용. 임시 파일 후 rename으로 원자 쓰기. 경로는 도움말에 표로 고정.
버전 고정
openclaw.version에 OCI 다이제스트·brew 핀. 파이프라인이 노드 해시 일치 검증. 롤아웃은 한 대씩 프로브 통과 후 다음. 불일치 시 병합 스크립트는 즉시 실패. 야간 doctor --json을 대시보드에 적재.
헬스 프로브 통합
LB는 단일 경로만 호출. JSON에 디스크·launchd·웹훅 핑·Doctor 요약을 묶고 degraded로 부분 장애 표시. 게이트웨이는 알리미로 이벤트만 넘깁니다.
DOC="$(openclaw doctor --json | head -c 2000)"
curl -fsS --max-time 4 "$UPSTREAM_WEBHOOK_PING" >/dev/null
printf '{"doctor":%s,"webhook":true}\n' "$DOC"
알리미는 오 분 창 dedupe 후 슬랙·메일 한 장. 치명일 때만 스택 첨부.
토큰 순환
공개 웹훅은 구십 일보다 짧게. 섀도를 카나리에만 주입해 이틀 안정 확인 후 전 노드 짧은 수명 파일을 rename. 티켓·실행자·UTC 기록.
실행 체크리스트
- 동일 트리 스캐폴딩 후 빈 조각 dry-run.
- CI에서 중복·금지 키·순서 위반 거부.
- Doctor·웹훅·디스크 한 엔드포인트로 LB 전환.
- dedupe·스풀 카운터로 알리미 스모크.
- 노드별 롤링 재기동과 p95 확인.
- 섀도 승격 후 구 시크릿 폐기 서명.
FAQ
Doctor 페이로드? 프로브엔 해시·심각도만, 본문은 객체 스토어.
요약 장애? 스풀 카운터 임계 시 원시 이벤트 승격.
테넌트 증가? 병합 시간 SLO 초과 시 샤드 분할.
트러블슈팅 시에는 먼저 병합 산출물 해시를 노드 간 비교하고, 통합 프로브 JSON을 한 줄씩 대조한 뒤 웹훅 요약 채널 지연을 확인하세요. 이렇게 하면 원인이 디렉터리인지 버전인지 알림인지 빠르게 갈립니다.