コンテンツ・アウェア・ストレージ （CAS） イメージのミラーリング

IBM Fusion HCIは、様々な CAS バージョンをサポートしており、 IBM Fusion HCIとは独立して、一定の範囲内でアップグレードすることができる。 2.10.0 において、サポートされる CASのバージョン範囲は、任意のバージョン < v1.1.0 である。 この手順を複数回実行することで、サポートされる範囲内で CASの各新バージョンにアップグレードすることができます。

このタスクについて

CAS サービスをミラーリングするためのハイレベルなステップ：
  1. 関連する Docker 登録にログインする
  2. IBM Fusion HCI の CAS コンポーネントを構成し、ミラーリングするための変数を定義します。
  3. ibm-pak コンフィギュレーション・ツールを実行し、 oc-mirror CLIツールで必要なファイルを自動生成する。
  4. oc-mirror CLIツールを実行して、 CAS コンポーネントをミラーリングします。
注:
  • この手順は、 IBM Fusionをアップグレードせずに、オフライン CASを新しいバージョンにアップグレードする場合に使用します。
  • 特定のサブコンポーネントをミラーリングすることを選択した場合、同じTARGET_PATH変数を使用して、すべてのコンポーネントが同じ場所にミラーリングされ、生成される ImageDigestMirrorSet がすべてのコンポーネントで同じままになるようにします。
  • ネットワーク制限のためのエアギャップのセットアップの詳細について Red Hat®OpenShift® Container Platform Red Hat OpenShift Container Platform オフライン・セットアップを参照してください。

手順

  1. Docker レジストリにログインする：
    1. 以下のコマンドを実行し、 Red Hat エンタープライズ認証情報で Docker レジストリにログインする：
      docker login registry.redhat.io -u <Red Hat enterprise registry username> -p <Red Hat enterprise registry password>
    2. IBM エンタイトルメント・キーを使用して IBM エンタイトルメント Container Registry にログインする。
      docker login cp.icr.io -u cp -p <your entitlement key>
      注意： IBM Fusion HCIのエンタイトルメント・キーに正しいエンタイトルメントが含まれていることを確認してください。
    3. 以下の環境変数を設定する：
      export LOCAL_ISF_REGISTRY="<Your enterprise registry host>:<port>" 
export LOCAL_ISF_REPOSITORY="<Your image path>" 
export TARGET_PATH="$LOCAL_ISF_REGISTRY/$LOCAL_ISF_REPOSITORY" 
echo "$TARGET_PATH" 
export CASE_NAME=ibm-cas 
export CASE_VERSION=1.0.2
      注： LOCAL_ISF_REGISTRY 変数を設定する際、ポートは必須ではない値である。 企業レジストリにアクセス可能で、セキュアな接続があれば、これを無視してもよい。
      ポートなしのサンプル値：
      export LOCAL_ISF_REGISTRY="registryhost.com"
      export LOCAL_ISF_REGISTRY="registryhost.com:443"
export LOCAL_ISF_REPOSITORY="fusion-mirror"
    4. コマンドを実行して、企業レジストリの認証情報を使って Docker レジストリにログインする。
      docker login $LOCAL_ISF_REGISTRY -u <your enterprise registry username> -p <your enterprise registry password>

      LOCAL_ISF_REGISTRY はあなたの資格登録簿だ。

      LOCAL_ISF_REPOSITORY はミラーリングしたい画像のパスです。 リポジトリのパスは自由に選択できる。 例えば hci-2.10.0/isf または hci-2.10.0.

  2. oc-mirror コマンドを使用するように ibm-pak プラグインを設定する：
    oc ibm-pak config mirror-tools -e oc-mirror
  3. ミラーリングホストからgetコマンドを実行して、 IBM の公開 CloudPak リポジトリからミラーリングメタデータをダウンロードする：
    oc ibm-pak get --version "${CASE_VERSION}" "${CASE_NAME}"
  4. ibm-pak generate コマンドを実行して、ご使用の環境に特化した oc mirror 設定ファイルを生成します：
    oc ibm-pak generate mirror-manifests --version "${CASE_VERSION}" "${CASE_NAME}" "${TARGET_PATH}"
    正常に完了した generate コマンドの出力例：
    ...

- キュレーションされていないカタログをミラーリングすること：

  oc mirror --config /root/.ibm-pak/data/mirror/ $ {CASE_NAME} /$ {CASE_VERSION}/image-set-config.yaml docker://$ {TARGET_PATH}
  5. generate コマンドの出力で提供された "non curated catalog "に対して oc mirror コマンドを実行する。
    例:
    oc mirror --config /root/.ibm-pak/data/mirror/${CASE_NAME}/${CASE_VERSION}/image-set-config.yaml docker://${TARGET_PATH}
  6. oc-mirror コマンドで参照されている image-set-config.yaml ファイルがあるディレクトリに移動する：
    cd /root/.ibm-pak/data/mirror/${CASE_NAME}/${CASE_VERSION}/

    このディレクトリには、 ibm-pak ツールによって自動的に生成されたいくつかのファイルが含まれている。

  7. ImageDigestMirrorSet ファイルをクラスタに適用します：
    oc apply -f image-digest-mirror-set.yaml
oc apply -f catalog-sources-linux-amd64.yaml
    注： カタログソース catalog-sources-linux-amd64.yaml を適用した後、それは自動的に削除され、 CAS がデプロイされると再作成される。

    オフラインアップグレードを動作させるには、ibm-pak で生成された CatalogSource ファイルを適用する必要があります。

    Fusionは CASに CatalogSource を適用するので、このディレクトリに生成された catalog-source.yaml ファイルを適用する必要はありません。