使用 RHEL Kickstart
使用使用 MicroShift 自动安装 RHEL 镜像的 Kickstart 文件
摘要
第 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,并且具有当前用户的读取权限。
流程
运行以下命令,安装包含
/usr/share/microshift/kickstart
目录中示例 Kickstart 文件的microshift-release-info
RPM 软件包:$ sudo dnf install -y microshift-release-info
运行以下命令,安装 Kickstart 文件创建过程中使用的工具:
$ sudo dnf install -y openssl gettext
设置指向
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 文件中。纯文本密码不是。
后续步骤
- 按照说明您的安装类型,从提供的模板创建可正常工作的 Kickstart 文件。有关基于 RPM、RHEL for Edge 和 RHEL 安装的镜像模式的说明,请按照以下步骤操作。
- 可选。使用 Kickstart 文件创建虚拟机(VM)。创建虚拟机可让您测试并验证 Kickstart 文件中的值。
1.1.2. 为 MicroShift RPM 安装创建 Kickstart 文件
使用 MicroShift 提供的 Kickstart 文件调配基于 RPM 的虚拟机。
先决条件
- 您可以设置 MicroShift Kickstart 文件。
- 您知道 [Activation Keys](https://console.redhat.com/insights/connector/activation-keys)和机构 ID 来激活您的红帽订阅。
-
您有设置
BOOTC_IMAGE_URL
、AUTH_CONFIG
和REGISTRY_CONFIG
变量所需的信息。
订阅必须包括访问 rhocp-4.x-for-rhel-9-$(uname -m)-rpms
和 fast-datapath-for-rhel-9-$(uname -m)-rpms
RPM 存储库。
流程
添加以下变量以创建 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。
运行以下命令来创建要在虚拟机安装过程中使用的
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 文件。
- 您有设置必要和可选变量所需的信息。
流程
添加以下所需的变量来创建 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
提交引用。
可选。为服务器身份验证添加以下变量:
AUTH_CONFIG
内容复制到 pre-install 阶段的/etc/ostree/auth.json
,以验证对OSTREE_SERVER_URL
服务器的访问。如果没有服务器身份验证,请跳过此设置。$ export AUTH_CONFIG="$(cat ~/.ostree-auth.json)"
运行以下命令来创建要在安装过程中使用的
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 文件。
- 您有设置必要和可选变量所需的信息。
流程
运行以下命令,将所需的
BOOTC_IMAGE_URL
变量值设置为指向 RHEL Kickstart 文件安装过程中使用的镜像:$ export BOOTC_IMAGE_URL=<myregistry>/<myorg>/<mypath>/microshift-image:tag 1
- 1
- 将 & lt;myregistry>, <myorg > , 和 <mypath > 替换为您的信息。
-
BOOTC_IMAGE_URL
变量包含对使用ostreecontainer
命令安装的镜像的引用。如果需要,您可以使用标签指定 latest 以外的 z-stream 版本。
-
可选。使用以下命令,为 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)
手册页。
运行以下命令,创建在安装过程中要使用的
kickstart.ks
文件:envsubst < \ /usr/share/microshift/kickstart/kickstart-bootc.ks.template > \ "${HOME}/kickstart.ks"