17.2. Geo レプリケーションの要件と制約

手順

1. config.yaml ファイルを更新して、データのレプリケート先のストレージエンジンを含めます。使用するすべてのストレージエンジンをリストする必要があります。

   # ...
   FEATURE_STORAGE_REPLICATION: true
   # ...
   DISTRIBUTED_STORAGE_CONFIG:
       usstorage:
           - RHOCSStorage
           - access_key: <access_key>
             bucket_name: <example_bucket>
             hostname: my.noobaa.hostname
             is_secure: false
             port: "443"
             secret_key: <secret_key>
             storage_path: /datastorage/registry
       eustorage:
           - S3Storage
           - host: s3.amazon.com
             port: "443"
             s3_access_key: <access_key>
             s3_bucket: <example bucket>
             s3_secret_key: <secret_key>
             storage_path: /datastorage/registry
   DISTRIBUTED_STORAGE_DEFAULT_LOCATIONS: []
   DISTRIBUTED_STORAGE_PREFERENCE:
       - usstorage
       - eustorage
   # ...

2. オプション: すべてのイメージをすべてのストレージエンジンに完全にレプリケートする必要がある場合は、DISTRIBUTED_STORAGE_DEFAULT_LOCATIONS フィールドを手動で設定すると、イメージをストレージエンジンにレプリケートできます。これにより、すべてのイメージがそのストレージエンジンにレプリケートされます。以下に例を示します。

   # ...
   DISTRIBUTED_STORAGE_DEFAULT_LOCATIONS:
       - usstorage
       - eustorage
   # ...

   注記

   名前空間ごとのレプリケーションを有効にするには、Red Hat Quay サポートにお問い合わせください。

3. ストレージを追加して Geo レプリケーションの Replicate to storage engine by default を有効にした後、すべてのストレージで既存のイメージデータを同期する必要があります。これを行うには、次のコマンドを実行してコンテナー内で実行する必要があります。

   $ podman exec -it <container_id>

4. 新しいストレージを追加した後にコンテンツを同期するために、次のコマンドを入力します。

   # scl enable python27 bash

   # python -m util.backfillreplication

   注記

   この操作は、新しいストレージを追加した後にコンテンツを同期するための 1 回限りの操作です。

1. config.yaml を Red Hat Quay を実行しているすべてのマシンにコピーします。

2. 各リージョンの各マシンは、マシンが稼働しているリージョンの優先ストレージエンジンを持つ QUAY_DISTRIBUTED_STORAGE_PREFERENCE 環境変数を追加します。

   たとえば、ヨーロッパで稼働しているマシンで、ホスト上の config ディレクトリーが $QUAY/config から利用できる場合です。

   $ sudo podman run -d --rm -p 80:8080 -p 443:8443  \
      --name=quay \
      -v $QUAY/config:/conf/stack:Z \
      -e QUAY_DISTRIBUTED_STORAGE_PREFERENCE=europestorage \
      registry.redhat.io/quay/quay-rhel8:v3.13.1

   注記

   指定された環境変数の値は、コンフィグパネルで定義されたロケーション ID の名前と一致する必要があります。

3. すべての Red Hat Quay コンテナーを再起動します。

手順

1. 次のコマンドを実行して、定義されたすべてのサイト間で Blob を同期します。

   $ python -m util.backfillreplication

   警告

   Red Hat Quay config.yaml ファイルからストレージエンジンを削除する前に、定義されているすべてのサイト間ですべての Blob が同期されていることを確認する 必要があります。続行する前に、この手順を完了してください。

2. サイト usstorage の Red Hat Quay config.yaml ファイルで、eustorage サイトの DISTRIBUTED_STORAGE_CONFIG エントリーを削除します。

3. 次のコマンドを入力して、実行中のコンテナーのリストを取得します。

   $ podman ps

   出力例

   CONTAINER ID  IMAGE                                                                     COMMAND         CREATED         STATUS             PORTS                                        NAMES
   92c5321cde38  registry.redhat.io/rhel8/redis-5:1                                        run-redis       11 days ago     Up 11 days ago     0.0.0.0:6379->6379/tcp                       redis
   4e6d1ecd3811  registry.redhat.io/rhel8/postgresql-13:1-109                              run-postgresql  33 seconds ago  Up 34 seconds ago  0.0.0.0:5432->5432/tcp                       postgresql-quay
   d2eadac74fda  registry-proxy.engineering.redhat.com/rh-osbs/quay-quay-rhel8:v3.9.0-131  registry        4 seconds ago   Up 4 seconds ago   0.0.0.0:80->8080/tcp, 0.0.0.0:443->8443/tcp  quay

4. 次のコマンドを入力して、PostgreSQL コンテナー内でシェルを実行します。

   $ podman exec -it postgresql-quay -- /bin/bash

5. 次のコマンドを実行して psql を入力します。

   bash-4.4$ psql

6. 次のコマンドを入力して、geo レプリケートされたデプロイメント内のサイトのリストを表示します。

   quay=# select * from imagestoragelocation;

   出力例

    id |       name
   ----+-------------------
     1 | usstorage
     2 | eustorage

7. 次のコマンドを入力して postgres CLI を終了し、bash-4.4 に再度入ります。

   \q

8. 次のコマンドを入力して、eustorage サイトを完全に削除します。

   重要

   次の操作は元に戻すことができません。注意して使用してください。

   bash-4.4$ python -m util.removelocation eustorage

   出力例

   WARNING: This is a destructive operation. Are you sure you want to remove eustorage from your storage locations? [y/n] y
   Deleted placement 30
   Deleted placement 31
   Deleted placement 32
   Deleted placement 33
   Deleted location eustorage

手順

1. Red Hat Quay の postgres インスタンスをデプロイします。

2. 次のコマンドを入力してデータベースにログインします。

   psql -U <username> -h <hostname> -p <port> -d <database_name>

3. quay という名前で Red Hat Quay のデータベースを作成します。以下に例を示します。

   CREATE DATABASE quay;

4. データベース内で pg_trm 拡張機能を有効にします。

   \c quay;
   CREATE EXTENSION IF NOT EXISTS pg_trgm;

5. Redis インスタンスをデプロイします。

   注記
   • クラウドプロバイダーに独自のサービスが含まれている場合は、Redis インスタンスをデプロイする必要がない可能性があります。
   • Builder を利用している場合は、Redis インスタンスをデプロイする必要があります。
   1. Redis 用の VM をデプロイします。
   2. Red Hat Quay が実行されているクラスターからアクセスできることを確認します。
   3. ポート 6379/TCP が開いている必要があります。

   4. インスタンス内で Redis を実行します。

      sudo dnf install -y podman
      podman run -d --name redis -p 6379:6379 redis

6. クラスターごとに 1 つずつ、2 つのオブジェクトストレージバックエンドを作成します。1 つのオブジェクトストレージバケットが最初のクラスター (プライマリークラスター) の近くにあり、もう 1 つが 2 番目のクラスター (セカンダリークラスター) の近くにあると理想的です。
7. 環境変数のオーバーライドを使用して、同じ設定バンドルでクラスターをデプロイし、個々のクラスターに適切なストレージバックエンドを選択します。
8. クラスターへの単一のエントリーポイントを提供するように、ロードバランサーを設定します。

手順

1. 次のコマンドを実行して、定義されたすべてのサイト間で Blob を同期します。

   $ python -m util.backfillreplication

   警告

   Red Hat Quay config.yaml ファイルからストレージエンジンを削除する前に、定義されているすべてのサイト間ですべての Blob が同期されていることを確認する 必要があります。

   このコマンドを実行すると、レプリケーションワーカーによって取得されるレプリケーションジョブが作成されます。レプリケートする必要がある Blob がある場合、スクリプトはレプリケートされる Blob の UUID を返します。このコマンドを複数回実行したときに、スクリプトから返された出力が空であっても、レプリケーションプロセスが完了したことを意味するわけではありません。それはレプリケーションのためにキューに入れる Blob が残っていないことを意味します。レプリケーションにかかる割り当て時間は検出された Blob の数によって異なるため、次のステップに進む前に適切に評価してください。

   または、Microsoft Azure などのサードパーティーのクラウドツールを使用して、同期ステータスを確認することもできます。

   このステップは次に進む前に完了する必要があります。

2. サイト usstorage の Red Hat Quay config.yaml ファイルで、eustorage サイトの DISTRIBUTED_STORAGE_CONFIG エントリーを削除します。

3. 次のコマンドを入力して、Quay アプリケーション Pod を識別します。

   $ oc get pod -n <quay_namespace>

   出力例

   quay390usstorage-quay-app-5779ddc886-2drh2
   quay390eustorage-quay-app-66969cd859-n2ssm

4. 以下のコマンドを入力して、usstorage Pod でインタラクティブシェルセッションを開きます。

   $ oc rsh quay390usstorage-quay-app-5779ddc886-2drh2

5. 次のコマンドを入力して、eustorage サイトを完全に削除します。

   重要

   次の操作は元に戻すことができません。注意して使用してください。

   sh-4.4$ python -m util.removelocation eustorage

   出力例

   WARNING: This is a destructive operation. Are you sure you want to remove eustorage from your storage locations? [y/n] y
   Deleted placement 30
   Deleted placement 31
   Deleted placement 32
   Deleted placement 33
   Deleted location eustorage