3.2. 更改 Fuse 在线配置的一般流程
对于在 OCP 上安装的 Fuse Online 环境,您可以通过更新其合成自定义资源来更改其配置。保存更改后,如果它们语法正确,OpenShift 会用您的更新更新
syndesis-operator
。语法错误会阻止更新。
在编辑 syndesis
自定义资源时,请确保不要指定无效的设置,其语法正确。syndesis-operator
将使用更新的 syndesis
自定义资源,即使语法正确设置无效。如果您确实指定了无效的设置,则只在 OpenShift 完成更新后了解它。在更新过程中,OpenShift 会删除无效的设置。
先决条件
- Fuse Online 安装在 OCP 现场。
-
已安装
oc
客户端工具,并连接到安装 Fuse Online 的 OCP 集群。 - 您有在要更改 Fuse 在线配置的项目中安装 Fuse Online 的权限。
-
您查询 了配置 Fuse Online 的自定义资源属性的描述,以了解安装后允许哪些配置更改,以及如何为您要进行配置更改更新合成自定义资源。
流程
使用有权限安装 Fuse Online 的帐户登录 OpenShift。例如:
oc login -u developer -p developer
切换到运行您要更改的配置的 Fuse Online 环境的 OpenShift 项目。例如:
oc project my-fuse-online-project
可选。在
syndesis
自定义资源中创建当前设置的备份副本,仅当您更新并保存不正确的内容时。例如,调用以下命令会在syndesis_app_backup.yml
文件中保存备份:oc get syndesis app -o yaml > syndesis_app_backup.yml
调用以下命令以在编辑器中打开 syndesis 自定义资源:
oc edit syndesis/app
注: 这个流程描述了如何在编辑器中打开自定义资源文件来设置配置。另外,您可以使用
oc patch
命令来编辑自定义资源。-
根据需要编辑
syndesis
自定义资源。 保存资源。
根据您编辑应用到的对象类型,您的更新会触发
syndesis-operator
在保存资源时重新部署一些 Fuse Online 组件。如果您更改了自定义资源的
components.server.features
部分中的maven:additionalArguments
、MavenRepositories
和integrationLimit
属性,则必须通过删除syndesis-server
pod 来触发重新部署。使用这个命令:oc delete 'oc get -o name pod -l syndesis.io/component=syndesis-server'
等待 2 分钟或三分钟,然后确认
syndesis
自定义资源已正确更新:调用以下命令以显示
syndesis
自定义资源的内容:oc describe syndesis/app
检查内容。
如果
syndesis
自定义资源不包含您需要的设置,请再次编辑它以指定有效的设置。
结果
对 syndesis
自定义资源的大多数更改都会触发 syndesis-operator
以重新部署 Fuse Online syndesis-server
组件。这意味着 OpenShift 会创建一个新的服务器 Pod。有些更改需要您删除 syndesis-server
容器集,以便 OpenShift 创建新的服务器 Pod。
在新服务器就绪前,最多需要一到两分钟。在这段时间中,Fuse Online 控制台不可用。在部署新服务器时,运行的集成会继续运行。新部署准备就绪后,新服务器将加载集成状态。您可以在以下情况下再次使用 Fuse Online 控制台:
-
syndesis-server
pod 状态为Running
。 - 刷新 Fuse Online 控制台会显示集成、连接、消息和运行时间的值。
对 syndesis
自定义资源的一些更改更新 Fuse 在线配置,但不需要重新部署 syndesis-server
。例如:
-
当您更新
syndesis
自定义资源来指定备份时,在备份作业发生前需要几秒钟。
每个配置更改的效果是在安装后 Fuse 在线配置更改允许 的效果。