RAML ファイルから HTML を作成する (docker 編)

• 概要
• 環境
• イメージ pull
• RAML ファイルの取得
• HTML 出力
• 確認

概要

raml2html をグローバルにインストールしたくなかったので docker 上で動かして .raml ファイルを .html ファイルに変換します

環境

• macOS 10.14.1
• docker 18.06.1-ce, build e68fc7a

イメージ pull

いろいろあるっぽいですが素直に検索で一番上に出てきたやつで

• docker pull mattjtodd/raml2html

RAML ファイルの取得

なんでも OK と言いたいのですが RAML 1.0 以上でなければなりません

• git clone https://github.com/vmware/nsxraml.git

HTML 出力

• docker run --rm -v $PWD:/raml mattjtodd/raml2html -i /raml/nsxvapi.raml -o /raml/result.html

_sourceToRamlObj: only RAML 1.0 is supported! になる場合は先頭のバージョンを #%RAML 1.0 に書き換えてください

確認

• open result.html