2.2. 在 OpenShift 4.x 服务器上安装 Fuse 镜像流和模板

流程

1. 以具有集群管理员访问权限的用户身份登录 OpenShift：

   oc login -u <user_with_cluster_admin_role>

2. 执行以下命令来检索服务签名证书颁发机构密钥：

   • 检索证书：

     oc get secrets/signing-key -n openshift-service-ca -o "jsonpath={.data['tls\.crt']}" | base64 --decode > ca.crt

   • 检索私钥：

     oc get secrets/signing-key -n openshift-service-ca -o "jsonpath={.data['tls\.key']}" | base64 --decode > ca.key

3. 生成客户端证书，如 Kubernetes 证书管理 中所述，使用 easyrsa、openssl 或 cfssl。

   以下是使用 openssl 的示例命令：

   1. 生成私钥：

      openssl genrsa -out server.key 2048

   2. 编写 CSR 配置文件。

      cat <<EOT >> csr.conf
        [ req ]
        default_bits = 2048
        prompt = no
        default_md = sha256
        distinguished_name = dn
      
        [ dn ]
        CN = fuse-console.fuse.svc
      
        [ v3_ext ]
        authorityKeyIdentifier=keyid,issuer:always
        keyUsage=keyEncipherment,dataEncipherment,digitalSignature
        extendedKeyUsage=serverAuth,clientAuth
      EOT

   3. 生成 CSR：

      openssl req -new -key server.key -out server.csr -config csr.conf

   4. 发布签名证书：

      openssl x509 -req -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out server.crt -days 10000 -extensions v3_ext -extfile csr.conf

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

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

   Create Operator Subscription 表单将打开。

   • 对于 安装模式，您可以将 Fuse Console Operator 安装到特定命名空间（当前 OpenShift 项目）。

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

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

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

7. 点 Subscribe.

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

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

9. 在终端窗口中，使用以下命令，使用您在 OpenShift 4.x 上保护 Fuse 控制台 生成的证书来创建 secret 并在 Fuse 控制台中挂载它，其中 APP_NAME 是 Fuse Console Deployment 的名称（如 fuse-console）。

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

   例如，如果 Fuse Console 应用程序的名称是 fuse-console，请输入以下命令：

   oc create secret tls fuse-console-tls-proxying --cert server.crt --key server.key

   如果成功，这个命令会返回一个响应来确认创建了 secret，例如：

   secret/fuse-console-operator-tls-proxying created

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

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

    2. 在 Provided APIs 下的 Overview 页面中，点 Create Instance。此时会打开一个新的自定义资源定义(CRD)文件。

       默认情况下，Fuse Console 部署到当前命名空间中。

    3. 如果要部署 Fuse 控制台来发现和管理当前命名空间中的应用程序，请跳至下一步。

       另外，如果要部署 Fuse 控制台，以在集群中的所有命名空间中发现和管理应用程序（以及您是一个经过身份验证的用户），请通过将 spec.type 字段的值从 namespace 改为 cluster 来编辑 CRD 文件。

    4. 点 Create。

       Fuse Console CRD 页面将打开显示新的 Fuse 控制台服务。

11. 打开 Fuse 控制台：

    1. 获取 Fuse 控制台 URL：

       • 在 OpenShift Web 控制台中，选择 Networking > Routes。
       • 在命令行中键入 oc get routes 命令。

    2. 在 Web 浏览器中，打开 Fuse 控制台 URL，然后登录。

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

    3. 点击 Allow selected permissions。

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

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

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

流程

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

   oc get template -n openshift

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

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

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

   • 对于集群模板：

     oc process --parameters -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003/fuse-console-cluster-os4.json

   • 对于命名空间模板：

     oc process --parameters -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003/fuse-console-namespace-os4.json

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. 运行以下命令创建新应用（其中 $project 是 OpenShift 项目的名称，$APP_NAME 是以上步骤中获取的应用程序的名称，$DOMAIN_NAME 是用于访问 Fuse 控制台的主机名：

   • 对于集群模板：

     oc new-app -n $project -f {templates-base-url}/fuse-console-cluster-os4.json -p ROUTE_HOSTNAME=$APP_NAME.$DOMAIN_NAME -p APP_NAME=$APP_NAME

   • 对于命名空间模板：

     oc new-app -n myproject -f {templates-base-url}/fuse-console-namespace-os4.json

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

   oc status

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

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

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

   例如：

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

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

    oc get myproject

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

   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 Web 控制台中，点 Operators，然后点 Installed Operators。
2. 在 Name 列中，单击 API Designer。

3. 在 Provided APIs 下，点 Create Instance。

   此时会打开 API Designer 实例的最小起始模板的默认表单。

4. 接受默认值或选择性地编辑以下值：

   • 大小 ： API Designer 实例的 pod 数量。

     默认为三个用于新资源类型的 pod，其中包含特定于管理 API Designer 的逻辑。

   • 镜像 ：API 设计器镜像。如果您更改了此镜像，API Designer Operator 会自动在集群中升级。
5. 单击 Create 以创建一个新的 apicurito-service。OpenShift 启动用于新 API Designer 服务的 pod、服务和其他组件。

6. 验证 API Designer 服务是否可用：

   1. 点 Operators，然后点 Installed Operators。

   2. 在 Provided APIs 列中，点 Apicurito CRD。

      在 Operator Details 页面中，会列出 apicurito-service。

7. 获取 API Designer 的 URL：

   1. 点 Networking > Routes。
   2. 确保选择了正确的项目。
   3. 在 apicurito-service 行中，在 Location 列中找到 API Designer Web 控制台的 URL。