refirio.org

Memo

■Dockerでの編集

サーバ上に置いて
https://github.com/teinen/openapi-sample/blob/master/openapi-sample.yaml
読み込ませて表示する。Swagger Editor の右半分はこれらしい
http://petstore.swagger.io/?url=https://raw.githubusercontent.com/swagger-api/swagger-codegen/master...

が、外に出せない情報を扱う場合はオンラインツールは避けたいところ
その場合Dockerでローカルで動かすことができる
（ただし「VSCodeでの起動」で紹介するように、もっと手軽に扱えるツールを導入する方が良さそう）

swaggerapi/swagger-editor - Docker Hub
https://hub.docker.com/r/swaggerapi/swagger-editor/■Dockerでの実行例

docker-compose.yml
version: '3'

services:
  swagger-ui:
    container_name: swagger-ui
    image: swaggerapi/swagger-ui
    ports:
      - '8081:8080'
    volumes:
      - ../../api/swagger/:/usr/share/nginx/html/swagger

  swagger-editor:
    container_name: swagger-editor
    image: swaggerapi/swagger-editor
    ports:
      - '8082:8080'


以下のとおり実行

$ cd /c/Users/refirio/docker/swagger
$ docker-compose build
$ docker-compose up -d
$ docker-compose down


swagger-ui
http://192.168.99.100:8081/
swagger-editor
http://192.168.99.100:8082/
Memo

Advertisement
