id	title
integrations	Workflow Integrations

Workflow Integration (Gradle, Maven, GitHub, CI/CD)

Gradle Integration

See the openapi-generator-gradle-plugin README for details related to configuring and using the Gradle Plugin.

Supported tasks include:

Listing generators
Validation of Open API 2.0 and 3.0 Specs
Generating "Meta" generators
Generating all generators supported by OpenAPI Generator

Maven Integration

See the openapi-generator-maven-plugin README for details related to configuring and using the Maven Plugin.

GitHub Integration

To push the auto-generated SDK to GitHub, we provide git_push.sh to streamline the process. For example:

Create a new repository in GitHub (Ref: https://help.github.com/articles/creating-a-new-repository/)
Generate the SDK

 java -jar openapi-generator-cli.jar generate \
 -i modules/openapi-generator/src/test/resources/3_0/petstore.json -g perl \
 --git-user-id "wing328" \
 --git-repo-id "petstore-perl" \
 --release-note "GitHub integration demo" \
 -o /var/tmp/perl/petstore

Push the SDK to GitHub

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

To use openapi-generator as part of Github workflows, the blog post "Autogenerating Clients with FastAPI and Github Actions" by Andrew Israel is a good starting point.

CI/CD

Some generators also generate CI/CD configuration files (.travis.yml) so that the output will be ready to be tested by the CI (e.g. Travis)

If you're looking for the configuration files of a particular CI that is not yet supported, please open an issue to let us know.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!