在 OpenShift Container Platform 上安装和操作 Fuse Online

1. 生成 OpenShift secret，以配置红帽容器镜像的身份验证。
2. 将 Fuse Online Operator 从 OperatorHub 安装到集群上的项目（命名空间）。
3. 另外，如果要包含用于持久连接和集成定义的外部数据库，请创建一个 OpenShift secret。

4. 将 Fuse Online 实例添加到 OpenShift 4.x 项目。

   （可选）编辑自定义资源，以启用一个或多个附加组件功能和/或实现一个或多个自定义配置设置。

5. （可选）向其他开发人员用户授予权限，以便他们能够访问 Fuse 在线 Web 控制台。

流程

1. 使用有权安装 Fuse Online 的帐户登录到 OpenShift。例如：

   oc login -u developer -p developer

2. 创建一个 postgreSQL 数据库，供您在其上安装 Fuse Online 的 OpenShift 集群，并定义以下配置选项的值：

   • 连接用户名
   • 数据库名称

   • 数据库密码

     以下示例使用了 OpenShift 默认提供的 PostgreSQL 模板之一。

     注： 仅使用 PostgreSQL 临时(postgresql-ephemeral)模板进行开发或测试。对于生产环境，请使用 PostgreSQL (postgresql)模板。

     oc new-app postgresql-ephemeral -p POSTGRESQL_USER=syndesis -p POSTGRESQL_PASSWORD=exdb-pwd -p POSTGRESQL_DATABASE=syndesisdb

     此命令返回有关配置 Fuse Online 时所需的数据库的信息，如 URL。

     有关创建数据库的详情，请参阅 OpenShift 文档中的 PostgreSQL 主题。

3. 创建并保存包含以下内容的资源文件（如 my-fuse-online-secret-cr.yml）：

   apiVersion: v1
   kind: Secret
   metadata:
     name: syndesis-global-config
     namespace: my-fuse-online-project
   type: Opaque
   stringData:
     POSTGRESQL_PASSWORD: exdb-pw

   将 my-fuse-online-project 替换为您要为其指定外部数据库的 Fuse Online 环境安装的 OpenShift 项目的名称。

   将 exdb-pw 替换为第 2 步中的密码。Fuse Online 将将其用作访问外部数据库的密码。请注意，stringData 会将 password 值转换为 base64 编码的值（因此您不必进行转换）。

   如需有关 OpenShift 机密的信息，请参阅 Secret。

4. 将 secret 添加到集群中，例如：

   oc apply -f my-fuse-online-secret-cr.yml

   在 OpenShift 集群中，可通过使用指定外部数据库的自定义资源安装的 Fuse Online 环境使用 syndesis-global-config secret。

5. 在您在 secret 的 YAML 文件中指定的 my-fuse-online-project 项目中安装 Fuse Online （在第 4 步中）。

   • 对于 OCP 3.11，在安装 Fuse Online 前，按照编辑默认 自定义资源文件中的说明进行操作。

   • 对于 OCP 4.6 及更新的版本，请按照 从 OperatorHub 安装 Fuse Online Operator 中的说明进行操作。在部署 Fuse Online 项目之前，在 OpenShift 4.x 项目中添加 Fuse Online 实例，请编辑自定义资源以指定外部数据库的使用，例如：

     apiVersion: syndesis.io/v1alpha1
     kind: Syndesis
     metadata:
       name: app
     spec:
       components:
         database:
           externalDbURL: "postgresql://syndesis-external-db:5432"
           user: db-user-name
           name: db-name

   • 将 syndesis-external-db:5432 替换为外部 PostgreSQL 数据库的主机名和端口。
   • 使用连接用户名替换 db-user-name。
   • 将 db-name 替换为数据库的名称。

1. 在 OpenShift 项目（命名空间）中创建 secret，以使用 registry.redhat.io 配置身份验证，以便 Fuse Online Operator 可以访问所需的安装模板。
2. 将 Fuse Online Operator 安装到 OpenShift 项目（命名空间）。安装 Operator 后，Operator 会在所选命名空间中运行。
3. 从已安装的操作器创建 Fuse Online 实例。您可以使用默认设置创建实例，或通过编辑实例的自定义资源来自定义实例。然后，您可以从提供的 URL 访问 Fuse Online。

1. 具有集群管理权限的用户：

   1. 下载安装脚本和相关文件。
   2. 使用 OpenShift oc 客户端工具 命令在集群级别注册自定义资源定义(CRD)。
   3. 使用 OpenShift oc client 工具命令，为一个或多个用户授予权限，以便在其项目中安装 Fuse Online。

2. 对于您要在其中安装 Fuse Online 的每个 OpenShift 项目，被授予安装 Fuse Online 权限的用户：

   1. 决定是否安装默认的 Fuse 在线环境或定制的 Fuse 在线环境。定制的 Fuse Online 环境启用一个或多个附加组件功能和/或实施一个或多个自定义配置设置。
   2. 下载安装脚本和相关文件。
   3. 可选的。如果需要自定义 Fuse Online 环境，请编辑 default-cr.yml 文件（在 Fuse Online 下载软件包中提供）。
   4. 可选的。如果需要保留连接和集成定义，请创建一个 OpenShift secret。
   5. 调用安装脚本。
   6. 确认 Fuse Online 正在运行。

流程

1. 从以下位置下载包含 Fuse 在线安装脚本的软件包：

   https://github.com/syndesisio/fuse-online-install/releases/tag/1.12

2. 在文件系统中方便的位置解包下载的存档。fuse-online-install-1.12 目录包含用于安装 Fuse 在线的脚本和支持文件。

3. 使用具有集群管理员权限的帐户登录 OpenShift。例如：

   oc login -u admin -p adminpwd

4. 运行以下命令，确认您已正确连接，它会列出此集群中已经注册的自定义资源定义。

   oc get crd

   如果没有错误消息，代表您被正确连接。

5. 切换到 fuse-online-install-1.12 目录并调用以下命令，在集群级别上注册自定义资源定义：

   bash install_ocp.sh --setup

6. 运行以下命令确认注册是否成功：

   oc get crd

   注册的自定义资源定义的输出列表应包含 syndesis。

7. 在您希望 Fuse 在线安装的每个项目中，授予用户安装权限。对于每个项目：

   1. 切换到您要在其中安装 Fuse Online 的项目。例如：

      oc project fuse-online-project

   2. 授予在该项目中安装 Fuse Online 的用户权限。例如，以下命令授予开发人员用户安装 Fuse Online 的权限。运行此命令后，开发人员可以在当前项目中 安装 Fuse Online，本例中为 fuse-online-project ：

      bash install_ocp.sh --grant developer

      对您要为其授予 Fuse Online 安装权限的每个 OpenShift 项目重复这两个命令。单个用户可在集群中的多个项目中安装 Fuse Online。要启用此功能，请切换到另一个项目并指定同一用户，例如：

      oc project another-fuse-online-project
bash install_ocp.sh --grant developer

流程

1. 如果您还没有下载包含 Fuse 在线安装脚本的软件包：

   1. 现在从以下位置下载：

      https://github.com/syndesisio/fuse-online-install/releases/tag/1.12

   2. 在文件系统中方便的位置解包下载的存档。fuse-online-install-1.12 目录包含用于安装 Fuse Online 的脚本和支持文件。

2. 使用有权安装 Fuse Online 的帐户登录到 OpenShift。例如：

   oc login -u developer -p developer

3. 在编辑器中打开 fuse-online-install-1.12/default-cr.yml 文件。
4. 编辑 default-cr.yml 文件，使其启用功能并设置您想要的参数。要确定您需要指定的内容，请参阅 配置 Fuse Online 的自定义资源属性的描述。
5. 保存 default-cr.yml 文件。

流程

1. 使用有权安装 Fuse Online 的帐户登录到 OpenShift。例如：

   oc login -u developer -p developer

2. 创建一个 postgreSQL 数据库，供您在其上安装 Fuse Online 的 OpenShift 集群，并定义以下配置选项的值：

   • 连接用户名
   • 数据库名称

   • 数据库密码

     以下示例使用了 OpenShift 默认提供的 PostgreSQL 模板之一。

     注： 仅使用 PostgreSQL 临时(postgresql-ephemeral)模板进行开发或测试。对于生产环境，请使用 PostgreSQL (postgresql)模板。

     oc new-app postgresql-ephemeral -p POSTGRESQL_USER=syndesis -p POSTGRESQL_PASSWORD=exdb-pwd -p POSTGRESQL_DATABASE=syndesisdb

     此命令返回有关配置 Fuse Online 时所需的数据库的信息，如 URL。

     有关创建数据库的详情，请参阅 OpenShift 文档中的 PostgreSQL 主题。

3. 创建并保存包含以下内容的资源文件（如 my-fuse-online-secret-cr.yml）：

   apiVersion: v1
   kind: Secret
   metadata:
     name: syndesis-global-config
     namespace: my-fuse-online-project
   type: Opaque
   stringData:
     POSTGRESQL_PASSWORD: exdb-pw

   将 my-fuse-online-project 替换为您要为其指定外部数据库的 Fuse Online 环境安装的 OpenShift 项目的名称。

   将 exdb-pw 替换为第 2 步中的密码。Fuse Online 将将其用作访问外部数据库的密码。请注意，stringData 会将 password 值转换为 base64 编码的值（因此您不必进行转换）。

   如需有关 OpenShift 机密的信息，请参阅 Secret。

4. 将 secret 添加到集群中，例如：

   oc apply -f my-fuse-online-secret-cr.yml

   在 OpenShift 集群中，可通过使用指定外部数据库的自定义资源安装的 Fuse Online 环境使用 syndesis-global-config secret。

5. 在您在 secret 的 YAML 文件中指定的 my-fuse-online-project 项目中安装 Fuse Online （在第 4 步中）。

   • 对于 OCP 3.11，在安装 Fuse Online 前，按照编辑默认 自定义资源文件中的说明进行操作。

   • 对于 OCP 4.6 及更新的版本，请按照 从 OperatorHub 安装 Fuse Online Operator 中的说明进行操作。在部署 Fuse Online 项目之前，在 OpenShift 4.x 项目中添加 Fuse Online 实例，请编辑自定义资源以指定外部数据库的使用，例如：

     apiVersion: syndesis.io/v1alpha1
     kind: Syndesis
     metadata:
       name: app
     spec:
       components:
         database:
           externalDbURL: "postgresql://syndesis-external-db:5432"
           user: db-user-name
           name: db-name

   • 将 syndesis-external-db:5432 替换为外部 PostgreSQL 数据库的主机名和端口。
   • 使用连接用户名替换 db-user-name。
   • 将 db-name 替换为数据库的名称。

流程

1. 如果您还没有下载包含 Fuse 在线安装脚本的软件包：

   1. 从以下位置下载：

      https://github.com/syndesisio/fuse-online-install/releases/tag/1.12

   2. 在文件系统中方便的位置解包下载的存档。fuse-online-install-1.12 目录包含用于安装 Fuse Online 的脚本和支持文件。

2. 使用有权安装 Fuse Online 的帐户登录到 OpenShift。例如：

   oc login -u developer -p developer

3. 切换到安装 Fuse Online 的 OpenShift 项目，例如：

   oc project my-fuse-online-project

   或者，在运行安装脚本时，您可以指定 --project my-fuse-online-project。

4. 在下载安装脚本的目录中，调用安装脚本：

   bash install_ocp.sh

   要了解安装脚本选项，请调用 bash install_ocp.sh --help 命令。

5. 确认用于安装 Fuse Online 的 syndesis 自定义资源包含您想要的内容：

   1. 调用以下命令以显示 syndesis 自定义资源内容：

      oc describe syndesis/app

   2. 检查自定义资源的内容。

      如果它不包含您的所有更新，则自定义资源中可能存在语法错误。您必须卸载 Fuse Online，并再次尝试定义有效的自定义资源。请参阅从 OCP 项目卸载 Fuse Online。

6. 确认安装成功：

   1. 显示位于 https://openshift-route 的 OpenShift OAuth 代理登录页面。

      如果您选择让安装脚本计算 OpenShift 路由，则脚本会在执行结束时显示计算的路由。将 openshift-route 替换为脚本提供的值。

      如果您编辑了 default-cr.yml 文件，以指定 Fuse Online 的 routeHostname，请将 openshift-route 替换为您指定的路由。

   2. 如果您还没有登录到 OpenShift 控制台，则会显示其登录页面。输入您的 OpenShift 用户名和密码登录。

   Fuse Online 主页会在您登录 OpenShift 控制台后立即或之后显示。

流程

1. 使用有权安装 Fuse Online 的帐户登录到 OpenShift。例如：

   oc login -u developer -p developer

2. 切换到运行 Fuse Online 环境的 OpenShift 项目，其配置要更改。例如：

   oc project my-fuse-online-project

3. 可选的。在 syndesis 自定义资源中创建当前设置的备份副本，只要您更新并保存不正确的内容。例如，调用以下命令会在 syndesis_app_backup.yml 文件中保存备份：

   oc get syndesis app -o yaml > syndesis_app_backup.yml

4. 调用以下命令在编辑器中打开 syndesis 自定义资源：

   oc edit syndesis/app

   注： 此流程描述了如何通过在编辑器中打开自定义资源文件来设置配置。或者，您可以使用 oc patch 命令来编辑自定义资源。

5. 根据需要编辑 syndesis 自定义资源。

6. 保存资源。

   根据您编辑的对象类型，您的更新会触发 syndesis-operator，以在保存资源时重新部署一些 Fuse Online 组件。

7. 如果您在自定义资源中更改了 demoData 选项，您必须使用以下命令删除 syndesis-server 和 syndesis-db pod 来触发重新部署：

   oc delete $(oc get -o name pod -l syndesis.io/component=syndesis-server)
   
   oc delete $(oc get -o name pod -l syndesis.io/component=syndesis-db)

8. 等待两分钟，然后确认正确更新复合自定义资源：

   1. 调用以下命令以显示 syndesis 自定义资源的内容：

      oc describe syndesis/app

   2. 检查内容。

      如果 复合 自定义资源不包含您需要的设置，请再次编辑它以指定有效的设置。

流程

1. 使用 oc patch 命令语法配置 容限 设置。为 Fuse Online 基础架构组件部署指定 infraScheduling，或为 Fuse Online 集成部署指定 integrationScheduling ：

   oc patch syndesis/app --type=merge -p '{"spec":{"infraScheduling"|"infraScheduling":{"tolerations":[{"key":"_value1_","operator":"_value2_","effect":"_value3_"},{"key":"_value4_","operator":"_value5_","effect":"_value6_"}]}}}'

   例如，以下命令为 Fuse Online 基础架构组件添加容限：

   oc patch syndesis/app --type=merge -p '{"spec":{"infraScheduling":{"tolerations":[{"key":"tol_1","operator":"Equal","effect":"NoSchedule"},{"key":"tol_2","operator":"Equal","value":"value2","effect":"NoSchedule"}]}}}'

2. 使用 oc patch 命令语法 配置节点关联性设置。为 Fuse Online 基础架构组件部署指定 infraScheduling，或为 Fuse Online 集成部署指定 integrationScheduling ：

    oc patch syndesis/app --type=merge  -p '{"spec":{"infraScheduling"|"infraScheduling":{"affinity":{"nodeAffinity":{"preferredDuringSchedulingIgnoredDuringExecution":[{"weight":_value1_,"preference":{"matchExpressions":[{"key":"_value1_","operator":"_value2_","values":["_value3_","_value4_"]}]}}]}}}'

   例如，以下命令将 nodeAffinity 设置为 Fuse Online 基础架构组件和集成：

    oc patch syndesis/app --type=merge  -p '{"spec":{"infraScheduling":{"affinity":{"nodeAffinity":{"preferredDuringSchedulingIgnoredDuringExecution":[{"weight":11,"preference":{"matchExpressions":[{"key":"_affinity","operator":"In","values":["foo","bar"]}]}}]}}},"integrationScheduling":{"affinity":{"nodeAffinity":{"preferredDuringSchedulingIgnoredDuringExecution":[{"weight":22,"preference":{"matchExpressions":[{"key":"my_affinity2","operator":"In","values":["foo","bar"]}]}}]}}}}}'

3. 要删除配置设置，请使用 oc patch 命令中的 remove 选项，如下例所示：

   • 以下示例命令从 Fuse Online 集成的 nodeAffinity 中删除 preferredDuringSchedulingIgnoredDuringExecution 设置：

     oc patch syndesis/app --type=json -p '[{"op": "remove", "path": "/spec/integrationScheduling/affinity/nodeAffinity/preferredDuringSchedulingIgnoredDuringExecution" }]'

   • 以下示例从 Fuse Online 基础架构组件中删除容限：

     oc patch syndesis/app --type=json -p '[{"op": "remove", "path": "/spec/infraScheduling/tolerations" }]'

流程

1. 在编辑器中打开自定义资源：

   如果您已经安装了 Fuse Online，请按照"更改 Fuse Online 配置" 中的步骤打开自定义资源。

   如果您还没有安装 Fuse Online，请按照这些主题中的步骤打开自定义资源，具体取决于您的 OCP 版本：

   • 对于 OCP 4.x： 将 Fuse Online 实例添加到 OpenShift 4.x 项目
   • 对于 OCP 3.11： 安装 Fuse Online 前编辑默认自定义资源文件

2. 对于 syndesis-server 和 syndesis-meta 组件，设置 Java Options (javaOptions)参数，并指定 HTTP 代理主机和端口的值。将相同的 HTTP 代理值用于 syndesis-server 和 syndesis-meta。

   例如：

   spec:
     components:
       server:
         javaOptions:
   -Dhttp.proxyHost=10.0.0.100 -Dhttp.proxyPort=8800
   
       meta:
         javaOptions:
   -Dhttp.proxyHost=10.0.0.100 -Dhttp.proxyPort=8800

3. 对于 Fuse Online 集成，请设置 Maven 参数（额外参数）参数。例如：

   spec:
     components:
       server:
         features:
           maven:
             additionalArguments: "-Dhttp.proxy=10.0.0.100 -Dhttp.proxyPort=8800"

4. 保存自定义资源。

   如果已安装 Fuse Online，则会重新部署 syndesis-server pod，以响应第 2 步中的 javaOptions 更新。

5. 重新发布使用 HTTP 代理的任何正在运行的集成。

   1. 在 Fuse Online 中，选择您要更新的集成。
   2. 选择 编辑。
   3. 选择 Publish。

流程

1. 使用有权编辑 Fuse Online 自定义资源的帐户登录到 OpenShift。例如：

   oc login -u developer -p developer

2. 切换到运行 Fuse Online 的项目。例如：

   oc project my-fuse-online-project

3. 编辑 syndesis 自定义资源：

   1. 调用以下命令，这通常会在编辑器中打开资源：

      oc edit syndesis

   2. 通过添加 demoData 字段并将它设置为 true 来编辑自定义资源，然后将 addons:unmarshal:enabled 字段更改为 true ：

      spec:
        demoData: true
        addons:
          todo:
            enabled: true

   3. 保存资源。

      将这个更改保存到 syndesis 自定义资源会触发 syndesis-operator 来创建新的 todo pod。

4. 要更新与自定义资源中的 demoData 选项相关的更改，您必须使用以下命令删除 syndesis-server 和 syndesis-db pod 来触发重新部署：

   oc delete $(oc get -o name pod -l syndesis.io/component=syndesis-server)
   
   oc delete $(oc get -o name pod -l syndesis.io/component=syndesis-db)

流程

1. 使用赋予您编辑 Fuse Online 自定义资源的帐户登录 OpenShift。例如：

   oc login -u admin -p admin-password

2. 切换到运行 Fuse Online 环境的项目。例如：

   oc project my-fuse-online-project

3. 编辑 syndesis 自定义资源：

   1. 调用以下命令，这通常会在编辑器中打开资源：

      oc edit syndesis

   2. 确保资源中存在以下行：根据需要编辑 ：

      components:
        server:
          features:
            auditing: true

4. 保存资源。

   当您在复合自定义资源中启用审计功能时，运行的合成 服务器配置 会重新加载，Fuse Online 开始记录对 Fuse Online 组件的相关更改。

5. 要查看 Fuse Online 审计日志信息，请输入以下命令：

流程

1. 在 Fuse Online 命名空间中，使用以下命令设置 monitoring-key=middleware 标签：

   oc label namespace <fuse-online-namespace> monitoring-key=middleware

2. 验证您的 Fuse Online 安装是否已将应用程序监控配置资源添加到 OpenShift 集群中：

   1. 在 OpenShift Web 控制台中，前往 application-monitoring 项目，然后打开 prometheus-route URL。

   2. 在 Prometheus 控制台中，进入 Status → Targets 页面。

      如果列出了 Syndesis 目标，则将配置 Fuse Online 以进行监控，您可以跳至第 4 步。

      如果没有列出 Syndesis 目标，请继续步骤 3。

3. 要通过安装在独立 OpenShift 项目中的 Prometheus 实例公开 Fuse Online 来监控，请在 syndesis 自定义资源中启用 ops 附加组件：

   1. 进入 Fuse Online 命名空间：

      OpenShift 4.x	OpenShift 3.11
      在 OpenShift Web 控制台中，前往 Fuse Online (syndesis)项目。 选择 Catalog > Installed Operators，然后点 Fuse Online Operator。 点 Syndesis CRD，然后点 app。 点 Yaml 在编辑器中打开 yaml 文件。	选择 Resources > Other Resources。 从下拉菜单中，选择 Syndesis 资源类型。 对于 app 资源，点 Actions，然后选择 Edit YAML 以打开编辑器中的 yaml 文件。

   2. 通过添加后续行来编辑 yaml 文件，将 Syndesis.Spec.Addons.Ops.Enable 值设置为 true ：

      spec:
        addons:
          ops:
            enabled: true

   3. 保存该文件。

   4. 等待 pod 重启。

      注意

      运行 install 命令后，Fuse Online infrastructure 资源将不能立即使用。您可能需要等待，然后才能在 Prometheus Targets 页面中看到 Fuse Online (Syndesis)目标。

4. 访问 Prometheus：

   1. 在安装应用程序监控 Operator 的项目的 OpenShift 控制台中，打开路由列表。
   2. 在 prometheus-route 条目旁边，单击 hostname URL 以打开 Prometheus 控制台。
   3. 要查看为 Fuse Online 基础架构组件配置的警报规则列表，请点 Alerts 菜单项。

5. 访问 Grafana 仪表板：

   1. 在安装应用程序监控 Operator 的项目的 OpenShift 控制台中，打开路由列表。
   2. 在 grafana-route 条目旁边，点主机名 URL 打开 Grafana 控制台。

   3. 在 Grafana 控制台的顶部，点仪表板选择器。

      • 对于 Fuse Online 集成，请选择 Integration - Camel。此仪表板显示 Apache Camel 集成应用程序公开的标准指标。

      • 对于 Fuse Online 基础架构组件，请选择以下基础架构仪表板之一：

        Infrastructure - DB

        显示与 Fuse Online Postgres 实例相关的指标。

        基础架构 - JVM

        显示关于为 syndesis-meta 或 syndesis-server 应用运行 JVM 的指标。从仪表板顶部的 应用程序 下拉列表中，选择您要监控的应用程序。

        基础架构 - REST API

        显示与 Fuse Online 基础架构 API 端点相关的指标，如 请求 吞吐量和延迟 。从仪表板顶部的 Application 下拉列表中选择要监控的应用程序。

6. 访问 Prometheus Alertmanager：

   1. 在安装应用程序监控 Operator 的项目的 OpenShift 控制台中，打开路由列表。

   2. 在 alertmanager-route 条目旁边，单击 hostname URL 以打开 Alertmanager 控制台。

      如果 Fuse Online 基础架构健康，则默认视图为空。

      如果有任何基础架构组件不健康，则会列出触发的任何活跃警报，以及静默它们的选项。

流程

1. 使用有权安装 Fuse Online 的帐户登录到 OpenShift。例如：

   oc login -u developer -p developer

2. 切换到您要配置备份的 Fuse Online 环境的 OpenShift 项目。例如：

   oc project my-fuse-online-project

3. 创建 OpenShift 机密。在命令行中：

   • 如以下命令格式所示，指定 syndesis-backup-s3。

   • 将 AWS 变量替换为您的 AWS 访问密钥、AWS secret 密钥、AWS 区域，其中存储桶所在的区域，以及存储桶的名称。

     使用以下命令格式创建 secret：

     oc create secret generic syndesis-backup-s3 \
     --from-literal=secret-key-id="my-aws-access-key" \
     --from-literal=secret-access-key="my-aws-secret-key" \
     --from-literal=region="aws-region" \
     --from-literal=bucket-name="aws-bucket-name"

     当备份作业运行时，必须存在此 secret。

4. 如果尚未安装 Fuse Online，您必须编辑 default-cr.yml 文件以启用备份。在安装 Fuse Online 前， 请参阅编辑复合自定义资源。安装 Fuse Online 后，将根据您在自定义资源中指定的调度来备份作业。

   如果 Fuse Online 正在运行，您必须编辑复合 自定义资源：

   1. 调用以下命令，它会在编辑器中打开 syndesis 自定义资源：

      oc edit syndesis

   2. 在 spec: 下添加以下内容：

      backup:
        schedule: my-backup-interval

      将 my-backup-interval 替换为备份之间所需的持续时间。要确定如何指定备份之间的间隔，请参阅以下资源：

      • Cron 预定义的调度

      • Cron interval

        不要在间隔前指定 @ 符号。例如，要配置每日备份，自定义资源将包含如下内容：

        apiVersion: syndesis.io/v1beta1
        kind: Syndesis
        metadata:
          name: app
        spec:
          backup:
            schedule: daily

5. 保存该文件。

   这会在 syndesis-operator 中添加一个备份作业。

流程

1. 从 Amazon S3 下载所需的备份文件。有关执行此操作的详情，请参阅 AWS 文档中的 如何从 S3 Bucket 下载对象？

2. 提取 zip 文件的内容。例如，以下命令行解压缩 7.6-2020-03-15-23:30:00.zip 文件，并将内容复制到 /tmp/fuse-online-backup 文件夹中：

   unzip 7.6-2020-03-15-23:30:00.zip -d /tmp/fuse-online-backup

3. 解码 Fuse Online 数据库，例如：

   base64 -d /tmp/fuse-online-backup/syndesis-db.dump > /tmp/fuse-online-backup/syndesis-db

4. 切换到运行新 Fuse Online 环境的 OpenShift 项目。例如，如果新的 Fuse Online 环境位于 my-fuse-online-project 中，您将调用以下命令：

   oc project my-fuse-online-project

   此流程的其余部分假定您已切换到包含新 Fuse Online 环境的项目。

5. 获取数据库 pod 的名称。

   如果恢复的 Fuse Online 环境使用提供的内部 PostgreSQL 数据库，请调用以下命令来获取数据库 pod 的名称：

   oc get pods -l deploymentconfig=syndesis-db -o jsonpath='{.items[*].metadata.name}'

   如果恢复的 Fuse Online 环境使用外部数据库，假设您知道如何获取该数据库的 pod 的名称。

   在剩余的命令中，您会看到 DATABASE_POD_NAME，为恢复的 Fuse Online 环境插入数据库 pod 的名称。

6. 缩减以任何方式访问数据库的组件。

   1. 缩减 syndesis-operator 以便缩减其他组件：

      oc scale deployment syndesis-operator --replicas 0

   2. 缩减 syndesis-server 和 syndesis-meta 组件：

      oc scale dc syesis-server --replicas 0
oc scale dc syndesis-meta --replicas 0

7. 将数据库备份文件发送到 Fuse Online 数据库 pod：

   oc cp /tmp/fuse-online-backup/syndesis-db DATABASE_POD_NAME:/tmp/syndesis-db

8. 在 Fuse Online 数据库 pod 中打开远程 shell 会话：

   oc rsh DATABASE_POD_NAME

9. 调用以下命令来恢复 Fuse Online 数据库。

   如果 psql 命令提示输入数据库密码，并且恢复的 Fuse Online 环境使用所提供的内部 PostgreSQL 数据库，您可以在 syndesis-db 部署配置中找到 POSTGRESQL_PASSWORD 环境变量中的密码。如果恢复的 Fuse Online 环境使用外部数据库，则假设您知道密码。

   cd /tmp
   psql -c 'DROP database if exists syndesis_restore'
   psql -c 'CREATE database syndesis_restore'
   pg_restore -v -d syndesis_restore /tmp/syndesis-db
   psql -c "SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname = 'syndesis'"
   psql -c 'DROP database if exists syndesis'
   psql -c 'ALTER database syndesis_restore rename to syndesis'

   Fuse Online 现在应该被恢复。您可以结束 RSH 会话：

   exit

10. 扩展 Fuse 在线组件：

    oc scale deployment syndesis-operator --replicas 1

    将 syndesis-operator 扩展到 1 应调出缩减的其他 pod。但是，如果没有发生这种情况，您可以手动扩展它们：

    oc scale dc syesis-server --replicas 1
oc scale dc syndesis-meta --replicas 1

11. 服务器会尝试启动每个恢复的集成，但您需要首先更新连接。因此，请确保恢复的集成没有运行：

    1. 获取 Fuse Online 控制台路由：

       echo "https://$(oc get route/syndesis -o jsonpath='{.spec.host}' )"

    2. 使用具有安装 Fuse Online 的 OpenShift 用户帐户登录 Fuse Online 控制台。
    3. 显示集成列表，并确保所有集成都已停止。如果集成正在运行，请停止它。

12. 对于具有密码的每个连接，您需要更新连接，使其具有此 Fuse Online 环境的正确密码。以下步骤演示了如何对提供的 PostgresDB 连接执行此操作。

    1. 在运行此恢复的 Fuse Online 环境的 OpenShift 控制台中，检索 PostgresDB 连接的密码。在 syndesis-db 部署中，密码位于环境变量中。
    2. 在 Fuse Online 控制台中，显示连接。
    3. 编辑 PostgresDB 连接。
    4. 在 PostgresDB 连接的连接详情中，将检索到的密码粘贴到 Password 字段中。

13. 对于每个集成，确认没有 Configuration Required 指示符。如果存在，请编辑集成来解决这个问题。集成中的所有步骤都正确后，发布集成。

    如果 Fuse Online 在构建步骤后将集成回滚到 Stopped 状态，请删除部署，请确保不需要配置，并尝试再次发布集成。

    如果在日志中看到以下信息，您可以安全地忽略以下信息：

    Error performing GET request to https://syndesis-my-fuse-online-project.my-cluster-url/api/v1/metrics/integrations

流程

1. 使用有权安装 Fuse Online 的帐户登录到 OpenShift。例如：

   oc login -u developer -p developer

2. 切换到正在运行您要卸载的 Fuse Online 环境的 OpenShift 项目。例如：

   oc project my-fuse-online-project

3. 删除 Fuse Online 基础架构：

   oc delete syesis app

4. 删除 syndesis-operator DeploymentConfig 和 ImageStream 资源：

   oc delete deployment/syndesis-operator
oc delete is/syndesis-operator

流程

1. 使用具有集群管理特权的帐户登录 OpenShift。例如：

   oc login -u admin -p admin

   虽然只有 syndesis-operator grant 命令需要集群管理特权，但这个过程假定集群管理员执行了所有步骤。

2. 切换到运行 Fuse Online 的 OpenShift 项目。您仅在这个项目中公开公共 API。例如：

   oc project fuse-online-north

3. 将角色授予 syndesis-public-oauthproxy 服务帐户。您的 OpenShift 项目使用此服务帐户来运行 OAuth 代理服务。指定具有集群管理特权的用户帐户。例如：

   syndesis-operator grant --user developer

   此命令创建集群角色和集群角色绑定到 syndesis-public-oauthproxy 服务帐户。ClusterRoleBinding 指定您要在其中公开 API 的 OpenShift 项目的名称，本例中为 fuse-online-north ：

   • ClusterRole:syndesis-auth-delegator
   • ClusterRoleBinding:syndesis-fuse-online-north-auth-delegator

4. 创建客户端服务帐户，并授予它访问 Fuse Online 公共 API 的权限：

   1. 使用您选择的名称创建 OpenShift 服务帐户。例如，以下命令会创建 cicd-client 服务帐户：

      oc create serviceaccount cicd-client

      调用公共 API 端点的命令使用此帐户访问公共 API。另外，您需要此服务帐户获取 secret 令牌，该令牌必须在 API 端点调用中指定。这在 获取用于调用 REST API 端点 的 secret 令牌 中进行了描述。

   2. 授予客户端服务帐户权限，以访问 Fuse Online 公共 API。如果 fuse-online-north 是安装 Fuse Online 的 OpenShift 项目的名称，如果 cicd-client 是您为访问 API 服务的服务帐户的名称，则您将调用以下命令：

      oc policy add-role-to-user edit system:serviceaccount:fuse-online-north:cicd-client`

5. 编辑 syndesis 自定义资源：

   1. 调用以下命令，这通常会在编辑器中打开资源：

      oc edit syndesis

   2. 编辑资源，使其启用公共 API，并指定 Fuse Online 环境的公共地址，作为 routeHostname 的设置来调用端点。（如果编辑了用于安装 Fuse Online 的 default-cr.yml 文件，则启用公共 API 并指定端点的路由主机名，则不需要编辑资源。）

      集群设置决定了您需要指定的公共地址。详情请参阅 OpenShift 文档的路由。在以下示例中，路由主机名对 minishift 集群有效。

      spec:
        addons:
          publicApi:
            enabled: true
            routeHostname: public-syndesis.192.168.64.63.nip.io

   3. 保存（或关闭）资源。

      保存复合自定义资源会触发 syndesis -operator （负责安装 Fuse Online）来部署公共 API OAuth 代理服务。

      如果您不需要编辑复合自定义资源 ， 则公共 API OAuth 代理服务已经部署。这可能是因为启用了 publicApi 以及用于安装 Fuse Online 的 default-cr.yml 文件中指定的路由。

流程

1. 获取您在公开此 Fuse Online 环境的公共 REST API 时创建的服务帐户的 secret 令牌名称。例如，如果 cicd-client 是服务帐户的名称，您将调用以下命令：

   oc describe serviceaccount cicd-client

   这将显示 cicd-client 服务帐户的信息列表，其中包括其两个令牌的名称，如下所示：

   Tokens:      cicd-client-token-gxb25
                cicd-client-token-gxdnv

2. 显示其中一个令牌的内容。例如：

   oc describe secret cicd-client-token-gxb25

   这将显示信息列表，包括显示 token: 的数据部分，后跟一个长的随机字符。这是服务帐户的两个机密令牌之一。

3. 复制机密令牌，将其粘贴到文件中并保存。

流程

1. 在左侧的 Fuse Online 导航面板中，单击 Integrations。
2. 在集成列表中，在您要标记的集成右侧，点 显示弹出菜单并点 Manage CI/CD。

3. 在出现的对话框中，执行以下操作之一或多个：

   • 如果要标记此集成的环境，请选中该环境左侧的复选框。
   • 如果要标记此集成的环境已被选择，请保留它。
   • 如果您需要为环境创建标签，请单击 Manage CI/CD，这会显示一个用于创建新环境标签的对话框。创建您需要的标签，然后返回到此流程来标记集成。

   Fuse Online 将所选环境标签应用到集成。您可以将任意数量的环境标签应用到集成。

4. 点 Save。

流程

1. 在 Fuse Online 中，在左侧导航面板中，单击 Integrations。
2. 在右上角，单击 Manage CI/CD。

3. 在 Manage CI/CD 页面中：

   • 创建 CI/CD 环境标签：

     1. 单击 Add New。
     2. 在 Add Tag Name 对话框中，在 Tag Name 输入字段中，输入新环境标签的名称，如 test1。
     3. 点 Save。在 Manage CI/CD 页面中，您刚刚添加的环境标签有一个新条目。

   • 更改 CI/CD 环境标签：

     1. 在 CI/CD 环境标签列表中，在您要更改的标签的条目中，点 Edit。
     2. 在 Edit Tag 对话框中，根据需要更改名称。
     3. 点 Save 在环境标签列表中看到更新的名称。Fuse Online 将更新的名称应用到已标记为您更改的环境标签的每个集成。

   • 删除 CI/CD 环境标签：

     1. 在 CI/CD 环境标签列表中，在您要删除的标签的条目中，单击 Remove。
     2. 在确认对话框中，单击 Yes。Fuse Online 删除环境标签，并从标记了它的任何集成中删除已删除的环境标签。