发行注记和已知问题

Red Hat OpenShift Local 2.14

Red Hat OpenShift Local 2.14 中突出显示的功能并发现问题

Fabrice Flore-Thebault

Red Hat Developer Group Documentation Team

摘要

本文档列出了并简要介绍了 Red Hat OpenShift Local 2.14 的新功能。它还包含有关在使用软件时可能会遇到的潜在问题的信息。在可能的情况下,会描述临时解决方案以了解发现的问题。

使开源包含更多

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

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-envcrc 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。

临时解决方案

再次禁用监控:

  1. 删除虚拟机:

    $ crc delete
  2. 创建虚拟机:

    $ 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 虚拟机正在运行,会出现这种情况。

临时解决方案

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

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

    $ crc start

第 6 章 Microsoft Windows 的问题

这部分论述了影响 Microsoft Windows 主机上的用户的 Red Hat OpenShift Local 问题。

6.1. 在安装后使用 Microsoft 标准安装程序(MSI)完成安装

流程

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

临时解决方案

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

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

其他资源

法律通告

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.