[Swagger] swagger 설치 및 배포

🛑 0. 사전 준비

1. WSL2 (docker)

1. powershell을 관리자 권한으로 실행

2. wsl 시스템 설정

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

3. 리눅스 커널 최신 업데이트

https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

4. 가상화 기능 설정

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

 

5. WSL2 설정

wsl --set-default-version 2

 

6. linux 설치(microsoft store)

2. docker

https://docs.docker.com/desktop/windows/install/

Install Docker Desktop on Windows

1. 다음 버튼 클릭 시 설치 가능 ※ 단, WSL2를 설치를 해야 docker 사용 가능

 

🟢 1. Swagger 설치 및 실행(api 명세)

swagger를 사용하기 위해서는 swagger-editor를 실행시켜야 합니다.

출처: https://github.com/swagger-api/swagger-editor

GitHub - swagger-api/swagger-editor: Swagger Editor

• 설치 명령어

docker pull swaggerapi/swagger-editor
docker run -d -p 80:8080 swaggerapi/swagger-editor

• 설치 및 실행 확인
  • PORT 80 확인
  • 초록불(running)이 들어와있을 경우 서버 실행완료

• localhost로 접속시 다음과 같은 화면이 나오면 성공

http://localhost/

🟢 2. API 명세서 배포

1.Generate Server - python-flask -> 압축파일 다운로드

2.압축해제 및 폴더 접속

3.requirements.txt 수정

connexion == 1.1.15
python_dateutil == 2.6.0
setuptools >= 21.0.0
werkzeug==0.16.1
markupsafe==2.0.1

4. docker를 활용한 배포

docker build -t swagger_server .
docker run -p 8080:8080 swagger_server

5. http://localhost:8080/v2/ui 접속