エアギャップ環境への Red Hat Developer Hub のインストール

手順

1. 次のコマンドを実行して、ミラーリングスクリプトをディスクにダウンロードします。

   curl -sSLO https://raw.githubusercontent.com/redhat-developer/rhdh-operator/refs/heads/release-1.5/.rhdh/scripts/prepare-restricted-environment.sh

   Copy to Clipboard

2. 適切なオプションのセットを指定した bash コマンドを使用して、ミラーリングスクリプトを実行します。

   bash prepare-restricted-environment.sh
    --filter-versions "1.5"
    --to-dir _<my_pulled_image_location>_ 

   1

   
    [--use-oc-mirror true] 

   2

   Copy to Clipboard

   1

   --to-dir オプションを使用して、必要なすべてのイメージをプルするディレクトリーへの絶対パスを指定します (例: /home/user/rhdh-operator-mirror-dir)。

   2

   (オプション) oc-mirror OpenShift Container Platform CLI プラグインを使用してイメージをミラーリングします。

   注記

   このスクリプトは複数のイメージをミラーレジストリーにコピーするため、完了までに数分かかる場合があります。

3. --to-dir オプションで指定したディレクトリーを非接続環境に転送します。

4. クラスターとターゲットミラーレジストリーの両方にアクセスできる非接続環境内のマシンから、適切なオプションのセットを指定した bash コマンドを使用してミラーリングスクリプトを実行します。

   bash <my_pulled_image_location>/install.sh 

   1

   
       --from-dir <my_pulled_image_location> 

   2

   
       [--to-registry <my.registry.example.com>] 

   3

   
       [--use-oc-mirror true] 

   4

   Copy to Clipboard

   1

   ダウンロードしたイメージと、そのイメージを格納するシステム上のディレクトリーへの絶対パス。

   2

   --to-dir オプションを使用して、必要なすべてのイメージをプルするディレクトリーを指定します。

   3

   イメージをミラーリングするターゲットミラーレジストリーの URL を指定します。

   4

   (オプション) oc-mirror OpenShift Container Platform CLI プラグインを使用してイメージをミラーリングします。

   重要

   oc-mirror を使用してイメージをディスクにミラーリングした場合は、ディスクからイメージをミラーリングする際にも oc-mirror を使用する必要があります。これは oc-mirror が使用するフォルダーレイアウトによるものです。

   注記

   スクリプトは Red Hat Developer Hub Operator を自動的にインストールするため、完了するまでに数分かかる場合があります。

手順

1. ターミナルで、ミラーリングスクリプトを保存するディレクトリーに移動します。

2. 次のコマンドを実行してミラーリングスクリプトをダウンロードします。

   curl -sSLO https://raw.githubusercontent.com/redhat-developer/rhdh-operator/refs/heads/release-1.5/.rhdh/scripts/prepare-restricted-environment.sh

   Copy to Clipboard

3. 適切なオプションのセットを指定した bash コマンドを使用して、ミラーリングスクリプトを実行します。

   bash prepare-restricted-environment.sh \
    --filter-versions "1.5" \
     [--to-registry <my.registry.example.com>] \ 

   1

   
     [--use-oc-mirror true] 

   2

   Copy to Clipboard

   1

   イメージをミラーリングするターゲットミラーレジストリーの URL を指定します。

   2

   (オプション) oc-mirror OpenShift Container Platform CLI プラグインを使用してイメージをミラーリングします。

   注記

   このスクリプトは複数のイメージをミラーレジストリーにコピーするため、完了までに数分かかる場合があります。

手順

1. ミラーリングするリソースを指定するには、ImageSetConfiguration ファイルを作成します。以下に例を示します。

   apiVersion: mirror.openshift.io/v1alpha2
   kind: ImageSetConfiguration
   mirror:
     helm:
       repositories:
              - name: <repository_name> (1)
           url: <repository_url> (2)
           charts:
             - name: <chart_name> (3)
               version: "<rhdh_version>" (4)

   Copy to Clipboard

   ミラーリングするリポジトリーの名前 (例: openshift-charts)。

   ミラーリングするリポジトリーの URL (例: https://charts.openshift.io)。

   ミラーリングする Helm チャートの名前 (例: redhat-developer-hub)。

   使用する Red Hat Developer Hub のバージョン (例: 1.5)

2. oc-mirror コマンドを実行して、ImageSetConfiguration.yaml ファイルで指定されたリソースをミラーリングします。以下に例を示します。

   oc-mirror --config=<mirror_config_directory>/ImageSetConfiguration.yaml <mirror_archive_directory>/

   Copy to Clipboard

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

   <mirror_config_directory>

   システム上のイメージセット設定ファイルの場所を指定します (例: .user)。

   <mirror_configuration_file>

   ミラー設定 yaml ファイルの名前を指定します (例: mirror-config.yaml)

   <mirror_archive_directory>

   ミラーアーカイブの作成先のディレクトリーの場所を指定します (例: file://.user)。

   注記

   oc-mirror コマンドを実行すると、ミラーアーカイブファイル、Helm チャート、ImageContentSourcePolicy (ICSP) マニフェストを含むローカルワークスペースが生成されます。ICSP マニフェストには、後の手順でクラスターに適用する必要がある imageContentSourcePolicy.yaml ファイルが含まれています。

   出力例

   Creating archive /path/to/mirror-archive/mirror_seq1_000000.tar

   Copy to Clipboard

3. 生成されたアーカイブファイル (例: mirror_seq1_000000.tar) をエアギャップ環境に転送します。

4. エアギャップ環境に接続し、次のオブジェクトにも接続されていることを確認します。

   • ローカルターゲットレジストリー
   • ターゲット OpenShift Container Platform クラスター

5. エアギャップ環境から oc-mirror コマンドを実行して、アーカイブからターゲットレジストリーにミラーリングします。以下に例を示します。

   oc-mirror --from <mirror-archive-file> <target-registry>

   Copy to Clipboard

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

   <mirror_archive_file>

   ミラーリングするリソースを含むファイルの名前を指定します (例: mirror_seq1_0000.tar)。

   <target_registry>

   ミラーリングされたイメージをプッシュするターゲットレジストリーの名前を指定します (例: docker://registry.localhost:5000)。

   出力例

   Wrote release signatures to oc-mirror-workspace/results-1738075410
   Writing image mapping to oc-mirror-workspace/results-1738075410/mapping.txt
   Writing ICSP manifests to oc-mirror-workspace/results-1738075410

   Copy to Clipboard

6. ワークスペースで、ls コマンドを実行して imageContentSourcePolicy.yaml ファイルを見つけます。以下に例を示します。

   ls <workspace_directory>/<results_directory>

   Copy to Clipboard

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

   <workspace_directory>

   ワークスペースディレクトリーの名前を指定します (例: oc-mirror-workspace)。

   <results_directory>

   結果ディレクトリーの名前を指定します (例: results-1738070846)。

7. Helm チャートをミラーリングするには、oc apply コマンドを実行して、非接続クラスターに imageContentSourcePolicy.yaml ファイルをデプロイします。以下に例を示します。

   oc apply -f <workspace_directory>/<results_directory>/ImageContentSourcePolicy.yaml

   Copy to Clipboard

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

   <workspace-directory>

   ワークスペースディレクトリーの名前を指定します (例: oc-mirror-workspace)。

   <results-directory>

   結果ディレクトリーの名前を指定します (例: results-1738070846)。

8. エアギャップ環境で、namespace と set オプションを指定して helm install コマンドを実行し、使用する namespace に Helm チャートをデプロイします。以下に例を示します。

   CLUSTER_ROUTER_BASE=$(oc get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/[.]*\.//')
   
   helm install <rhdh_instance> <workspace_directory>/<results_directory>/charts/<archive_file> --namespace <your_namespace> --create-namespace \
     --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE"

   Copy to Clipboard

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

   <rhdh_instance>

   Red Hat Developer Hub インスタンスの名前を指定します (例: my-rhdh)。

   <workspace_directory>

   ワークスペースディレクトリーの名前を指定します (例: oc-mirror-workspace)。

   <results_directory>

   結果ディレクトリーの名前を指定します (例: results-1738070846)。

   <archive_file>

   ミラーリングするリソースを含むアーカイブファイルの名前を指定します (例: redhat-developer-hub-1.4.1.tgz)。

   <your_namespace>

   Helm チャートをデプロイする namespace を指定します (例: my-rhdh-project)。

手順

1. 次のコマンドを実行して、OpenShift CLI (oc) を使用して OpenShift Container Platform アカウントにログインします。

   oc login -u <user> -p <password> https://api.<hostname>:6443

   Copy to Clipboard
2. 非接続クラスターから、OpenShift Container Platform イメージレジストリーなど、ミラーリングするイメージレジストリーにログインします。
3. ImageSetConfiguration.yaml ファイルを作成します。

4. ImageSetConfiguration.yaml ファイルで、ミラーリングするリソースを指定します。以下に例を示します。

   apiVersion: mirror.openshift.io/v1alpha2
   kind: ImageSetConfiguration
   mirror:
     helm:
       repositories:
         - name: <repository_name> (1)
           url: <repository_url> (2)
           charts:
             - name: <chart_name> (3)
               version: "<rhdh_version>" (4)

   Copy to Clipboard

   ミラーリングする Helm チャートを含むリポジトリーの名前 (例: openshift-charts)。

   ミラーリングする Helm チャートを含むリポジトリーの URL (例: https://charts.openshift.io)。

   ミラーリングするイメージを含む Helm チャートの名前 (例: redhat-developer-hub)。

   使用する Red Hat Developer Hub のバージョン (例: 1.5)

5. oc-mirror コマンドを実行して、イメージセット設定ファイルで指定されたリソースをターゲットレジストリーに直接ミラーリングします。以下に例を示します。

   oc-mirror --config=<mirror_config_directory>/ImageSetConfiguration.yaml <target-mirror-registry>

   Copy to Clipboard

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

   <mirror_config_directory>

   システム上のイメージセット設定ファイルの場所を指定します (例: .user)。

   <target_mirror_registry>

   ターゲットミラーレジストリーの場所と名前を指定します (例: docker://registry.example:5000)。

   注記

   oc-mirror コマンドを実行すると、Helm チャートと ImageContentSourcePolicy (ICSP) マニフェストを含むローカルワークスペースが作成されます。ICSP マニフェストには、後の手順でクラスターに適用する必要がある、自動生成された imageContentSourcePolicy.yaml ファイルが含まれています。

   出力例

   Writing image mapping to oc-mirror-workspace/results-1738070846/mapping.txt
   Writing ICSP manifests to oc-mirror-workspace/results-1738070846

   Copy to Clipboard

6. ワークスペースで、ls コマンドを実行して imageContentSourcePolicy.yaml ファイルを見つけます。以下に例を示します。

   ls <workspace_directory>/<results_directory>

   Copy to Clipboard

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

   <workspace_directory>

   ワークスペースディレクトリーの名前を指定します (例: oc-mirror-workspace)。

   <results_directory>

   結果ディレクトリーの名前を指定します (例: results-1738070846)。

7. Helm チャートをミラーリングするには、oc apply コマンドを実行して、非接続クラスターに imageContentSourcePolicy.yaml ファイルをデプロイします。以下に例を示します。

   oc apply -f <workspace_directory>/<results_directory>/ImageContentSourcePolicy.yaml

   Copy to Clipboard

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

   <workspace_directory>

   ワークスペースディレクトリーの名前を指定します (例: oc-mirror-workspace)。

   <results_directory>

   結果ディレクトリーの名前を指定します (例: results-1738070846)。

8. エアギャップ環境で、namespace と set オプションを指定して helm install コマンドを実行し、使用する namespace に Helm チャートをデプロイします。以下に例を示します。

   CLUSTER_ROUTER_BASE=$(oc get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/[.]*\.//')
   
   helm install <rhdh_instance> <workspace_directory>/<results_directory>/charts/<archive_file> --namespace <your_namespace> --create-namespace \
     --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE"

   Copy to Clipboard

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

   <rhdh_instance>

   Red Hat Developer Hub インスタンスの名前を指定します (例: my-rhdh)。

   <workspace_directory>

   ワークスペースディレクトリーの名前を指定します (例: oc-mirror-workspace)。

   <results_directory>

   結果ディレクトリーの名前を指定します (例: results-1738070846)。

   <archive_file>

   ミラーリングするリソースを含むアーカイブファイルの名前を指定します (例: redhat-developer-hub-1.4.1.tgz)。

   <your_namespace>

   Helm チャートをデプロイする namespace を指定します (例: my-rhdh-project)。