サポートコンソール開発者トライアルの開始お問い合わせ

13.2. 単一ノードでの OpenShift のインストール

Web ベースの Assisted Installer と、Assisted Installer を使用して生成した検出 ISO を使用して、単一ノードの OpenShift をインストールできます。また、coreos-installer を使用してインストール ISO を生成することにより、単一ノードの OpenShift をインストールすることもできます。

13.2.1. Assisted Installer を使用した単一ノード OpenShift のインストール

OpenShift Container Platform を単一ノードにインストールするには、Web ベースの Assisted Installer ウィザードのガイドに従い、インストールを管理します。

詳細と設定オプションについては、Assisted Installer for OpenShift Container Platform ドキュメントを参照してください。

13.2.1.1. Assisted Installer を使用したディスカバリー ISO の生成

OpenShift Container Platform を単一ノードにインストールするには、Assisted Installer が生成できる検出 ISO が必要です。

手順

  1. 管理ホストでブラウザーを開き、Red Hat OpenShift Cluster Manager に移動します。
  2. Create Cluster をクリックして新規クラスターを作成します。
  3. Cluster name フィールドにクラスターの名前を入力します。

  4. Base domain フィールドにベースドメインを入力します。以下に例を示します。 

    example.com

    すべての DNS レコードはこのベースドメインのサブドメインである必要があり、クラスター名が含まれる必要があります。以下に例を示します。 

    <cluster-name>.example.com
    注記

    クラスターのインストール後にベースドメインまたはクラスター名を変更することはできません。

  5. Install single node OpenShift (SNO) を選択し、ウィザードの残りの手順を完了します。検出 ISO をダウンロードします。
  6. 仮想メディアを使用してインストールするための検出 ISO URL を書き留めておきます。
注記

このプロセス中に OpenShift Virtualization を有効にする場合は、仮想マシン用に 50 GiB 以上の 2 つ目のローカルストレージデバイスが必要です。

関連情報

13.2.1.2. Assisted Installer を使用した単一ノード OpenShift のインストール

Assisted Installer を使用して、単一ノードクラスターをインストールします。

手順

  1. RHCOS 検出 ISO をターゲットホストにアタッチします。
  2. サーバーの BIOS 設定で起動ドライブの順序を設定して、アタッチされた検出 ISO から起動し、サーバーを再起動します。
  3. 管理ホストで、ブラウザーに戻ります。ホストが、検出されたホストのリストに表示されるまで待ちます。必要に応じて、Assisted Clusters ページを再読み込みし、クラスター名を選択します。
  4. インストールウィザードの手順を完了します。使用可能なサブネットからのサブネットを含む、ネットワークの詳細を追加します。必要に応じて SSH 公開鍵を追加します。
  5. インストールの進捗を監視します。クラスターイベントを確認します。インストールプロセスがサーバーのハードディスクへのオペレーティングシステムイメージの書き込みを完了すると、サーバーが再起動します。

  6. 検出 ISO を削除し、インストールドライブから起動するようにサーバーをリセットします。

    サーバーが自動的に数回再起動し、コントロールプレーンがデプロイされます。

関連情報

13.2.2. 単一ノードの OpenShift を手動でインストールする

OpenShift Container Platform を単一ノードにインストールするには、最初にインストール ISO を生成してから、ISO からサーバーを起動します。openshift-install インストールプログラムを使用して、インストールを監視できます。

関連情報

13.2.2.1. coreos-installer によるインストール ISO の生成

OpenShift Container Platform を単一ノードにインストールするには、インストール ISO が必要です。これは、以下の手順で生成できます。

前提条件

  • podman をインストールします。
注記

DNS レコードを含むネットワーク要件については、「単一ノードに OpenShift をインストールするための要件」を参照してください。

手順

  1. OpenShift Container Platform バージョンを設定します。 

    $ OCP_VERSION=<ocp_version> 1
    1
    <ocp_version> を現在のバージョン (latest-4.14 など) に置き換えます。

  2. ホストアーキテクチャーを設定します。 

    $ ARCH=<architecture> 1
    1
    <architecture> をターゲットホストアーキテクチャー (aarch64 や x86_64 など) に置き換えます。

  3. OpenShift Container Platform クライアント (oc) をダウンロードし、次のコマンドを入力して使用できるようにします。 

    $ curl -k https://mirror.openshift.com/pub/openshift-v4/clients/ocp/$OCP_VERSION/openshift-client-linux.tar.gz -o oc.tar.gz
    $ tar zxf oc.tar.gz
    $ chmod +x oc

  4. OpenShift Container Platform インストーラーをダウンロードし、以下のコマンドを入力して使用できるようにします。 

    $ curl -k https://mirror.openshift.com/pub/openshift-v4/clients/ocp/$OCP_VERSION/openshift-install-linux.tar.gz -o openshift-install-linux.tar.gz
    $ tar zxvf openshift-install-linux.tar.gz
    $ chmod +x openshift-install

  5. 次のコマンドを実行して、RHCOS ISO URL を取得します。 

    $ ISO_URL=$(./openshift-install coreos print-stream-json | grep location | grep $ARCH | grep iso | cut -d\" -f4)

  6. RHCOS ISO をダウンロードします。 

    $ curl -L $ISO_URL -o rhcos-live.iso

  7. install-config.yaml ファイルを作成します。 

    apiVersion: v1
baseDomain: <domain> 1
compute:
- name: worker
  replicas: 0 2
controlPlane:
  name: master
  replicas: 1 3
metadata:
  name: <name> 4
networking: 5
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16 6
  networkType: OVNKubernetes
  serviceNetwork:
  - 172.30.0.0/16
platform:
  none: {}
bootstrapInPlace:
  installationDisk: /dev/disk/by-id/<disk_id> 7
pullSecret: '<pull_secret>' 8
sshKey: |
  <ssh_key> 9
    1
    クラスタードメイン名を追加します。
    2
    compute レプリカを 0 に設定します。これにより、コントロールプレーンノードがスケジュール可能になります。
    3
    controlPlane レプリカを 1 に設定します。この設定は、以前の compute 設定と組み合わせて、クラスターが単一ノードで実行されるようにします。
    4
    メタデータ 名をクラスター名に設定します。
    5
    networking の詳細を設定します。OVN-Kubernetes は、単一ノードクラスターで許可されている唯一のネットワークプラグインタイプです。
    6
    単一ノードの OpenShift クラスターのサブネットと一致するように cidr 値を設定します。
    7
    インストールディスクドライブへのパスを設定します (例: /dev/disk/by-id/wwn-0x64cd98f04fde100024684cf3034da5c2)。
    8
    Red Hat OpenShift Cluster Manager からプルシークレット をコピーし、その内容をこの設定に追加します。
    9
    インストール後にクラスターにログインできるように、管理ホストから公開 SSH 鍵を追加します。

  8. 以下のコマンドを実行して、OpenShift Container Platform アセットを生成します。 

    $ mkdir ocp
    $ cp install-config.yaml ocp
    $ ./openshift-install --dir=ocp create single-node-ignition-config

  9. 以下のコマンドを実行して、Ignition データを RHCOS ISO に埋め込みます。 

    $ alias coreos-installer='podman run --privileged --pull always --rm \
        -v /dev:/dev -v /run/udev:/run/udev -v $PWD:/data \
        -w /data quay.io/coreos/coreos-installer:release'
    $ coreos-installer iso ignition embed -fi ocp/bootstrap-in-place-for-live-iso.ign rhcos-live.iso

関連情報

13.2.2.2. openshift-install を使用したクラスターのインストールの監視

openshift-install を使用して、単一ノードクラスターのインストールの進行状況を監視します。

手順

  1. 変更した RHCOS インストール ISO をターゲットホストにアタッチします。
  2. サーバーの BIOS 設定で起動ドライブの順序を設定して、アタッチされた検出 ISO から起動し、サーバーを再起動します。

  3. 管理ホストで、次のコマンドを実行してインストールを監視します。 

    $ ./openshift-install --dir=ocp wait-for install-complete

    コントロールプレーンのデプロイ中にサーバーが数回再起動します。

検証

  • インストールが完了したら、次のコマンドを実行して環境を確認します。 

    $ export KUBECONFIG=ocp/auth/kubeconfig
    $ oc get nodes

    出力例

    NAME                         STATUS   ROLES           AGE     VERSION
control-plane.example.com    Ready    master,worker   10m     v1.27.3

関連情報

13.2.3. クラウドプロバイダーへのシングルノード OpenShift のインストール

13.2.3.1. クラウドプロバイダーにシングルノード OpenShift をインストールするための追加要件

クラウドプロバイダー上で installer-provisioned installation に関するドキュメントは、3 つのコントロールプレーンノードで構成される高可用性クラスターに基づいています。ドキュメントを参照するときは、単一ノード OpenShift クラスターと高可用性クラスターの要件の違いを考慮してください。

  • 高可用性クラスターには、一時的なブートストラップマシン、3 台のコントロールプレーンマシン、および少なくとも 2 台のコンピュートマシンが必要です。シングルノード OpenShift クラスターの場合、必要なのは一時ブートストラップマシンと、コントロールプレーンノード用の 1 つのクラウドインスタンスのみであり、ワーカーノードは必要ありません。
  • 高可用性クラスターのインストールの最小リソース要件には、4 つの vCPU と 100 GB のストレージを備えたコントロールプレーンノードが含まれます。シングルノードの OpenShift クラスターの場合、最低 8 個の仮想 CPU と 120 GB のストレージが必要です。
  • install-config.yaml ファイルの controlPlane.replicas 設定は 1 に設定する必要があります。
  • install-config.yaml ファイルの compute.replicas 設定は 0 に設定する必要があります。これにより、コントロールプレーンノードがスケジュール可能になります。

13.2.3.2. シングルノード OpenShift でサポートされているクラウドプロバイダー

次の表には、サポートされているクラウドプロバイダーと CPU アーキテクチャーのリストが含まれています。

表13.3 サポートされているクラウドプロバイダー
クラウドプロバイダーCPU アーキテクチャー

Amazon Web Service (AWS)

x86_64 and AArch64

Microsoft Azure

x86_64

Google Cloud Platform (GCP)

x86_64 and AArch64

13.2.3.3. AWS への単一ノード OpenShift のインストール

単一ノードクラスターを AWS にインストールするには、「カスタマイズを使用した AWS へのクラスターのインストール」手順を使用して、installer-provisioned installation が必要です。

関連情報

13.2.3.4. Azure への単一ノード OpenShift のインストール

シングルノードクラスターを Azure にインストールするには、「カスタマイズを使用した Azure へのクラスターのインストール」手順を使用して、installer-provisioned installation が必要です。

関連情報

13.2.3.5. GCP への単一ノード OpenShift のインストール

単一ノードクラスターを GCP にインストールするには、「カスタマイズを使用した GCP へのクラスターのインストール」手順を使用して、installer-provisioned installation が必要です。

関連情報

13.2.4. USB ドライブに起動可能な ISO イメージを作成する

ISO イメージを含む起動可能な USB ドライブを使用して、ソフトウェアをインストールできます。USB ドライブを使用してサーバーを起動すると、ソフトウェアをインストールするサーバーの準備が整います。

手順

  1. 管理ホストで、USB ドライブを USB ポートに挿入します。

  2. 起動可能な USB ドライブを作成します。以下に例を示します。 

    # dd if=<path_to_iso> of=<path_to_usb> status=progress

    ここでは、以下のようになります。

    <path_to_iso>
    rhcos-live.iso など、ダウンロードした ISO ファイルへの相対パスです。
    <path_to_usb>
    /dev/sdb など、接続された USB ドライブの場所です。

    ISO が USB ドライブにコピーされたら、USB ドライブを使用してサーバーにソフトウェアをインストールできます。

13.2.5. Redfish API を使用した HTTP ホスト ISO イメージからの起動

Redfish Baseboard Management Controller (BMC) API を使用してインストールした ISO を使用して、ネットワーク内のホストをプロビジョニングできます。

注記

この手順例では、Dell サーバーでの手順を示します。

重要

ハードウェアと互換性のある iDRAC の最新ファームウェアバージョンがあることを確認してください。ハードウェアまたはファームウェアに問題がある場合は、プロバイダーに連絡する必要があります。

前提条件

  • インストール Red Hat Enterprise Linux CoreOS (RHCOS) ISO をダウンロードしている。
  • iDRAC9 と互換性のある Dell PowerEdge サーバーを使用している。

手順

  1. ネットワークでアクセス可能な HTTP サーバーに ISO ファイルをコピーします。

  2. ホストされている ISO ファイルからホストを起動します。以下に例を示します。

    1. 次のコマンドを実行して、Redfish API を呼び出し、ホストされている ISO を VirtualMedia ブートメディアとして設定します。 

      $ curl -k -u <bmc_username>:<bmc_password> -d '{"Image":"<hosted_iso_file>", "Inserted": true}' -H "Content-Type: application/json" -X POST <host_bmc_address>/redfish/v1/Managers/iDRAC.Embedded.1/VirtualMedia/CD/Actions/VirtualMedia.InsertMedia

      ここでは、以下のようになります。

      <bmc_username>:<bmc_password>
      ターゲットホスト BMC のユーザー名とパスワードです。
      <hosted_iso_file>
      ホストされたインストール ISO の URL です (例: http://webserver.example.com/rhcos-live-minimal.iso)。ISO は、ターゲットホストマシンからアクセスできる必要があります。
      <host_bmc_address>
      ターゲットホストマシンの BMC IP アドレスです。

    2. 次のコマンドを実行して、VirtualMedia デバイスから起動するようにホストを設定します。 

      $ curl -k -u <bmc_username>:<bmc_password> -X PATCH -H 'Content-Type: application/json' -d '{"Boot": {"BootSourceOverrideTarget": "Cd", "BootSourceOverrideMode": "UEFI", "BootSourceOverrideEnabled": "Once"}}' <host_bmc_address>/redfish/v1/Systems/System.Embedded.1

    3. ホストを再起動します。 

      $ curl -k -u <bmc_username>:<bmc_password> -d '{"ResetType": "ForceRestart"}' -H 'Content-type: application/json' -X POST <host_bmc_address>/redfish/v1/Systems/System.Embedded.1/Actions/ComputerSystem.Reset

    4. オプション: ホストの電源がオフになっている場合は、{"ResetType": "On"} スイッチを使用して起動できます。以下のコマンドを実行します。 

      $ curl -k -u <bmc_username>:<bmc_password> -d '{"ResetType": "On"}' -H 'Content-type: application/json' -X POST <host_bmc_address>/redfish/v1/Systems/System.Embedded.1/Actions/ComputerSystem.Reset

13.2.6. リモートサーバーアクセス用のカスタムライブ RHCOS ISO の作成

場合によっては、外部ディスクドライブをサーバーに接続することはできませんが、サーバーにリモートアクセスしてノードをプロビジョニングする必要があります。サーバーへの SSH アクセスを有効にすることを推奨します。起動後にサーバーにアクセスできるように、SSHd を有効にし、事前定義された認証情報を使用してライブ RHCOS ISO を作成できます。

前提条件

  • butane ユーティリティーをインストールしました。

手順

  1. coreos-installer イメージ ミラー ページから coreos-installer バイナリーをダウンロードします。
  2. mirror.openshift.com から最新のライブ RHCOS ISO をダウンロードします。

  3. butane ユーティリティーが Ignition ファイルの作成に使用する embedded.yaml ファイルを作成します。 

    variant: openshift
version: 4.14.0
metadata:
  name: sshd
  labels:
    machineconfiguration.openshift.io/role: worker
passwd:
  users:
    - name: core 1
      ssh_authorized_keys:
        - '<ssh_key>'
    1
    core ユーザーには sudo 権限があります。

  4. butane ユーティリティーを実行し、以下のコマンドを使用して Ignition ファイルを作成します。 

    $ butane -pr embedded.yaml -o embedded.ign

  5. Ignition ファイルが作成されたら、coreos-installer ユーティリティーを使用して、rhcos-sshd-4.14.0-x86_64-live.x86_64.iso という名前の新しいライブ RHCOS ISO に設定を含めることができます。 

    $ coreos-installer iso ignition embed -i embedded.ign rhcos-4.14.0-x86_64-live.x86_64.iso -o rhcos-sshd-4.14.0-x86_64-live.x86_64.iso

検証

  • 次のコマンドを実行して、カスタムライブ ISO を使用してサーバーを起動できることを確認します。 

    # coreos-installer iso ignition show rhcos-sshd-4.14.0-x86_64-live.x86_64.iso

    出力例

    {
  "ignition": {
    "version": "3.2.0"
  },
  "passwd": {
    "users": [
      {
        "name": "core",
        "sshAuthorizedKeys": [
          "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCZnG8AIzlDAhpyENpK2qKiTT8EbRWOrz7NXjRzopbPu215mocaJgjjwJjh1cYhgPhpAp6M/ttTk7I4OI7g4588Apx4bwJep6oWTU35LkY8ZxkGVPAJL8kVlTdKQviDv3XX12l4QfnDom4tm4gVbRH0gNT1wzhnLP+LKYm2Ohr9D7p9NBnAdro6k++XWgkDeijLRUTwdEyWunIdW1f8G0Mg8Y1Xzr13BUo3+8aey7HLKJMDtobkz/C8ESYA/f7HJc5FxF0XbapWWovSSDJrr9OmlL9f4TfE+cQk3s+eoKiz2bgNPRgEEwihVbGsCN4grA+RzLCAOpec+2dTJrQvFqsD alosadag@sonnelicht.local"
        ]
      }
    ]
  }
}

13.2.7. IBM Z および IBM LinuxONE を使用したシングルノード OpenShift のインストール

IBM Z® および IBM® LinuxONE にシングルノードクラスターをインストールするには、「IBM Z® および IBM® LinuxONE への RHEL KVM を使用したクラスターのインストール」または「IBM Z® および IBM® LinuxONE への z/VM を使用したクラスターのインストール」のいずれかの手順を参照して、ユーザーがプロビジョニングしたインストールを行う必要があります。

注記

IBM Z® にシングルノードクラスターをインストールすると、開発環境およびテスト環境のインストールが簡素化され、エントリーレベルで必要なリソース要件が少なくなります。

ハードウェア要件
  • クラスターごとに、SMT2 対応の 2 つの Integrated Facilities for Linux (IFL) に相当します。
  • 最低でもネットワーク接続 1 つ。これで、LoadBalancer サービスに接続するだけでなく、クラスター外のトラッフィクに関するデータを提供します。
注記

専用または共有 IFL を使用して、十分なコンピューティングリソースを割り当てることができます。リソース共有は IBM Z® の重要な強みの 1 つです。ただし、各ハイパーバイザーレイヤーで容量を正しく調整し、すべての OpenShift Container Platform クラスターに十分なリソースを確保する必要があります。

関連情報

13.2.7.1. IBM Z および IBM LinuxONE での z/VM を使用したシングルノード OpenShift のインストール

前提条件

  • podman をインストールしている。

手順

  1. 次のコマンドを実行して、OpenShift Container Platform のバージョンを設定します。 

    $ OCP_VERSION=<ocp_version> 1
    1
    <ocp_version> を現在のバージョン (latest-4.14 など) に置き換えます。

  2. 次のコマンドを実行して、ホストアーキテクチャーを設定します。 

    $ ARCH=<architecture> 1
    1
    <architecture> をターゲットホストアーキテクチャー s390x に置き換えます。

  3. OpenShift Container Platform クライアント (oc) をダウンロードし、次のコマンドを入力して使用できるようにします。 

    $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-client-linux.tar.gz -o oc.tar.gz
    $ tar zxf oc.tar.gz
    $ chmod +x oc

  4. OpenShift Container Platform インストーラーをダウンロードし、以下のコマンドを入力して使用できるようにします。 

    $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-install-linux.tar.gz -o openshift-install-linux.tar.gz
    $ tar zxvf openshift-install-linux.tar.gz
    $ chmod +x openshift-install

  5. install-config.yaml ファイルを作成します。 

    apiVersion: v1
baseDomain: <domain> 1
compute:
- name: worker
  replicas: 0 2
controlPlane:
  name: master
  replicas: 1 3
metadata:
  name: <name> 4
networking: 5
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16 6
  networkType: OVNKubernetes
  serviceNetwork:
  - 172.30.0.0/16
platform:
  none: {}
bootstrapInPlace:
  installationDisk: /dev/disk/by-id/<disk_id> 7
pullSecret: '<pull_secret>' 8
sshKey: |
  <ssh_key> 9
    1
    クラスタードメイン名を追加します。
    2
    compute レプリカを 0 に設定します。これにより、コントロールプレーンノードがスケジュール可能になります。
    3
    controlPlane レプリカを 1 に設定します。この設定は、以前の compute 設定と組み合わせて、クラスターが単一ノードで実行されるようにします。
    4
    メタデータ 名をクラスター名に設定します。
    5
    networking の詳細を設定します。OVN-Kubernetes は、単一ノードクラスターで許可されている唯一のネットワークプラグインタイプです。
    6
    単一ノードの OpenShift クラスターのサブネットと一致するように cidr 値を設定します。
    7
    インストールディスクドライブへのパスを設定します (例: /dev/disk/by-id/wwn-0x64cd98f04fde100024684cf3034da5c2)。
    8
    Red Hat OpenShift Cluster Manager からプルシークレット をコピーし、その内容をこの設定に追加します。
    9
    インストール後にクラスターにログインできるように、管理ホストから公開 SSH 鍵を追加します。

  6. 以下のコマンドを実行して、OpenShift Container Platform アセットを生成します。 

    $ mkdir ocp
    $ cp install-config.yaml ocp
    $ ./openshift-install --dir=ocp create single-node-ignition-config

  7. Red Hat カスタマーポータルの 製品ダウンロード ページまたは RHCOS イメージミラー ページから、RHEL kernel、initramfs、および rootfs アーティファクトを取得します。

    重要

    RHCOS イメージは OpenShift Container Platform の各リリースごとに変更されない可能性があります。インストールする OpenShift Container Platform バージョンと等しいか、それ以下のバージョンの内で最も新しいバージョンのイメージをダウンロードする必要があります。この手順で説明されている適切な kernel、initramfs、および rootfs アーティファクトのみを使用します。

    ファイル名には、OpenShift Container Platform のバージョン番号が含まれます。以下の例のようになります。

    kernel
    rhcos-<version>-live-kernel-<architecture>
    initramfs
    rhcos-<version>-live-initramfs.<architecture>.img
    rootfs

    rhcos-<version>-live-rootfs.<architecture>.img

    注記

    rootfs イメージは FCP および DASD の場合と同じです。

  8. 次のアーティファクトとファイルを HTTP または HTTPS サーバーに移動します。

    • ダウンロードされた RHEL ライブ kernel、initramfs、および rootfs アーティファクト
    • Ignition ファイル

  9. 特定の仮想マシンのパラメーターファイルを作成します。

    パラメーターファイルの例

    rd.neednet=1 \
console=ttysclp0 \
coreos.live.rootfs_url=<rhcos_liveos>:8080/rootfs.img \1
ignition.firstboot ignition.platform.id=metal \
ignition.config.url=<rhcos_ign>:8080/ignition/bootstrap-in-place-for-live-iso.ign \2
ip=encbdd0:dhcp::02:00:00:02:34:02 3
rd.znet=qeth,0.0.bdd0,0.0.bdd1,0.0.bdd2,layer2=1 \
rd.dasd=0.0.4411 \4
rd.zfcp=0.0.8001,0x50050763040051e3,0x4000406300000000 \5
zfcp.allow_lun_scan=0 \
rd.luks.options=discard

    1
    coreos.live.rootfs_url= アーティファクトには、起動している kernel` および `initramfs に一致する rootfs アーティファクトを指定します。HTTP プロトコルおよび HTTPS プロトコルのみがサポートされます。
    2
    ignition.config.url= パラメーターには、マシンロールの Ignition ファイルを指定します。HTTP プロトコルおよび HTTPS プロトコルのみがサポートされます。
    3
    ip= パラメーターの場合は、DHCP を使用して自動的に IP アドレスを割り当てるか、「IBM Z® および IBM® LinuxONE での z/VM を使用したクラスターのインストールの説明」に従って手動で IP アドレスを割り当てます。
    4
    DASD タイプのディスクにインストールする場合は、rd.dasd= を使用して、RHCOS がインストールされる DASD を指定します。FCP タイプのディスクの場合は、このエントリーを省略します。
    5
    FCP タイプのディスクにインストールする場合は、rd.zfcp=<adapter>,<wwpn>,<lun> を使用して、RHCOS がインストールされる FCP ディスクを指定します。DASD タイプのディスクの場合は、このエントリーを省略します。

    その他のパラメーターはすべて変更しません。

  10. 次のアーティファクト、ファイル、イメージを z/VM に転送します。たとえば、FTP を使用する場合は以下のようになります。

    • kernel と initramfs アーティファクト
    • パラメーターファイル

    • RHCOS イメージ

      FTP でファイルを転送し、仮想リーダーから起動する方法については、Z/VM 環境へのインストール を参照してください。

  11. ブートストラップノードになる z/VM ゲスト仮想マシンの仮想リーダーに対してファイルの punch を実行します。
  12. ブートストラップマシンで CMS にログインします。

  13. 次のコマンドを実行して、リーダーからブートストラップマシンを IPL します。 

    $ cp ipl c

  14. 仮想マシンを最初に再起動した後、次のコマンドを直接続けて実行します。

    1. 最初の再起動後に DASD デバイスを起動するには、次のコマンドを実行します。 

      $ cp i <devno> clear loadparm prompt

      ここでは、以下のようになります。

      <devno>
      ゲストから見えるブートデバイスのデバイス番号を指定します。 
      $ cp vi vmsg 0 <kernel_parameters>

      ここでは、以下のようになります。

      <kernel_parameters>
      システム制御プログラムデータ (SCPDATA) として保存されるカーネルパラメーターのセットを指定します。Linux をブートするとき、これらのカーネルパラメーターは、ブート設定で使用される既存のカーネルパラメーターの末尾に連結されます。組み合わせたパラメーター文字列は 896 文字を超えてはなりません。

    2. 最初の再起動後に FCP デバイスを起動するには、次のコマンドを実行します。 

      $ cp set loaddev portname <wwpn> lun <lun>

      ここでは、以下のようになります。

      <wwpn>
      ターゲットポートと <lun> 論理ユニットを 16 進数形式で指定します。 
      $ cp set loaddev bootprog <n>

      ここでは、以下のようになります。

      <n>
      ブートするカーネルを指定します。 
      $ cp set loaddev scpdata {APPEND|NEW} '<kernel_parameters>'

      ここでは、以下のようになります。

      <kernel_parameters>
      システム制御プログラムデータ (SCPDATA) として保存されるカーネルパラメーターのセットを指定します。Linux をブートするとき、これらのカーネルパラメーターは、ブート設定で使用される既存のカーネルパラメーターの末尾に連結されます。組み合わせたパラメーター文字列は 896 文字を超えてはなりません。
      <APPEND|NEW>
      オプション: カーネルパラメーターを既存の SCPDATA に追加するには、APPEND を指定します。これはデフォルトになります。NEW を指定して既存の SCPDATA を置き換えます。

      例

      $ cp set loaddev scpdata 'rd.zfcp=0.0.8001,0x500507630a0350a4,0x4000409D00000000
ip=encbdd0:dhcp::02:00:00:02:34:02 rd.neednet=1'

      IPL およびブートプロセスを開始するには、次のコマンドを実行します。 

      $ cp i <devno>

      ここでは、以下のようになります。

      <devno>
      ゲストから見えるブートデバイスのデバイス番号を指定します。

13.2.7.2. IBM Z および IBM LinuxONE での RHEL KVM を使用したシングルノード OpenShift のインストール

前提条件

  • podman をインストールしている。

手順

  1. 次のコマンドを実行して、OpenShift Container Platform のバージョンを設定します。 

    $ OCP_VERSION=<ocp_version> 1
    1
    <ocp_version> を現在のバージョン (latest-4.14 など) に置き換えます。

  2. 次のコマンドを実行して、ホストアーキテクチャーを設定します。 

    $ ARCH=<architecture> 1
    1
    <architecture> をターゲットホストアーキテクチャー s390x に置き換えます。

  3. OpenShift Container Platform クライアント (oc) をダウンロードし、次のコマンドを入力して使用できるようにします。 

    $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-client-linux.tar.gz -o oc.tar.gz
    $ tar zxf oc.tar.gz
    $ chmod +x oc

  4. OpenShift Container Platform インストーラーをダウンロードし、以下のコマンドを入力して使用できるようにします。 

    $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-install-linux.tar.gz -o openshift-install-linux.tar.gz
    $ tar zxvf openshift-install-linux.tar.gz
    $ chmod +x openshift-install

  5. install-config.yaml ファイルを作成します。 

    apiVersion: v1
baseDomain: <domain> 1
compute:
- name: worker
  replicas: 0 2
controlPlane:
  name: master
  replicas: 1 3
metadata:
  name: <name> 4
networking: 5
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16 6
  networkType: OVNKubernetes
  serviceNetwork:
  - 172.30.0.0/16
platform:
  none: {}
bootstrapInPlace:
  installationDisk: /dev/disk/by-id/<disk_id> 7
pullSecret: '<pull_secret>' 8
sshKey: |
  <ssh_key> 9
    1
    クラスタードメイン名を追加します。
    2
    compute レプリカを 0 に設定します。これにより、コントロールプレーンノードがスケジュール可能になります。
    3
    controlPlane レプリカを 1 に設定します。この設定は、以前の compute 設定と組み合わせて、クラスターが単一ノードで実行されるようにします。
    4
    メタデータ 名をクラスター名に設定します。
    5
    networking の詳細を設定します。OVN-Kubernetes は、単一ノードクラスターで許可されている唯一のネットワークプラグインタイプです。
    6
    単一ノードの OpenShift クラスターのサブネットと一致するように cidr 値を設定します。
    7
    インストールディスクドライブへのパスを設定します (例: /dev/disk/by-id/wwn-0x64cd98f04fde100024684cf3034da5c2)。
    8
    Red Hat OpenShift Cluster Manager からプルシークレット をコピーし、その内容をこの設定に追加します。
    9
    インストール後にクラスターにログインできるように、管理ホストから公開 SSH 鍵を追加します。

  6. 以下のコマンドを実行して、OpenShift Container Platform アセットを生成します。 

    $ mkdir ocp
    $ cp install-config.yaml ocp
    $ ./openshift-install --dir=ocp create single-node-ignition-config

  7. Red Hat カスタマーポータルの 製品ダウンロード ページまたは RHCOS イメージミラー ページから、RHEL kernel、initramfs、および rootfs アーティファクトを取得します。

    重要

    RHCOS イメージは OpenShift Container Platform の各リリースごとに変更されない可能性があります。インストールする OpenShift Container Platform バージョンと等しいか、それ以下のバージョンの内で最も新しいバージョンのイメージをダウンロードする必要があります。この手順で説明されている適切な kernel、initramfs、および rootfs アーティファクトのみを使用します。

    ファイル名には、OpenShift Container Platform のバージョン番号が含まれます。以下の例のようになります。

    kernel
    rhcos-<version>-live-kernel-<architecture>
    initramfs
    rhcos-<version>-live-initramfs.<architecture>.img
    rootfs
    rhcos-<version>-live-rootfs.<architecture>.img

  8. virt-install を起動する前に、次のファイルとアーティファクトを HTTP または HTTPS サーバーに移動します。

    • ダウンロードされた RHEL ライブ kernel、initramfs、および rootfs アーティファクト
    • Ignition ファイル

  9. 次のコンポーネントを使用して、KVM ゲストノードを作成します。

    • RHEL の kernel および initramfs アーティファクト
    • Ignition ファイル
    • 新しいディスクイメージ
    • 調整された parm ライン引数 
$ virt-install \
   --name <vm_name> \
   --autostart \
   --memory=<memory_mb> \
   --cpu host \
   --vcpus <vcpus> \
   --location <media_location>,kernel=<rhcos_kernel>,initrd=<rhcos_initrd> \1
   --disk size=100 \
   --network network=<virt_network_parm> \
   --graphics none \
   --noautoconsole \
   --extra-args "ip=<ip>::<gateway>:<mask>:<hostname>::none" \
   --extra-args "nameserver=<name_server>" \
   --extra-args "ip=dhcp rd.neednet=1 ignition.platform.id=metal ignition.firstboot" \
   --extra-args "coreos.live.rootfs_url=<rhcos_liveos>" \2
   --extra-args "ignition.config.url=<rhcos_ign>" \3
   --extra-args "random.trust_cpu=on rd.luks.options=discard" \
   --extra-args "console=ttysclp0" \
   --wait
1
--location パラメーターには、HTTP または HTTPS サーバー上の kernel/initrd の場所を指定します。
2
coreos.live.rootfs_url= アーティファクトには、起動している kernel と initramfs に一致する rootfs アーティファクトを指定します。HTTP プロトコルおよび HTTPS プロトコルのみがサポートされます。
3
ignition.config.url= パラメーターには、マシンロールの Ignition ファイルを指定します。HTTP プロトコルおよび HTTPS プロトコルのみがサポートされます。

13.2.8. IBM Power を使用した単一ノード OpenShift のインストール

IBM Power® に単一ノードクラスターをインストールするには、「IBM Power® を使用したクラスターのインストール」手順を使用して、user-provisioned installation が必要です。

注記

IBM Power® にシングルノードクラスターをインストールすると、開発環境およびテスト環境のインストールが簡素化され、エントリーレベルで必要なリソース要件が少なくなります。

ハードウェア要件
  • クラスターごとに、SMT2 対応の 2 つの Integrated Facilities for Linux (IFL) に相当します。
  • 最低でもネットワーク接続 1 つ。これで、LoadBalancer サービスに接続するだけでなく、クラスター外のトラッフィクに関するデータを提供します。
注記

専用または共有 IFL を使用して、十分なコンピューティングリソースを割り当てることができます。リソース共有は IBM Power® の重要な強みの 1 つです。ただし、各ハイパーバイザーレイヤーで容量を正しく調整し、すべての OpenShift Container Platform クラスターに十分なリソースを確保する必要があります。

関連情報

13.2.8.1. IBM Power を使用した単一ノード OpenShift の基礎のセットアップ

IBM Power® に単一ノード OpenShift をインストールする前に、踏み台をセットアップする必要があります。IBM Power® 上でシングルノード OpenShift の踏み台サーバーをセットアップするには、以下のサービスの設定が必要です。

  • PXE は、単一ノード OpenShift クラスターのインストールに使用されます。PXE では、次のサービスを設定して実行する必要があります。

    • api、api-int、および *.apps を定義する DNS
    • PXE を有効にし、単一ノードの OpenShift ノードに IP アドレスを割り当てる DHCP サービス
    • Ignition および RHCOS rootfs イメージを提供する HTTP
    • TFTP による PXE の有効化
  • DNS、DHCP、PXE、HTTP の httpd をサポートするには、dnsmasq をインストールする必要があります。

これらの要件を満たす踏み台サーバーを設定するには、次の手順を使用します。

手順

  1. 次のコマンドを使用して grub2 をインストールします。これは PowerVM の PXE を有効にするために必要です。 

    grub2-mknetdir --net-directory=/var/lib/tftpboot

    /var/lib/tftpboot/boot/grub2/grub.cfg ファイルの例

    default=0
fallback=1
timeout=1
if [ ${net_default_mac} == fa:b0:45:27:43:20 ]; then
menuentry "CoreOS (BIOS)" {
   echo "Loading kernel"
   linux "/rhcos/kernel" ip=dhcp rd.neednet=1 ignition.platform.id=metal ignition.firstboot coreos.live.rootfs_url=http://192.168.10.5:8000/install/rootfs.img ignition.config.url=http://192.168.10.5:8000/ignition/sno.ign
   echo "Loading initrd"
   initrd  "/rhcos/initramfs.img"
}
fi

  2. 次のコマンドを使用して、PXE のミラーリポジトリーから RHCOS イメージファイルをダウンロードします。

    1. 次のコマンドを入力して、RHCOS_URL 変数に次の 4.12 URL を割り当てます。 

      $ export RHCOS_URL=https://mirror.openshift.com/pub/openshift-v4/ppc64le/dependencies/rhcos/4.12/latest/

    2. 次のコマンドを入力して、/var/lib/tftpboot/rhcos ディレクトリーに移動します。 

      $ cd /var/lib/tftpboot/rhcos

    3. 次のコマンドを実行して、RHCOS_URL 変数に保存されている URL から指定された RHCOS カーネルファイルをダウンロードします。 

      $ wget ${RHCOS_URL}/rhcos-live-kernel-ppc64le -o kernel

    4. 次のコマンドを入力して、RHCOS_URL 変数に保存されている URL から RHCOS initramfs ファイルをダウンロードします。 

      $ wget ${RHCOS_URL}/rhcos-live-initramfs.ppc64le.img -o initramfs.img

    5. 次のコマンドを実行して、/var//var/www/html/install/ ディレクトリーに移動します。 

      $ cd /var//var/www/html/install/

    6. 次のコマンドを入力して、RHCOS_URL 変数に保存されている URL から RHCOS root filesystem イメージファイルをダウンロードして保存します。 

      $ wget ${RHCOS_URL}/rhcos-live-rootfs.ppc64le.img -o rootfs.img

  3. 単一ノード OpenShift クラスターの ignition ファイルを作成するには、install-config.yaml ファイルを作成する必要があります。

    1. 次のコマンドを入力して、ファイルを保持する作業ディレクトリーを作成します。 

      $ mkdir -p ~/sno-work

    2. 次のコマンドを入力して、~/sno-work ディレクトリーに移動します。 

      $ cd ~/sno-work

    3. 次のサンプルファイルを使用して、必要な install-config.yaml を ~/sno-work ディレクトリーに作成できます。 

      apiVersion: v1
baseDomain: <domain> 1
compute:
- name: worker
  replicas: 0 2
controlPlane:
  name: master
  replicas: 1 3
metadata:
  name: <name> 4
networking: 5
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16 6
  networkType: OVNKubernetes
  serviceNetwork:
  - 172.30.0.0/16
platform:
  none: {}
bootstrapInPlace:
  installationDisk: /dev/disk/by-id/<disk_id> 7
pullSecret: '<pull_secret>' 8
sshKey: |
  <ssh_key> 9
      1
      クラスタードメイン名を追加します。
      2
      compute レプリカを 0 に設定します。これにより、コントロールプレーンノードがスケジュール可能になります。
      3
      controlPlane レプリカを 1 に設定します。この設定は、以前の compute 設定と組み合わせて、クラスターが単一ノードで実行されるようにします。
      4
      メタデータ 名をクラスター名に設定します。
      5
      networking の詳細を設定します。OVN-Kubernetes は、単一ノードクラスターで許可されている唯一のネットワークプラグインタイプです。
      6
      単一ノードの OpenShift クラスターのサブネットと一致するように cidr 値を設定します。
      7
      インストールディスクドライブへのパスを設定します (例: /dev/disk/by-id/wwn-0x64cd98f04fde100024684cf3034da5c2)。
      8
      Red Hat OpenShift Cluster Manager からプルシークレット をコピーし、その内容をこの設定に追加します。
      9
      インストール後にクラスターにログインできるように、管理ホストから公開 SSH 鍵を追加します。

  4. openshift-install イメージをダウンロードして ignition ファイルを作成し、それを http ディレクトリーにコピーします。

    1. 次のコマンドを実行して、openshift-install-linux-4.12.0 .tar ファイルをダウンロードします。 

      $ wget https://mirror.openshift.com/pub/openshift-v4/ppc64le/clients/ocp/4.12.0/openshift-install-linux-4.12.0.tar.gz

    2. 次のコマンドを入力して、openshift-install-linux-4.12.0.tar.gz アーカイブを展開します。 

      $ tar xzvf openshift-install-linux-4.12.0.tar.gz

    3. 以下のコマンドを入力し、以下を実行します。 

      $ ./openshift-install --dir=~/sno-work create create single-node-ignition-config

    4. 次のコマンドを入力して、Ignition ファイルを作成します。 

      $ cp ~/sno-work/single-node-ignition-config.ign /var/www/html/ignition/sno.ign

    5. 次のコマンドを入力して、/var/www/html ディレクトリーの SELinux ファイルを復元します。 

      $ restorecon -vR /var/www/html || true

      踏み台には必要なファイルがすべて含まれており、単一ノードの OpenShift をインストールするために適切に設定されています。

13.2.8.2. IBM Power を使用した単一ノード OpenShift のインストール

前提条件

  • 踏み台を設定しました。

手順

単一ノード OpenShift クラスターのインストールには 2 つの手順があります。まず、単一ノードの OpenShift 論理パーティション (LPAR) を PXE で起動する必要があり、次にインストールの進行状況を監視する必要があります。

  1. 次のコマンドを使用して、netboot で powerVM を起動します。 

    $ lpar_netboot -i -D -f -t ent -m <sno_mac> -s auto -d auto -S <server_ip> -C <sno_ip> -G <gateway> <lpar_name> default_profile <cec_name>

    ここでは、以下のようになります。

    sno_mac
    シングルノード OpenShift クラスターの MAC アドレスを指定します。
    sno_ip
    単一ノード OpenShift クラスターの IP アドレスを指定します。
    server_ip
    踏み台 (PXE サーバー) の IP アドレスを指定します。
    gateway
    ネットワークのゲートウェイ IP を指定します。
    lpar_name
    HMC 内の単一ノード OpenShift lpar 名を指定します。
    cec_name
    sno_lpar が存在するシステム名を指定します。

  2. 単一ノード OpenShift LPAR が PXE で起動した後、openshift-install コマンドを使用してインストールの進行状況を監視します。

    1. ブートストラップが完了したら、次のコマンドを実行します。 

      ./openshift-install wait-for bootstrap-complete

    2. 正常に戻ったら、次のコマンドを実行します。 

      ./openshift-install wait-for install-complete
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.