Syncing images to a local private registry

Syncing images to a local private registry#

関連するインストールフェーズ Phase 4: Preparing the Environment

前提条件#

  • **`edbctl CLI tool** <Hybrid Manager CLI - edbctl>` がインストールおよび構成されています。

  • 有効な **EDB Repos 2.0 Token** 。

  • ターゲットローカルプライベートレジストリへの書き込みアクセス例AWS ECR、Google Artifact Registry、Harbor 。


イメージを内部的にホスティングすると、次のことが保証されます。

  • セキュリティとコンプライアンス アーティファクトのスキャンと承認を制御します。

  • 信頼性 展開は、外部のインターネット接続またはサードパーティのアップタイムに依存しません。

  • パフォーマンス イメージをプルするクラスターノードの遅延の削減。

このプロセスでは、 edbctl ツールを使用して、SHA256ダイジェストを保存しながらEDB Repos 2.0からプライベートレジストリにアーティファクトをコピーします。

HMのソフトウェアスタックはEDB Repos 2.0レジストリにプッシュされ、ローカルプライベートレジストリで使用するアーティファクトを提供します。RHOSまたはRancher RKE2オンプレミスシナリオの顧客管理の内部レジストリ、またはクラウドサービスの自己管理レジストリCSPシナリオでのHMのプロバイダーCSPレジストリ AWS Elastic Container Registry ECR、 Google Cloud Artifact Registry GAR、または Azure Container Registry ACR 。

開始する前に、コンテナイメージをホストする準備ができている安全で承認されたプライベートレジストリがあることを確認します。

レジストリのURIと、書き込みアクセスを持つユーザー名とパスワードまたはトークンが必要です。さらに、インストールするEDB Postgres AIの特定のバージョンを確認します。

これらの資格情報を使用して、同期プロセスは、必要なすべてのアーティファクトをEDB Repos 2.0からローカルのプライベートレジストリに直接コピーし、Helmチャートのインストールまたはアップグレードで利用できるようにします。

同期変数の構成#

必須情報

  • リリースバージョン インストールするハイブリッドマネージャーHMのタグ例v2026.5.1 。

  • EDB Token: docker.enterprisedb.com のアクセストークン。

  • ローカルレジストリ 組織のレジストリのURIと資格情報。

  1. EDBリリースバージョンを定義する

export EDBPGAI_RELEASE=<EDB-pgai-release-version>
  1. EDB資格情報を定義しますソース

export CS_EDB_TOKEN=<your-edb-repos-token>
export EDB_SOURCE_REGISTRY=pgai-platform
  1. プライベートレジストリ資格情報の定義 宛先

export LOCAL_REGISTRY_URI=<your_local_container_registry_uri>
export LOCAL_REGISTRY_USER=<your_local_registry_user>
export LOCAL_REGISTRY_PWD=<your_local_registry_password>

クラウドレジストリ AWS ECR、Google Artifact Registry、またはAzure ACRを使用している場合、ローカル環境がaws ecr get-login-password などを介して認証され、LOCAL_REGISTRY_PWD が有効なトークンを反映していることを確認します。

次のコマンドを実行して、プラットフォームイメージとオペレーターアーティファクトをワンステップで同期します。

edbctl image sync-to-local-registry \
    --destination-registry-uri "${LOCAL_REGISTRY_URI}" \
    --version "${EDBPGAI_RELEASE}" \
    --source-registry-username "${EDB_SOURCE_REGISTRY}" \
    --source-registry-password "${CS_EDB_TOKEN}" \
    --destination-registry-username "${LOCAL_REGISTRY_USER}" \
    --destination-registry-password "${LOCAL_REGISTRY_PWD}"

このコマンドは、次のアーティファクトをプライベートレジストリにミラーリングします。

  • プラットフォームイメージ — ポータル、ビーコン、トランスポーター、およびその他のHMコンポーネント。

  • オペレーターマネージャーイメージ — edb-hcp-operator コントローラーイメージ。

  • オペレーターバンドルイメージ — OCP認定バンドル、エアギャップOpenShiftクラスターでセルフホストのOperatorHubカタログをビルドするために使用されます。

  • オペレーターヘルムチャート — edb-hcp-operator チャート、画像とともにOCIアーティファクトとしてミラーリングされます。

構成の更新#

同期が完了したら、プライベートレジストリからイメージをプルするようにHMを構成する必要があります。

HybridControlPlane CRを編集して、spec.imageRegistry をプライベートレジストリURIに設定します。

apiVersion: edbpgai.edb.com/v1alpha1
kind: HybridControlPlane
metadata:
  name: edbpgai
spec:
  imageRegistry: "<your_local_container_registry_uri>"
  # ... your other spec fields

更新されたCRを適用します。

kubectl apply -f hybridmanager.yaml

次のステップ#

イメージが同期され、構成が更新されたら、インストールを続行する準備が整います。

** フェーズ4環境の準備 または フェーズ5ハイブリッドマネージャーのインストール に戻ります。**