don't stop believing

점점 Visual Studio Code가 좋아집니다. Swagger의 markup 파일인 yaml 을 Visual Studio Code에서 바로 볼수 있는 확장 프로그램이 있습니다.Swagger Viewer 전에는 npm을 설치하고 봐야했는데 훨씬 편해졌습니다. Code을 열고 확장에서 Swagger Viewer를 검색합니다. 현제는 1.7.0 버전이네요.설치를 하고 다시로드를 해줍니다.이제 yaml 파일을 열고 명령 팔레트를 실행합니다.명령 팔레트: 보기 > 명령 팔레트 (Command + Sift + P) 명령 팔레트에서 Preview Swagger를 입력합니다.명령을 실행하면 좌측에 Preview 창이 생성되며 Swagger가 보입니다.역시 확장 프로그램 (Plugin)이 있는 툴이 좋네요.

Ubuntu 서버에 Swagger를 설치하고 swagger-ui를 연동한 상태입니다. Swagger의 구성은 기본 구성에서 시작하겠습니다. [Ubuntu에 Swagger 설치] 이제 API 서버 개발 진행에 따라 Swagger를 계속 업데이트 해줘야 하는데 서버에 있는 Swagger의 editor 실행이 안되 yaml 수정이 불편합니다. 혹시 내가 모르는 swagger edit 실행방법이 있는지는 모르겠으나 우선 생각한 방법은 아래와 같습니다. 사내 테스트 서버에 API 서버를 구성한다.Gitlab과 Jenkins로 사내 테스트 서버에 자동 배포을 구성한다.사내 테스트 서버에 Swagger를 설치하고 실행한다.Local PC에 Swagger edit를 설치하고 yaml 파일을 작성한다.yaml 파일을 A..

swagger 서버에 원격으로 접속해 API 문서를 작성하려면 swagger editor를 설치해야 합니다.Mac에 swagger editor를 설치하고 원격으로 연결해봅시다. 먼저 Mac에 node를 설치합니다. node는 brew로 설치합니다.[Mac에 Homebrew 설치] $ brew install node 이제 node와 npm이 설치되어 있는지 버전을 확인해 봅시다. $ node -v v9.3.0 $ npm -v 5.6.0 이제 적당한 곳에 swagger-editor를 받습니다. 저는 Download 폴더에 받겠습니다. $ cd ~/Download $ git clone https://github.com/swagger-api/swagger-editor.git $ cd swagger-editor ..

API Document 관리를 위해 Swagger를 사용해 봅시다.Swagger는 node.js의 모듈로 설치됩니다.[https://swagger.io/] 먼저 Ubuntu에 node.js를 설치하기 전에 apt-get을 업데이트 해줍니다. $ sudo apt-get update && sudo apt-get -y upgrade 이제 node.js를 설치합니다. $ curl -sL https://deb.nodesource.com/setup_9.x | sudo -E bash - $ sudo apt-get install -y nodejs 최신 버전을 확인하려면 아래 url에서 확인할 수 있습니다.[https://github.com/nodesource/distributions]npm이 잘 설치되었는지 버전을 확..