3.5. 部署主题
通过将主题目录复制到主题或者将其部署为存档,可以部署到红帽构建的 Keycloak 中。在开发过程中,您可以将主题复制到
主题
目录,但在生产中,您可能需要考虑使用 存档
。一个存档
可以更轻松地拥有主题版本的副本,特别是当您有多个红帽构建的 Keycloak 实例(例如使用集群)时。
流程
- 要将主题部署为存档,请使用主题资源创建一个 JAR 存档。
将文件
META-INF/keycloak-themes.json
添加到存档中可用的主题的存档中,以及每个主题提供的类型。例如,对于
mytheme
theme createmytheme.jar
,其内容如下:- META-INF/keycloak-themes.json
- theme/mytheme/login/theme.properties
- theme/mytheme/login/login.ftl
- theme/mytheme/login/resources/css/styles.css
- theme/mytheme/login/resources/img/image.png
- theme/mytheme/login/messages/messages_en.properties
theme/mytheme/email/messages/messages_en.properties
在这种情况下,
META-INF/keycloak-themes.json
的内容将是:{ "themes": [{ "name" : "mytheme", "types": [ "login", "email" ] }] }
一个存档可以包含多个主题,每个主题可以支持一个或多个类型。
要将存档部署到红帽构建的 Keycloak 中,将其添加到红帽构建的 Keycloak 的 provider/
目录中,如果已在运行,重启服务器。