发行注记和已知问题

Red Hat OpenShift Local 2.22

Red Hat OpenShift Local 2.22 中突出显示的功能和识别的问题

Fabrice Flore-Thebault

Red Hat Developer Group Documentation Team

摘要

本文档列出了 Red Hat OpenShift Local 2.22 的新功能和改进的功能。它还包含有关在使用软件时可能会遇到的潜在问题的信息。在可能的情况下,会针对发现的问题进行临时解决方案。

使开源包含更多

红帽致力于替换我们的代码、文档和 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 客户端二进制(oc)

v4.13.3

Podman 二进制文件

4.4.4

1.2. 最低系统要求

Red Hat OpenShift Local 有以下最低硬件和操作系统要求。

1.2.1. 硬件要求

Red Hat OpenShift Local 在以下构架中被支持:

表 1.2. 预设置和架构兼容性

presetAMD64Intel 64M1

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。

临时解决方案

再次禁用监控:

  1. 删除虚拟机:

    $ crc delete
  2. 创建虚拟机:

    $ 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)在安装后完成安装

流程

  1. 使用 MSI 安装程序安装 Red Hat OpenShift Local
  2. 重启您的计算机
  3. 在 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.

临时解决方案

  1. 重启您的计算机
  2. 运行命令:

    $ 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 二进制文件移到不包含特殊字符的位置。

2.3. macOS 的问题

本节论述了影响 macOS 主机上用户的 Red Hat OpenShift Local 问题。

2.3.1. Hibernation 会导致虚拟机时间不同步

Red Hat OpenShift Local 虚拟机中的时间可能会与主机上的时间不同步。如果主机进入休眠时,Red Hat OpenShift Local 虚拟机正在运行。

临时解决方案

  1. 停止 Red Hat OpenShift Local 虚拟机:

    $ crc stop
  2. 重启 Red Hat OpenShift Local 虚拟机:

    $ crc start

法律通告

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.