发行注记和已知问题
Red Hat OpenShift Local 2.14 中突出显示的功能并发现问题
Fabrice Flore-Thebault
ffloreth@redhat.comdevtools-docs@redhat.com
摘要
使开源包含更多
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情,请参阅我们的首席技术官 Chris Wright 提供的消息。
部分 I. 发行注记
本节记录了 Red Hat OpenShift Local 2.14 产品中最重要的功能和程序错误修复。
第 1 章 组件版本
Red Hat OpenShift Local 2.14 有以下主要组件版本:
表 1.1. Red Hat OpenShift Local, 组件版本
| 组件 | 版本 |
|---|---|
| OpenShift Container Platform | 4.12.1 |
|
OpenShift 客户端二进制( | v4.12.1 |
| podman 二进制文件 | 4.3.1 |
第 2 章 最低系统要求
Red Hat OpenShift Local 具有以下最低硬件和操作系统要求。
2.1. 硬件要求
Red Hat OpenShift Local 在 AMD64、Intel 64 和 Apple Silicon 构架上被支持。Red Hat OpenShift Local 不支持嵌套虚拟化。
根据所需的容器运行时,Red Hat OpenShift Local 需要以下系统资源:
2.1.1. 对于 OpenShift Container Platform
- 4 个物理 CPU 内核
- 9 GB 可用内存
- 35 GB 存储空间
OpenShift Container Platform 集群要求这些最小资源在 Red Hat OpenShift Local 实例中运行。有些工作负载可能需要更多资源。要为 Red Hat OpenShift Local 实例分配更多资源,请参阅配置实例。
2.1.2. 对于 Podman 容器运行时
- 2 个物理 CPU 内核
- 2 GB 可用内存
- 35 GB 存储空间
2.2. 操作系统要求
Red Hat OpenShift Local 需要以下支持的操作系统的最低版本:
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。
2.2.2. macOS
- 在 macOS 上,Red Hat OpenShift Local 需要 macOS 11 领导 Sur 或更高版本。Red Hat OpenShift Local 无法在早期版本的 macOS 上工作。
2.2.3. Linux
- 红帽在 Red Hat Enterprise Linux 和 CentOS 8 或 9 的两个最新次版本中提供对 Red Hat OpenShift Local 的支持,以及两个最新的 Fedora 版本。
- 在使用 Red Hat Enterprise Linux 时,必须通过 红帽客户门户网站注册运行 Red Hat OpenShift Local 的计算机。
- Ubuntu 18.04 LTS 或更高版本和 Debian 10 或更高版本不被支持,且可能需要手动设置主机机器。
- 请参阅所需软件包 以为您的 Linux 发行版安装所需的软件包。
第 3 章 更改及改进
以下是 Red Hat OpenShift Local 2.14 中引入的一些显著变化。
3.1. 主要改进
Red Hat OpenShift Local 将最小、预配置的 OpenShift Container Platform 4 集群或 Podman 容器运行时引入本地笔记本或桌面计算机,用于开发和测试目的。Red Hat OpenShift Local 有一个 Red Hat Enterprise Linux 虚拟机,它支持用于 Linux、macOS 和 Microsoft Windows 10 的原生虚拟机监控程序。
- Red Hat OpenShift Local 用于在 OpenShift 4 集群或 Podman 容器运行时上进行本地开发和测试。要在本地运行 OpenShift 3 集群,请参阅 Red Hat Container Development Kit。
3.2. 技术预览
对这些功能的支持属于 技术预览功能支持范围。
-
Red Hat OpenShift Local 2.14 包含了使用
crc bundle generate命令基于当前运行的集群创建自定义捆绑包的功能。这个命令、其参数和行为可能会在以后的版本中不兼容的方式改变。
3.3. 主要变化
- Red Hat OpenShift Local 2.14 提供 OpenShift Container Platform 4.12.1 作为嵌入式 OpenShift 版本。
- Red Hat OpenShift Local 2.14 提供 Podman 4.3.1。
-
crc oc-env和crc podman-env命令在 PowerShell Core 上工作。请参阅 提交。 -
crc podman-env --root输出会将缺少的--root添加到打印的说明中。请参阅 问题,3492。
部分 II. 已知问题
Red Hat OpenShift Local 2.14 用户可能遇到的问题,以及这些问题的可能临时解决方案。
第 4 章 常规问题
影响所有支持的平台的问题。
4.1. SSH 密钥不匹配错误
crc cleanup 命令不会从用户 SSH 已知主机中删除 Red Hat OpenShift Local 实例 SSH 密钥。
因此,当使用 podman-remote 等命令访问 Red Hat OpenShift Local 实例时,您可能会收到以下错误消息:
Error: failed to connect: ssh: handshake failed: knownhosts: key mismatch
临时解决方案
从 SSH 知道的主机中删除 SSH 密钥:
$ ssh-keygen -R $(crc ip)
其他资源
4.2. 代理设置错误地应用到 Podman 预设置
当使用 Podman 预设置时,使用 crc config set 命令配置的代理设置不会被 Red Hat OpenShift Local 中嵌入的 podman-remote 二进制文件使用。
4.3. Red Hat OpenShift Local 默认禁用指标
为确保 Red Hat OpenShift Local 可以在典型的笔记本上运行,Red Hat OpenShift Local 会禁用一些资源密集型服务,如 Prometheus 以及所有相关监控、警报和遥测功能。您可以启用这些功能。
流程
- 请参阅 配置虚拟机以分配 更多资源
- 请参阅 启动 Monitoring、Alerting 和 Telemetry
在启用这些功能后,您无法禁用 Monitoring。
临时解决方案
再次禁用监控:
删除虚拟机:
$ crc delete
创建虚拟机:
$ crc start
4.4. 启用多个 Operator 需要的内存超过默认值
crc start 命令默认为 Red Hat OpenShift Local 虚拟机分配 9 GiB 内存。启用许多 Operator 可能会增加内存要求。
临时解决方案
- 请参阅 配置虚拟机以 分配额外的内存。
4.5. 当第一个 名称服务器是 IPv6 时,Red Hat OpenShift Local 无法正常工作
如果第一个 名称服务器是 IPv6,则 Red Hat OpenShift Local 虚拟机的 DNS 解析可能会失败。
临时解决方案
使用
-n标志在启动 Red Hat OpenShift Local 虚拟机时指定 IPv4名称服务器:$ crc start -n 8.8.8.8
第 5 章 macOS 的问题
本节论述了影响 macOS 主机上用户的 Red Hat OpenShift Local 问题。
5.1. 休眠会导致虚拟机时间重新同步
Red Hat OpenShift Local 虚拟机的时间可能会与主机上的时间进行重新同步。当主机进入休眠时,如果 Red Hat OpenShift Local 虚拟机正在运行,会出现这种情况。
临时解决方案
停止 Red Hat OpenShift Local 虚拟机:
$ crc stop
重启 Red Hat OpenShift Local 虚拟机:
$ crc start
第 6 章 Microsoft Windows 的问题
这部分论述了影响 Microsoft Windows 主机上的用户的 Red Hat OpenShift Local 问题。
6.1. 在安装后使用 Microsoft 标准安装程序(MSI)完成安装
流程
- 使用 MSI 安装程序安装 Red Hat OpenShift Local
- 重启您的计算机
在命令提示或 PowerShell 中运行命令:
$ crc setup
6.2. crc cleanup 命令可能会失败,并显示权限错误
运行 crc setup 后跟 crc cleanup,而不在命令间重启您的主机计算机会导致 crc cleanup 报告以下错误:
Post "http://unix/clean": open \\.\pipe\crc-admin-helper: Access is denied.
临时解决方案
- 重启您的计算机
运行以下命令:
$ crc cleanup
6.3. 在 %WINDRIVE%外部运行时意外行为
当您从网络驱动器启动 crc 二进制文件时,Hyper-V 驱动程序将失败。
临时解决方案
将
crc二进制文件移到%WINDRIVE%的位置。%WINDRIVE%通常设置为C:\。
6.4. Red Hat OpenShift Local 预期 PowerShell 中的 FullLanguage 支持
Red Hat OpenShift Local 支持 ConstrainedLanguage PowerShell 模式,以及系统管理员决定的例外。
6.5. crc oc-env 命令无法使用 %PATH%中的特殊字符
在 Microsoft Windows 上,PowerShell 和 command 提示不使用 UTF-8 编码。因此,使用 %PATH% 中存在特殊字符运行 crc oc-env 命令将无法准确编码 UTF-8 字符。
临时解决方案
-
将
crc二进制文件移到不包含特殊字符的位置。
其他资源
- 如需了解 Red Hat OpenShift Local 功能和 OpenShift Container Platform 简介,请参阅 Red Hat OpenShift Local 入门指南。
-
使用OpenShift Container Platform 产品及 Red Hat Bugzilla 上的
crc组件来报告 Red Hat OpenShift Local 或请求功能的问题。