Docker로 스웨거 설치 후 테마 설정하기 (swagger)
Swagger UI와 Swagger Editor를 Docker 로 띄워서 빠르게 사용해보자.
Swagger Hub에서 작업하는건 한글 입력이 잘 되지 않는 경우가 있었고 OAS3를 사용할 겸 설치하는 게 편하다.
설치
설치는 서버 하나만 있으면 충분하다.
Editor
1 | $ docker run -d \ |
UI
UI 에서는 API 문서를 상대경로로 사용하기 위해 볼륨 마운트를 했다.
Docker for Windows에서 c 드라이브를 마운트하기 위해서는 아래처럼 //c/path
로 접근하면 된다.
1 | $ docker run -d \ |
테마 추가
테마는 나이스한 라이브러리를 사용하자.
두 컨테이너 모두 /usr/share/nginx/html/
경로의 index.html
을 열어 head 안에 넣어주면 된다.
docker exec
로 쉘에 접근하는 건 다 하시리라 믿고 다만, 컨테이너에 bash 쉘이 없기에 기본 sh 쉘로 접근하면 된다.
1 | <link |
여담
스웨거에 side menu 가 있는 버전이나 라이브러리가 있으면 좋을텐데, 누가 만들었을 것 같은데 아직 못 찾았다.