入门指南

流程

1. 为您的平台下载 最新版本的 Red Hat OpenShift Local。
2. 在 Microsoft Windows 上，提取存档的内容。

3. 在 macOS 或 Microsoft Windows 上，运行指导安装程序并按照说明进行操作。

   注意

   在 Microsoft Windows 上，您必须将 Red Hat OpenShift Local 安装到本地 C:\ 驱动器中。您无法从网络驱动器运行 Red Hat OpenShift Local。

   在 Red Hat Enterprise Linux 中，假设归档位于 ~/Downloads 目录中，请按照以下步骤操作：

   1. 提取存档的内容：

      $ cd ~/Downloads
      $ tar xvf crc-linux-amd64.tar.xz

   2. 如果 ~/bin 目录不存在，请创建该目录，并将 crc 可执行文件复制到其中：

      $ mkdir -p ~/bin
      $ cp ~/Downloads/crc-linux-*-amd64/crc ~/bin

   3. 将 ~/bin 目录添加到您的 $PATH 中：

      $ export PATH=$PATH:$HOME/bin
      $ echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

流程

1. 下载 Red Hat OpenShift Local 的最新版本。

2. 删除现有的 Red Hat OpenShift Local 实例：

   $ crc delete

   警告

   crc delete 命令会导致存储在 Red Hat OpenShift Local 实例中的数据丢失。运行此命令前，先保存存储在实例中的所有信息。

3. 将之前的 crc 可执行文件替换为最新版本的可执行文件。通过检查其版本来验证新的 crc 可执行文件是否正在使用：

   $ crc version

4. 设置新的 Red Hat OpenShift Local 版本：

   $ crc setup

5. 启动新的 Red Hat OpenShift Local 实例：

   $ crc start

流程

1. （可选）在 Linux 上，默认选择 OpenShift Container Platform 预设置。选择 Podman 容器运行时预设置：

   $ crc config set preset podman

2. 为 Red Hat OpenShift Local 设置主机机器：

   $ crc setup

流程

1. 启动 Red Hat OpenShift Local 实例：

   $ crc start

2. 对于 OpenShift 预设，在提示时提供您的用户 pull secret。

   注意

   在提供请求前，集群至少需要 4 分钟才能启动所需的容器和 Operator。

流程

1. 以 developer 用户身份登录到运行由 Red Hat OpenShift Local 管理的 OpenShift Container Platform 集群：

   $ odo login -u developer -p developer

2. 为您的应用程序创建一个项目：

   $ odo create project sample-app

3. 为您的组件创建一个新目录：

   $ mkdir sample-app
   $ cd sample-app

4. 初始化 Node.js 应用程序示例：

   $ odo init --name sample-app --devfile nodejs --starter nodejs-starter

5. 开发 nodejs 应用程序：

   $ odo dev

6. 要从浏览器中访问应用程序，请使用 odo dev 命令输出中的 URL。

流程

1. 使用 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>

2. 如果代理使用自定义 CA 证书文件，请按如下所示对其进行设置：

   $ crc config set proxy-ca-file <path-to-custom-ca-file>

流程

1. 启动集群：

   $ crc start

   确保集群在此过程中保持运行。

2. 安装 haproxy 软件包和其他工具：

   $ sudo dnf install haproxy /usr/sbin/semanage

3. 修改防火墙以允许与集群通信：

   $ 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

4. 对于 SELinux，允许 HAProxy 侦听 TCP 端口 6443 在此端口上提供 kube-apiserver ：

   $ sudo semanage port -a -t http_port_t -p tcp 6443

5. 创建默认 haproxy 配置的备份：

   $ sudo cp /etc/haproxy/haproxy.cfg{,.bak}

6. 配置 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

7. 启动 haproxy 服务：

   $ sudo systemctl start haproxy

流程

1. 安装 dnsmasq 软件包：

   $ sudo dnf install dnsmasq

2. 在 NetworkManager 中，启用 dnsmasq 进行 DNS 解析：

   $ sudo tee /etc/NetworkManager/conf.d/use-dnsmasq.conf &>/dev/null <<EOF
   [main]
   dns=dnsmasq
   EOF

3. 将 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 的本地实例创建，并将与远程集群的条目冲突。

4. 重新载入 NetworkManager 服务：

   $ sudo systemctl reload NetworkManager

5. 使用 oc 以 developer 用户身份登录远程集群：

   $ oc login -u developer -p developer https://api.crc.testing:6443

   远程 OpenShift Container Platform Web 控制台位于 https://console-openshift-console.apps-crc.testing。

流程

1. 将 enable-cluster-monitoring 可配置的属性设置为 true ：

   $ crc config set enable-cluster-monitoring true

2. 启动实例：

   $ crc start

   警告

   无法禁用集群监控。要删除监控，将 enable-cluster-monitoring 可配置的属性设置为 false，并删除现有的 Red Hat OpenShift Local 实例。

流程

1. 运行 oc get nodes 命令来识别所需的节点。输出结果类似如下：

   $ oc get nodes
   NAME                 STATUS   ROLES           AGE    VERSION
   crc-shdl4-master-0   Ready    master,worker   7d7h   v1.14.6+7e13ab9a7

2. 运行 oc debug nodes/<node & gt;，其中 <node> 是上一步中打印的节点的名称。

1. 下载最新的 Red Hat OpenShift Local 版本，并将 crc 可执行文件放在 $PATH 中。

2. 使用 crc delete 命令删除带有证书错误的集群：

   $ crc delete

   警告

   crc delete 命令会导致存储在 Red Hat OpenShift Local 实例中的数据丢失。运行此命令前，先保存存储在实例中的所有信息。

3. 设置新发行版本：

   $ crc setup

4. 启动新实例：

   $ crc start

流程

1. 在尝试启动实例前发出 crc delete 命令：

   $ crc delete

   警告

   crc delete 命令会导致存储在 Red Hat OpenShift Local 实例中的数据丢失。运行此命令前，先保存存储在实例中的所有信息。

1. 停止 Red Hat OpenShift Local 实例：

   $ crc stop

2. 删除 Red Hat OpenShift Local 实例：

   $ crc delete

   警告

   crc delete 命令会导致存储在 Red Hat OpenShift Local 实例中的数据丢失。运行此命令前，先保存存储在实例中的所有信息。

3. 从 crc setup 命令清理剩余的更改：

   $ crc cleanup

   注意

   crc cleanup 命令会删除现有的 Red Hat OpenShift Local 实例，并恢复对 crc setup 命令创建的 DNS 条目的更改。在 macOS 上，c cleanup 命令也会删除系统托盘。

4. 设置主机机器以重新应用更改：

   $ crc setup

5. 启动 Red Hat OpenShift Local 实例：

   $ crc start

   注意

   在提供请求前，集群至少需要 4 分钟才能启动所需的容器和 Operator。

1. 为遇到的问题 搜索打开问题。
2. 如果没有现有问题解决了遇到的问题，请创建一个问题， 并将 ~/.crc/crc.log 文件附加到 创建的问题。~/.crc/crc.log 文件有详细的调试和故障排除信息，可帮助诊断您遇到的问题。