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

先决条件

• 有 集群管理员 对 OpenShift 集群的访问权限。

• 如果您要为多个 OpenShift 集群生成证书，并且之前在当前目录中为不同的集群生成证书，请执行以下操作之一以确保为当前集群生成不同的证书：

  • 从当前目录中删除现有证书文件（如 ca.crt、ca.key 和 ca.srl）。

  • 更改到其他工作目录。例如，如果您的当前工作目录命名为 cluster1，请创建一个新的 cluster2 目录，并将工作目录改为其中：

    mkdir ../cluster2

    cd ../cluster2

先决条件

• 您知道用户名。
• 您知道 pod 的名称。

流程

• 要确定用户是否有用于 pod 的 Fuse Console admin 角色，请运行以下命令来查看用户是否可以更新 OpenShift 上的 pod：

  oc auth can-i update pods/<pod> --as <user>

  如果响应是 yes，则用户具有 pod 的 Fuse 控制台 管理员角色。用户可以在 Fuse 控制台中为 pod 执行写入 MBean 操作。

• 要确定用户是否有用于 pod 的 Fuse Console viewer 角色，请运行以下命令来查看用户是否可以在 OpenShift 上获取 pod：

  oc auth can-i get pods/<pod> --as <user>

  如果响应是 yes，则用户具有 pod 的 Fuse Console viewer 角色。用户可以在 Fuse 控制台中为 pod 执行 只读 MBean 操作。根据上下文，Fuse 控制台可防止具有 viewer 角色的用户 执行写入 MBean 操作，方法是禁用一个选项，或者在用户尝试写入 MBean 操作时显示"operation not allowed for this user"消息。

  如果没有，则用户不绑定到任何 Fuse 控制台角色，用户无法在 Fuse 控制台中查看 pod。

其他资源

• OpenShift 4.x 上 Fuse 控制台的基于角色的访问控制
• 在 OpenShift 4.x 上自定义对 Fuse 控制台进行基于角色的访问权限
• 在 OpenShift 4.x 上为 Fuse 控制台禁用基于角色的访问控制

前提条件

• 您可以使用 OperatorHub 或其中一个 Fuse 控制台 RBAC 模板(deployment-cluster-rbac.yml 或 deployment-namespace-rbac.yml)安装 Fuse 控制台。

其他资源

• OpenShift 4.x 上 Fuse 控制台的基于角色的访问控制
• 确定 OpenShift 4.x 上 Fuse 控制台的访问角色
• 在 OpenShift 4.x 上为 Fuse 控制台禁用基于角色的访问控制

其他资源

• OpenShift 4.x 上 Fuse 控制台的基于角色的访问控制
• 确定 OpenShift 4.x 上 Fuse 控制台的访问角色
• 在 OpenShift 4.x 上自定义对 Fuse 控制台进行基于角色的访问权限

先决条件

• 有 集群管理员 对 OpenShift 集群的访问权限。
• 您已安装 Fuse Console Operator，如使用 OperatorHub 在 OpenShift 4.x 上安装和部署 Fuse 控制台 中所述。

• 在部署 Fuse 控制台前设置环境变量：

  1. 在 OpenShift Web 控制台中，安装有 Fuse Console Operator 的项目中，选择 Operators > Installed Operators> Red Hat Integration - Fuse Console。
  2. 单击 Hawtio 选项卡，然后单击 Create Hawtio。
  3. 在 Create Hawtio 页面中，在 Form 视图中，向下滚动到 Config> Nginx 部分。

  4. 展开 Nginx 部分，然后设置环境变量。例如：

     • clientBodyBufferSize: 256k
     • proxyBuffers: 16 128k
     • subrequestOutputBufferSize: 100m
  5. 保存配置。
  6. 点 Create 以部署 Fuse 控制台。
  7. 部署完成后，打开 Deployments> fuse-console 页面，然后点 Environment 来验证环境变量是否在列表中。

• 在部署 Fuse 控制台后设置环境变量：

  1. 在 OpenShift Web 控制台中，打开部署 Fuse 控制台的项目。
  2. 选择 Operators> Installed Operators> Red Hat Integration - Fuse Console。
  3. 单击 Hawtio 选项卡，然后单击 fuse-console。
  4. 选择 Actions> Edit Hawtio。
  5. 在 Editor 窗口中，滚动到 spec 部分。

  6. 在 spec 部分，添加新的 nginx 部分并指定一个或多个环境变量，例如：

     apiVersion: hawt.io/v1alpha1
     kind: Hawtio
     metadata:
       name: fuse-console
     spec:
       type: Namespace
       nginx:
         clientBodyBufferSize: 256k
         proxyBuffers: 16 128k
         subrequestOutputBufferSize: 100m
     .
     .
     .

  7. 点 Save。

     OpenShift 重新部署 Fuse 控制台。

  8. 重新部署完成后，打开 Workloads> Deployments> fuse-console 页面，然后点 Environment 来查看列表中的环境变量。

先决条件

• 有 集群管理员 对 OpenShift 集群的访问权限。
• 您已在 OpenShift 上安装 Fuse 控制台模板，如在 OpenShift 4.x 服务器 上安装 Fuse 镜像流和模板 中所述。

• 在部署 Fuse 控制台前设置环境变量：

  1. 确定您要使用的 Fuse 控制台模板：

     • 集群模板(fuse-console-cluster-os4.json)
     • 带有可配置的 RBAC 的集群模板(fuse-console-cluster-rbac.yml)
     • 命名空间模板(fuse-console-namespace-os4.json)
     • 带有可配置的 RBAC (fuse-console-namespace-rbac.yml)的命名空间模板

  2. 编辑您要用于 Fuse 控制台的 Fuse Console 模板的本地副本，使其包含 NGINX_CLIENT_BODY_BUFFER_SIZE、NGINX_PROXY_BUFFERS 和/或 NGINX_SUBREQUEST_OUTPUT_BUFFER_SIZE 环境变量，如下例所示：

     apiVersion: v1
     kind: DeploymentConfig
     metadata:
       name: fuse-console
     spec:
       template:
         spec:
           containers:
           - env:
             - name: NGINX_CLIENT_BODY_BUFFER_SIZE
               value: 256k
             - name: NGINX_PROXY_BUFFERS
               value: 16 128k
             - name: NGINX_SUBREQUEST_OUTPUT_BUFFER_SIZE
               value: 100m

  3. 保存您的更改。
  4. 按照 在 OpenShift 4.x 中设置 Fuse 控制台 中所述，请按照安装和部署 Fuse 控制台 的步骤进行操作。

• 在部署 Fuse 控制台后设置环境变量：

  1. 在终端窗口中，登录到 OpenShift 集群。

  2. 打开部署 Fuse 控制台的项目。例如，如果在 myfuse 项目中部署了 Fuse 控制台，请使用以下命令：

     oc project myfuse

  3. 获取 Fuse 控制台部署的名称：

     oc get deployments

     此命令返回在当前项目中运行的部署列表。例如：

     NAME                        READY   UP-TO-DATE   AVAILABLE    AGE
     fuse-console                1/1     1               1           114m

  4. 运行以下命令，为 Fuse 控制台部署设置环境变量：

     oc set env dc/fuse-console NGINX_CLIENT_BODY_BUFFER_SIZE="256k"
     
     oc set env dc/fuse-console NGINX_PROXY_BUFFERS="16 128k"
     
     oc set env dc/fuse-console NGINX_SUBREQUEST_OUTPUT_BUFFER_SIZE="10m"

     OpenShift 重新部署 Fuse 控制台。

  5. 重新部署完成后，验证环境变量设置：

     1. 获取 Fuse Console pod 名称：

        oc get pods

     2. 运行以下命令来查看环境设置

        oc exec <fuse-console-podname> -- cat /opt/app-root/etc/nginx.d/nginx-gateway.conf | grep "Performance tuning" -A 3

        例如，如果 pod 名称是 fuse-console-6646cbbd4c-9rplg，请运行以下命令：

        oc exec fuse-console-6646cbbd4c-9rplg -- cat /opt/app-root/etc/nginx.d/nginx-gateway.conf | grep "Performance tuning" -A 3