Quarkiverse Hub

Edit this Page

Checklist

Here is a checklist with the tasks to be performed on any new Quarkiverse extension repository:

Requesting a new repository

Create an Extension Proposal issue in the Quarkus repository

The core team can then decide if the extension should belong to core or as a Quarkiverse extension. Please indicate the lead maintainers for the extension, and preferably a URL with more information about the technology the extension should enable.

Once the lead maintainers are identified (their GitHub accounts), a pull-request is created in the Quarkiverse DevOps repository with the data provided in a .tf file (because the pull-request needs to be created from a branch in the same repository, existing Quarkiverse members can do this without waiting for any Quarkiverse org owner).

❗ IMPORTANT
If you need to change any setting in the repository (give push permissions to anyone, enable a GitHub app, etc.), make sure you perform these changes in the repository's .tf file. Changes performed in the GitHub UI directly can be discarded at any time without notice.

After the repository is created

Integrate with the Quarkus Ecosystem CI

If you wish to have your extension tested against the latest snapshot in Quarkus core, you need to register your extension in the Quarkus Ecosystem CI

  1. Create an Ecosystem CI issue and assign to the extension lead
  2. In the Ecosystem CI repository, create a info.yaml file in a quarkiverse-<YOUR_EXTENSION> directory with the following contents:
url: https://github.com/quarkiverse/quarkus-<YOUR_EXTENSION>
issues:
  repo: quarkiverse/quarkiverse
  latestCommit: <the issue number you created in the previous step>

Register the extension documentation in the quarkiverse-docs

In order to have your extension documentation listed in the Quarkiverse Documentation website, open a PR including it in the antora-playbook.yml

Make your extension available in the tooling

Create a YAML file with your extension's group-id and artifact-id in the quarkus-extension-catalog repository

Allow your company to be named as a sponsor or contributor (optional)

If you would like your company to be listed as a contributor or sponsor of the extension, register an opt in in the opt-in file in the quarkus-extension-catalog repository.

When your extension is ready

Release your extension

When all tests pass, and you're pretty confident that your extension is ready, it's time to release your extension to Maven central