Swagger Codegen ワークフロー連携

Maven 連携

ワークフローとの連携や任意の codegen ターゲットの生成には、swagger-codegen-maven-plugin を使用できます。

Gradle 連携

ソースコードと API ドキュメントの生成には、Gradle Swagger Generator Plugin を利用できます。

GitHub 連携

自動生成された SDK を GitHub にプッシュするために、プロセスを効率化する git_push.sh を提供しています。例えば、

GitHub で新しいリポジトリを作成します (参考: https://help.github.com/articles/creating-a-new-repository/)
SDK を生成する

1
 java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate \
2
 -i modules/swagger-codegen/src/test/resources/2_0/petstore.json -l perl \
3
 --git-user-id "swaggerapi" \
4
 --git-repo-id "petstore-perl" \
5
 --release-note "Github integration demo" \
6
 -o /var/tmp/perl/petstore

SDK を GitHub にプッシュする

1
cd /var/tmp/perl/petstore
2
/bin/sh ./git_push.sh