在 OpenShift 中管理 Fuse

1. 以具有集群管理员访问权限的用户身份登录 Web 浏览器中的 OpenShift 控制台。
2. 点 Operators，然后点 OperatorHub。
3. 在搜索字段窗口中，键入 Fuse Console 以过滤 Operator 列表。
4. 单击 Fuse Console Operator。

5. 在 Fuse Console Operator 安装窗口中，单击 Install。

   Create Operator Subscription 表单将打开。

   • 对于 Update Channel，请选择 7.11.x。

   • 对于 Installation Mode，接受默认命名空间（集群上的特定命名空间）。

     请注意，在安装 Operator 后，当您部署 Fuse 控制台时，您可以选择监控集群中的所有命名空间中的所有应用程序，或仅在安装 Fuse Console Operator 的命名空间中监控应用程序。

   • 对于 Installed Namespace，选择要在其中安装 Fuse Console Operator 的命名空间。

   • 对于 Update Approval，您可以选择 Automatic 或 Manual 来配置 OpenShift 如何处理 Fuse Console Operator 的更新。

     • 如果选择自动 更新，则当有 Fuse Console Operator 的新版本时，OpenShift Operator Lifecycle Manager(OLM)将自动升级运行 Fuse 控制台的运行实例，而无需人为干预。
     • 如果选择手动 更新，则当有新版 Operator 可用时，OLM 会创建更新请求。作为集群管理员，您必须手动批准该更新请求，才能让 Fuse Console Operator 更新至新版本。

6. 点 Install。

   OpenShift 在当前命名空间中安装 Fuse Console Operator。

7. 要验证安装，点 Operators，然后点 Installed Operators。您可以在 Operator 列表中看到 Fuse Console。

8. 使用 OpenShift Web 控制台部署 Fuse 控制台：

   1. 在 Installed Operators 列表的 Name 列下，单击 Fuse Console。

   2. 在 Provided APIs 下的 Operator Details 页面中，点 Create Instance。

      接受配置默认值或有选择性地编辑它们。

      对于 Replicas，如果要提高 Fuse 控制台性能（例如在高可用性环境中），您可以增加分配给 Fuse 控制台的 pod 数量。

      对于 Rbac （基于角色的访问控制），在 config Map 字段中指定一个值，如果您要自定义默认的 RBAC 行为，以及 ConfigMap 文件是否已存在于您安装 Fuse Console Operator 的命名空间中。如需有关 RBAC 的更多信息，请参阅 OpenShift 4.x 上 Fuse 控制台的基于角色的访问控制。

      对于 Nginx，请参阅 Fuse Console Operator 安装的性能调优。

   3. 点 Create。

      Fuse Console Operator Details 页面将打开，并显示部署的状态。

9. 打开 Fuse 控制台：

   1. 对于 命名空间 部署：在 OpenShift Web 控制台中，打开您安装 Fuse Console operator 的项目，然后选择 Overview。在 Project Overview 页面中，向下滚动到 Launcher 部分，再单击 Fuse Console 链接。

      对于 集群部署，在 OpenShift Web 控制台的标题栏中，点网格图标( )。在弹出菜单中 红帽应用程序，单击 Fuse Console URL 链接。

   2. 登录到 Fuse 控制台。

      在浏览器中打开一个 Authorize Access 页面，列出所需权限。

   3. 点击 Allow selected permissions。

      Fuse 控制台在浏览器中打开，并显示您有权访问的 Fuse 应用程序 pod。

10. 为您要查看的应用程序点 Connect。

    这时将打开一个新的浏览器窗口，其中显示 Fuse 控制台中的应用程序。

流程

1. 使用以下命令检索所有模板列表，验证已安装了 Fuse Console 镜像流：

   oc get template -n openshift

   Copy to Clipboard

2. 另外，如果要使用新发行版本标签更新已安装的镜像流，请使用以下命令将 Fuse Console 镜像导入到 openshift 命名空间：

   oc import-image fuse7/fuse-console-rhel8:1.10 --from=registry.redhat.io/fuse7/fuse-console-rhel8:1.10 --confirm -n openshift

   Copy to Clipboard

3. 运行以下命令来获取 Fuse Console APP_NAME 值：

   oc process --parameters -f TEMPLATE-FILENAME

   Copy to Clipboard

   其中 TEMPLATE-FILENAME 是以下模板之一：

   • Cluster 模板：

     `https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-cluster-os4.json`

     Copy to Clipboard

   • 带有可配置 RBAC 的集群模板：

     `https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-cluster-rbac.yml`

     Copy to Clipboard

   • 命名空间模板：

     `https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-namespace-os4.json`

     Copy to Clipboard

   • 使用可配置 RBAC 的命名空间模板：

     `https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-namespace-rbac.yml`

     Copy to Clipboard

     例如，对于带有可配置的 RBAC 的集群模板，请运行这个命令：

     oc process --parameters -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002/fuse-console-cluster-rbac.yml

     Copy to Clipboard

4. 从您在 OpenShift 4.x 上保护 Fuse 控制台 生成的证书，使用以下命令创建 secret 并将其挂载到 Fuse 控制台中（其中 APP_NAME 是 Fuse Console 应用程序的名称）。

   oc create secret tls APP_NAME-tls-proxying --cert server.crt --key server.key

   Copy to Clipboard

5. 通过运行以下命令，基于 Fuse Console 模板的本地副本（其中 myproject 是 OpenShift 项目的名称，mytemp 是包含 Fuse 控制台模板的本地目录的路径），myhost 是用于访问 Fuse 控制台模板的主机名：

   • 对于集群模板：

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002/fuse-console-cluster-os4.json  -p ROUTE_HOSTNAME=myhost

     Copy to Clipboard

   • 对于使用 RBAC 模板的集群：

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002/fuse-console-cluster-rbac.yml -p ROUTE_HOSTNAME=myhost

     Copy to Clipboard

   • 对于命名空间模板：

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002/fuse-console-namespace-os4.json

     Copy to Clipboard

   • 对于带有 RBAC 模板的命名空间：

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002/fuse-console-namespace-rbac.yml

     Copy to Clipboard

6. 要配置 Fuse 控制台，使其可以打开 OpenShift Web 控制台，请运行以下命令来设置 OPENSHIFT_WEB_CONSOLE_URL 环境变量：

   oc set env dc/${APP_NAME} OPENSHIFT_WEB_CONSOLE_URL=`oc get -n openshift-config-managed cm console-public -o jsonpath={.data.consoleURL}`

   Copy to Clipboard

7. 运行以下命令，获取 Fuse Console 部署的状态和 URL：

   oc status

   Copy to Clipboard
8. 要从浏览器访问 Fuse 控制台，请使用第 7 步中返回的 URL（例如 https://fuse-console.192.168.64.12.nip.io）。

1. 在终端窗口中，使用以下命令更改应用程序自定义资源定义的 .spec.version 字段：

   oc patch -n <project-name> <custom-resource-name> --type='merge' -p '{"spec":{"version":"1.7.1"}}'

   Copy to Clipboard

   例如：

   oc patch -n myproject hawtio/example-fuseconsole --type='merge' -p '{"spec":{"version":"1.7.1"}}'

   Copy to Clipboard

2. 检查应用程序的状态已更新：

    oc get -n myproject hawtio/example-fuseconsole

   Copy to Clipboard

   响应显示应用程序的信息，包括版本号：

   NAME                  AGE   URL                                        IMAGE
   example-fuseconsole   1m    https://fuseconsole.192.168.64.38.nip.io   docker.io/fuseconsole/online:1.7.1

   Copy to Clipboard

   更改 .spec.version 字段的值时，OpenShift 会自动重新部署应用。

3. 检查版本更改触发的重新部署状态：

   oc rollout status deployment.v1.apps/example-fuseconsole

   Copy to Clipboard

   成功部署显示这个响应：

   deployment "example-fuseconsole" successfully rolled out

   Copy to Clipboard

流程

1. 启动 OpenShift 4 服务器。

2. 以管理员身份登录 OpenShift 服务器。

   oc login --user system:admin --token=my-token --server=https://my-cluster.example.com:6443

   Copy to Clipboard

3. 验证您是否正在使用为其创建了 docker-registry secret 的项目。

   oc project openshift

   Copy to Clipboard

4. 查看 Samples operator 的当前配置。

   oc get configs.samples.operator.openshift.io -n openshift-cluster-samples-operator -o yaml

   Copy to Clipboard

5. 配置 Samples operator 以忽略添加的 fuse 模板和镜像流。

   oc edit configs.samples.operator.openshift.io -n openshift-cluster-samples-operator

   Copy to Clipboard

6. 添加 Fuse 镜像流 Skipped Imagestreams 部分，并将 Fuse 和 Spring Boot 2 模板添加到跳过的 Templates 部分。

   [...]
   spec:
     architectures:
     - x86_64
     managementState: Managed
     skippedImagestreams:
     - fuse-console-rhel8
     - fuse-eap-openshift-jdk8-rhel7
     - fuse-eap-openshift-jdk11-rhel8
     - fuse-java-openshift-rhel8
     - fuse-java-openshift-jdk11-rhel8
     - fuse-karaf-openshift-rhel8
     - fuse-karaf-openshift-jdk11-rhel8
     - fuse-apicurito-generator-rhel8
     - fuse-apicurito-rhel8
     skippedTemplates:
     - s2i-fuse711-eap-camel-amq
     - s2i-fuse711-eap-camel-cdi
     - s2i-fuse711-eap-camel-cxf-jaxrs
     - s2i-fuse711-eap-camel-cxf-jaxws
     - s2i-fuse711-karaf-camel-amq
     - s2i-fuse711-karaf-camel-log
     - s2i-fuse711-karaf-camel-rest-sql
     - s2i-fuse711-karaf-cxf-rest
     - s2i-fuse711-spring-boot-2-camel-amq
     - s2i-fuse711-spring-boot-2-camel-config
     - s2i-fuse711-spring-boot-2-camel-drools
     - s2i-fuse711-spring-boot-2-camel-infinispan
     - s2i-fuse711-spring-boot-2-camel-rest-3scale
     - s2i-fuse711-spring-boot-2-camel-rest-sql
     - s2i-fuse711-spring-boot-2-camel
     - s2i-fuse711-spring-boot-2-camel-xa
     - s2i-fuse711-spring-boot-2-camel-xml
     - s2i-fuse711-spring-boot-2-cxf-jaxrs
     - s2i-fuse711-spring-boot-2-cxf-jaxws
     - s2i-fuse711-spring-boot-2-cxf-jaxrs-xml
     - s2i-fuse711-spring-boot-2-cxf-jaxws-xml

   Copy to Clipboard

7. 在 OpenShift 镜像流上升级 Fuse。

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002
   
   oc replace -n openshift -f ${BASEURL}/fis-image-streams.json

   Copy to Clipboard

8. 在 OpenShift quickstart 模板上升级 Fuse:

   for template in eap-camel-amq-template.json \
    eap-camel-cdi-template.json \
    eap-camel-cxf-jaxrs-template.json \
    eap-camel-cxf-jaxws-template.json \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json ;
    do
    oc replace -n openshift \
    ${BASEURL}/quickstarts/${template}
    done

   Copy to Clipboard

9. 升级 Spring Boot 2 Quickstart 模板：

   for template in spring-boot-2-camel-amq-template.json \
    spring-boot-2-camel-config-template.json \
    spring-boot-2-camel-drools-template.json \
    spring-boot-2-camel-infinispan-template.json \
    spring-boot-2-camel-rest-3scale-template.json \
    spring-boot-2-camel-rest-sql-template.json \
    spring-boot-2-camel-template.json \
    spring-boot-2-camel-xa-template.json \
    spring-boot-2-camel-xml-template.json \
    spring-boot-2-cxf-jaxrs-template.json \
    spring-boot-2-cxf-jaxws-template.json \
    spring-boot-2-cxf-jaxrs-xml-template.json \
    spring-boot-2-cxf-jaxws-xml-template.json ;
    do oc replace -n openshift \
    ${BASEURL}/quickstarts/${template}
    done

   Copy to Clipboard

10. （可选） 查看 OpenShift 模板上的升级 Fuse:

    oc get template -n openshift

    Copy to Clipboard

1. 通过运行以下命令之一（其中 myproject 是项目的名称），基于 Fuse Console 模板创建新应用：

   • 对于 Fuse Console 集群 模板，其中 myhost 是用于访问 Fuse 控制台的主机名：

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002/fis-console-cluster-template.json -p ROUTE_HOSTNAME=myhost

     Copy to Clipboard

   • 对于 Fuse Console 命名空间 模板：

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002/fis-console-namespace-template.json

     Copy to Clipboard
     注意

     您可以省略 命名空间 模板的 route_hostname 参数，因为 OpenShift 会自动生成一个。

2. 运行以下命令，获取 Fuse Console 部署的状态和 URL：

   oc status

   Copy to Clipboard

3. 要从浏览器访问 Fuse 控制台，请使用提供的 URL。

   Example:

   +https://fuse-console.192.168.64.12.nip.io.

流程

1. 在 OpenShift 项目中的 Applications → Pods 视图中，点击 pod 名称来查看正在运行的 Fuse Pod 的详情。在此页面的右侧，您会看到容器模板的摘要：

   

2. 从此视图中，单击 Open Java Console 链接以打开 Fuse 控制台。

   

1. 在 Camel 标签页的树视图中，单击 Camel 上下文。
2. 选中列表中一个或多个上下文旁边的框。
3. 点 Start 或 Suspend。

4. 删除上下文：

   1. 停止上下文。
   2. 单击 ellipse 图标，然后从下拉菜单中选择 Delete。

1. 在 Camel 标签页的树视图中，点 Camel 应用程序。
2. 若要查看应用属性和值的列表，请单击 Attributes。
3. 要查看应用程序属性的图形表示，请点击 Chart，然后点 Edit 来选择要在 chart 中看到的属性。
4. 要查看 inflight 和 blocked Exchanges，点 Exchanges。
5. 要查看应用程序端点，请点击 Endpoints。您可以根据 URL、路由 ID 和 方向 过滤列表。
6. 要查看、启用和禁用与 Camel 内置类型转换机制相关的统计信息，用于将消息正文和消息标头转换为不同的类型，请点击 Type Converters。
7. 要查看并执行 JMX 操作，如从 XML 添加或更新路由或查找类路径中所有可用的 Camel 组件，请单击 运营。

1. 查看路由列表：

   1. 点 Camel 选项卡。

   2. 在 tree 视图中，点击应用程序的路由文件夹：

      

2. 要启动、停止或删除一个或多个路由：

   1. 选中列表中一个或多个路由旁边的框。
   2. 点 Start 或 Stop。

   3. 要删除路由，您必须首先停止该路由。然后点击 ellipse 图标，然后从下拉菜单中选择 Delete。

      

      注意
      • 当您删除路由时，您可以从部署的应用程序中将其删除。
      • 您也可以在树视图中选择特定的路由，然后单击右上角菜单启动、停止或删除它。
3. 要查看路由的图形图，请单击 Route 图表。
4. 要查看 inflight 和 blocked Exchanges，点 Exchanges。
5. 要查看端点，请单击 Endpoints。您可以根据 URL、Route ID 和方向过滤列表。
6. 点 Type Converters 查看、启用和禁用与 Camel 内置类型转换机制相关的统计信息，该机制用于将消息正文和消息标头转换为不同的类型。

7. 与特定路由交互：

   1. 在 Camel 标签页的树视图中，选择一个路由。
   2. 要查看路由属性和值的列表，请单击 Attributes。
   3. 要查看路由属性的图形表示，请点击 Chart。您可以点击 Edit 来选择要在 chart 中看到的属性。
   4. 要查看 inflight 和 blocked Exchanges，点 Exchanges。
   5. 点击 Operations 在路由上查看并执行 JMX 操作，如转储路由为 XML 或获取路由的 Camel ID 值。

8. 跟踪通过路由的消息：

   1. 在 Camel 标签页的树视图中，选择一个路由。
   2. 选择 Trace，然后单击 Start tracing。

9. 将信息发送到路由：

   1. 在 Camel 标签页的树视图中，打开上下文的端点文件夹，然后选择端点。
   2. 点 Send 子选项卡。
   3. 以 JSON 或 XML 格式配置消息。
   4. 点 Send。
   5. 返回路由的 Trace 选项卡，以查看通过路由的消息流。

1. 在 Camel 标签页的树视图中，选择一个路由。
2. 选择 Debug，然后单击 Start debug。

3. 要添加断点，请在图表中选择节点，然后点 Add breakpoint。一个红色点会出现在节点中：

   

   节点添加到 breakpoints 列表中：

   

4. 点击下箭头以向下一节点或 Play 按钮恢复运行路由。
5. 单击 暂停 按钮，以暂停路由的所有线程。
6. 完成后点 Stop debug。所有断点都会被清除。