A2A Local Access Guide
이 페이지는 로컬 브라우저에서 A2A Wiki를 여는 방법과, 사이트가 열리지 않을 때 확인할 순서를 정리한다.
전역 저장소 위치, 다른 Codex 창에서의 갱신 방식, 동시 작업 충돌 회피는 A2A Global Wiki Operations를 기준으로 본다.
현재 세션에서 열 URL
현재 세션에서는 fallback 정적 서버가 아래 주소로 검증되어 있다.
http://127.0.0.1:8767/docs/a2a/
직접 열 주요 페이지:
http://127.0.0.1:8767/docs/a2a/book-roadmap.html
http://127.0.0.1:8767/docs/a2a/visual-map.html
http://127.0.0.1:8767/docs/a2a/scenario-walkthroughs.html
http://127.0.0.1:8767/docs/a2a/status-gap-audit.html
왜 8765가 아닐 수 있는가
llmwiki serve의 기본 포트는 보통 8765다. 하지만 현재 작업 중에는 8765가 점유되어 있거나 접속이 불안정해서, site/ 디렉터리를 Python 정적 서버로 8767에 띄웠다.
즉 지금은 아래처럼 이해하면 된다.
| 포트 | 의미 |
|---|---|
8765 |
기본 llmwiki serve 후보 |
8767 |
현재 검증된 fallback 정적 서버 |
서버가 안 열릴 때 확인 순서
- 먼저 현재 fallback URL을 연다.
http://127.0.0.1:8767/docs/a2a/
- 안 열리면 정적 site 파일이 있는지 확인한다.
test -f /home/silogood/.local/share/llm-wiki-pratiyush/site/docs/a2a/index.html
- site를 다시 빌드한다.
/home/silogood/.local/bin/llmwiki build
- fallback 서버를 다시 띄운다.
cd /home/silogood/.local/share/llm-wiki-pratiyush/site
python3 -m http.server 8767 --bind 0.0.0.0
- 응답을 확인한다.
curl -I http://127.0.0.1:8767/docs/a2a/index.html
기대 결과:
HTTP/1.0 200 OK
Content-type: text/html
현재 검증된 상태
마지막 확인 기준:
http://127.0.0.1:8767/docs/a2a/index.html응답200 OKhttp://127.0.0.1:8767/docs/a2a/visual-map.html응답200 OKhttp://127.0.0.1:8767/docs/a2a/visual-map.svg응답200 OKllmwiki lint결과0 errors, 0 warnings