第4章 リリースイメージ
Red Hat Advanced Cluster Management for Kubernetes を使用してプロバイダーでクラスターを作成する場合は、新規クラスターに使用するリリースイメージを指定する必要があります。リリースイメージでは、クラスターのビルドに使用する Red Hat OpenShift Container Platform のバージョンを指定します。
acm-hive-openshift-releases GitHub リポジトリーの yaml ファイルを使用して、リリースイメージを参照します。Red Hat Advanced Cluster Management for Kubernetes はこれらのファイルを使用して、コンソールで利用可能なリリースイメージの一覧を作成します。リポジトリーには、clusterImageSets ディレクトリーと subscription ディレクトリーが含まれます。これらのディレクトリーは、リリースイメージの操作時に使用します。
clusterImageSets ディレクトリーには以下のディレクトリーが含まれます。
- Fast: サポート対象の各 OpenShift Container Platform バージョンのリリースイメージの内、最新のバージョン 2 つを参照するファイルが含まれます。
- Releases: サポート対象の各 OpenShift Container Platform バージョンのリリースイメージすべてを参照するファイルが含まれます。注記: これらのリリースすべてがテストされおらず、安定版とみなされているわけではありません。
- Stable: サポート対象の各 OpenShift Container Platform バージョンのリリースイメージの内、最新の安定版 2 つを参照するファイルが含まれます。このフォルダー内のリリースイメージはテストされ、検証されています。
subscription ディレクトリーには、リリースイメージの一覧がプルされる場所を指定するファイルが含まれます。Red Hat Advanced Cluster Management のデフォルトのリリースイメージは、Quay.io デフォルトで提供されます。これらのリリースイメージは、acm-hive-openshift-releases GitHub repository のファイルで参照されます。
4.1. 利用可能なリリースイメージの同期 リンクのコピーリンクがクリップボードにコピーされました!
リリースイメージは頻繁に更新されるため、リリースイメージの一覧を同期して、利用可能な最新バージョンを選択できるようにする必要があります。リリースイメージは、acm-hive-openshift-releases の GitHub リポジトリーから入手できます。
リリースイメージの安定性には、以下の 3 つのレベルがあります。
| カテゴリー | 説明 |
| stable | 完全にテストされたイメージで、クラスターを正常にインストールしてビルドできることが確認されています。 |
| fast | 部分的にテスト済みですが、stable バージョンよりも安定性が低い可能性があります。 |
| candidate | テストはしていませんが、最新のイメージです。バグがある可能性もあります。 |
一覧を更新するには、以下の手順を実行します。
- acm-hive-openshift-releases GitHub repository をクローンします。
以下のコマンドを入力して、Red Hat Advanced Cluster Management for Kubernetes のハブクラスターに接続します。
oc apply -k subscription/
oc apply -k subscription/Copy to Clipboard Copied! Toggle word wrap Toggle overflow 約 1 分後に、最新の
fastエントリーが 2 つ利用可能になります。acm-hive-openshift-releasesGitHub リポジトリーをクローンした後にstableリリースイメージの一覧を同期するには、以下のコマンドを入力してstableイメージを更新します。make subscribe-stable
make subscribe-stableCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記: この
makeコマンドは、Linux または MacOS のオペレーティングシステムを使用している場合のみ実行できます。Windows オペレーティングシステムを使用している場合は、以下のコマンドを実行してstableイメージを更新します。oc apply -f subscription-stable
oc apply -f subscription-stableCopy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドを実行後に、利用可能な
stableのリリースイメージの一覧が、現在利用可能なイメージに約 1 分ほどで更新されます。Fast リリースイメージを同期して表示するには、以下のコマンドを実行します。
make subscribe-fast
make subscribe-fastCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記: この
makeコマンドは、Linux または MacOS のオペレーティングシステムを使用している場合のみ実行できます。Windows オペレーティングシステムを使用している場合は、以下のコマンドを実行してfastイメージを更新します。oc apply -f subscription/subscription-fast.yaml
oc apply -f subscription/subscription-fast.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドを実行後に、利用可能な
stableとfastのリリースイメージの一覧が、現在利用可能なイメージに約 1 分ほどで更新されます。candidateリリースイメージを同期して表示するには、以下のコマンドを実行します。make subscribe-candidate
make subscribe-candidateCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記: この
makeコマンドは、Linux または MacOS のオペレーティングシステムを使用している場合のみ実行できます。Windows オペレーティングシステムを使用している場合は、以下のコマンドを実行してcandidateイメージを更新します。oc apply -f subscription/subscription-candidate.yaml
oc apply -f subscription/subscription-candidate.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドを実行後に、利用可能な
stable、fastおよびcandidateのリリースイメージの一覧が、現在利用可能なイメージに約 1 分ほどで更新されます。
- クラスターの作成時に、Red Hat Advanced Cluster Management コンソールで現在利用可能なリリースイメージの一覧を表示します。
以下の形式でコマンドを入力して、これらのチャネルのサブスクライブを解除して更新の表示を停止することができます。
oc delete -f subscription/subscription-stable
oc delete -f subscription/subscription-stableCopy to Clipboard Copied! Toggle word wrap Toggle overflow
4.1.1. 接続時におけるリリースイメージのカスタム一覧の管理 リンクのコピーリンクがクリップボードにコピーされました!
すべてのクラスターに同じリリースイメージが使用されるようにします。クラスターの作成時に利用可能なリリースイメージのカスタム一覧を作成し、作業を簡素化します。利用可能なリリースイメージを管理するには、以下の手順を実行します。
- acm-hive-openshift-releases GitHub repository をフォークします。
./subscription/channel.yamlファイルを更新して、open-cluster-managementではなく、フォークしたリポジトリーの GitHub 名にアクセスするように、spec: pathnameを変更します。この手順では、ハブクラスターによるリリースイメージの取得先を指定します。更新後の内容は以下の例のようになります。spec: type: GitHub pathname: https://github.com/<forked_content>/acm-hive-openshift-releases.git
spec: type: GitHub pathname: https://github.com/<forked_content>/acm-hive-openshift-releases.gitCopy to Clipboard Copied! Toggle word wrap Toggle overflow forked_content はフォークしたリポジトリーのへのパスに置き換えます。
-
Red Hat Advanced Cluster Management for Kubernetes を使用して、クラスターの作成時に使用できるように、イメージの
yamlファイルを./clusterImageSets/stable/または./clusterImageSets/fast/に追加します。ヒント: フォークしたリポジトリーに変更をマージして、メインのリポジトリーから利用可能なyamlファイルを取得できます。 - フォークしたリポジトリーに変更をコミットし、マージします。
acm-hive-openshift-releasesリポジトリーをクローンした後に stable リリースイメージの一覧を同期するには、以下のコマンドを入力して stable イメージを更新します。make subscribe-stable
make subscribe-stableCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記: この
makeコマンドは、Linux または MacOS のオペレーティングシステムを使用している場合のみ実行できます。Windows オペレーティングシステムを使用している場合は、以下のコマンドを入力します。oc apply -k subscription/ oc delete -f subscription/subscription-fast.yaml oc apply -f subscription/subscription-stable.yaml
oc apply -k subscription/ oc delete -f subscription/subscription-fast.yaml oc apply -f subscription/subscription-stable.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドを実行後に、利用可能な安定版のリリースイメージの一覧が、現在利用可能なイメージに約 1 分ほどで更新されます。
デフォルトでは、安定版のイメージのみが一覧表示されます。Fast リリースイメージを同期して表示するには、以下のコマンドを実行します。
make subscribe-fast
make subscribe-fastCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記: この
makeコマンドは、Linux または MacOS のオペレーティングシステムを使用している場合のみ実行できます。Windows オペレーティングシステムを使用している場合は、以下のコマンドを入力します。oc apply -k subscription/ oc apply -f subscription/subscription-fast.yaml
oc apply -k subscription/ oc apply -f subscription/subscription-fast.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドを実行後に、利用可能な fast リリースイメージの一覧が、現在利用可能なイメージに約 1 分ほどで更新されます。
デフォルトではRed Hat Advanced Cluster Management は ClusterImageSets を複数事前に読み込みます。以下のコマンドを使用して、利用可能な ClusterImageSet を表示し、デフォルトの設定を削除します (任意)。
oc get clusterImageSets oc delete clusterImageSet <clusterImageSet_NAME>
oc get clusterImageSets oc delete clusterImageSet <clusterImageSet_NAME>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - クラスターの作成時に、Red Hat Advanced Cluster Management コンソールで現在利用可能なリリースイメージの一覧を表示します。
4.1.2. 非接続時におけるリリースイメージのカスタム一覧の管理 リンクのコピーリンクがクリップボードにコピーされました!
ハブクラスターにインターネット接続がない場合は、リリースイメージのカスタムリストを管理しないといけない場合があります。クラスターの作成時に利用可能なリリースイメージのカスタム一覧を作成します。非接続時に、利用可能なリリースイメージを管理するには、以下の手順を実行します。
- オンライン接続されているシステムを使用している場合は、acm-hive-openshift-releases GitHub repository に移動します。
-
clusterImageSetsディレクトリーを、非接続の Red Hat Advanced Cluster Management for Kubernetes ハブクラスターにアクセス可能なシステムにコピーします。 -
clusterImageSetyaml を手作業で追加して、Red Hat Advanced Cluster Management for Kubernetes コンソールを使用してクラスターを作成する時に利用できるようにイメージのyamlファイルを追加します。 clusterImageSetsコマンドを作成します。oc create -f <clusterImageSet_FILE>
oc create -f <clusterImageSet_FILE>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 追加するリソースごとにこのコマンドを実行すると、利用可能なリリースイメージの一覧が使用できるようになります。
- または Red Hat Advanced Cluster Management のクラスター作成のコンソールに直接イメージの URL を貼り付けることもできます。これにより、clusterImageSets が存在しない場合には、新しいものが作成されます。
- クラスターの作成時に、Red Hat Advanced Cluster Management コンソールで現在利用可能なリリースイメージの一覧を表示します。