RHEL キックスタートの使用


Red Hat build of MicroShift 4.20

MicroShift を含む RHEL イメージのインストールを自動化するキックスタートファイルを使用する

Red Hat OpenShift Documentation Team

概要

キックスタートファイルを使用して、通常の Red Hat Enterprise Linux (RHEL) インストールを自動化するには、成功に必要な情報をすべて含む単一のファイルを作成します。

第1章 キックスタートファイルを使用した RHEL への MicroShift のインストール

MicroShift を含む RHEL イメージのインストールを自動化するキックスタートファイルを使用します。

1.1. RHEL インストールで MicroShift を埋め込むためのキックスタートファイル

キックスタートファイルを使用して、通常の Red Hat Enterprise Linux (RHEL) インストールを自動化するには、成功に必要な情報をすべて含む単一のファイルを作成します。

  • 選択した RHEL タイプのキックスタートファイルに MicroShift を含めることにより、MicroShift のインストールを自動化することもできます。
  • キックスタートファイルを使用して、仮想マシン (VM) をプロビジョニングしたり、エッジデバイスへのデプロイメント用の通常の RHEL インストールを完了したりできます。

MicroShift の場合は、キックスタートファイルに、次の要件を満たすために RHEL システムをプロビジョニングする情報が含まれている必要があります。

  • プロビジョニングする RHEL システムは、MicroShift をインストールするための要件を満たしている必要がある。
  • RHEL ファイルシステムに、ワークロードの永続ボリューム (PV) に十分な容量を持つ論理ボリュームマネージャー (LVM) ボリュームグループ (VG) がある。
  • Red Hat Hybrid Cloud Console からのプルシークレットが /etc/crio/openshift-pull-secret として存在し、root ユーザーのみの読み取り/書き込みパーミッションがある。

1.1.1. MicroShift キックスタートファイルのセットアップ

インストールタイプの手順に従って、MicroShift で提供されるキックスタートファイルを使用してホストをプロビジョニングできます。前の手順で作成した ISO は、キックスタートファイルでプロビジョニングするホストで実行されます。MicroShift キックスタートファイルを使い始めるには、次の手順から開始します。

前提条件

  • プロビジョニングするホストは、MicroShift をインストールするためのシステム要件を満たしている必要がある。
  • ~/.pull-secret.json からのプルシークレットが存在し、現在のユーザーの読み取りパーミッションがある。

手順

  1. 次のコマンドを実行して、/usr/share/microshift/kickstart ディレクトリーにあるサンプルキックスタートファイルを含む microshift-release-info RPM パッケージをインストールします。

    $ sudo dnf install -y microshift-release-info
    Copy to Clipboard Toggle word wrap
  2. 以下のコマンドを実行して、キックスタートファイルの作成時に使用するユーティリティーをインストールします。

    $ 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 コンテナーレジストリーのアクセスを認証します。

      PULL_SECRET 変数を設定するコマンドの例

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

    • 次のコマンドを実行して、`USER_PASSWD` 設定で使用するパスワードを 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
      暗号化されたパスワードだけがキックスタートファイルに含まれます。プレーンテキストのパスワードは含まれません。

次のステップ

  • インストールタイプの指示に従って、提供されているテンプレートから作業キックスタートファイルを作成します。RHEL インストール用の RPM ベース、RHEL for Edge、およびイメージモードでは、以下の手順に従います。
  • オプション: キックスタートファイルを使用して仮想マシン (VM) を作成します。仮想マシンを作成すると、キックスタートファイル内の値をテストおよび検証できます。

1.1.2. MicroShift RPM インストールのキックスタートファイルの作成

MicroShift で提供されるキックスタートファイルを使用して、RPM ベースの仮想マシンをプロビジョニングします。

前提条件

  • MicroShift キックスタートファイルをセットアップしている。
  • Red Hat サブスクリプションをアクティブ化するための アクティベーションキー と組織 ID を把握している。
  • 必須変数 BOOTC_IMAGE_URLAUTH_CONFIG、および REGISTRY_CONFIG を設定するために必要な情報がある。
重要

サブスクリプションに、RPM リポジトリー rhocp-4.x-for-rhel-9-$(uname -m)-rpms および fast-datapath-for-rhel-9-$(uname -m)-rpms へのアクセスが含まれている必要があります。

手順

  1. 以下の変数を追加して、RPM キックスタートファイルを作成します。

    キックスタートファイル変数を設定するコマンドの例

    • RHSM_ORG 変数には、キックスタートファイルのサブスクリプション登録コマンドの Red Hat Subscription Manager 組織 ID が含まれます。

      $ export RHSM_ORG="$(cat ~/.rhsm-activation-org)"
      Copy to Clipboard Toggle word wrap
    • RHSM_KEY 変数には、キックスタートファイルのサブスクリプション登録コマンドの 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

1.1.3. MicroShift RHEL for Edge インストールのキックスタートファイルの作成

MicroShift で提供されるキックスタートファイルを使用して、RHEL for Edge ベースの仮想マシンをプロビジョニングします。

前提条件

  • MicroShift キックスタートファイルをセットアップしている。
  • 必須および任意の変数を設定するために必要な情報がある。

手順

  1. 次の必要な変数を追加して、RHEL for Edge のキックスタートファイルを作成します。

    必要な変数を設定するコマンドの例

    • OSTREE_SERVER_URL 変数には、キックスタートコマンド ostreesetup に渡される rpm-ostree サーバー URL が含まれます。

      $ export OSTREE_SERVER_URL="<http://my_ostree_server_url>" 
      1
      Copy to Clipboard Toggle word wrap
      1
      http://my_ostree_server_url は、お使いのサーバーの URL に置き換えます。
    • OSTREE_COMMIT_REF 変数には、サーバーからインストールされる rpm-ostree コミット参照が含まれます。

      $ export OSTREE_COMMIT_REF="<myostree_commit_reference>" 
      1
      Copy to Clipboard Toggle word wrap
      1
      <myostree_commit_reference> は、rpm-ostree コミット参照に置き換えます。
  2. オプション: サーバー認証に次の変数を追加します。

    • AUTH_CONFIG の内容は、インストール前の段階で /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 で提供されるキックスタートファイルを、RHEL インストール用のイメージモードで使用できます。

前提条件

  • MicroShift キックスタートファイルをセットアップしている。
  • 必須および任意の変数を設定するために必要な情報がある。

手順

  1. 以下のコマンドを実行して、RHEL キックスタートファイルのインストールプロセスで使用されるイメージを参照するように、必要な BOOTC_IMAGE_URL 変数値を設定します。

    $ export BOOTC_IMAGE_URL=<myregistry>/<myorg>/<mypath>/microshift-image:tag 
    1
    Copy to Clipboard Toggle word wrap
    1
    <myregistry><myorg>、および <mypath> は、実際の情報に置き換えます。
    • BOOTC_IMAGE_URL 変数には、ostreecontainer コマンドでインストールされるイメージへの参照が含まれています。必要に応じてタグを使用して、最新以外の z-stream リリースを指定できます。
  2. オプション: 以下のコマンドを使用して、レジストリー認証および設定の変数および値を追加します。

    オプションの変数を設定するコマンドの例

    • 次のコマンドを実行して、BOOTC_IMAGE_URL イメージへのアクセスを認証するように AUTH_CONFIG 変数を設定します。

      $ export AUTH_CONFIG="$(cat ~/.quay-auth.json)" 
      1
      Copy to Clipboard Toggle word wrap
      1
      このファイルフォーマットの詳細は、containers-auth.json(5) の man ページを参照してください。
    • 次のコマンドを実行して、BOOTC_IMAGE_URL イメージを含むレジストリーへのアクセスを設定するように、REGISTRY_CONFIG 変数を設定します。

      $ export REGISTRY_CONFIG="$(cat ~/.quay-config.conf)" 
      1
      Copy to Clipboard Toggle word wrap
      1
      このファイルフォーマットの詳細は、containers-registries.conf(5) の man ページを参照してください。
  3. 以下のコマンドを実行して、インストール中に使用する kickstart.ks ファイルを作成します。

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

法律上の通知

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

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat