OpenAPIの分割したスキーマファイルを結合する

1. はじめに

• OpenAPI用スキーマファイルが肥大化したため、$refで外部ファイル化したものを1ファイルに結合したい
• node.jsをインストールしてnpm経由でswagger-cliを取得して実行したい

2. node.jsのインストール

• npmを使用してインストールするためnode.jsをインストールする

2.1. node.jsのダウンロードサイトを開く

2.2. インストーラーをダウンロードする

2.3. インストーラーを実行する

2.4. Nextボタンをクリックする

2.5. チェックボックスをONにしてNextボタンをクリックする

2.6. Nextボタンをクリックする

2.7. Nextボタンをクリックする

2.8. Nextボタンをクリックする

2.9. Installボタンをクリックする

2.10. Finishボタンをクリックする

2.11. パソコンを再起動する

3. swagger-cliのインストール

3.1. コマンドプロンプトを起動する

3.2. node.jsのインストールを確認する

node --version

3.3. swagger-cliをインストールする

npm install -g @apidevtools/swagger-cli

4. スキーマファイルの統合

swagger-cli bundle -o ./.gen_api_schema/openapi.yaml -t yaml ./openapi.yaml

• -o : 結合したスキーマファイルの出力先（結合後）
• -t: ファイル形式（YAML形式を選択）
• : 分割したスキーマファイル（結合前）

5. 参考文献