发行注记和已知问题
Red Hat OpenShift Local 2.22 中突出显示的功能和识别的问题
Fabrice Flore-Thebault
ffloreth@redhat.comdevtools-docs@redhat.com
摘要
使开源包含更多
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情,请参阅我们的首席技术官 Chris Wright 提供的消息。
第 1 章 发行注记
这些是 Red Hat OpenShift Local 2.22 产品中最重要的功能和程序错误修复。
1.1. 组件版本
Red Hat OpenShift Local 2.22 有以下主要组件版本:
表 1.1. Red Hat OpenShift Local, 组件版本
| 组件 | Version |
|---|---|
| OpenShift Container Platform | 4.13.3 |
|
OpenShift 客户端二进制( | v4.13.3 |
| Podman 二进制文件 | 4.4.4 |
1.2. 最低系统要求
Red Hat OpenShift Local 有以下最低硬件和操作系统要求。
1.2.1. 硬件要求
Red Hat OpenShift Local 在以下构架中被支持:
表 1.2. 预设置和架构兼容性
| preset | AMD64 | Intel 64 | M1 |
|---|---|---|---|
| OpenShift Container Platform | 是 | 是 | 是 |
| MicroShift | 是 | 是 | 是 |
| podman 容器运行时 | 是 | 是 | 是 |
Red Hat OpenShift Local 不支持嵌套虚拟化。
根据所需的容器运行时,Red Hat OpenShift Local 需要以下系统资源:
1.2.1.1. 对于 OpenShift Container Platform
- 4 个物理 CPU 内核
- 9 GB 可用内存
- 35 GB 存储空间
1.2.1.2. 对于 MicroShift
- 2 个物理 CPU 内核
- 4 GB 可用内存
- 35 GB 存储空间
OpenShift Container Platform 和 MicroShift 预设置需要这些最小资源在 Red Hat OpenShift Local 实例中运行。有些工作负载可能需要更多资源。要为 Red Hat OpenShift Local 实例分配更多资源,请参阅配置实例。
1.2.1.3. 对于 Podman 容器运行时
- 2 个物理 CPU 内核
- 2 GB 可用内存
- 35 GB 存储空间
1.2.2. 操作系统要求
Red Hat OpenShift Local 需要以下支持的操作系统的最低版本:
1.2.2.1. Microsoft Windows 的要求
- 在 Microsoft Windows 上,Red Hat OpenShift Local 需要 Windows 10 Fall Creators Update (版本 1709)或更新版本。Red Hat OpenShift Local 不适用于早期版本的 Microsoft Windows。不支持 Microsoft Windows 10 Home Edition。
1.2.2.2. macOS 的要求
- 在 macOS 中,Red Hat OpenShift Local 需要 macOS 11 Big Sur 或更高版本。Red Hat OpenShift Local 在早期版本的 macOS 中无法正常工作。
1.2.2.3. Linux 的要求
- 在 Linux 中,Red Hat OpenShift Local 仅在最新两个 Red Hat Enterprise Linux/CentOS 8 和 9 个次版本中被支持,以及最新的两个稳定 Fedora 版本。
- 使用 Red Hat Enterprise Linux 时,运行 Red Hat OpenShift Local 的 机器必须使用红帽客户门户网站 进行注册。
- 不支持 Ubuntu 18.04 LTS 或更高版本以及 Debian 10 或更高版本,可能需要手动设置主机机器。
- 请参阅 为您的 Linux 发行版本安装所需的软件包。
1.3. 更改和增强
Red Hat OpenShift Local 2.22 中引入了一些显著变化。
1.4. 主要改进
- 您可以使用 Red Hat OpenShift Local 进行开发和测试目的。
Red Hat OpenShift Local 在您的计算机上安装其中一个预设:
openshift- 最少的预配置 OpenShift Container Platform 4.13 集群。
microshift- MicroShift.
podman- podman 容器运行时。
preset 在 Red Hat Enterprise Linux 虚拟机(在原生 hypervisor)中运行,在这些平台上:
- Linux
- macOS
- Microsoft Windows 10
1.5. 技术预览
对这些功能的支持属于 技术预览功能支持范围。
-
Red Hat OpenShift Local 2.22 包括了根据当前运行的使用
crc bundle generate命令创建自定义捆绑包的功能。这个命令、其参数和行为可能会在以后的版本中以不兼容的方式改变。
1.6. 主要变化
-
Red Hat OpenShift Local 2.22 在嵌入式 OpenShift 预设置(
openshift)中提供 OpenShift Container Platform 4.13.3。 -
Red Hat OpenShift Local 2.22 在嵌入式 Podman 容器引擎预设置(
podman)中提供 Podman 4.4.4。 -
Red Hat OpenShift Local 2.22 在嵌入式 MicroShift 预设置(
microshift)中提供 MicroShift 4.13.3。
1.6.1. 当属性没有设置时,CRC config get 会返回默认值
在以前的版本中,当设置具有默认值时,crc 配置会返回错误代码。在这个版本中,它返回默认值。
其他资源
1.6.2. 修复了设置过程中下载错误
在以前的版本中,设置失败并显示错误: 无法为默认捆绑包获得验证的哈希值。在这个版本中,在 crc setup 中修复了捆绑包哈希下载错误。
其他资源
1.6.3. 为 MicroShift 预设置重新定义磁盘大小
在以前的版本中,无法调整 MicroShift 预设置磁盘的大小。在这个版本中,为 MicroShift 预设置添加了 disk-resize 功能。
其他资源
1.6.4. 修复了来自容器内的 DNS 查找
在以前的版本中,Red Hat OpenShift Local DNS 服务的 DNS 信息可能会超过 512B,有些客户端可能无法处理消息。在这个版本中,DNS 消息会被压缩,容器可能会降低 DNS 信息。
其他资源
第 2 章 已知问题
Red Hat OpenShift Local 2.22 用户可能遇到的问题,以及这些问题的可能的临时解决方案。
2.1. 常规问题
影响所有支持的平台的问题。
2.1.1. 代理设置错误地应用到 Podman 预设置
当使用 Podman preset 时,使用 crc config set 命令配置的代理设置不会被 Red Hat OpenShift Local 中嵌入的 podman-remote 二进制文件使用。
2.1.2. Red Hat OpenShift Local 默认禁用指标
为确保 Red Hat OpenShift Local 可以在典型的笔记本上运行,Red Hat OpenShift Local 会禁用一些资源密集型服务,如 Prometheus 以及所有相关监控、警报和遥测功能。您可以启用这些功能。
流程
- 请参阅 配置虚拟机以分配 更多资源
- 请参阅 启动 Monitoring、Alerting 和 Telemetry
在启用这些功能后,您无法禁用 Monitoring。
临时解决方案
再次禁用监控:
删除虚拟机:
$ crc delete
创建虚拟机:
$ crc start
2.1.3. 启用多个 Operator 需要的内存超过默认值
默认情况下,crc start 命令将 9 GiB 内存分配给 Red Hat OpenShift Local 虚拟机。启用多个 Operator 可能会增加内存要求。
临时解决方案
- 请参阅 配置虚拟机以分配 额外内存。
2.1.4. 当第一个 名称服务器是 IPv6 时,Red Hat OpenShift Local 无法正常工作
如果第一个 名称服务器是 IPv6,则对 Red Hat OpenShift Local 虚拟机的 DNS 解析可能会失败。
临时解决方案
使用
-n标志启动 Red Hat OpenShift Local 虚拟机时,指定 IPv4名称服务器:$ crc start -n 8.8.8.8
2.1.5. 运行 crc 设置可能会 为您提供一个已知的错误
运行 crc setup 命令时,您可能会遇到以下错误:
unable to get verified hash for default bundle: Get "https://developers.redhat.com/content-gateway/file/pub/openshift-v4/clients/crc/bundles/openshift/4.12.13/sha256sum.txt.sig": context deadline exceeded (Client.Timeout exceeded while awaiting headers)
临时解决方案
-
尝试运行
crc setup命令,将错误解决。
2.2. Microsoft Windows 上的问题
本节论述了影响 Microsoft Windows 主机上用户的 Red Hat OpenShift Local 问题。
2.2.1. 使用 Microsoft 标准安装程序(MSI)在安装后完成安装
流程
- 使用 MSI 安装程序安装 Red Hat OpenShift Local
- 重启您的计算机
在 Command Prompt 或 PowerShell 中运行命令:
$ crc setup
2.2.2. crc cleanup 命令可能会失败,并显示权限错误
在命令间运行 crc setup,并在命令间重启主机计算机会导致 报告以下错误:
crc cleanup
Post "http://unix/clean": open \\.\pipe\crc-admin-helper: Access is denied.
临时解决方案
- 重启您的计算机
运行命令:
$ crc cleanup
2.2.3. 在 %WINDRIVE%之外运行时的意外行为
当您从网络驱动器启动 crc 二进制文件时,Hyper-V 驱动程序将失败。
临时解决方案
将
crc二进制文件移到%WINDRIVE%上的位置。%WINDRIVE%通常设置为C:\。
2.2.4. Red Hat OpenShift Local 需要 PowerShell 中的 完全语言支持
Red Hat OpenShift Local 支持 ConstrainedLanguage PowerShell 模式,但系统管理员决定例外。
2.2.5. crc oc-env 命令无法使用 %PATH%中的特殊字符。
在 Microsoft Windows 上,PowerShell 和命令提示不使用 UTF-8 编码。因此,运行带有 %PATH% 中的特殊字符的 crc oc-env 命令将无法准确编码 UTF-8 字符。
临时解决方案
-
将
crc二进制文件移到不包含特殊字符的位置。
其他资源
- 如需了解 Red Hat OpenShift Local 的功能和 OpenShift Container Platform 简介,请参阅"Red Hat OpenShift Local""入门指南 "。
-
报告 Red Hat OpenShift Local 的问题或请求功能,使用 Red Hat Bugzilla 中的 OpenShift Container Platform 产品和
crc组件。
2.3. macOS 的问题
本节论述了影响 macOS 主机上用户的 Red Hat OpenShift Local 问题。
2.3.1. Hibernation 会导致虚拟机时间不同步
Red Hat OpenShift Local 虚拟机中的时间可能会与主机上的时间不同步。如果主机进入休眠时,Red Hat OpenShift Local 虚拟机正在运行。
临时解决方案
停止 Red Hat OpenShift Local 虚拟机:
$ crc stop
重启 Red Hat OpenShift Local 虚拟机:
$ crc start