入门指南
使用和开发 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. 硬件要求
Red Hat OpenShift Local 在 AMD64、Intel 64 处理器和 M1 构架上被支持。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 领导 Sur 或更高版本。Red Hat OpenShift Local 无法在早期版本的 macOS 上工作。
2.1.2.3. Linux
- 在 Linux 中,只有两个 Red Hat Enterprise Linux/CentOS 8 和 9 次版本以及最新的两个稳定的 Fedora 版本中才支持 Red Hat OpenShift Local。
- 在使用 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 上的系统栏更改您选择的预设置,或者从所有支持的操作系统中从命令行更改您选择的设置。一次只能激活一个预设置。
3.2. 设置 Red Hat OpenShift Local
crc setup 命令执行操作来为 Red Hat OpenShift Local 实例设置主机机器的环境。
如果 ~/.crc 目录尚不存在,则 crc setup 命令创建该目录。
如果要设置新版本,请在设置新的 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命令,以打印将缓存的oc可执行文件添加到$PATH所需的命令:$ crc oc-env
- 运行 print 命令。
以
developer用户登录:$ oc login -u developer https://api.crc.testing:6443
注意crc start命令打印开发人员用户的密码。您还可以通过运行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 和 view。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 上,您可以使用系统栏或命令行界面更改所选预设置。在 Linux 上,使用命令行界面。
您无法更改现有 Red Hat OpenShift Local 实例的预设置。只有创建 Red Hat OpenShift Local 实例时,才会应用预设置更改。要启用预设置更改,您必须删除现有实例并启动新实例。
流程
从命令行更改所选预设置:
$ crc config set preset <name>对于 OpenShift Container Platform,有效的预设置名称为
openshift,microshiftfor Red Hat Device Edge 和podman用于 Podman 容器运行时。
其他资源
- 有关每个预设置的最低系统要求的更多信息,请参阅 最低系统要求。
4.4. 配置实例
使用 cpus 和内存 属性分别配置 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 API 服务器会公开为 api.crc.testing,而 OpenShift Container Platform 控制台则作为 console-openshift-console.apps-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
在 Red Hat Enterprise Linux 和 CentOS 8.3 中,systemd-resolved 也作为技术预览提供。将主机配置为使用 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-monitoring可配置属性设置为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在 Microsoft Windows 上,使用 PowerShell:
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 中,c cleanup命令也会删除系统栏。设置主机机器以重新应用更改:
$ crc setup
启动 Red Hat OpenShift Local 实例:
$ crc start
注意在提供请求前,集群至少需要 4 分钟才能启动必要的容器和 Operator。
如果这个过程没有解决这个问题,请执行以下步骤:
- 搜索您遇到的问题打开的问题。
- 如果没有现有问题解决了遇到的问题,请创建一个问题, 并将 ~/.crc/crc.log 文件附加到 创建的问题。~/.crc/crc.log 文件具有详细的调试和故障排除信息,这有助于诊断您遇到的问题。