1. 3.0.5 → 3.1.3
2. 3.1.3 → 3.2.2
3. 3.2.2 → 3.3.4
4. 3.3.4 → 3.4.z
5. 3.4.z → 3.5.z

手順

1. 次のコマンドを入力して、quayregistry-quay-config-editor ルートオブジェクトを取得します。

   $ oc get route

   出力例

   ---
   quayregistry-quay-config-editor-c866f64c4-68gtb   1/1     Running     0          49m
   ---

2. 次のコマンドを入力して、quayregistry-quay-config-editor ルートオブジェクトを削除します。

   $ oc delete route quayregistry-quay-config-editor

3. 次のコマンドを入力して、quayregistry-quay-config-editor デプロイメントオブジェクトを取得します。

   $ oc get deployment

   出力例

   ---
   quayregistry-quay-config-editor
   ---

4. 次のコマンドを入力して、quayregistry-quay-config-editor デプロイメントオブジェクトを削除します。

   $ oc delete deployment quayregistry-quay-config-editor

5. 次のコマンドを入力して、quayregistry-quay-config-editor サービスオブジェクトを取得します。

   $ oc get svc | grep config-editor

   出力例

   quayregistry-quay-config-editor   ClusterIP   172.30.219.194   <none>        80/TCP                              6h15m

6. 次のコマンドを入力して、quayregistry-quay-config-editor サービスオブジェクトを削除します。

   $ oc delete service quayregistry-quay-config-editor

7. 次のコマンドを入力して、quayregistry-quay-config-editor-credentials シークレットを取得します。

   $ oc get secret | grep config-editor

   出力例

   quayregistry-quay-config-editor-credentials-mb8kchfg92   Opaque                2       52m

8. 次のコマンドを入力して、quayregistry-quay-config-editor-credentials シークレットを削除します。

   $ oc delete secret quayregistry-quay-config-editor-credentials-mb8kchfg92

9. 次のコマンドを入力して、quayregistry-quay-config-editor Pod を取得します。

   $ $ oc get pod

   出力例

   ---
   quayregistry-quay-config-editor-c866f64c4-68gtb   1/1     Running     0          49m
   ---

10. 次のコマンドを入力して、quayregistry-quay-config-editor Pod を削除します。

    $ oc delete pod quayregistry-quay-app-6bc4fbd456-8bc9c

手順

1. "quay-operator/migrate": "true" を QuayEcosystem の metadata.labels に追加します。

   $ oc edit quayecosystem <quayecosystemname>

   metadata:
     labels:
       quay-operator/migrate: "true"

2. QuayRegistry が QuayEcosystem と同じ metadata.name で作成されるまで待機します。QuayEcosystem にはラベル "quay-operator/migration-complete": "true" のマークが付けられます。
3. 新しい QuayRegistry の status.registryEndpoint が設定されたら、Red Hat Quay にアクセスし、すべてのデータと設定が正常に移行されたことを確認します。
4. すべてが正常に動作する場合は QuayEcosystem を削除でき、Kubernetes ガベージコレクションによって古いリソースがすべてクリーンアップされます。

手順

1. 次のコマンドを入力して、Red Hat Quay コンテナーをスケールダウンします。

   $ sudo podman stop <quay_container_name>

2. オプション: Clair を使用している場合は、次のコマンドを入力して Clair コンテナーを停止します。

   $ sudo podman stop <clair_container_id>

3. SCLOrg の Data Migration の手順から Podman プロセスを実行します。これにより、リモート PostgreSQL サーバーからのデータ移行が可能になります。

   $ sudo podman run -d --name <migration_postgresql_database> 1
     -e POSTGRESQL_MIGRATION_REMOTE_HOST=172.17.0.2 \ 2
     -e POSTGRESQL_MIGRATION_ADMIN_PASSWORD=remoteAdminP@ssword \
     -v </host/data/directory:/var/lib/pgsql/data:Z> 3
     [ OPTIONAL_CONFIGURATION_VARIABLES ]
     rhel8/postgresql-13

   1

   PostgreSQL 13 移行データベースの名前。

   2

   現在の Red Hat Quay PostgreSQL 13 データベースコンテナーの IP アドレス。sudo podman inspect -f "{{.NetworkSettings.IPAddress}}" postgresql-quay コマンドを実行して取得できます。

   3

   最初の PostgreSQL 10 デプロイメントとは異なるボリュームマウントポイントを指定し、そのディレクトリーのアクセス制御リストを変更する必要があります。以下に例を示します。

   $ mkdir -p /host/data/directory

   $ setfacl -m u:26:-wx /host/data/directory

   これにより、新しいコンテナーによってデータが上書きされるのを防ぎます。

4. オプション: Clair を使用している場合は、Clair PostgreSQL データベースコンテナーに対して前の手順を繰り返します。

5. PostgreSQL 10 コンテナーを停止します。

   $ sudo podman stop <postgresql_container_name>

6. PostgreSQL の移行が完了したら、手順 3 の新しいデータボリュームマウント (例: </host/data/directory:/var/lib/postgresql/data>) を使用して PostgreSQL 13 コンテナーを実行します。

   $ sudo podman run -d --rm --name postgresql-quay \
     -e POSTGRESQL_USER=<username> \
     -e POSTGRESQL_PASSWORD=<password> \
    	-e POSTGRESQL_DATABASE=<quay_database_name> \
     -e POSTGRESQL_ADMIN_PASSWORD=<admin_password> \
     -p 5432:5432 \
     -v </host/data/directory:/var/lib/pgsql/data:Z> \
       registry.redhat.io/rhel8/postgresql-13:1-109

7. オプション: Clair を使用している場合は、Clair PostgreSQL データベースコンテナーに対して前の手順を繰り返します。

8. Red Hat Quay コンテナーを起動します。

   $ sudo podman run -d --rm -p 80:8080 -p 443:8443 --name=quay \
   -v /home/<quay_user>/quay-poc/config:/conf/stack:Z \
   -v /home/<quay_user>/quay-poc/storage:/datastorage:Z \
   {productrepo}/{quayimage}:{productminv}

9. オプション: 以下の例のように Clair コンテナーを再起動します。

   $ sudo podman run -d --name clairv4 \
   -p 8081:8081 -p 8088:8088 \
   -e CLAIR_CONF=/clair/config.yaml \
   -e CLAIR_MODE=combo \
   registry.redhat.io/quay/clair-rhel8:v3.9.0

1. Red Hat Quay クラスターの全ホストのサービスを停止します。

2. データベースの秘密鍵として使用するランダムなデータを生成します。以下に例を示します。

   $ openssl rand -hex 48
   2d023adb9c477305348490aa0fd9c

3. config.yaml ファイルに新しい DATABASE_SECRET_KEY フィールドを追加します。以下に例を示します。

   DATABASE_SECRET_KEY: "2d023adb9c477305348490aa0fd9c"

   注記

   OpenShift のインストールでは、config.yaml ファイルはシークレットとして保存されます。

4. Quay コンテナーを 1 つ起動し、3.2.2 への移行を完了します。
5. 移行が完了したら、すべてのノードで同じ config.yaml が利用可能であることを確認し、それらのノードで新しい quay 3.2.2 サービスを起動します。
6. quay-builder と Clair の 3.0.z バージョンを起動して、クラスターに戻すコンテナーのインスタンスを置き換えます。

1. Red Hat Quay インスタンスを実行している各システムですべての Red Hat Quay インスタンスのリストを取得します。

   1. システム A で以下のコマンドを入力して、Red Hat Quay インスタンスを表示します。

      $ sudo podman ps

      出力例

      CONTAINER ID  IMAGE                                      COMMAND         CREATED        STATUS            PORTS                                        NAMES
      ec16ece208c0  registry.redhat.io/quay/quay-rhel8:v3.7.0  registry        6 minutes ago  Up 6 minutes ago  0.0.0.0:80->8080/tcp, 0.0.0.0:443->8443/tcp  quay01

   2. System B で以下のコマンドを入力して、Red Hat Quay インスタンスを表示します。

      $ sudo podman ps

      出力例

      CONTAINER ID  IMAGE                                      COMMAND         CREATED        STATUS            PORTS                                        NAMES
      7ae0c9a8b37d  registry.redhat.io/quay/quay-rhel8:v3.7.0  registry        5 minutes ago   Up 2 seconds ago   0.0.0.0:82->8080/tcp, 0.0.0.0:445->8443/tcp  quay02

   3. System C で以下のコマンドを入力して、Red Hat Quay インスタンスを表示します。

      $ sudo podman ps

      出力例

      CONTAINER ID  IMAGE                                      COMMAND         CREATED        STATUS            PORTS                                        NAMES
      e75c4aebfee9  registry.redhat.io/quay/quay-rhel8:v3.7.0  registry        4 seconds ago   Up 4 seconds ago   0.0.0.0:84->8080/tcp, 0.0.0.0:447->8443/tcp  quay03

2. 各システムの Red Hat Quay インスタンスをすべて一時的にシャットダウンします。

   1. システム A で以下のコマンドを入力して、Red Hat Quay インスタンスをシャットダウンします。

      $ sudo podman stop ec16ece208c0

   2. System B で以下のコマンドを入力して、Red Hat Quay インスタンスをシャットダウンします。

      $ sudo podman stop 7ae0c9a8b37d

   3. System C で以下のコマンドを入力して、Red Hat Quay インスタンスをシャットダウンします。

      $ sudo podman stop e75c4aebfee9

3. 各システムで、Red Hat Quay 3 などの最新の Red Hat Quay バージョンを取得します。

   1. システム A で以下のコマンドを入力して、最新の Red Hat Quay バージョンを取得します。

      $ sudo podman pull registry.redhat.io/quay/quay-rhel8:v3.8.0

   2. システム B で以下のコマンドを入力して、最新の Red Hat Quay バージョンを取得します。

      $ sudo podman pull registry.redhat.io/quay/quay-rhel8:v3.8.0

   3. システム C で以下のコマンドを入力して、最新の Red Hat Quay バージョンを取得します。

      $ sudo podman pull registry.redhat.io/quay/quay-rhel8:v3.8.0

4. 高可用性 Red Hat Quay デプロイメントの System A で、Red Hat Quay 3 などの新しいイメージバージョンを実行します。

   # sudo podman run --restart=always -p 443:8443 -p 80:8080 \
      --sysctl net.core.somaxconn=4096 \
      --name=quay01 \
      -v /mnt/quay/config:/conf/stack:Z \
      -v /mnt/quay/storage:/datastorage:Z \
      -d registry.redhat.io/quay/quay-rhel8:v3.8.0

5. 新しい Red Hat Quay コンテナーがシステム A で完全に動作可能になるまで待ちます。コンテナーのステータスは、次のコマンドを実行すると確認できます。

   $ sudo podman ps

   出力例

   CONTAINER ID  IMAGE                                      COMMAND         CREATED        STATUS            PORTS                                        NAMES
   70b9f38c3fb4  registry.redhat.io/quay/quay-rhel8:v3.8.0  registry        2 seconds ago   Up 2 seconds ago   0.0.0.0:82->8080/tcp, 0.0.0.0:445->8443/tcp  quay01

6. オプション: Red Hat Quay UI に移動して、Red Hat Quay が完全に動作していることを確認します。

7. システム A 上の Red Hat Quay が完全に動作可能であることを確認したら、System B および System C で新しいイメージバージョンを実行します。

   1. 高可用性 Red Hat Quay デプロイメントの System B で、Red Hat Quay 3 などの新しいイメージバージョンを実行します。

      # sudo podman run --restart=always -p 443:8443 -p 80:8080 \
         --sysctl net.core.somaxconn=4096 \
         --name=quay02 \
         -v /mnt/quay/config:/conf/stack:Z \
         -v /mnt/quay/storage:/datastorage:Z \
         -d registry.redhat.io/quay/quay-rhel8:v3.8.0

   2. 高可用性 Red Hat Quay デプロイメントの System C で、Red Hat Quay 3 などの新しいイメージバージョンを実行します。

      # sudo podman run --restart=always -p 443:8443 -p 80:8080 \
         --sysctl net.core.somaxconn=4096 \
         --name=quay03 \
         -v /mnt/quay/config:/conf/stack:Z \
         -v /mnt/quay/storage:/datastorage:Z \
         -d registry.redhat.io/quay/quay-rhel8:v3.8.0

8. 次のコマンドを入力して、システム B およびシステム C のコンテナーのステータスを確認できます。

   $ sudo podman ps

1. システム B およびシステム C で、Red Hat Quay レジストリーをスケールダウンします。これを行うには、自動スケーリングを無効にし、Red Hat Quay、ミラーワーカー、および Clair (マネージドの場合) のレプリカ数をオーバーライドします。次の quayregistry.yaml ファイルを参照として使用します。

   apiVersion: quay.redhat.com/v1
   kind: QuayRegistry
   metadata:
     name: registry
     namespace: ns
   spec:
     components:
       …
       - kind: horizontalpodautoscaler
         managed: false 1
       - kind: quay
         managed: true
         overrides: 2
           replicas: 0
       - kind: clair
         managed: true
         overrides:
           replicas: 0
       - kind: mirror
         managed: true
         overrides:
           replicas: 0
       …

   1

   Quay、Clair、ミラーリングワーカーの自動スケーリングを無効にします。

   2

   データベースおよびオブジェクトストレージにアクセスするコンポーネントのレプリカ数を 0 に設定します。

   注記

   Red Hat Quay Operator がシステム A で実行されている状態を維持する必要があります。システム A の quayregistry.yaml ファイルは更新しないでください。

2. registry-quay-app、registry-quay-mirror、および registry-clair-app Pod が消えるまで待機します。以下のコマンドを入力してステータスを確認します。

   oc get pods -n <quay-namespace>

   出力例

   quay-operator.v3.7.1-6f9d859bd-p5ftc               1/1     Running     0             12m
   quayregistry-clair-postgres-7487f5bd86-xnxpr       1/1     Running     1 (12m ago)   12m
   quayregistry-quay-app-upgrade-xq2v6                0/1     Completed   0             12m
   quayregistry-quay-redis-84f888776f-hhgms           1/1     Running     0             12m

3. システム A で、最新の y-stream バージョンへの Red Hat Quay のアップグレードを開始します。これは手動プロセスです。インストールされた Operator のアップグレードの詳細は、インストールされた Operator のアップグレード を参照してください。Red Hat Quay アップグレードパスの詳細は、Red Hat Quay Operator のアップグレード を参照してください。
4. 新規の Red Hat Quay Operator のインストール後に、クラスターに必要なアップグレードは自動的に完了します。その後、新しい Red Hat Quay Pod は、最新の y-stream バージョンで起動します。さらに、新しい Quay Pod がスケジュールされ、起動します。

5. Red Hat Quay UI に移動して、更新が適切に機能していることを確認します。

   1. OpenShift コンソールで Operators → Installed Operators に移動し、Registry Endpoint リンクをクリックします。

      重要

      Red Hat Quay UI が利用可能になるまで、次の手順を実行しないでください。システム A で UI が利用可能になるまで、システム B およびシステム C で Red Hat Quay Operator をアップグレードしないでください。

6. 更新が System A で適切に機能していることを確認した後に、System B および System C で Red Hat Quay Operator を開始します。Operator のアップグレードにより、Red Hat Quay インストールがアップグレードされ、Pod が再起動されます。

   注記

   データベーススキーマは新しい y-stream インストールに適しているため、System B および System C の新しい Pod がすぐに起動します。