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


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

通过使用 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
    Copy to Clipboard Toggle word wrap
  2. 运行以下命令,安装 Kickstart 文件创建过程中使用的工具:

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

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

      设置 PULL_SECRET 变量的命令示例:

      $ export PULL_SECRET="$(cat ~/.pull-secret.json)"
      Copy to Clipboard Toggle word wrap

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

      设置 PASSWD_TEXT 变量的命令示例。

      $ PASSWD_TEXT=<redhat_user_plain_text_password> 
      1
      Copy to Clipboard Toggle word wrap

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

      设置 USER_PASSWD 变量的示例。

      $ export USER_PASSWD="$(openssl passwd -6 "${PASSWD_TEXT}")"  
      1
      Copy to Clipboard Toggle word wrap

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

后续步骤

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

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

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

先决条件

  • 您可以设置 MicroShift Kickstart 文件。
  • 您知道 激活密钥 和组织 ID 以激活您的红帽订阅。
  • 您有设置 BOOTC_IMAGE_URLAUTH_CONFIGREGISTRY_CONFIG 所需的变量所需的信息。
重要

订阅必须包括访问 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)"
      Copy to Clipboard Toggle word wrap
    • RHSM_KEY 变量包含 Kickstart 文件中订阅注册命令的 Red Hat Subscription Manager 激活码。

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

      $ export MICROSHIFT_VER={product-version} 
      1
      Copy to Clipboard Toggle word wrap
      1
      安装集合的次版本的最新 .z
  2. 运行以下命令来创建要在虚拟机安装过程中使用的 kickstart.ks 文件:

    envsubst < \
        /usr/share/microshift/kickstart/kickstart-rpm.ks.template > \
        "${HOME}/kickstart.ks"
    Copy to Clipboard Toggle word wrap

使用 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
      Copy to Clipboard Toggle word wrap
      1
      使用服务器 URL 替换 http://my_ostree_server_url
    • OSTREE_COMMIT_REF 变量包含从服务器安装的 rpm-ostree 提交引用。

      $ export OSTREE_COMMIT_REF="<myostree_commit_reference>" 
      1
      Copy to Clipboard Toggle word wrap
      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)"
      Copy to Clipboard Toggle word wrap
  3. 运行以下命令来创建要在安装过程中使用的 kickstart.ks 文件:

    envsubst < \
        /usr/share/microshift/kickstart/kickstart-ostree.ks.template > \
        "${HOME}/kickstart.ks"
    Copy to Clipboard Toggle word wrap
注意

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

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

先决条件

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

流程

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

    $ export BOOTC_IMAGE_URL=<myregistry>/<myorg>/<mypath>/microshift-image:tag 
    1
    Copy to Clipboard Toggle word wrap
    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
      Copy to Clipboard Toggle word wrap
      1
      有关此文件格式的更多信息,请参阅 containers-auth.json (5) 手册页。
    • 运行以下命令,设置 REGISTRY_CONFIG 变量来配置对包含 BOOTC_IMAGE_URL 镜像的 registry 的访问:

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

    envsubst < \
        /usr/share/microshift/kickstart/kickstart-bootc.ks.template > \
        "${HOME}/kickstart.ks"
    Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat