Skip to content

Latest commit

 

History

History
142 lines (84 loc) · 7.37 KB

iso-install.md

File metadata and controls

142 lines (84 loc) · 7.37 KB
sidebar_position sidebar_label title keywords Description
2
ISO 安装
ISO 安装
Harvester
harvester
Rancher
rancher
ISO 安装
如果需要获取 Harvester ISO，访问 GitHub 上的发行版本进行下载。在安装过程中，你可以选择组建一个新的集群，或者将节点加入到现有的集群中。

Harvester 作为可启动的设备镜像提供，你可以使用 ISO 镜像将其直接安装在裸机服务器上。要获取 ISO 镜像，请从 Harvesterreleases 页面下载 💿harvester-v1.x.x-amd64.iso。

在安装过程中，你可以选择创建新的 Harvester 集群或将节点加入现有的 Harvester 集群。

以下视频概述了 ISO 安装的过程。

<iframe width="800" height="400" src="https://www.youtube.com/embed/X0VIGZ_lExQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

安装步骤

  1. 挂载 Harvester ISO 文件并通过选择 Harvester Installer 来启动服务器。

    iso-install.png

  2. 使用箭头键选择安装模式。默认情况下，第一个节点将是集群的管理节点。

    choose-installation-mode.png

    • Create a new Harvester cluster：创建一个全新的 Harvester 集群。

    • Join an existing Harvester cluster：加入现有的 Harvester 集群。你需要要加入的集群的 VIP 和集群 Token。

    • Install Harvester binaries only：如果选择此选项，则首次启动后需要进行其他设置。

    :::info 当有 3 个节点时，首先添加的另外 2 个节点会自动提升为管理节点，从而形成 HA 集群。如果你想提升其它地区的管理节点，你可以在执行自定义主机的步骤时提供一个 Harvester 配置的 URL，在 os.labels 中添加节点标签 topology.kubernetes.io/zone。在这种情况下，至少需要三个不同的地区。 :::

  3. 选择要安装 Harvester 集群的安装磁盘和要存储 VM 数据的数据磁盘。默认情况下，Harvester 对 UEFI 和 BIOS 使用 GUID 分区表 (GPT) 分区架构。如果你使用 BIOS 启动，则可以选择 Master boot record (MBR)。

    choose-installation-target-data-disk.png

    • Installation disk：安装 Harvester 集群的磁盘。
    • Data disk：存储虚拟机数据的磁盘。建议选择单独的磁盘来存储虚拟机数据。
    • Persistent size：如果你只有一个磁盘，或者使用同一个磁盘来存储操作系统和虚拟机数据，则需要配置持久化分区大小来存储系统包和容器镜像。默认最小持久分区大小为 150 GiB。你可以使用 200Gi 或 153600Mi 格式来指定大小。

  4. 配置节点的 HostName。

    config-hostname.png

  5. 配置管理网络的网络接口。默认情况下，Harvester 创建一个名为 mgmt-bo 的 bond NIC，IP 地址可以通过 DHCP 配置或静态分配。

    :::note 在 Harvester 集群的整个生命周期中都无法更改节点 IP。如果你使用 DHCP，则必须确保 DHCP 服务器始终为同一节点提供相同的 IP。如果节点 IP 发生变化，相关节点将无法加入集群，甚至可能破坏集群。 :::

    config-network.png

  6. （可选）配置 DNS Servers。使用逗号作为分隔符来添加更多 DNS 服务器。要使用默认 DNS 服务器，将其留空。

    config-dns-server.png

  7. 选择 VIP Mode 以配置虚拟 IP (VIP)。该 VIP 用于访问集群或让其他节点加入集群。

    :::note 如果使用了 DHCP 配置 IP 地址，你需要在 DHCP 服务器上配置静态 MAC 到 IP 地址映射，从而获得持久性的虚拟 IP (VIP)，并且 VIP 必须是唯一的。 :::

    config-virtual-ip.png

  8. 配置 Cluster token。这个 Token 用于将其他节点添加到集群中。

    config-cluster-token.png

  9. 配置并确认用于访问节点的 Password。默认的 SSH 用户是 rancher。

    config-password.png

  10. 配置 NTP服务器 以确保所有节点的时间同步。默认为 0.suse.pool.ntp.org。使用逗号作为分隔符来添加更多 NTP 服务器。

    config-ntp-server.png

  11. （可选）如果你需要使用 HTTP 代理来访问外部环境，请输入 Proxy address。否则，请留空。

    config-proxy.png

  12. （可选）你可以选择通过提供 HTTP URL 导入 SSH 密钥。例如，使用你的 GitHub 公钥 https://github.com/<username>.keys。

    import-ssh-keys.png

  13. （可选）如果你需要使用 Harvester 配置文件来自定义主机，在此处输入 HTTP URL。

    remote-config.png

  14. 检查并确认你的安装选项。确认安装选项后，Harvester 会安装到你的主机上。安装可能需要几分钟。

    confirm-install.png

  15. 安装完成后，你的节点将重启。重启后，Harvester 控制台将显示管理 URL 和状态。网页界面的默认 URL 是 https://your-virtual-ip。你可以使用 F12 从 Harvester 控制台切换到 Shell，然后键入 exit 返回到 Harvester 控制台。

    :::note 如果你在第一页选择了 Install Harvester binaries only，则需要在首次启动后进行额外的设置。 :::

    iso-installed.png

  16. 在首次登录时，你会收到为默认 admin 用户设置密码的提示。

    first-login.png

已知问题

使用较旧的显卡或显示器时，安装程序可能会崩溃

如果你使用的是较旧的显卡/显示器，你可能会在 ISO 安装过程中遇到 panic: invalid dimensions 错误。

invalid-dimensions.png

我们正在解决这个已知问题并计划在未来版本中修复。你可以使用另一个 GRUB 条目，从而在启动时强制使用 1024x768 的分辨率。

force-resolution.png

如果你使用的是 v1.1.1 之前的版本，请尝试以下解决方法：

  1. 使用 ISO 启动，然后按 E 编辑第一个菜单项：

    grub-menu.png

  2. 将 vga=792 附加到以 $linux 开头的行：

    edit-menu-entry.png

  3. 按 Ctrl+X 或 F10 启动。