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. 使用以下命令验证是否安装了 Fuse Console 镜像流，以检索所有模板的列表：

   oc get template -n openshift

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

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

3. 将以下 Fuse 控制台模板从原始格式 https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-750056-redhat-00006 下载到您选择的本地目录（例如，mytemp）。

   • 集群模板： fuse-console-cluster-os4.json
   • 命名空间模板： fuse-console-namespace-os4.json

4. 对于命名空间模板，请跳至下一步。

   对于集群模板，在您选择的编辑器中编辑 fuse-console-cluster-os4.json 文件的本地副本，将 "grantMethod": "auto" 属性添加到 OAuthClient 部分：

   {
         "kind": "OAuthClient",
         "apiVersion": "v1",
         "metadata": {
           "name": "${APP_NAME}-oauth-client"
         },
         "grantMethod": "auto",
         "redirectURIs": [
           "https://${ROUTE_HOSTNAME}"
         ]
   }

5. 运行以下命令来获取 Fuse Console APP_NAME 值（其中 mytemp 是包含 Fuse Console 模板的本地目录的路径）：

   • 对于集群模板：

     oc process --parameters -f mytemp/fuse-console-cluster-os4.json

   • 对于命名空间模板：

     oc process --parameters -f mytemp/fuse-console-namespace-os4.json

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

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

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

   • 对于集群模板：

     oc new-app -n myproject -f mytemp/fuse-console-cluster-os4.json -p ROUTE_HOSTNAME=myhost

   • 对于命名空间模板：

     oc new-app -n myproject -f mytemp/fuse-console-namespace-os4.json

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

   oc status

9. 要从浏览器访问 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。