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

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(도구 불가)로 잡음. → 고침(ABAP_OPENCODE 9c03e2f): web/opencode.json 에 model: openrouter/z-ai/glm-5.2, disabled_providers: [anthropic, opencode], openrouter whitelist: [z-ai/glm-5.2], Dockerfile opencode-ai@1.18.32 고정. 서버에서 모델 미지정 전송도 GLM 으로 가고 목록은 GLM 하나만 확인.