Chapter 2. Configure the extension registry client
The extension registry, registry.quarkus.redhat.com, hosts the Quarkus extensions that Red Hat provides.
You can configure your Quarkus developer tools to access extensions in this registry by adding the registry to your registry client configuration file. The registry client configuration file is a YAML file that contains a list of registries.
-
The default Quarkus registry is
registry.quarkus.io; typically, you do not need to configure it. However, if a user provides a custom registry list andregistry.quarkus.iois not on it, thenregistry.quarkus.iois not enabled. - Ensure that the registry you prefer appears first on the registry list. When Quarkus developer tools search for registries, they begin at the top of the list.
Procedure
-
Open the
config.yamlfile that contains your extension registry configuration. When you configure your extension registries for the first time, you might need to create aconfig.yamlfile in the$HOME/.quarkusdirectory on your machine. Add the new registry to the
config.yamlfile. For example:config.yaml
registries: - registry.quarkus.redhat.com - registry.quarkus.io
2.1. Limit the extension catalog to a specific offering
The extension registry, registry.quarkus.redhat.com, hosts the definition of Quarkus extensions that Red Hat provides.
Extensions can be associated with multiple offerings; however, you can configure the extension registry to limit the extension catalog to a specific offering. You can configure only one offering per registry.
In the following example, the extension catalog provided by registry.quarkus.redhat.com is limited to extensions that make up the redhat offering.
If you do not configure an offering, the registry returns the complete extension catalog.
Procedure
-
Open the
config.yamlfile that contains your extension registry configuration. Add
offering: redhatto theconfig.yamlfile.For example:
config.yaml
registries: - registry.quarkus.redhat.com offering: redhat - registry.quarkus.io
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}