红帽全球峰会第 1 章 Red Hat build of Keycloak Operator 安装
如何在 OpenShift 上安装 Operator。
使用这个流程在 OpenShift 集群中安装红帽构建的 Keycloak Operator。
- 打开 OpenShift Container Platform Web 控制台。
- 在左列中，单击 Home, Operators, OperatorHub。
- 在搜索输入框中搜索 "Keycloak"。
- 从结果列表中选择 Operator。
- 按照屏幕上的说明进行操作。
有关使用 CLI 或 Web 控制台安装 Operator 的常规说明，请参阅 在命名空间中安装 Operator。在默认目录中，Operator 被命名为 rhbk-operator。确保使用与所需红帽构建的 Keycloak 版本对应的频道。
1.1. 为 OLM 升级配置手动批准
复制链接链接已复制到粘贴板!
警告
重要： 自动 OLM 升级
默认情况下，当发布新版本时，OLM 会自动更新 Keycloak Operator 的 Red Hat build。这可能导致几个严重的问题：
- 当使用默认红帽构建的 Keycloak 镜像时，Operator 会使用对应的红帽构建的 Keycloak 版本匹配的镜像，从而导致在 Operator 升级时 意外地升级 Keycloak 升级。
- 即使使用自定义镜像，主要的 Operator 升级可能会引入与现有 Keycloak CR 配置相关的重要兼容性问题，可能需要手动干预
- Keycloak CR 中的新字段或行为更改可能会影响现有部署
- 由于与数据库迁移相关的更改，没有将红帽降级到以前的红帽 Keycloak 版本的选项
建议：
我们强烈建议在 Red Hat build of Keycloak Operator 中使用手动批准模式。这样可确保您可以：
- 在批准升级前，请参阅发行注记并按照迁移更改进行操作
- 为升级调度维护窗口
- 首先在非生产环境中测试升级
- 备份数据库，以便在出现问题时降级到以前的红帽 Keycloak 构建
要防止 OLM 自动升级，请在安装 Operator 时将批准策略设置为 Manual ：
1.1.1. 使用 OpenShift Web 控制台
复制链接链接已复制到粘贴板!
安装 Operator 时，在更新批准策略部分选择 Manual approval ：
1.1.2. 使用 CLI
复制链接链接已复制到粘贴板!
对于命令行安装，创建一个带有 installPlanApproval: Manual 的订阅：
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
name: rhbk-operator
namespace: <target-namespace>
spec:
channel: <desired-channel>
name: rhbk-operator
source: redhat-operators
sourceNamespace: openshift-marketplace
installPlanApproval: Manual安装后，任何升级都需要通过 OLM 界面或通过 CLI 进行手动批准。
'%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}