17.4.2. シングルノード OpenShift のイメージベースのデプロイについて


openshift-install プログラムを使用すると、設定 ISO を手動で生成できます。設定 ISO をプリインストールされたホストにアタッチして、デプロイを完了します。

17.4.2.1. openshift-install プログラムを使用したシングルノード OpenShift クラスターのデプロイ

openshift-install プログラムを使用して、イメージベースのインストールでプリインストールしたホストを設定およびデプロイできます。サイト固有の詳細情報を使用してターゲットホストを設定するには、次のリソースを作成する必要があります。

  • install-config.yaml インストールマニフェスト
  • image-based-config.yaml マニフェスト

openshift-install プログラムは、これらのリソースを使用して設定 ISO を生成します。この設定 ISO をプリインストールされたターゲットホストにアタッチして、デプロイを完了します。

注記

image-based-config.yaml マニフェストの仕様の詳細は、「image-based-config.yaml マニフェストのリファレンス仕様」を参照してください。

前提条件

  • イメージベースのインストールを使用して、シングルノード OpenShift をホストにプリインストールした。
  • 最新バージョンの openshift-install プログラムをダウンロードした。
  • プルリクエストを認証するためのプルシークレットを作成した。詳細は、「イメージプルシークレットの使用」を参照してください。

手順

  1. 次のコマンドを実行して作業ディレクトリーを作成します。

    $ mkdir ibi-config-iso-workdir 
    1
    1
    ibi-config-iso-workdir は、作業ディレクトリーの名前に置き換えます。
  2. インストールマニフェストを作成します。

    1. install-config マニフェストを定義する YAML ファイルを作成します。

      install-config.yaml ファイルの例

      apiVersion: v1
      metadata:
        name: sno-cluster-name
      baseDomain: host.example.com
      compute:
        - architecture: amd64
          hyperthreading: Enabled
          name: worker
          replicas: 0
      controlPlane:
        architecture: amd64
        hyperthreading: Enabled
        name: master
        replicas: 1
      networking:
        machineNetwork: 
      1
      
        - cidr: 192.168.200.0/24
        #- cidr: fd01::/64
      platform:
        none: {}
      fips: false
      cpuPartitioningMode: "AllNodes"
      pullSecret: '{"auths":{"<your_pull_secret>"}}}'
      sshKey: 'ssh-rsa <your_ssh_pub_key>'

      1
      デュアルスタックネットワークの場合、リスト形式を使用して IPv4 と IPv6 の両方の CIDR を指定できます。リストの最初の CIDR はプライマリーアドレスファミリーであり、シードクラスターのプライマリーアドレスファミリーと一致する必要があります。
      重要

      クラスターをデプロイするのにプロキシー設定が必要な場合は、次の手順を実行する必要があります。

      • プロキシー設定を備えたシードクラスターからシードイメージを作成します。2 つのプロキシー設定が同じである必要はありません。
      • インストールマニフェストの machineNetwork フィールドを設定します。
    2. ファイルを作業ディレクトリーに保存します。
  3. オプション: 次のコマンドを実行して、作業ディレクトリーに設定テンプレートを作成します。

    $ openshift-install image-based create config-template --dir ibi-config-iso-workdir/

    出力例

    INFO Config-Template created in: ibi-config-iso-workdir

    このコマンドにより、作業ディレクトリーに image-based-config.yaml 設定テンプレートが作成されます。

    #
    # Note: This is a sample ImageBasedConfig file showing
    # which fields are available to aid you in creating your
    # own image-based-config.yaml file.
    #
    apiVersion: v1beta1
    kind: ImageBasedConfig
    metadata:
      name: example-image-based-config
    additionalNTPSources:
      - 0.rhel.pool.ntp.org
      - 1.rhel.pool.ntp.org
    hostname: change-to-hostname
    releaseRegistry: quay.io
    # networkConfig contains the network configuration for the host in NMState format.
    # See https://nmstate.io/examples.html for examples.
    networkConfig:
      interfaces:
        - name: eth0
          type: ethernet
          state: up
          mac-address: 00:00:00:00:00:00
          ipv4:
            enabled: true
            address:
              - ip: 192.168.122.2
                prefix-length: 23
            dhcp: false
  4. 設定ファイルを編集します。

    image-based-config.yaml ファイルの例

    #
    # Note: This is a sample ImageBasedConfig file showing
    # which fields are available to aid you in creating your
    # own image-based-config.yaml file.
    #
    apiVersion: v1beta1
    kind: ImageBasedConfig
    metadata:
      name: sno-cluster-name
    additionalNTPSources:
      - 0.rhel.pool.ntp.org
      - 1.rhel.pool.ntp.org
    hostname: host.example.com
    releaseRegistry: quay.io
    # networkConfig contains the network configuration for the host in NMState format.
    # See https://nmstate.io/examples.html for examples.
    networkConfig:
        interfaces:
          - name: ens1f0
            type: ethernet
            state: up
            ipv4:
              enabled: true
              dhcp: false
              auto-dns: false
              address:
                - ip: 192.168.200.25
                  prefix-length: 24
            ipv6:
              enabled: false
        dns-resolver:
          config:
            server:
              - 192.168.15.47
              - 192.168.15.48
        routes:
          config:
          - destination: 0.0.0.0/0
            metric: 150
            next-hop-address: 192.168.200.254
            next-hop-interface: ens1f0

  5. 次のコマンドを実行して、作業ディレクトリーに設定 ISO を作成します。

    $ openshift-install image-based create config-image --dir ibi-config-iso-workdir/

    出力例

    INFO Adding NMConnection file <ens1f0.nmconnection>
    INFO Consuming Install Config from target directory
    INFO Consuming Image-based Config ISO configuration from target directory
    INFO Config-Image created in: ibi-config-iso-workdir/auth

    作業ディレクトリーで出力を確認します。

    出力例

    ibi-config-iso-workdir/
    ├── auth
    │   ├── kubeadmin-password
    │   └── kubeconfig
    └── imagebasedconfig.iso

  6. 任意の方法を使用して imagebasedconfig.iso をプリインストールされたホストにアタッチします。ホストを再起動して設定プロセスを完了し、クラスターをデプロイします。

検証

ホストで設定プロセスが完了したら、クラスターにアクセスしてそのステータスを確認します。

  1. 次のコマンドを実行して、kubeconfig 環境変数を kubeconfig ファイルにエクスポートします。

    $ export KUBECONFIG=ibi-config-iso-workdir/auth/kubeconfig
  2. 次のコマンドを実行して、クラスターが応答していることを確認します。

    $ oc get nodes

    出力例

    NAME                                         STATUS   ROLES                  AGE     VERSION
    node/sno-cluster-name.host.example.com       Ready    control-plane,master   5h15m   v1.33.4

17.4.2.1.1. image-based-config.yaml マニフェストのリファレンス仕様

以下では、image-based-config.yaml マニフェストの仕様を説明します。

openshift-install プログラムは、image-based-config.yaml マニフェストを使用して、シングルノード OpenShift のイメージベースのデプロイ用にサイト固有の設定 ISO を作成します。

Expand
表17.9 必須の仕様
仕様説明

hostname

string

シングルノード OpenShift クラスターのノードの名前を定義します。

Expand
表17.10 任意の仕様
仕様説明

networkConfig

string

ホストのネットワーク設定を指定します。次に例を示します。

networkConfig:
    interfaces:
      - name: ens1f0
        type: ethernet
        state: up
        ...

静的ネットワークが必要な場合は、ライブインストール ISO を作成するホストに nmstatectl ライブラリーをインストールする必要があります。nmstate を使用してネットワーク設定を定義する方法の詳細は、nmstate.io を参照してください。

重要

インターフェイスの名前は、オペレーティングシステムに表示される実際の NIC 名と同じである必要があります。

additionalNTPSources

string

全クラスターホストの NTP ソースのリストを指定します。これらの NTP ソースは、クラスター内の既存の NTP ソースに追加されます。NTP ソースのホスト名または IP アドレスを使用できます。

releaseRegistry

string

シードクラスターのリリースイメージに使用したコンテナーイメージレジストリーを指定します。

nodeLabels

map[string]string

シングルノード OpenShift ノードのカスタムノードラベルを指定します。次に例を示します。

nodeLabels:
  node-role.kubernetes.io/edge: true
  environment: production
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

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

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

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

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

Legal Notice

Theme

© 2026 Red Hat
トップに戻る