Swagger를 설치하기에 앞서 node.js 및 npm을 설치한다. (이미 설치되어 있으면 생략)
npm 이란 무엇인가?
npm이란 Node Package Modules의 약자다. Node.js에서 사용가능한 모듈들을 패키지화시켜 모아놓은 것이다. 이를 통해 웹에서 필요로 하는 특정기능들을 일일이 개발하지 않아도 이미 누군가가 만들어서 올려놓은 모듈을 다운로드 받는 것으로 대신할 수 있어 개발을 쉽게 할 수 있는 것이다. 물론 Github에 올라가있는 모듈을 다운로드받아 빌드하고 사용해도 되지만 어떤 모듈들이 있는지 알 수도 없고 버전관리 등에도 불편함이 생길 수 밖에 없다. 그래서 Isaac Z. Schlueter라는 개발자가 만든 npm은 Node.js 개발자들에게 이제 필수로 자리잡은 상황이다.
npm 설치하기
과거에는 Node.js를 설치하고 따로 설치했었다. 특히 윈도우에서는 설치하기가 불편했었는데 현재는 운영체제에 맞는 Node.js Installer 를 다운로드하고 실행하기만 하면 자동으로 설치가 된다. 물론 개별설치도 가능하다.
Node.js 다운로드 사이트 : http://nodejs.org/download/
1. Swagger module 설치하기
$ npm install -g swagger
2. Swagger 프로젝트 생성하기
$ swagger project create hello-world
https://github.com/swagger-api/swagger-node/blob/master/docs/quick-start.md 참고
3. Swagger Editor 실행하기
$ swagger project edit