GeezerVisonThe World Wide Web, restored to 800 pixels of glory. |
| Home|About|Gaming cabinet|Archives|How it works|Starter sites |
GeezerVison is showing www.keycloak.org — Migrating to Quarkus distribution Migrating to Quarkus distributionMigrate to the new Quarkus distribution from the legacy WildFly distributionStarting with Keycloak 17 the default distribution is now powered by Quarkus, while the legacy WildFly powered distribution will still be around until June 2022 we highly recommend starting the migration as soon as possible. The new distribution introduces a number of breaking changes, including:
Before undertaking the migration we highly recommend reading through the new Server Guides to understand how to install and configure the new distribution. Migrating configurationThe WildFly distribution of Keycloak used complicated XML files for configuration, resulting in the need for a CLI tool ( The new Quarkus powered distribution leverages a simple configuration file instead, with corresponding CLI arguments and environment variables as options, making it significantly easier to configure Keycloak. However, this results in the inability to automatically migrate the configuration from the previous distribution. To migrate to the new Quarkus powered distribution the first step is to understand what configuration changes you are applying to the legacy distribution, and apply those that are necessary to the new distribution by following the new Server Guides. One thing to note is the new distribution is a lot more opinionated when it comes to configuration. It aims to provide better defaults, with the need to configure less yourself. However, we may not always have the balance right, and there may be use-cases not covered. If you are unable to configure something that you need to tweak in the new distribution, please open a discussion in GitHub Discussions. Until a new release is available it is possible to configure the new distribution by directly applying Quarkus level configuration through the Quarkus is not an application serverUnlike WildFly, Quarkus is not an application server. While an application server can dynamically deploy applications, and alter what is loaded into memory at runtime, this is not possible on Quarkus. Quarkus on the other hand brings immutability to containers, faster startup, and more predictability. While with the WildFly distribution you could hot-deploy custom providers, change the database vendor as a runtime configuration this is no longer supported. Instead, the Quarkus distribution provides a separate build step that optimises the runtime. One important thing to note here is that the build step does not actually build the Keycloak sources, but rather just optimises the runtime through an augmentation process, which is fairly fast and able to fully optimise what is loaded into the runtime. We recommend that you do this build step as a part of installing Keycloak, through CI, or by creating a custom container image that extends the base Keycloak image. However, there is also an auto build mode that makes Keycloak behave more or less the same as the WildFly distribution in this regard. This comes with a startup time penalty, but is still able to optimise the runtime better than the WildFly distribution could. Setup of initial usersThe Keycloak Wildfly distribution contained scripts named To add the initial admin user, set the environment variables Default context path changedBy default, the new Quarkus distribution removes
When the relative path is specified, it is still possible to be redirected from the root to the relative path.
Specifically, when the user access Migrating custom providersSimilarly to the WildFly distribution custom providers are deployed to Keycloak by copying them to a deployment directory. In the new distribution you should copy your providers to the With the new distribution there is no longer a separate classpath for custom providers, so you may need to be more careful with what additional dependencies you include. In addition, the While the WildFly distribution automatically discovered custom providers, even supported the ability to hot-deploy custom providers while Keycloak is running, this is no longer supported, and when you make a change to the providers or dependencies in the Depending on what APIs your providers use you may also need to make some changes to the providers. If you only leveraged classes from Keycloak SPIs you shouldn’t need to, but if you used other APIs from WildFly you may need to make some changes. In addition, JavaEE APIs like session/stateless beans are no longer supported. Migrating containersThe container images for the Quarkus distribution derive from UBI Micro instead of UBI Minimal. This means that some binaries or configuration files (those not necessary for Keycloak’s main functionality) may be missing. The solution is to add these files in as part of the container customization process explained in the Running Keycloak in a container guide. For example, for the Kerberos authentication features you will need to add Migrating using the OperatorTo use the Quarkus distribution on Kubernetes and OpenShift you need to use the new Operator, the old Operator does not support the new distribution. There is no "direct" migration path, to install Keycloak using the new Operator you need to create a new Custom Resource (CR) to end up with a new Keycloak Deployment based on the Quarkus distribution. The old and new operator can co-exist even in the same namespace since they are using a different API Group and Version in the CRDs. For the old operator, the apiVersion is:
For the new operator, the apiVersion is:
When using
The new operator doesn’t support Client, User and Realm CRDs directly. Instead, it provides one CRD to perform a realm import as described in Automating a realm import. Using this new CR you can import Users, Clients and more through the wrapping Realm. On this page
|
| You are visitor 01402639 — GeezerVison does not store the pages you look up. Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required. |