エアギャップ環境への Red Hat Developer Hub のインストール
概要
第1章 エアギャップ環境 リンクのコピーリンクがクリップボードにコピーされました!
エアギャップ環境は、エアギャップネットワークまたは分離ネットワークとも呼ばれ、システムまたはネットワークを物理的に分離することでセキュリティーを確保します。この分離は、エアギャップシステムと外部ソース間の不正なアクセス、データ転送、または通信を防止するために確立されます。
Red Hat Developer Hub は、セキュリティーを確保し、特定の規制要件を満たすために、エアギャップ環境にインストールできます。
第2章 Operator を使用したエアギャップ環境への Red Hat Developer Hub のインストール リンクのコピーリンクがクリップボードにコピーされました!
制限されたネットワーク上で動作する OpenShift Container Platform クラスターでは、パブリックリソースは使用できません。ただし、Red Hat Developer Hub Operator をデプロイして Developer Hub を実行するには、次のパブリックリソースが必要です。
- Operator イメージ (バンドル、Operator、カタログ)
- オペランドイメージ (RHDH、PostgreSQL)
これらのリソースを使用できるようにするには、これらのリソースを、OpenShift Container Platform クラスターにアクセスできるミラーレジストリー内の同等のリソースに置き換えます。
必要なイメージをミラーリングし、Red Hat Developer Hub Operator のインストール時や Developer Hub インスタンスの作成時にそれらのイメージを使用するために必要な設定を提供する、ヘルパースクリプトを使用できます。
このスクリプトにはターゲットミラーレジストリーが必要です。OpenShift Container Platform クラスターが制限されたネットワークで動作する準備ができている場合は、このレジストリーがすでにインストールされているはずです。ただし、クラスターを非接続で使用できるように準備している場合は、スクリプトを使用してクラスターにミラーレジストリーをデプロイし、それをミラーリングプロセスに使用できます。
前提条件
-
OpenShift Container Platform クラスターに対する管理権限を持つアクティブな OpenShift CLI (
oc) セッションがある。OpenShift CLI の使用を開始 を参照してください。 -
registry.redhat.ioRed Hat エコシステムカタログへのアクティブなocレジストリーセッションがある。Red Hat コンテナーレジストリーの認証 を参照してください。 -
opmCLI ツールがインストールされている。opm CLI のインストール を参照してください。 - jq パッケージがインストールされている。Download jq を参照してください。
- Podman がインストールされている。Podman Installation Instructions を参照してください。
- Skopeo バージョン 1.14 以降がインストールされている。Installing Skopeo を参照してください。
- クラスターのミラーレジストリーがすでにある場合は、当該レジストリーへの管理アクセスを持つアクティブな Skopeo セッション。レジストリーへの認証 および 非接続インストールのイメージのミラーリング を参照してください。
内部 OpenShift Container Platform クラスターイメージレジストリーは、ターゲットミラーレジストリーとして使用できません。ミラーレジストリーについて を参照してください。
- 独自のミラーレジストリーを作成する場合は、Red Hat OpenShift 導入用のミラーレジストリーを使用したミラーレジストリーの作成 を参照してください。
ミラーレジストリーをまだ持っていない場合は、ヘルパースクリプトを使用してミラーレジストリーを作成できます。また、次の追加の前提条件が必要です。
- cURL パッケージがインストールされている。Red Hat Enterprise Linux の場合、curl パッケージをインストールすると、curl コマンドが使用可能になります。他のプラットフォームで curl を使用するには、cURL の Web サイト を参照してください。
-
htpasswdコマンドが利用可能である。Red Hat Enterprise Linux の場合、httpd-toolsパッケージをインストールすると、htpasswdコマンドが使用可能になります。
手順
ミラーリングスクリプト
prepare-restricted-environment.sh(ソース) をダウンロードして実行し、カスタム Operator カタログをインストールして関連イメージをミラーリングします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記このスクリプトは複数のイメージをミラーレジストリーにコピーするため、完了までに数分かかる場合があります。
第3章 Helm チャートを使用したエアギャップ環境への Red Hat Developer Hub のインストール リンクのコピーリンクがクリップボードにコピーされました!
エアギャップ環境は、エアギャップネットワークまたは分離ネットワークとも呼ばれ、システムまたはネットワークを物理的に分離することでセキュリティーを確保します。この分離は、エアギャップシステムと外部ソース間の不正なアクセス、データ転送、または通信を防止するために確立されます。
Red Hat Developer Hub は、セキュリティーを確保し、特定の規制要件を満たすために、エアギャップ環境にインストールできます。
Developer Hub をエアギャップ環境にインストールするには、registry.redhat.io とエアギャップ環境のレジストリーにアクセスできる必要があります。
前提条件
- Red Hat OpenShift Container Platform 4.13 以降がインストールされている。
-
registry.redhat.ioにアクセスできる。 - クラスターの Red Hat OpenShift Container Platform イメージレジストリーにアクセスできる。イメージレジストリーの公開の詳細は、Red Hat OpenShift Container Platform のドキュメントの レジストリーの公開 を参照してください。
-
ワークステーションに OpenShift CLI (
oc) がインストールされている。 -
ワークステーションに
podmanコマンドラインツールがインストールされている。 - Red Hat Developer ポータルのアカウントがある。
手順
次のコマンドを実行して、OpenShift CLI (
oc) を使用して OpenShift Container Platform アカウントにログインします。oc login -u <user> -p <password> https://api.<hostname>:6443
oc login -u <user> -p <password> https://api.<hostname>:6443Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行し、
podmanコマンドラインツールを使用して OpenShift Container Platform イメージレジストリーにログインします。podman login -u kubeadmin -p $(oc whoami -t) default-route-openshift-image-registry.<hostname>
podman login -u kubeadmin -p $(oc whoami -t) default-route-openshift-image-registry.<hostname>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記次のコマンドを実行して OpenShift Container Platform イメージレジストリーの完全なホスト名を取得し、そのホスト名をコマンドで使用してログインできます。
REGISTRY_HOST=$(oc get route default-route -n openshift-image-registry --template='{{ .spec.host }}')REGISTRY_HOST=$(oc get route default-route -n openshift-image-registry --template='{{ .spec.host }}')Copy to Clipboard Copied! Toggle word wrap Toggle overflow podman login -u kubeadmin -p $(oc whoami -t) $REGISTRY_HOST
podman login -u kubeadmin -p $(oc whoami -t) $REGISTRY_HOSTCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行して、
podmanのregistry.redhat.ioにログインします。podman login registry.redhat.io
podman login registry.redhat.ioCopy to Clipboard Copied! Toggle word wrap Toggle overflow レジストリー認証の詳細は、Red Hat コンテナーレジストリーの認証 を参照してください。
次のコマンドを実行して、Red Hat Image registry から Developer Hub および PostgreSQL イメージをワークステーションにプルします。
podman pull registry.redhat.io/rhdh/rhdh-hub-rhel9:1.2.6
podman pull registry.redhat.io/rhdh/rhdh-hub-rhel9:1.2.6Copy to Clipboard Copied! Toggle word wrap Toggle overflow podman pull registry.redhat.io/rhel9/postgresql-15:latest
podman pull registry.redhat.io/rhel9/postgresql-15:latestCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、両方のイメージを内部 OpenShift Container Platform イメージレジストリーにプッシュします。
podman push --remove-signatures registry.redhat.io/rhdh/rhdh-hub-rhel9:1.2.6 default-route-openshift-image-registry.<hostname>/<project_name>/rhdh-hub-rhel9:1.2.6
podman push --remove-signatures registry.redhat.io/rhdh/rhdh-hub-rhel9:1.2.6 default-route-openshift-image-registry.<hostname>/<project_name>/rhdh-hub-rhel9:1.2.6Copy to Clipboard Copied! Toggle word wrap Toggle overflow podman push --remove-signatures registry.redhat.io/rhel9/postgresql-15:latest default-route-openshift-image-registry.<hostname>/<project_name>/postgresql-15:latest
podman push --remove-signatures registry.redhat.io/rhel9/postgresql-15:latest default-route-openshift-image-registry.<hostname>/<project_name>/postgresql-15:latestCopy to Clipboard Copied! Toggle word wrap Toggle overflow イメージを OpenShift Container Platform イメージレジストリーに直接プッシュする方法の詳細は、How do I push an Image directly into the OpenShift 4 registry を参照してください。
重要x509 エラーが発生した場合は、OpenShift Container Platform ルートに使用される CA 証明書がシステムにインストール されていることを確認してください。
次のコマンドを使用して、両方のイメージが OpenShift Container Platform の内部レジストリーに存在することを確認します。
oc get imagestream -n <project_name>
oc get imagestream -n <project_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、両方のイメージのローカルイメージ検索を有効にします。
oc set image-lookup postgresql-15
oc set image-lookup postgresql-15Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc set image-lookup rhdh-hub-rhel9
oc set image-lookup rhdh-hub-rhel9Copy to Clipboard Copied! Toggle word wrap Toggle overflow YAML view に移動し、次の値を使用して
backstageとpostgresqlのimageセクションを更新します。Developer Hub イメージの値の例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow PostgreSQL イメージの値の例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Helm Chart を使用して Red Hat Developer Hub をインストールします。