入门指南
使用和开发 Red Hat OpenShift Local 的快速入门指南
Fabrice Flore-Thebault
ffloreth@redhat.comdevtools-docs@redhat.com
摘要
使开源包含更多
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情,请参阅我们的首席技术官 Chris Wright 提供的消息。
第 1 章 Red Hat OpenShift Local 简介
1.1. 关于 Red Hat OpenShift Local
Red Hat OpenShift Local 将最小的 OpenShift Container Platform 4 集群和 Podman 容器运行时引入到您的本地计算机。这些运行时为开发和测试目的提供了最小的环境。Red Hat OpenShift Local 主要用于在开发人员桌面上运行。对于其他 OpenShift Container Platform 用例,如无头或多开发人员设置,请使用 完整的 OpenShift 安装程序。
如需了解 OpenShift Container Platform 的完整介绍,请参阅 OpenShift Container Platform 文档。
Red Hat OpenShift Local 包含 crc 命令行界面(CLI),以使用所需的容器运行时与 Red Hat OpenShift Local 实例交互。
1.2. 与生产环境的 OpenShift Container Platform 安装的不同
Red Hat OpenShift Local 的 OpenShift 预设置提供了一个常规的 OpenShift Container Platform 安装,它有以下显著区别:
- OpenShift Container Platform 集群是临时的,不适用于生产环境。
- Red Hat OpenShift Local 没有到较新的 OpenShift Container Platform 版本的升级路径。升级 OpenShift Container Platform 版本可能会导致难以重现的问题。
- 它使用一个单一节点,它的行为与 control plane 和 worker 节点相同。
- 它默认禁用 Cluster Monitoring Operator。这个禁用的 Operator 会导致 Web 控制台的对应部分无法正常工作。
- OpenShift Container Platform 集群在称为 实例的 虚拟机中运行。这可能导致其他区别,特别是外部网络。
由 Red Hat OpenShift Local 提供的 OpenShift Container Platform 集群还包括以下不可自定义的集群设置。这些设置不应修改:
- 使用 *.crc.testing 域。
用于内部集群通信的地址范围。
- 集群使用 172 地址范围。例如,当代理在同一地址空间中运行时,这可能会导致问题。
第 2 章 安装
2.1. 最低系统要求
Red Hat OpenShift Local 有以下最低硬件和操作系统要求。
2.1.1. 硬件要求
AMD64、Intel 64 处理器和 M1 构架支持 Red Hat OpenShift Local。Red Hat OpenShift Local 不支持嵌套虚拟化。
根据所需的容器运行时,Red Hat OpenShift Local 需要以下系统资源:
2.1.1.1. 对于 OpenShift Container Platform
- 4 个物理 CPU 内核
- 9 GB 可用内存
- 35 GB 存储空间
2.1.1.2. 对于 Red Hat Device Edge
- 2 个物理 CPU 内核
- 4 GB 可用内存
- 35 GB 存储空间
OpenShift Container Platform 和 Red Hat Device Edge 预设需要这些最小资源在 Red Hat OpenShift Local 实例中运行。有些工作负载可能需要更多资源。要为 Red Hat OpenShift Local 实例分配更多资源,请参阅配置实例。
2.1.1.3. 对于 Podman 容器运行时
- 2 个物理 CPU 内核
- 2 GB 可用内存
- 35 GB 存储空间
2.1.2. 操作系统要求
Red Hat OpenShift Local 需要以下支持的操作系统的最低版本:
2.1.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.1.2.2. macOS
- 在 macOS 中,Red Hat OpenShift Local 需要 macOS 11 Big Sur 或更高版本。Red Hat OpenShift Local 在早期版本的 macOS 中无法正常工作。
2.1.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 发行版本安装所需的软件包。
2.2. Linux 所需的软件包
Red Hat OpenShift Local 需要 libvirt 和 NetworkManager 软件包在 Linux 上运行。请参考下表查找用于为您的 Linux 发行版本安装这些软件包的命令:
表 2.1. 按发行版的软件包安装命令
| Linux 发行版 | 安装命令 |
|---|---|
| Fedora/Red Hat Enterprise Linux/CentOS |
|
| Debian/Ubuntu |
|
2.3. 安装 Red Hat OpenShift Local
Red Hat OpenShift Local 作为 Red Hat Enterprise Linux 的可移植可执行文件提供。在 Microsoft Windows 和 macOS 上,Red Hat OpenShift Local 使用一个指导的安装程序提供。
先决条件
- 您的主机机器必须满足最低系统要求。如需更多信息,请参阅 最低系统要求。
流程
- 为您的平台下载 最新版本的 Red Hat OpenShift Local。
- 在 Microsoft Windows 上,提取存档的内容。
在 macOS 或 Microsoft Windows 上,运行指导安装程序并按照说明进行操作。
注意在 Microsoft Windows 上,您必须将 Red Hat OpenShift Local 安装到本地 C:\ 驱动器。您无法从网络驱动器运行 Red Hat OpenShift Local。
在 Red Hat Enterprise Linux 中,假设存档位于 ~/Downloads 目录中,请按照以下步骤执行:
提取存档的内容:
$ cd ~/Downloads $ tar xvf crc-linux-amd64.tar.xz
如果不存在,请创建 ~/bin 目录,并将
crc可执行文件复制到其中:$ mkdir -p ~/bin $ cp ~/Downloads/crc-linux-*-amd64/crc ~/bin
将 ~/bin 目录添加到
$PATH中:$ export PATH=$PATH:$HOME/bin $ echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc
2.4. 关于使用数据收集
Red Hat OpenShift Local 会提示您输入可选的匿名使用数据收集,以帮助开发。不会收集个人可识别的信息。您随时可以授予或撤销使用数据收集的同意。
其他资源
- 有关收集数据的更多信息,请参阅 Red Hat Telemetry 数据收集通知。
- 要授予或撤销使用数据收集的同意,请参阅配置使用数据收集。
2.5. 配置使用数据收集
您随时可以使用以下方法授予或撤销使用数据收集的同意。
对遥测同意的更改不会修改正在运行的实例。更改在下次运行 crc start 命令时生效。
流程
要手动启用遥测,请运行以下命令:
$ crc config set consent-telemetry yes
要手动禁用遥测,请运行以下命令:
$ crc config set consent-telemetry no
其他资源
- 有关收集的数据的更多信息,请参阅 Red Hat Telemetry 数据收集通知。
2.6. 升级 Red Hat OpenShift Local
较新版本的 Red Hat OpenShift Local 可执行文件需要手动设置,以防止之前版本的潜在不兼容。
流程
- 下载 Red Hat OpenShift Local 的最新版本。
删除现有的 Red Hat OpenShift Local 实例:
$ crc delete
警告crc delete命令会导致 Red Hat OpenShift Local 实例中存储的数据丢失。在运行此命令前,保存存储在实例中的需要的信息。将之前的
crc可执行文件替换为最新发行版本的可执行文件。通过检查其版本来验证新的crc可执行文件是否使用:$ crc version
设置新的 Red Hat OpenShift Local 发行版本:
$ crc setup
启动新的 Red Hat OpenShift Local 实例:
$ crc start
第 3 章 使用 Red Hat OpenShift Local
3.1. 关于预设置
Red Hat OpenShift Local presets 代表一个受管容器运行时,以及实例运行它所需的系统资源绑定。Red Hat OpenShift Local 为 OpenShift Container Platform、Red Hat Device Edge 和 Podman 容器运行时提供预设。
在 Microsoft Windows 和 macOS 上,Red Hat OpenShift Local 指南的安装程序会提示您输入所需的预设置。在 Linux 上,默认选择 OpenShift Container Platform 预设置。在运行 crc setup 命令前,您可以使用 crc config 命令更改此选择。您可以从 Microsoft Windows 和 macOS 上的系统 tray 更改所选预设置,或者从所有支持的操作系统上的命令行更改。在一个时间点上只能有一个预设置处于活跃状态。
3.2. 设置 Red Hat OpenShift Local
crc setup 命令执行操作,为 Red Hat OpenShift Local 实例设置主机机器的环境。
crc setup 命令会创建 ~/.crc 目录(如果不存在)。
如果要设置新版本,请在设置新的 Red Hat OpenShift Local 版本前捕获对实例所做的任何更改。
先决条件
-
在 Linux 或 macOS 中,请确保您的用户帐户有使用
sudo命令的权限。在 Microsoft Windows 上,请确保您的用户帐户可以提升至管理员特权。
不要以 root 用户或管理员运行 crc 可执行文件。始终使用用户帐户运行 crc 可执行文件。
流程
(可选)在 Linux 上,默认选择 OpenShift Container Platform 预设置。选择 Podman 容器运行时预设置:
$ crc config set preset podman
为 Red Hat OpenShift Local 设置主机机器:
$ crc setup
其他资源
- 有关可用容器运行时预设置的更多信息,请参阅关于预设置。
3.3. 启动实例
crc start 命令启动 Red Hat OpenShift Local 实例并配置的容器运行时。
先决条件
- 为了避免与网络相关的问题,请确保您没有连接到 VPN,且您的网络连接可靠。
-
您可以使用
crc setup命令设置主机机器。如需更多信息,请参阅设置 Red Hat OpenShift Local。 - 在 Microsoft Windows 上,请确保您的用户帐户可以提升至管理员特权。
对于 OpenShift 预设置,请确保您具有有效的 OpenShift 用户 pull secret。从 Red Hat Hybrid Cloud Console 上的 Red Hat OpenShift Local 的 Pull Secret 部分复制或下载 pull secret。
注意访问用户 pull secret 需要红帽帐户。
流程
启动 Red Hat OpenShift Local 实例:
$ crc start
对于 OpenShift 预设置,在提示时提供用户 pull secret。
注意在提供请求前,集群至少需要 4 分钟才能启动必要的容器和 Operator。
其他资源
- 要更改分配给实例的默认资源,请参阅配置实例。
-
如果您在
crc start中看到错误,请参阅 Red Hat OpenShift Local 故障排除部分以了解潜在的解决方案。
3.4. 访问 OpenShift 集群
使用 OpenShift Container Platform Web 控制台或 OpenShift CLI (oc)访问在 Red Hat OpenShift Local 实例中运行的 OpenShift Container Platform 集群。
3.4.1. 访问 OpenShift Web 控制台
使用您的 Web 浏览器访问 OpenShift Container Platform Web 控制台。
使用 kubeadmin 或 developer 用户访问集群。使用 developer 员用户创建项目或 OpenShift 应用以及应用部署。使用 kubeadmin 用户仅针对管理任务,如创建新用户或设置角色。
先决条件
流程
要使用默认 Web 浏览器访问 OpenShift Container Platform Web 控制台,请运行以下命令:
$ crc console
以
developer用户身份登录,使用crc start命令的输出中打印的密码。您还可以运行以下命令来查看developer和kubeadmin用户的密码:$ crc console --credentials
如果您无法访问由 Red Hat OpenShift Local 管理的 OpenShift Container Platform 集群,请参阅对 Red Hat OpenShift Local 进行故障排除。
其他资源
- OpenShift Container Platform 文档 涵盖了项目和应用程序的创建。
3.4.2. 使用 OpenShift CLI 访问 OpenShift 集群
使用 OpenShift CLI (oc)访问由 Red Hat OpenShift Local 管理的 OpenShift Container Platform 集群。
先决条件
流程
运行
crc oc-env命令,将缓存的ocexecutable 添加到$PATH中:$ crc oc-env
- 运行打印的命令。
以
developer用户登录:$ oc login -u developer https://api.crc.testing:6443
注意crc start命令打印developer用户的密码。您还可以通过运行crc console --credentials命令来查看它。现在,您可以使用
oc与 OpenShift Container Platform 集群交互。例如,要验证 OpenShift Container Platform 集群 Operator 是否可用,请以kubeadmin用户身份登录并运行以下命令:$ oc config use-context crc-admin $ oc whoami kubeadmin $ oc get co
注意Red Hat OpenShift Local 默认禁用 Cluster Monitoring Operator。
如果您无法访问由 Red Hat OpenShift Local 管理的 OpenShift Container Platform 集群,请参阅对 Red Hat OpenShift Local 进行故障排除。
其他资源
- OpenShift Container Platform 文档 涵盖了项目和应用程序的创建。
3.4.3. 访问内部 OpenShift registry
在 Red Hat OpenShift Local 实例中运行的 OpenShift Container Platform 集群默认包含一个内部容器镜像 registry。此内部容器镜像 registry 可用作本地开发容器镜像的发布目标。要访问内部 OpenShift Container Platform registry,请按照以下步骤执行。
先决条件
- Red Hat OpenShift Local 被配置为使用 OpenShift 预设置。如需更多信息,请参阅 更改所选预设置。
- 正在运行的 Red Hat OpenShift Local 实例。如需更多信息 ,请参阅 启动实例。
-
正常工作的 OpenShift CLI (
oc)命令。如需更多信息,请参阅使用 OpenShift CLI 访问 OpenShift 集群。
流程
检查哪个用户登录到集群:
$ oc whoami
注意出于演示目的,假定当前用户为
kubeadmin。以该用户身份登录 registry,其令牌如下:
$ oc registry login --insecure=true
创建一个新项目
$ oc new-project demo
镜像容器镜像示例:
$ oc image mirror registry.access.redhat.com/ubi8/ubi:latest=default-route-openshift-image-registry.apps-crc.testing/demo/ubi8:latest --insecure=true --filter-by-os=linux/amd64
获取镜像流并验证推送的镜像是否已列出:
$ oc get is
在镜像流中启用镜像查找:
$ oc set image-lookup ubi8
此设置允许镜像流是镜像源,而无需为内部 registry 提供完整的 URL。
使用最近推送的镜像创建 pod:
$ oc run demo --image=ubi8 --command -- sleep 600s
3.5. 使用 odo部署示例应用程序
您可以使用 odo 使用命令行创建 OpenShift 项目和应用程序。此流程将示例应用程序部署到在 Red Hat OpenShift Local 实例中运行的 OpenShift Container Platform 集群。
先决条件
流程
以
developer用户身份登录由 Red Hat OpenShift Local 管理的正在运行的 OpenShift Container Platform 集群:$ odo login -u developer -p developer
为您的应用程序创建一个项目:
$ odo project create sample-app
为您的组件创建一个新目录:
$ mkdir sample-app $ cd sample-app
克隆一个 Node.js 应用程序示例:
$ git clone https://github.com/openshift/nodejs-ex $ cd nodejs-ex
在应用程序中添加
nodejs组件:$ odo create nodejs
创建 URL 并在本地配置文件中添加条目:
$ odo url create --port 8080
推送更改:
$ odo push
现在,您的组件已使用可访问的 URL 部署到集群中。
列出 URL 并检查组件所需的 URL:
$ odo url list
- 使用生成的 URL 查看部署的应用程序。
其他资源
-
有关使用
odo的更多信息,请参阅odo文档。
3.6. 停止实例
crc stop 命令停止正在运行的 Red Hat OpenShift Local 实例和容器运行时。在关闭集群时,停止过程需要几分钟时间。
流程
停止 Red Hat OpenShift Local 实例和容器运行时:
$ crc stop
3.7. 删除实例
crc delete 命令删除现有的 Red Hat OpenShift Local 实例。
流程
删除 Red Hat OpenShift Local 实例:
$ crc delete
警告crc delete命令会导致 Red Hat OpenShift Local 实例中存储的数据丢失。在运行此命令前,保存存储在实例中的需要的信息。
第 4 章 配置 Red Hat OpenShift Local
4.1. 关于 Red Hat OpenShift Local 配置
使用 crc config 命令配置 crc 可执行文件和 Red Hat OpenShift Local 实例。crc config 命令需要一个子命令来操作配置。可用的子命令包括 get、set、 unset,以及查看。get、set 和 unset 子命令对命名的可配置属性进行操作。运行 crc config --help 命令来列出可用的属性。
您还可以使用 crc config 命令配置 crc start 和 crc setup 命令的启动检查的行为。默认情况下,启动检查会报告错误并在不满足其条件时停止执行。将以 skip-check 开始的属性值设置为 true 以跳过检查。
4.2. 查看 Red Hat OpenShift Local 配置
Red Hat OpenShift Local 可执行文件提供了查看可配置属性和当前 Red Hat OpenShift Local 配置的命令。
流程
查看可用的可配置属性:
$ crc config --help
查看可配置属性的值:
$ crc config get <property>查看完整的当前配置:
$ crc config view
注意如果配置由默认值包含,则
crc config view命令不会返回任何信息。
4.3. 更改所选预设置
您可以通过选择所需的预设置来更改 Red Hat OpenShift Local 实例的容器运行时。
在 Microsoft Windows 和 macOS 上,您可以使用系统 tray 或 命令行界面更改所选预设置。在 Linux 上,使用命令行界面。
您无法更改现有 Red Hat OpenShift Local 实例的预设置。只有在创建 Red Hat OpenShift Local 实例时,才会应用预设置更改。要启用预设置更改,您必须删除现有实例并启动新的实例。
流程
从命令行更改所选预设置:
$ crc config set preset <name>对于 OpenShift Container Platform,有效的 preset 名称为
openshift,microshiftfor Red Hat Device Edge 和podmanfor Podman 容器运行时。
其他资源
- 有关每个预设置的最低系统要求的更多信息,请参阅 最低系统要求。
4.4. 配置实例
使用 cpus 和 memory 属性配置 Red Hat OpenShift Local 实例可用的默认 vCPU 和内存量。
或者,可以将 --cpus 和 --memory 标志分别用于 crc start 命令的 vCPU 和内存量。
您无法更改正在运行的 Red Hat OpenShift Local 实例的配置。要启用配置更改,您必须停止正在运行的实例并重新启动它。
流程
配置实例可用的 vCPU 数量:
$ crc config set cpus <number>cpus属性的默认值为4。分配的 vCPU 数量必须大于或等于默认值。使用所需 vCPU 数量启动实例:
$ crc start --cpus <number>配置实例可用的内存:
$ crc config set memory <number-in-mib>注意可用内存的值以兆字节(MiB)设置。一个 gibibyte (GiB)内存等于 1024 MiB。
memory属性的默认值为9216。分配的内存量必须大于或等于默认值。使用所需内存量启动实例:
$ crc start --memory <number-in-mib>
第 5 章 网络
5.1. DNS 配置详情
5.1.1. 常规 DNS 设置
由 Red Hat OpenShift Local 管理的 OpenShift Container Platform 集群使用 2 个 DNS 域名、crc.testing 和 apps-crc.testing。crc.testing 域用于 OpenShift Container Platform 核心服务。apps-crc.testing 域用于访问集群中部署的 OpenShift 应用。
例如,当 OpenShift Container Platform 控制台作为 console-openshift-console.apps-crc.testing 访问时,OpenShift Container Platform API 服务器会公开为 api.crc.testing。这些 DNS 域由在 Red Hat OpenShift Local 实例中运行的 dnsmasq DNS 容器提供。
crc setup 命令检测并调整您的系统 DNS 配置,以便它可以解析这些域。在运行 crc start 时,完成其他检查来验证 DNS 是否已正确配置。
5.1.2. Linux
根据具体发行版的 Linux,Red Hat OpenShift Local 需要以下 DNS 配置:
5.1.2.1. NetworkManager + systemd-resolved
默认情况下,在 Fedora 33 或更新版本中使用此配置,以及 Ubuntu 桌面版本。
- Red Hat OpenShift Local 期望 NetworkManager 管理网络。
-
Red Hat OpenShift Local 配置
systemd-resolved,将testing域的请求转发到192.168.130.11DNS 服务器。192.168.130.11是 Red Hat OpenShift Local 实例的 IP。 systemd-resolved配置使用 /etc/NetworkManager/dispatcher.d/99-crc.sh 中的 NetworkManager 分配程序脚本完成:#!/bin/sh export LC_ALL=C systemd-resolve --interface crc --set-dns 192.168.130.11 --set-domain ~testing exit 0
systemd-resolved 在 Red Hat Enterprise Linux 和 CentOS 8.3 中也作为不受支持的技术预览提供。将主机配置为使用 systemd-resolved 后,停止任何正在运行的集群并重新运行 crc setup。
5.1.2.2. NetworkManager + dnsmasq
默认情况下,在 Fedora 32 或更早版本、Red Hat Enterprise Linux 和 CentOS 上使用此配置。
- Red Hat OpenShift Local 期望 NetworkManager 管理网络。
-
NetworkManager 使用带有 /etc/NetworkManager/conf.d/crc-nm-
dnsmasq.conf 配置文件的 dnsmasq。 此
dnsmasq实例的配置文件是 /etc/NetworkManager/dnsmasq.d/crc.conf :server=/crc.testing/192.168.130.11 server=/apps-crc.testing/192.168.130.11
-
NetworkManager
dnsmasq实例将crc.testing和apps-crc.testing域的请求转发到192.168.130.11DNS 服务器。
-
NetworkManager
5.2. 保留的 IP 子网
由 Red Hat OpenShift Local 管理的 OpenShift Container Platform 集群为内部使用保留 IP 子网,这些子网不应与主机网络冲突。确定可以使用以下 IP 子网:
保留的 IP 子网
-
10.217.0.0/22 -
10.217.4.0/23 -
192.168.126.0/24
此外,主机管理程序可以根据主机操作系统保留另一个 IP 子网。macOS 和 Microsoft Windows 上不会保留额外的子网。Linux 的额外保留子网是 192.168.130.0/24。
5.3. 在代理后面启动 Red Hat OpenShift Local
您可以使用环境变量或可配置属性在定义的代理后面启动 Red Hat OpenShift Local。
OpenShift Container Platform 不支持 SOCKS 代理。
先决条件
-
如果您不使用
crc oc-env,当与集群交互时,请将.testing域导出为no_proxy环境变量的一部分。嵌入的oc可执行文件不需要手动设置。有关使用嵌入式oc可执行文件的更多信息,请参阅使用 OpenShift CLI 访问 OpenShift 集群。
流程
使用
http_proxy和https_proxy环境变量或使用crc config set命令定义代理,如下所示:$ crc config set http-proxy http://proxy.example.com:<port> $ crc config set https-proxy http://proxy.example.com:<port> $ crc config set no-proxy <comma-separated-no-proxy-entries>
如果代理使用自定义 CA 证书文件,请按如下所示设置:
$ crc config set proxy-ca-file <path-to-custom-ca-file>
在 Red Hat OpenShift Local 配置中设置的与代理相关的值优先于使用环境变量设置的值。
5.4. 在远程服务器上设置 Red Hat OpenShift Local
配置远程服务器以运行由 Red Hat OpenShift Local 提供的 OpenShift Container Platform 集群。
这个过程假设使用 Red Hat Enterprise Linux、Fedora 或 CentOS 服务器。在远程服务器中运行此流程中的每个命令。
仅在本地网络中执行此步骤。在互联网上公开不安全的服务器存在许多安全隐患。
先决条件
- 在远程服务器上安装并设置 Red Hat OpenShift Local。如需更多信息,请参阅安装 Red Hat OpenShift Local 和 设置 Red Hat OpenShift Local。
- Red Hat OpenShift Local 被配置为使用远程服务器上的 OpenShift 预设置。如需更多信息,请参阅 更改所选预设置。
-
您的用户帐户在远程服务器上具有
sudo权限。
流程
启动集群:
$ crc start
确保集群在此过程中保持运行。
安装
haproxy软件包和其他工具:$ sudo dnf install haproxy /usr/sbin/semanage
修改防火墙以允许与集群通信:
$ sudo systemctl enable --now firewalld $ sudo firewall-cmd --add-service=http --permanent $ sudo firewall-cmd --add-service=https --permanent $ sudo firewall-cmd --add-service=kube-apiserver --permanent $ sudo firewall-cmd --reload
对于 SELinux,允许 HAProxy 侦听 TCP 端口 6443 为这个端口上提供
kube-apiserver:$ sudo semanage port -a -t http_port_t -p tcp 6443
创建默认
haproxy配置的备份:$ sudo cp /etc/haproxy/haproxy.cfg{,.bak}配置
haproxy以与集群搭配使用:$ export CRC_IP=$(crc ip) $ sudo tee /etc/haproxy/haproxy.cfg &>/dev/null <<EOF global log /dev/log local0 defaults balance roundrobin log global maxconn 100 mode tcp timeout connect 5s timeout client 500s timeout server 500s listen apps bind 0.0.0.0:80 server crcvm $CRC_IP:80 check listen apps_ssl bind 0.0.0.0:443 server crcvm $CRC_IP:443 check listen api bind 0.0.0.0:6443 server crcvm $CRC_IP:6443 check EOF启动
haproxy服务:$ sudo systemctl start haproxy
5.5. 连接到远程 Red Hat OpenShift Local 实例
使用 dnsmasq 将客户端机器连接到运行由 Red Hat OpenShift Local 管理的 OpenShift Container Platform 集群的远程服务器。
此流程假设使用 Red Hat Enterprise Linux、Fedora 或 CentOS 客户端。在客户端上运行此流程中的每个命令。
连接到仅在本地网络上公开的服务器。
先决条件
- 为客户端设置要连接的远程服务器。如需更多信息,请参阅在 远程服务器中设置 Red Hat OpenShift Local。
- 您知道服务器的外部 IP 地址。
-
在客户端的
$PATH中有 最新的 OpenShift CLI (oc)。
流程
安装
dnsmasq软件包:$ sudo dnf install dnsmasq
在 NetworkManager 中启用
dnsmasq进行 DNS 解析:$ sudo tee /etc/NetworkManager/conf.d/use-dnsmasq.conf &>/dev/null <<EOF [main] dns=dnsmasq EOF
将 Red Hat OpenShift Local 的 DNS 条目添加到
dnsmasq配置中:$ sudo tee /etc/NetworkManager/dnsmasq.d/external-crc.conf &>/dev/null <<EOF address=/apps-crc.testing/SERVER_IP_ADDRESS address=/api.crc.testing/SERVER_IP_ADDRESS EOF
注意注释掉 /etc/NetworkManager/dnsmasq.d/crc.conf 中的任何现有条目。这些条目是通过运行本地 Red Hat OpenShift Local 实例创建的,并与远程集群的条目冲突。
重新载入 NetworkManager 服务:
$ sudo systemctl reload NetworkManager
使用
oc以developer用户身份登录远程集群:$ oc login -u developer -p developer https://api.crc.testing:6443
远程 OpenShift Container Platform Web 控制台位于 https://console-openshift-console.apps-crc.testing。
第 6 章 管理任务
6.1. 启动监控
Red Hat OpenShift Local 默认禁用集群监控,以确保 Red Hat OpenShift Local 可以在典型的笔记本上运行。监控负责在 Red Hat Hybrid Cloud Console 中列出您的集群。按照以下步骤为集群启用监控。
先决条件
-
您必须为 Red Hat OpenShift Local 实例分配额外内存。对于核心功能,推荐至少 14 GiB 内存(值为
14336)。增加的工作负载将需要更多内存。如需更多信息 ,请参阅配置实例。
流程
将
enable-cluster-monitoringconfigurable 属性设置为true:$ crc config set enable-cluster-monitoring true
启动实例:
$ crc start
警告集群监控无法被禁用。要删除监控,请将
enable-cluster-monitoring可配置的属性设置为false,并删除现有的 Red Hat OpenShift Local 实例。
6.2. 启用覆盖 Operator
为确保 Red Hat OpenShift Local 可以在典型的笔记本电脑上运行,一些资源密集型服务会被默认禁用。这些服务可通过从 Operator 覆盖列表中手动删除所需的 Operator 来启用。
先决条件
-
正在运行的 Red Hat OpenShift Local 虚拟机和一个可正常工作的
oc命令。如需更多信息,请参阅使用oc访问 OpenShift 集群。 -
您必须以
kubeadmin用户身份登录oc。
流程
列出非受管 Operator,并记录所需 Operator 的数字索引:
在 Linux 或 macOS 中:
$ oc get clusterversion version -ojsonpath='{range .spec.overrides[*]}{.name}{"\n"}{end}' | nl -v 0使用 PowerShell 在 Microsoft Windows 上:
PS> oc get clusterversion version -ojsonpath='{range .spec.overrides[*]}{.name}{"\n"}{end}' | % {$nl++;"`t$($nl-1) `t $_"};$nl=0
使用标识的数字索引启动所需的 Operator:
$ oc patch clusterversion/version --type='json' -p '[{"op":"remove", "path":"/spec/overrides/<unmanaged-operator-index>"}]' clusterversion.config.openshift.io/version patched
第 7 章 Red Hat OpenShift Local 故障排除
Red Hat OpenShift Local 的目标是为开发和测试目的提供 OpenShift Container Platform 环境。在安装或使用特定 OpenShift 应用程序时出现的问题超出了 Red Hat OpenShift Local 的范围。向相关项目报告这些问题。
7.1. 获取 OpenShift 集群的 shell 访问
要访问集群以进行故障排除或调试目的,请按照以下步骤执行。
常规使用不需要直接访问 OpenShift Container Platform 集群,因此强烈建议不要这样做。
先决条件
-
启用 OpenShift CLI (
oc)对集群的访问,并以kubeadmin用户身份登录。具体步骤请参阅使用 OpenShift CLI 访问 OpenShift 集群。
流程
运行
oc get nodes命令以识别所需的节点。输出结果类似如下:$ oc get nodes NAME STATUS ROLES AGE VERSION crc-shdl4-master-0 Ready master,worker 7d7h v1.14.6+7e13ab9a7
-
运行
oc debug nodes/<node>,其中 <node> 是上一步中打印的节点的名称。
7.2. 过期证书故障排除
每个发布的 crc 可执行文件中的 OpenShift Container Platform 系统捆绑包在发布后过期 1 年。此过期是因为嵌入在 OpenShift Container Platform 集群中的证书。在需要时,crc start 命令会触发自动证书续订过程。证书续订可在集群的开始时间最多添加五分钟。
要避免这个额外的启动时间,或者在证书续订过程中失败,请使用以下步骤:
流程
要解决无法自动更新的证书错误:
-
下载最新的 Red Hat OpenShift Local 版本,并将
crc可执行文件放在$PATH中。 使用
crc delete命令删除带有证书错误的集群:$ crc delete
警告crc delete命令会导致 Red Hat OpenShift Local 实例中存储的数据丢失。在运行此命令前,保存存储在实例中的需要的信息。设置新版本:
$ crc setup
启动新实例:
$ crc start
7.3. 捆绑包版本不匹配的故障排除
创建的 Red Hat OpenShift Local 实例包含捆绑包信息和实例数据。在设置新的 Red Hat OpenShift Local 发行版本时,不会更新捆绑信息和实例数据。由于较早的实例数据中的自定义,因此不会更新此信息。这将在运行 crc start 命令时导致错误:
$ crc start ... FATA Bundle 'crc_hyperkit_4.2.8.crcbundle' was requested, but the existing VM is using 'crc_hyperkit_4.2.2.crcbundle'
流程
在尝试启动实例前发出
crc delete命令:$ crc delete
警告crc delete命令会导致 Red Hat OpenShift Local 实例中存储的数据丢失。在运行此命令前,保存存储在实例中的需要的信息。
7.4. 未知问题的故障排除
通过重启带有干净状态的 Red Hat OpenShift Local 解决大多数问题。这涉及停止实例、将其删除、恢复 crc setup 命令所做的更改、重新应用这些更改并重新启动实例。
先决条件
-
您可以使用
crc setup命令设置主机机器。如需更多信息,请参阅设置 Red Hat OpenShift Local。 -
已使用
crc start命令启动了 Red Hat OpenShift Local。如需更多信息 ,请参阅 启动实例。 - 您使用的是最新的 Red Hat OpenShift Local 版本。使用早于 Red Hat OpenShift Local 1.2.0 的版本可能会导致与过期 x509 证书相关的错误。如需更多信息,请参阅对 过期的证书进行故障排除。
流程
要排除 Red Hat OpenShift Local 的问题,请执行以下步骤:
停止 Red Hat OpenShift Local 实例:
$ crc stop
删除 Red Hat OpenShift Local 实例:
$ crc delete
警告crc delete命令会导致 Red Hat OpenShift Local 实例中存储的数据丢失。在运行此命令前,保存存储在实例中的需要的信息。从
crc setup命令清理剩余的更改:$ crc cleanup
注意crc cleanup命令删除现有的 Red Hat OpenShift Local 实例,并恢复对crc setup命令创建的 DNS 条目的更改。在 macOS 中,crc cleanup命令也会删除系统托盘。设置主机机器以重新应用更改:
$ crc setup
启动 Red Hat OpenShift Local 实例:
$ crc start
注意在提供请求前,集群至少需要 4 分钟才能启动必要的容器和 Operator。
如果此过程没有解决您的问题,请执行以下步骤:
- 在遇到的问题 中搜索您遇到的问题。
- 如果没有现有问题解决了遇到的问题,请创建一个问题, 并将 ~/.crc/crc.log 文件附加到 创建的问题。~/.crc/crc.log 文件包含详细的调试和故障排除信息,可帮助诊断您遇到的问题。