第6章 Red Hat Quay Operator によって管理される Red Hat Quay のバックアップおよび復元

手順

1. 次のコマンドを入力して、Red Hat Quay Pod のリストを取得します。

   $ oc get pods -n <namespace>

   出力例

   example-registry-clair-app-7dc7ff5844-4skw5           0/1     Error                    0             70d
   example-registry-clair-app-7dc7ff5844-nvn4f           1/1     Running                  0             31d
   example-registry-clair-app-7dc7ff5844-x4smw           0/1     ContainerStatusUnknown   6 (70d ago)   70d
   example-registry-clair-app-7dc7ff5844-xjnvt           1/1     Running                  0             60d
   example-registry-clair-postgres-547d75759-75c49       1/1     Running                  0             70d
   example-registry-quay-app-76c8f55467-52wjz            1/1     Running                  0             70d
   example-registry-quay-app-76c8f55467-hwz4c            1/1     Running                  0             70d
   example-registry-quay-app-upgrade-57ghs               0/1     Completed                1             70d
   example-registry-quay-database-7c55899f89-hmnm6       1/1     Running                  0             70d
   example-registry-quay-mirror-6cccbd76d-btsnb          1/1     Running                  0             70d
   example-registry-quay-mirror-6cccbd76d-x8g42          1/1     Running                  0             70d
   example-registry-quay-redis-85cbdf96bf-4vk5m          1/1     Running                  0             70d

2. 次のコマンドを入力して、Quay コンテナーへのリモートシェルセッションを開きます。

   $ oc rsh example-registry-quay-app-76c8f55467-52wjz

3. 次のコマンドを入力して、必要なサービスキーを作成します。

   sh-4.4$ python3 tools/generatekeypair.py quay-readonly

   出力例

   Writing public key to quay-readonly.jwk
   Writing key ID to quay-readonly.kid
   Writing private key to quay-readonly.pem

手順

1. 次のコマンドを入力して、Red Hat Quay データベース環境に入ります。

   $ oc rsh example-registry-quay-database-76c8f55467-52wjz psql -U <database_username> -d <database_name>

2. 次のコマンドを入力して、servicekeyapproval の承認タイプと関連する注記を表示します。

   quay=# select * from servicekeyapproval;

   出力例

    id | approver_id |          approval_type           |       approved_date        | notes
   ----+-------------+----------------------------------+----------------------------+-------
     1 |             | ServiceKeyApprovalType.AUTOMATIC | 2024-05-07 03:47:48.181347 |
     2 |             | ServiceKeyApprovalType.AUTOMATIC | 2024-05-07 03:47:55.808087 |
     3 |             | ServiceKeyApprovalType.AUTOMATIC | 2024-05-07 03:49:04.27095  |
     4 |             | ServiceKeyApprovalType.AUTOMATIC | 2024-05-07 03:49:05.46235  |
     5 |           1 | ServiceKeyApprovalType.SUPERUSER | 2024-05-07 04:05:10.296796 |
   ...

3. 次のクエリーを入力して、Red Hat Quay データベースにサービスキーを追加します。

   quay=# INSERT INTO servicekey
     (name, service, metadata, kid, jwk, created_date, expiration_date)
     VALUES ('quay-readonly',
              'quay',
              '{}',
              '{<contents_of_.kid_file>}',
              '{<contents_of_.jwk_file>}',
              '{<created_date_of_read-only>}',
              '{<expiration_date_of_read-only>}');

   出力例

   INSERT 0 1

4. 次のクエリーを使用してキー承認を追加します。

   quay=# INSERT INTO servicekeyapproval ('approval_type', 'approved_date', 'notes')
     VALUES ("ServiceKeyApprovalType.SUPERUSER", "CURRENT_DATE",
              {include_notes_here_on_why_this_is_being_added});

   出力例

   INSERT 0 1

5. 作成されたサービスキー行の approval_id フィールドを、作成されたサービスキー承認の id フィールドに設定します。必要な ID を取得するには、次の SELECT ステートメントを使用できます。

   UPDATE servicekey
   SET approval_id = (SELECT id FROM servicekeyapproval WHERE approval_type = 'ServiceKeyApprovalType.SUPERUSER')
   WHERE name = 'quay-readonly';

   UPDATE 1

手順

1. 次のコマンドを入力して、Red Hat Quay on OpenShift Container Platform デプロイメントのシークレット名を読み取ります。

   $ oc get deployment -o yaml <quay_main_app_deployment_name>

2. base64 コマンドを使用して、quay-readonly.kid ファイルと quay-readonly.pem ファイルをエンコードします。

   $ base64 -w0 quay-readonly.kid

   出力例

   ZjUyNDFm...

   $ base64 -w0 quay-readonly.pem

   出力例

   LS0tLS1CRUdJTiBSU0E...

3. 次のコマンドを入力して、現在の設定バンドルとシークレットを取得します。

   $ oc get secret quay-config-secret-name -o json | jq '.data."config.yaml"' | cut -d '"' -f2 | base64 -d -w0 > config.yaml

4. config.yaml ファイルを編集し、次の情報を追加します。

   # ...
   REGISTRY_STATE: readonly
   INSTANCE_SERVICE_KEY_KID_LOCATION: 'conf/stack/quay-readonly.kid'
   INSTANCE_SERVICE_KEY_LOCATION: 'conf/stack/quay-readonly.pem'
   # ...

5. 次のコマンドを実行してファイルを保存し、base64 でエンコードします。

   $ base64 -w0 quay-config.yaml

6. Red Hat Quay Operator Pod を 0 にスケールダウンします。これにより、シークレットの編集後に Operator がシークレットを調整することがなくなります。

   $ oc scale --replicas=0 deployment quay-operator -n openshift-operators

7. シークレットを編集し、新しい内容を追加します。

   $ oc edit secret quay-config-secret-name -n quay-namespace

   # ...
   data:
     "quay-readonly.kid": "ZjUyNDFm..."
     "quay-readonly.pem": "LS0tLS1CRUdJTiBSU0E..."
     "config.yaml": "QUNUSU9OX0xPR19..."
   # ...

   Red Hat Quay on OpenShift Container Platform デプロイメントを読み取り専用モードで実行すると、レジストリーの操作を安全に管理しながら、バックアップや復元などのアクションを実行できます。