摘要 本文档列出了 Red Hat OpenShift Local 2.26 的新功能和改进的功能。它还包含有关在使用软件时可 能会遇到的潜在问题的信息。在可能的情况下，会针对发现的问题进行临时解决方案。 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Local 2.26 发 发行注 行注记 记和已知 和已知问题 问题 6 第 2 章 已知问题 Red Hat OpenShift Local 2.26 用户可能遇到的问题，以及这些问题的可能的临时解决方案。 2.1. 常规问题 影响所有支持的平台的问题。 2.1.1. 代理设置错误地应用到 Podman 预设置 当使用 Podman preset 时，使用 crc config set 命令配置的代理设置不会被 Monitoring。 临时解决方案 再次禁用监控： 1. 删除虚拟机： $ crc delete 2. 创建虚拟机： $ crc start 2.1.3. 启用多个 Operator 需要的内存超过默认值 默认情况下，crc start 命令将 9 GiB 内存分配给 Red Hat OpenShift Local 虚拟机。启用多个 Operator 可能会增加内存要求。 临时 临时解决方案 解决方案

如果您在执行本文档所述的某个流程或 OpenShift Container Platform 时遇到问题，请访问 红帽客户门户 网站。 通过红帽客户门户网站： 搜索或者浏览红帽知识库，了解与红帽产品相关的文章和解决方案。 提交问题单给红帽支持。 访问其他产品文档。 要识别集群中的问题，您可以在 OpenShift Cluster Manager 中使用 Insights。Insights 提供了问题的详细 目前，在未部署网关时，Tempo 查询前端服务不得使用内部 mTLS。这个问题不会影响 Jaeger Query API。解决办法是禁用 mTLS。(TRACING-3510) 临时 临时解决方案 解决方案 禁用 mTLS，如下所示： 1. 运行以下命令，打开 Tempo Operator ConfigMap 进行编辑： OpenShift Container Platform 4.14 分布式追踪 的镜像。Red Hat OpenShift distributed tracing Platform (Tempo) CSV 缺少对操作对象镜像的引用。(TRACING-3523) 临时 临时解决方案 解决方案 在镜像工具中添加 Tempo Operator 相关镜像，将镜像复制到 registry： 1.2.6. Red Hat build of OpenTelemetry 重要 重要 $

OpenShift Virtualization 。不支持由其他 云提供商提供的裸机服务器。 3.6. 程序错误修复 如果您在克隆源可用前启动克隆操作，克隆操作现在可以成功完成，而无需使用临时解决方案。 (BZ#1855182) 如果虚拟机在版本 4.8 之前引用 OpenShift Virtualization 提供的已删除模板，则编辑虚拟机会失 败。在 OpenShift Virtualization ocs-storagecluster-cephfs 存储类的虚 拟机无法迁移，虚拟机状态变为 Paused。这是因为两个 pod 会尝试同时访问共享 ReadWriteMany CephFS 卷。(BZ#2092271) 作为临时解决方案，使用 ocs-storagecluster-ceph-rbd 存储类在使用 Red Hat Ceph Storage 的集群上实时迁移虚拟机。 更新至 OpenShift Virtualization 字段设置为相对路径，会出现这种情况。 作为临时解决方案，删除并重新创建 VM 清单，将 spec.volumes.containerDisk.path 字段 的值设置为绝对路径。然后您可以更新 OpenShift Virtualization。 如果单个节点包含超过 50 个镜像，pod 调度可能会在节点间进行平衡。这是因为节点上的镜像 列表默认简写为 50。(BZ#1984442) 作为临时解决方案，您可以通过编辑 KubeletConfig

推荐的 ETCD 实践 1.6. 将 ETCD 移动到不同的磁盘 1.7. 分离 ETCD 数据 1.8. OPENSHIFT CONTAINER PLATFORM 基础架构组件 1.9. 移动监控解决方案 1.10. 移动默认 REGISTRY 1.11. 移动路由器 1.12. 基础架构节点大小 1.13. 其他资源 第 第 2 章 章 IBM Z 和 和 LINUXONE 环 环境的推荐主机 enterprise Kubernetes 文档中的 "Red Hat OpenShift control plane and infrastructure nodes"部分。 1.9. 移动监控解决方案 监控堆栈包含多个组件，包括 Prometheus、Grafana 和 Alertmanager。Cluster Monitoring Operator 管 理此堆栈。要将监控堆栈重新部署到基础 密集型的，那么您可能无法 在不对性能造成影响的情况下使用高的比率。对于高 I/O 密集型工作负载，即便具有较高的过量 使用比率，也能保持一致的性能。 其他 其他资 资源 源 Z/VM 通用性能问题和解决方案 Z/VM 过量使用注意事项 LPAR CPU 管理 2.2. 禁用透明巨页 Transparent Huge Pages (THP) 会试图自动执行创建、管理和使用巨页的大部分方面。由于

Pytorch 等机器学习框架。 注意 注意 不支持在 CephFS 持久性卷上运行 PostgresSQL 工作负载，建议使用 RADOS 块设备 (RBD) 卷。如需更多信息，请参阅知识库文章解决方案 ODF 数据库工作负载必须不使用 CephFS PV/PVC。 Red Hat OpenShift Data Foundation 版本 4.x 由一组软件项目组成，包括： Ceph，提供块 目前，Cryptographic Module Validation Program (CMVP) 用于处理加密模块。您可以在modules in Process List 中查看这些模块的状态。有关最新信息，请参阅红帽知识库解决方案 RHEL 内核加密组件。 注意 注意 在安装 OpenShift Data Foundation 前，在 OpenShift Container Platform 上启用 FIPS 模 式。OpenShift Foundation 订阅提供高级或标准支持。 6.2. 灾难恢复订阅要求 Red Hat OpenShift Data Foundation 支持的灾难恢复功能需要满足以下所有先决条件，才能成功实施灾 难恢复解决方案： 有效的 Red Hat OpenShift Data Foundation 高级授权 有效的 Red Hat Advanced Cluster Management for Kubernetes

system:openshift:discovery (BZ#1821771) oc annotate 命令不适用于包含了等号（=）的 LDAP 组名称，因为命令使用等号作为注释名称和 值之间的分隔符。作为临时解决方案，使用 oc patch 或 oc edit 添加注解。(BZ#1917280) 如果安装程序无法获取与 Google Cloud Platform (GCP)服务帐户关联的所有项目，安装会失 败，并显示 cluster 没有现有安装配置文件 (install-config.yaml) 错误 错误消息 消息 带有现有安装配置文件创建清单的 openshift-install 错误 错误消息 消息 作为临时解决方案，如果您有一个安装配置文件，使用特定的项目 ID 更新该文件，使其 使用 platform.gcp.projectID。否则，手动创建安装配置文件，并输入特定的项目 ID。 再次运行安装程序，指定该文件。(OCPBUGS-15238) 在大型计算节点上引导失败。(OCPBUGS-20075) 当您在 IBM Power® 上部署带有 Network Type 为 OVNKubernetes 的集群时，计算节点可能会 因为内核堆栈溢出而重启。作为临时解决方案，您可以使用 Network Type 为 OpenShiftSDN 部 署集群。(RHEL-3901) 以下已知问题适用于使用版本 candidate 3 或 4 将 OpenShift Container

Container Platform 提供的所有其他标准保护。OpenShift Kubernetes Engine 提供对 OpenShift Container Platform 使用的集成监控解决方案的完整访问权限，该解决方案基 于 Prometheus，并为常见 Kubernetes 问题提供深入的覆盖范围和警报。 OpenShift Kubernetes Engine 使用与 OpenShift Container Storage 兼容并提供支持。 2.1.7. Red Hat Middleware 兼容 OpenShift Kubernetes Engine 与独立的 Red Hat Middleware 产品解决方案兼容并提供支持。包括 OpenShift 的 Red Hat Middleware Bundles 仅包含 OpenShift Container Platform。 2.1.8. OpenShift {rh-rhacm-first} for Kubernetes 兼容。OpenShift Kubernetes Engine 订阅不提供集群范围的日志聚合解决方案，或支持 Elasticsearch、Fluentd 或基于 Kibana 的日志记录解决方案。同样，OpenShift Container Platform 或 console.redhat.com Cost Management SaaS 服务中的计费功能也不支持

镜像与集群升级到的版本 匹配。另外，您的 Ignition 配置文件必须修改为与 spec v3 兼容。如需了解更多详细信息和 Ignition 配置 文件示例，请参阅 升级到 OpenShift 4.6+ 知识库解决方案后向 UPI 集群添加新节点会失败 。 1.2.1.6. 现 现在，支持 在，支持 RHCOS 和 和 MCO 的 的扩 扩展 展 对于默认的 RHCOS 安装，RHCOS 和 MCO 现在支持以下扩展。 Platform 4.6 中，除了默认的平台监控外，您还可以为用户定义的项目启用监 控。现在，您可以监控 OpenShift Container Platform 中的自己的项目，而无需额外的监控解决方案。使 用这个新功能，可以集中监控核心平台组件和用户定义项目。 使用这个新功能，您可以执行以下任务： 为用户定义的项目启用和配置监控 创建使用您自己的 pod 和服务的指标的记录和警报规则 Operator（EO）试图重启集群时重新生成证书。这会导致 EO 和集 群间的通信问题，从而导致 EO 节点有不匹配的证书。 不匹配的证书在升级 Elasticsearch 时可能会导致问题。作为临时解决方案，您可以选择性地单独 升级 CLO 和 EO。如果无法正常工作，请运行以下命令重启 Elasticsearch Pod： pod 重启后，不匹配的证书会被修复，从而解决了升级问题。(BZ#1906641)

ServiceMeshExtension 检查问题，您会看到以下错 误：stderr: Error create mount namespace before pivot: function not implemented。 临时解决方案：ServiceMeshExtension 在 Service Mesh 2.2 中已弃用。从 ServiceMeshExtension 迁移到 WasmPlugin 资源。如需更多信息，请参阅从 在为服务网格 control plane 中为 ingressgateway 配置 Service ExternalIP 时，不会 创建该服务。SMCP 的 schema 缺少该服务的参数。 临时解决方案：禁用 SMCP spec 中的网关创建，手动管理网关部署（包括 Service、Role 和 RoleBinding）。 OSSM-882 适用于 Service Mesh 2.1 及更早版本。命名空间位于 的命名空间并将其添加到 Service Mesh member roll 中，Kiali UI 不会显示这个命名空间。这是因为对于定义的排除特征，软件会排除以定义特征开始 或包括定义特征的命名空间。 临时解决方案：更改 Kiali 自定义资源设置，以便使用尖号 (^) 前缀设置。例如： api: namespaces: exclude: 第 第 1 章 章 SERVICE MESH 2.X

source image。当镜像索引包括对镜像 registry 中不再存在的镜像的引用 时，会发生此错误。镜像索引可能会保留旧的引用，以便为运行这些镜像 的用户在升级图表中显示新的升级路径。作为临时解决方案，您可以使用 --skip-missing 选项绕过错误并继续下载镜像索引。如需更多信息，请参 阅 Service Mesh Operator 镜像失败。 如果本地容器 registry 连接到镜像主机，请执行以下操作： source image。当镜像索引包括对镜像 registry 中不再存在的镜像的引用时，会 发生此错误。镜像索引可能会保留旧的引用，以便为运行这些镜像的用户在升级图 表中显示新的升级路径。作为临时解决方案，您可以使用 --skip-missing 选项绕 过错误并继续下载镜像索引。如需更多信息，请参阅 Service Mesh Operator 镜像 失败。 oc adm catalog mirror 不支持嵌套存储库。因此，运行 oc adm catalog mirror 命令会失 败，并显示 401 未授权错误。作为临时解决方案，您可以在运行 oc adm catalog mirror 命令时使用 --max-components=2 选项来禁用嵌套存储库的创建。有关此 临时解决方案的更多信息，请参阅 Unauthorized error thrown while using catalog mirror