使用 RHEL Kickstart


Red Hat build of MicroShift 4.18

使用使用 MicroShift 自动安装 RHEL 镜像的 Kickstart 文件

Red Hat OpenShift Documentation Team

摘要

通过使用 Kickstart 文件,您可以通过创建一个文件来自动执行典型的 Red Hat Enterprise Linux (RHEL)安装,其中包含成功所需的所有信息。

第 1 章 使用 Kickstart 文件在 RHEL 中安装 MicroShift

使用一个 Kickstart 文件,通过 MicroShift 自动安装 RHEL 镜像。

1.1. 用于在 RHEL 安装中嵌入 MicroShift 的 Kickstart 文件

通过使用 Kickstart 文件,您可以通过创建一个文件来自动执行典型的 Red Hat Enterprise Linux (RHEL)安装,其中包含成功所需的所有信息。

  • 您还可以在 Kickstart 文件中为您选择的 RHEL 类型包含 MicroShift 安装来自动化 MicroShift 安装。
  • 您可以使用 Kickstart 文件置备虚拟机(VM),或完成常规 RHEL 安装以便在边缘设备上部署。

对于 MicroShift,您的 Kickstart 文件必须包含置备 RHEL 系统以满足以下要求的信息:

  • 您置备的 RHEL 系统必须满足安装 MicroShift 的要求。
  • RHEL 文件系统必须具有一个逻辑卷管理器(LVM)卷组(VG),且有足够的容量用于工作负载的持久性卷(PV)。
  • Red Hat Hybrid Cloud Console 中的 pull secret 必须显示为 /etc/crio/openshift-pull-secret,并具有 root 用户只读读/写权限。

1.1.1. 设置 MicroShift Kickstart 文件

您可以根据安装类型的说明使用 MicroShift 提供的 Kickstart 文件来置备主机。然后,您在前面的步骤中创建的 ISO 会在您使用 Kickstart 文件置备的主机上运行。要开始 MicroShift Kickstart 文件,请从以下流程开始。

先决条件

  • 您置备的主机必须满足安装 MicroShift 的系统要求。
  • 必须存在 ~/.pull-secret.json 中的 pull secret,并且具有当前用户的读取权限。

流程

  1. 运行以下命令,安装包含 /usr/share/microshift/kickstart 目录中示例 Kickstart 文件的 microshift-release-info RPM 软件包:

    $ sudo dnf install -y microshift-release-info
  2. 运行以下命令,安装 Kickstart 文件创建过程中使用的工具:

    $ sudo dnf install -y openssl gettext
  3. 设置指向 kickstart.ks 中包含的机密的变量。

    • PULL_SECRET 文件内容被复制到安装后阶段的 /etc/crio/openshift-pull-secret 目录中,以验证 OpenShift Container Platform 容器 registry 访问。

      设置 PULL_SECRET 变量的命令示例:

      $ export PULL_SECRET="$(cat ~/.pull-secret.json)"

    • 运行以下命令,在 PASSWD_TEXT 变量中设置要使用的密码:

      设置 PASSWD_TEXT 变量的命令示例。

      $ PASSWD_TEXT=<my_redhat_user_plain_text_password> 1

      1
      <my_redhat_user_plain_text_password > 替换为您要使用的密码。
    • USER_PASSWD 设置用作 redhat 用户的加密密码,以登录到主机。使用 SHA-512 加密标准加密您的密码字符串。

      设置 USER_PASSWD 变量的示例。

      $ export USER_PASSWD="$(openssl passwd -6 "${PASSWD_TEXT}")"  1

      1
      只有加密的密码包含在 Kickstart 文件中。纯文本密码不是。

后续步骤

  1. 按照说明您的安装类型,从提供的模板创建可正常工作的 Kickstart 文件。有关基于 RPM、RHEL for Edge 和 RHEL 安装的镜像模式的说明,请按照以下步骤操作。
  2. 可选。使用 Kickstart 文件创建虚拟机(VM)。创建虚拟机可让您测试并验证 Kickstart 文件中的值。

1.1.2. 为 MicroShift RPM 安装创建 Kickstart 文件

使用 MicroShift 提供的 Kickstart 文件调配基于 RPM 的虚拟机。

先决条件

重要

订阅必须包括访问 rhocp-4.x-for-rhel-9-$(uname -m)-rpmsfast-datapath-for-rhel-9-$(uname -m)-rpms RPM 存储库。

流程

  1. 添加以下变量以创建 RPM Kickstart 文件:

    设置 Kickstart 文件变量的示例命令。

    • RHSM_ORG 变量包含 Kickstart 文件中订阅注册命令的 Red Hat Subscription Manager 机构 ID。

      $ export RHSM_ORG="$(cat ~/.rhsm-activation-org)"
    • RHSM_KEY 变量包含 Kickstart 文件中订阅注册命令的 Red Hat Subscription Manager 激活码。

      $ export RHSM_KEY="$(cat ~/.rhsm-activation-key)"
    • MICROSHIFT_VER 变量引用使用 4.y 格式安装的 MicroShift 版本。此变量中设置的 4.y 版本的最新可用 .z 版本会被自动安装。

      $ export MICROSHIFT_VER=4.17 1
      1
      对于您设置的次版本,会安装该版本的最新 z-stream。
  2. 运行以下命令来创建要在虚拟机安装过程中使用的 kickstart.ks 文件:

    envsubst < \
        /usr/share/microshift/kickstart/kickstart-rpm.ks.template > \
        "${HOME}/kickstart.ks"

1.1.3. 为 MicroShift RHEL for Edge 安装创建 Kickstart 文件

使用 MicroShift 提供的 Kickstart 文件为基于 Edge 的虚拟机置备 RHEL。

先决条件

  • 您可以设置 MicroShift Kickstart 文件。
  • 您有设置必要和可选变量所需的信息。

流程

  1. 添加以下所需的变量来创建 RHEL for Edge Kickstart 文件:

    设置必要变量的命令示例。

    • OSTREE_SERVER_URL 变量包含一个 rpm-ostree 服务器 URL,它传递给 ostreesetup Kickstart 命令。

      $ export OSTREE_SERVER_URL="<http://my_ostree_server_url>" 1
      1
      使用服务器 URL 替换 http://my_ostree_server_url
    • OSTREE_COMMIT_REF 变量包含从服务器安装的 rpm-ostree 提交引用。

      $ export OSTREE_COMMIT_REF="<myostree_commit_reference>" 1
      1
      <myostree_commit_reference& gt; 替换为 rpm-ostree 提交引用。
  2. 可选。为服务器身份验证添加以下变量:

    • AUTH_CONFIG 内容复制到 pre-install 阶段的 /etc/ostree/auth.json,以验证对 OSTREE_SERVER_URL 服务器的访问。如果没有服务器身份验证,请跳过此设置。

      $ export AUTH_CONFIG="$(cat ~/.ostree-auth.json)"
  3. 运行以下命令来创建要在安装过程中使用的 kickstart.ks 文件:

    envsubst < \
        /usr/share/microshift/kickstart/kickstart-ostree.ks.template > \
        "${HOME}/kickstart.ks"
注意

安装 rpm-ostree 提交中指定的 MicroShift 版本。要更改 MicroShift 的版本,您必须创建一个新提交。

1.1.4. 创建用于在 RHEL 的镜像模式中安装 MicroShift 的 Kickstart 文件

您可以将 MicroShift 提供的 Kickstart 文件用于 RHEL 安装的镜像模式。

先决条件

  • 您可以设置 MicroShift Kickstart 文件。
  • 您有设置必要和可选变量所需的信息。

流程

  1. 运行以下命令,将所需的 BOOTC_IMAGE_URL 变量值设置为指向 RHEL Kickstart 文件安装过程中使用的镜像:

    $ export BOOTC_IMAGE_URL=<myregistry>/<myorg>/<mypath>/microshift-image:tag 1
    1
    将 & lt;myregistry&gt;, <myorg > , 和 <mypath > 替换为您的信息。
    • BOOTC_IMAGE_URL 变量包含对使用 ostreecontainer 命令安装的镜像的引用。如果需要,您可以使用标签指定 latest 以外的 z-stream 版本。
  2. 可选。使用以下命令,为 registry 身份验证和配置添加变量和值:

    设置可选变量的命令示例

    • 运行以下命令,设置 AUTH_CONFIG 变量来验证对 BOOTC_IMAGE_URL 镜像的访问:

      $ export AUTH_CONFIG="$(cat ~/.quay-auth.json)" 1
      1
      有关此文件格式的更多信息,请参阅 containers-auth.json (5) 手册页。
    • 运行以下命令,设置 REGISTRY_CONFIG 变量来配置对包含 BOOTC_IMAGE_URL 镜像的 registry 的访问:

      $ export REGISTRY_CONFIG="$(cat ~/.quay-config.conf)" 1
      1
      有关此文件格式的更多信息,请参阅 containers-registries.conf (5) 手册页。
  3. 运行以下命令,创建在安装过程中要使用的 kickstart.ks 文件:

    envsubst < \
        /usr/share/microshift/kickstart/kickstart-bootc.ks.template > \
        "${HOME}/kickstart.ks"

法律通告

Copyright © 2025 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.
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.