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 的 providers/
目录中,并在服务器已在运行时重新启动服务器。