2.4. 在 OpenShift 4.x 中设置 Fuse 控制台

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

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

   Create Operator Subscription 表单将打开。

   • 对于 更新频道，请选择 7.13.x。

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

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

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

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

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

6. 点 Install。

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

7. 要验证安装，点 Operators，然后点 Installed Operators。您可以在操作器列表中看到 Fuse 控制台。

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 行为，并且是否安装了 Fuse Console Operator 的命名空间中已存在 ConfigMap 文件。如需有关 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 控制台 URL 链接。

   2. 登录到 Fuse 控制台。

      浏览器中打开了 Authorize Access 页面，其中列出了所需权限。

   3. 点击 Allow selected permissions。

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

10. 对于您要查看的应用程序，点 Connect。

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

流程

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

   oc get template -n openshift

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

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

   oc process --parameters -f TEMPLATE-FILENAME

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

   • 集群模板：

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-cluster-os4.json

   • 使用可配置的 RBAC 的集群模板：

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-cluster-rbac.yml

   • 命名空间模板：

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-namespace-os4.json

   • 带有可配置的 RBAC 的命名空间模板：

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-namespace-rbac.yml

     例如，对于使用可配置的 RBAC 的集群模板，请运行以下命令：

     oc process --parameters -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-cluster-rbac.yml

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

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

   • 对于集群模板：

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

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

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

   • 对于命名空间模板：

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-namespace-os4.json

   • 对于使用 RBAC 模板的命名空间：

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-namespace-rbac.yml

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}`

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

   oc status

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"}}'

   例如：

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

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

    oc get -n myproject hawtio/example-fuseconsole

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

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

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

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

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

   成功部署会显示这个响应：

   deployment "example-fuseconsole" successfully rolled out

流程

1. 启动 OpenShift 4 服务器。

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

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

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

   oc project openshift

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

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

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

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

6. 添加 Fuse imagestreams Skipped Imagestreams 部分，并将 Fuse 和 Spring Boot 2 模板添加到 Skipped 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-fuse713-eap-camel-amq
     - s2i-fuse713-eap-camel-cdi
     - s2i-fuse713-eap-camel-cxf-jaxrs
     - s2i-fuse713-eap-camel-cxf-jaxws
     - s2i-fuse713-karaf-camel-amq
     - s2i-fuse713-karaf-camel-log
     - s2i-fuse713-karaf-camel-rest-sql
     - s2i-fuse713-karaf-cxf-rest
     - s2i-fuse713-spring-boot-2-camel-amq
     - s2i-fuse713-spring-boot-2-camel-config
     - s2i-fuse713-spring-boot-2-camel-drools
     - s2i-fuse713-spring-boot-2-camel-infinispan
     - s2i-fuse713-spring-boot-2-camel-rest-3scale
     - s2i-fuse713-spring-boot-2-camel-rest-sql
     - s2i-fuse713-spring-boot-2-camel
     - s2i-fuse713-spring-boot-2-camel-xa
     - s2i-fuse713-spring-boot-2-camel-xml
     - s2i-fuse713-spring-boot-2-cxf-jaxrs
     - s2i-fuse713-spring-boot-2-cxf-jaxws
     - s2i-fuse713-spring-boot-2-cxf-jaxrs-xml
     - s2i-fuse713-spring-boot-2-cxf-jaxws-xml

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

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

8. 在 OpenShift 快速启动模板上升级 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

9. 升级 Spring Boot 2 快速启动模板：

   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

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

    oc get template -n openshift