docs(troubleshooting): 우리 서버 opencode DNS 충돌 사고 기록

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

docs/troubleshootings/2026-09-23-docker-dns-collision.md

@@ -0,0 +1,24 @@
+# 2026-09-23 우리 서버 ABAP_OPENCODE 세션 깜빡임 · Session not found
+
+## 증상
+- 20.200.170.37 ABAP_OPENCODE 웹에서 채팅하면 "OpenCode 서버 오류 UnknownError" / "Session not found". 답은 나오기도 함.
+- 왼쪽 세션 목록이 보였다 사라졌다 함.
+
+## 원인
+CodeAssist 에 SAP MCP 를 붙이려고 CodeAssist compose 의 `opencode` 서비스를 abap-opencode 네트워크(`abap-opencode_default`)에도 연결함.
+compose 는 **서비스 이름을 그 네트워크의 DNS 별칭으로 등록**하므로, 그 네트워크에서 `opencode` 이름이 컨테이너 두 개(ABAP_OPENCODE 것 + CodeAssist 것)로 풀림.
+→ ABAP_OPENCODE 백엔드의 `http://opencode:4096` 요청이 번갈아 두 서버로 감. 세션 목록 42개/10개가 번갈아 나오고, 한쪽에서 만든 세션을 다른 쪽이 "not found".
+Claude 모델 선택 시 UnknownError 도 같은 원인(CodeAssist OpenCode 엔 anthropic 이 없음).
+
+## 조치
+1. 즉시 `docker network disconnect abap-opencode_default codeassist-opencode-1` → 목록 43개로 고정.
+2. CodeAssist 서비스명을 `ca-opencode` 로 변경(`deploy/docker/docker-compose.yml`, `docker-compose.mcp.yml`) 후 재배포. MCP `connected`, ABAP_OPENCODE 목록 안정 확인.
+3. 사고 시간(약 20분) 동안 만든 ABAP_OPENCODE 세션은 CodeAssist 쪽에 생겨 복구 안 됨 — 새로 생성해서 써야 함.
+
+## 앞으로
+- 다른 compose 의 네트워크에 붙이는 서비스는 **이름이 그쪽 서비스(opencode·be·fe·mcp·db)와 겹치면 안 됨.** 접두어(`ca-`)를 붙임.
+- 네트워크 합류 후엔 붙는 쪽에서 `list_sessions` 를 여러 번 불러 크기가 일정한지 확인.
+
+## 같이 발견한 것 (별개)
+- ABAP_OPENCODE `Dockerfile.opencode` 가 `npm install -g opencode-ai` 버전 고정 없음 → 오늘 재빌드로 1.18.32 가 됨.
+- `web/opencode.json` 에 기본 모델이 없어, 새 버전은 기본을 anthropic claude-sonnet-4-6(키 무효) / openrouter gemini-image(도구 불가)로 잡음. 화면에서 모델을 GLM 으로 골라야 함. 고치려면 opencode.json 에 `"model"` 과 `disabled_providers`, Dockerfile 에 버전 고정.