Red Hat Quay Operator の機能

手順

1. 次のコマンドを入力して、cluster-monitoring-config ConfigMap オブジェクトが存在するかどうかを確認します。

   $ oc -n openshift-monitoring get configmap cluster-monitoring-config

   出力例

   Error from server (NotFound): configmaps "cluster-monitoring-config" not found

2. オプション: ConfigMap オブジェクトが存在しない場合は、YAML マニフェストを作成します。次の例では、ファイルの名前は cluster-monitoring-config.yaml です。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cluster-monitoring-config
     namespace: openshift-monitoring
   data:
     config.yaml: |

3. オプション: ConfigMap オブジェクトが存在しない場合は、ConfigMap オブジェクトを作成します。

   $ oc apply -f cluster-monitoring-config.yaml

   出力例

   configmap/cluster-monitoring-config created

4. 次のコマンドを実行して、ConfigMap オブジェクトが存在することを確認します。

   $ oc -n openshift-monitoring get configmap cluster-monitoring-config

   出力例

   NAME                        DATA   AGE
   cluster-monitoring-config   1      12s

手順

1. 次のコマンドを入力して、user-workload-monitoring-config ConfigMap オブジェクトが存在するかどうかを確認します。

   $ oc -n openshift-user-workload-monitoring get configmap user-workload-monitoring-config

   出力例

   Error from server (NotFound): configmaps "user-workload-monitoring-config" not found

2. ConfigMap オブジェクトが存在しない場合は、YAML マニフェストを作成します。次の例では、ファイルの名前は user-workload-monitoring-config.yaml です。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: user-workload-monitoring-config
     namespace: openshift-user-workload-monitoring
   data:
     config.yaml: |

3. オプション: 次のコマンドを入力して、ConfigMap オブジェクトを作成します。

   $ oc apply -f user-workload-monitoring-config.yaml

   出力例

   configmap/user-workload-monitoring-config created

手順

1. 次のコマンドを入力して、ユーザー定義プロジェクトの監視が実行されているかどうかを確認します。

   $ oc get pods -n openshift-user-workload-monitoring

   出力例

   No resources found in openshift-user-workload-monitoring namespace.

2. 次のコマンドを入力して、cluster-monitoring-config ConfigMap を編集します。

   $ oc -n openshift-monitoring edit configmap cluster-monitoring-config

3. config.yaml ファイルで enableUserWorkload: true を設定して、クラスター上のユーザー定義プロジェクトの監視を有効にします。

   apiVersion: v1
   data:
     config.yaml: |
       enableUserWorkload: true
   kind: ConfigMap
   metadata:
     annotations:

4. 次のコマンドを入力してファイルを保存し、変更を適用して、適切な Pod が実行されていることを確認します。

   $ oc get pods -n openshift-user-workload-monitoring

   出力例

   NAME                                   READY   STATUS    RESTARTS   AGE
   prometheus-operator-6f96b4b8f8-gq6rl   2/2     Running   0          15s
   prometheus-user-workload-0             5/5     Running   1          12s
   prometheus-user-workload-1             5/5     Running   1          12s
   thanos-ruler-user-workload-0           3/3     Running   0          8s
   thanos-ruler-user-workload-1           3/3     Running   0          8s

手順

1. Service オブジェクトの YAML ファイルを作成します。

   $ cat <<EOF >  quay-service.yaml
   
   apiVersion: v1
   kind: Service
   metadata:
     annotations:
     labels:
       quay-component: monitoring
       quay-operator/quayregistry: example-registry
     name: example-registry-quay-metrics
     namespace: quay-enterprise
   spec:
     ports:
     - name: quay-metrics
       port: 9091
       protocol: TCP
       targetPort: 9091
     selector:
       quay-component: quay-app
       quay-operator/quayregistry: example-registry
     type: ClusterIP
   EOF

2. 次のコマンドを入力して、Service オブジェクトを作成します。

   $  oc apply -f quay-service.yaml

   出力例

   service/example-registry-quay-metrics created

手順

1. ServiceMonitor リソースの YAML ファイルを作成します。

   $ cat <<EOF >  quay-service-monitor.yaml
   
   apiVersion: monitoring.coreos.com/v1
   kind: ServiceMonitor
   metadata:
     labels:
       quay-operator/quayregistry: example-registry
     name: example-registry-quay-metrics-monitor
     namespace: quay-enterprise
   spec:
     endpoints:
     - port: quay-metrics
     namespaceSelector:
       any: true
     selector:
       matchLabels:
         quay-component: monitoring
   EOF

2. 次のコマンドを入力して、ServiceMonitor リソースを作成します。

   $ oc apply -f quay-service-monitor.yaml

   出力例

   servicemonitor.monitoring.coreos.com/example-registry-quay-metrics-monitor created

手順

1. OpenShift Container Platform コンソールにログインし、Storage → Persistent Volume Claims を選択します。
2. PostgreSQL 13 または Clair PostgreSQL 13 に必要な PersistentVolumeClaim を選択します (例: example-registry-quay-postgres-13)。
3. Action メニューから Expand PVC を選択します。

4. 永続ボリューム要求 (PVC) の新しいサイズを入力し、Expand を選択します。

   数分後、拡張されたサイズが PVC の Capacity フィールドに反映されます。

手順

1. ClusterServiceVersion オブジェクトは、クラスター内で実行中の Operator を Operator Lifecycle Manager が表現したものです。Kubernetes UI または kubectl/oc CLI ツールを使用して、Red Hat Quay Operator の ClusterServiceVersion を見つけます。以下に例を示します。

   $ oc get clusterserviceversions -n <your-namespace>

2. UI、oc edit、または別の方法を使用して、Red Hat Quay ClusterServiceVersion を変更して、オーバーライドイメージを指す上記の環境変数を含めます。

   JSONPath: spec.install.spec.deployments[0].spec.template.spec.containers[0].env

   - name: RELATED_IMAGE_COMPONENT_QUAY
     value: quay.io/projectquay/quay@sha256:c35f5af964431673f4ff5c9e90bdf45f19e38b8742b5903d41c10cc7f6339a6d
   - name: RELATED_IMAGE_COMPONENT_CLAIR
     value: quay.io/projectquay/clair@sha256:70c99feceb4c0973540d22e740659cd8d616775d3ad1c1698ddf71d0221f3ce6
   - name: RELATED_IMAGE_COMPONENT_POSTGRES
     value: centos/postgresql-10-centos7@sha256:de1560cb35e5ec643e7b3a772ebaac8e3a7a2a8e8271d9e91ff023539b4dfb33
   - name: RELATED_IMAGE_COMPONENT_REDIS
     value: centos/redis-32-centos7@sha256:06dbb609484330ec6be6090109f1fa16e936afcf975d1cbc5fff3e6c7cae7542

手順

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

手順

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-app-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. 作成されたサービスキー行の authorization_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. 次のコマンドを入力して、OpenShift Container Platform デプロイメント上の Red Hat Quay のシークレット名を読み取ります。

   $ 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..."
   # ...

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

手順

1. QuayRegistry カスタムリソースをエクスポートしてバックアップするには、次のコマンドを入力します。

   $ oc get quayregistry <quay_registry_name> -n <quay_namespace> -o yaml > quay-registry.yaml

2. 作成される quayregistry.yaml を編集し、ステータスセクションおよび以下のメタデータフィールドを削除します。

     metadata.creationTimestamp
     metadata.finalizers
     metadata.generation
     metadata.resourceVersion
     metadata.uid

3. 次のコマンドを入力して、マネージドキーのシークレットをバックアップします。

   注記

   Red Hat Quay 3.7.0 より前のバージョンを実行している場合は、この手順を省略できます。一部のシークレットは Red Hat Quay の初回デプロイ時に自動的に生成されます。これらは QuayRegistry リソースの名前空間で、<quay_registry_name>-quay_registry_managed_secret_keys というシークレットに保存されます。

   $ oc get secret -n <quay_namespace> <quay_registry_name>_quay_registry_managed_secret_keys -o yaml > managed_secret_keys.yaml

4. 作成された managed_secret_keys.yaml ファイルを編集し、エントリー metadata.ownerReferences を削除します。managed_secret_keys.yaml ファイルは、以下のようになります。

   apiVersion: v1
   kind: Secret
   type: Opaque
   metadata:
     name: <quayname>_quay_registry_managed_secret_keys>
     namespace: <quay_namespace>
   data:
     CONFIG_EDITOR_PW: <redacted>
     DATABASE_SECRET_KEY: <redacted>
     DB_ROOT_PW: <redacted>
     DB_URI: <redacted>
     SECRET_KEY: <redacted>
     SECURITY_SCANNER_V4_PSK: <redacted>

   data プロパティーの情報はすべて同じままにする必要があります。

5. 次のコマンドを入力して、現在の Quay 設定ファイルをリダイレクトします。

   $ oc get secret -n <quay-namespace>  $(oc get quayregistry <quay_registry_name> -n <quay_namespace>  -o jsonpath='{.spec.configBundleSecret}') -o yaml > config-bundle.yaml

6. Quay Pod 内にマウントされた /conf/stack/config.yaml ファイルをバックアップします。

   $ oc exec -it quay_pod_name -- cat /conf/stack/config.yaml > quay_config.yaml

手順

1. Red Hat Quay デプロイメントのバージョンに応じて、次のいずれかのオプションを使用してデプロイメントをスケールダウンします。

   1. Operator バージョン 3.7 以降: Red Hat Quay の自動スケーリングを無効にし、Red Hat Quay、ミラーワーカー、および Clair (管理される場合) のレプリカ数をオーバーライドすることで Red Hat Quay デプロイメントを縮小します。QuayRegistry リソースは、以下のようになります。

      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 に設定します。

   2. Operator バージョン 3.6 以前: まず Red Hat Quay レジストリーをスケールダウンしてからマネージドの Red Hat Quay リソースをスケールダウンして、Red Hat Quay デプロイメントをスケールダウンします。

      $ oc scale --replicas=0 deployment $(oc get deployment -n <quay-operator-namespace>|awk '/^quay-operator/ {print $1}') -n <quay-operator-namespace>

      $ oc scale --replicas=0 deployment $(oc get deployment -n <quay-namespace>|awk '/quay-app/ {print $1}') -n <quay-namespace>

      $ oc scale --replicas=0 deployment $(oc get deployment -n <quay-namespace>|awk '/quay-mirror/ {print $1}') -n <quay-namespace>

      $ oc scale --replicas=0 deployment $(oc get deployment -n <quay-namespace>|awk '/clair-app/ {print $1}') -n <quay-namespace>

2. registry-quay-app、registry-quay-mirror、および registry-clair-app Pod (どのコンポーネントを Red Hat Quay Operator がマネージするように設定したかにより異なります) が非表示になるまで待機します。以下のコマンドを実行してステータスを確認できます。

   $ oc get pods -n <quay_namespace>

   出力例:

   $ oc get pod

   出力例

   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-database-859d5445ff-cqthr        1/1     Running     0             12m
   quayregistry-quay-redis-84f888776f-hhgms           1/1     Running     0             12m

手順

1. Quay PostgreSQL Pod 名を特定します。

   $ oc get pod -l quay-component=postgres -n <quay_namespace> -o jsonpath='{.items[0].metadata.name}'

   出力例:

   quayregistry-quay-database-59f54bb7-58xs7

2. Quay データベース名を取得します。

   $ oc -n <quay_namespace> rsh $(oc get pod -l app=quay -o NAME -n <quay_namespace> |head -n 1) cat /conf/stack/config.yaml|awk -F"/" '/^DB_URI/ {print $4}'
   quayregistry-quay-database

3. バックアップデータベースをダウンロードします。

   $ oc exec quayregistry-quay-database-59f54bb7-58xs7 -- /usr/bin/pg_dump -C quayregistry-quay-database  > backup.sql

1. Red Hat Quay デプロイメントのバージョンに応じて、次のいずれかのオプションを使用してデプロイメントをスケールアップします。

   1. Operator バージョン 3.7 以降: 自動スケーリングを再度有効にし、必要な場合は Quay、ミラーワーカー、および Clair のレプリカオーバーライドを適宜削除して、Red Hat Quay デプロイメントをスケールアップします。QuayRegistry リソースは、以下のようになります。

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

      1

      Quay、Clair、ミラーリングワーカーの自動スケーリングの再有効化 (必要に応じて)

      2

      Quay コンポーネントのバックアップをスケーリングするためにレプリカオーバーライドを再削除

   2. Operator バージョン 3.6 以前の場合: Red Hat Quay レジストリーをスケールアップして、Red Hat Quay デプロイメントをスケールアップします。

      $ oc scale --replicas=1 deployment $(oc get deployment -n <quay_operator_namespace> | awk '/^quay-operator/ {print $1}') -n <quay_operator_namespace>

2. 次のコマンドを入力して、Red Hat Quay デプロイメントのステータスを確認します。

   $ oc wait quayregistry registry --for=condition=Available=true -n <quay_namespace>

   出力例:

   apiVersion: quay.redhat.com/v1
   kind: QuayRegistry
   metadata:
     ...
     name: registry
     namespace: <quay-namespace>
     ...
   spec:
     ...
   status:
     - lastTransitionTime: '2022-06-20T05:31:17Z'
       lastUpdateTime: '2022-06-20T17:31:13Z'
       message: All components reporting as healthy
       reason: HealthChecksPassing
       status: 'True'
       type: Available

手順

1. 次のコマンドを入力して、バックアップされた Red Hat Quay 設定を復元します。

   $ oc create -f ./config-bundle.yaml

   重要

   エラー Error from server (AlreadyExists): error when creating "./config-bundle.yaml": secrets "config-bundle-secret" already exists が発生した場合は、$ oc delete Secret config-bundle-secret -n <quay-namespace> を使用して既存リソースを削除し、$ oc create -f ./config-bundle.yaml で再作成する必要があります。

2. 次のコマンドを入力して、生成されたキーをバックアップから復元します。

   $ oc create -f ./managed-secret-keys.yaml

3. QuayRegistry カスタムリソースを復元します。

   $ oc create -f ./quay-registry.yaml

4. Red Hat Quay デプロイメントのステータスを確認し、これが利用可能になるまで待機します。

   $ oc wait quayregistry registry --for=condition=Available=true -n <quay-namespace>

手順

1. Red Hat Quay デプロイメントのバージョンに応じて、次のいずれかのオプションを使用してデプロイメントをスケールダウンします。

   1. Operator バージョン 3.7 以降: Red Hat Quay の自動スケーリングを無効にし、Red Hat Quay、ミラーワーカー、および Clair (マネージドの場合) のレプリカ数をオーバーライドすることで Quay デプロイメントを縮小します。QuayRegistry リソースは、以下のようになります。

      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 に設定します。

   2. Operator バージョン 3.6 以前: まず Red Hat Quay レジストリーをスケールダウンしてからマネージドの Red Hat Quay リソースをスケールダウンして、Red Hat Quay デプロイメントをスケールダウンします。

      $ oc scale --replicas=0 deployment $(oc get deployment -n <quay-operator-namespace>|awk '/^quay-operator/ {print $1}') -n <quay-operator-namespace>

      $ oc scale --replicas=0 deployment $(oc get deployment -n <quay-namespace>|awk '/quay-app/ {print $1}') -n <quay-namespace>

      $ oc scale --replicas=0 deployment $(oc get deployment -n <quay-namespace>|awk '/quay-mirror/ {print $1}') -n <quay-namespace>

      $ oc scale --replicas=0 deployment $(oc get deployment -n <quay-namespace>|awk '/clair-app/ {print $1}') -n <quay-namespace>

2. registry-quay-app、registry-quay-mirror、および registry-clair-app Pod (どのコンポーネントを Red Hat Quay Operator がマネージするように設定したかにより異なります) が非表示になるまで待機します。以下のコマンドを実行してステータスを確認できます。

   $ oc get pods -n <quay-namespace>

   出力例:

   registry-quay-config-editor-77847fc4f5-nsbbv   1/1     Running            0          9m1s
   registry-quay-database-66969cd859-n2ssm        1/1     Running            0          6d1h
   registry-quay-redis-7cc5f6c977-956g8           1/1     Running            0          5d21h

手順

1. 次のコマンドを入力して、Quay データベース Pod を識別します。

   $ oc get pod -l quay-component=postgres -n  <quay-namespace> -o jsonpath='{.items[0].metadata.name}'

   出力例:

   quayregistry-quay-database-59f54bb7-58xs7

2. ローカル環境および Pod にコピーして、バックアップをアップロードします。

   $ oc cp ./backup.sql -n <quay-namespace> registry-quay-database-66969cd859-n2ssm:/tmp/backup.sql

3. 次のコマンドを入力して、データベースへのリモートターミナルを開きます。

   $ oc rsh -n <quay-namespace> registry-quay-database-66969cd859-n2ssm

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

   bash-4.4$ psql

5. 以下のコマンドを実行してデータベースをリスト表示できます。

   postgres=# \l

   出力例

                                                     List of databases
              Name            |           Owner            | Encoding |  Collate   |   Ctype    |   Access privileges
   ----------------------------+----------------------------+----------+------------+------------+-----------------------
   postgres                   | postgres                   | UTF8     | en_US.utf8 | en_US.utf8 |
   quayregistry-quay-database | quayregistry-quay-database | UTF8     | en_US.utf8 | en_US.utf8 |

6. 次のコマンドを入力してデータベースを削除します。

   postgres=# DROP DATABASE "quayregistry-quay-database";

   出力例

   DROP DATABASE

7. postgres CLI を終了して bash-4.4 を再入力します。

   \q

8. PostgreSQL データベースをバックアップデータベースにリダイレクトします。

   sh-4.4$ psql < /tmp/backup.sql

9. 次のコマンドを入力して bash を終了します。

   sh-4.4$ exit

手順

1. 次のコマンドを入力して、AWS_ACCESS_KEY_ID をエクスポートします。

   $ export AWS_ACCESS_KEY_ID=$(oc get secret -l app=noobaa -n <quay-namespace>  -o jsonpath='{.items[0].data.AWS_ACCESS_KEY_ID}' |base64 -d)

2. 次のコマンドを入力して、AWS_SECRET_ACCESS_KEY をエクスポートします。

   $ export AWS_SECRET_ACCESS_KEY=$(oc get secret -l app=noobaa -n <quay-namespace> -o jsonpath='{.items[0].data.AWS_SECRET_ACCESS_KEY}' |base64 -d)

3. 以下のコマンドを実行して、すべての Blob をバケットにアップロードします。

   $ aws s3 sync --no-verify-ssl --endpoint https://$(oc get route s3 -n openshift-storage  -o jsonpath='{.spec.host}') ./blobs  s3://$(oc get cm -l app=noobaa -n <quay-namespace> -o jsonpath='{.items[0].data.BUCKET_NAME}')

1. Red Hat Quay デプロイメントのバージョンに応じて、次のいずれかのオプションを使用してデプロイメントをスケールアップします。

   1. Operator バージョン 3.7 以降: 自動スケーリングを再度有効にし、必要な場合は Quay、ミラーワーカー、および Clair のレプリカオーバーライドを適宜削除して、Red Hat Quay デプロイメントをスケールアップします。QuayRegistry リソースは、以下のようになります。

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

      1

      Red Hat Quay、Clair、ミラーリングワーカーの自動スケーリングの再有効化 (必要に応じて)

      2

      Red Hat Quay コンポーネントのバックアップをスケーリングするためにレプリカオーバーライドを再削除

   2. Operator バージョン 3.6 以前の場合: Red Hat Quay レジストリーを再度スケールアップして、Red Hat Quay デプロイメントをスケールアップします。

      $ oc scale --replicas=1 deployment $(oc get deployment -n <quay-operator-namespace> | awk '/^quay-operator/ {print $1}') -n <quay-operator-namespace>

2. Red Hat Quay デプロイメントのステータスを確認します。

   $ oc wait quayregistry registry --for=condition=Available=true -n <quay-namespace>

   出力例:

   apiVersion: quay.redhat.com/v1
   kind: QuayRegistry
   metadata:
     ...
     name: registry
     namespace: <quay-namespace>
     ...
   spec:
     ...
   status:
     - lastTransitionTime: '2022-06-20T05:31:17Z'
       lastUpdateTime: '2022-06-20T17:31:13Z'
       message: All components reporting as healthy
       reason: HealthChecksPassing
       status: 'True'
       type: Available

手順

1. quay-integration.yaml を作成します:

   $ touch quay-integration.yaml

2. QuayIntegration カスタムリソースの最小限のデプロイメントには、次の設定を使用します。

     apiVersion: quay.redhat.com/v1
     kind: QuayIntegration
     metadata:
       name: example-quayintegration
     spec:
       clusterID: openshift  1
       credentialsSecret:
         namespace: openshift-operators
         name: quay-integration2
       quayHostname: https://<QUAY_URL>   3
       insecureRegistry: false 4

   1

   clusterID の値は、エコシステム全体で一意である必要があります。この値は必須であり、デフォルトは openshift です。

   2

   credentialsSecret プロパティーは、以前に作成されたトークンが含まれるシークレットの namespace および名前を参照します。

   3

   QUAY_URL を Red Hat Quay インスタンスのホスト名に置き換えます。

   4

   Red Hat Quay が自己署名証明書を使用している場合は、プロパティーを insecureRegistry: true に設定します。

1. QuayIntegration カスタムリソースを作成します。

   $ oc create -f quay-integration.yaml

手順

1. Web コンソールの Administrator パースペクティブを開き、Operators → Installed Operators に移動します。
2. Red Hat Quay Bridge Operator をクリックします。
3. Quay Bridge Operator の Details ページで、Quay Integration API カードの Create Instance をクリックします。

4. Create QuayIntegration ページで、Form view または YAML view のいずれかに以下の必須情報を入力します。

   • Name: QuayIntegration カスタムリソースオブジェクトを参照する名前。
   • Cluster ID: このクラスターに関連付けられている ID。この値は、エコシステム全体で一意である必要があります。指定しない場合、デフォルトで openshift になります。
   • Credentials secret: 以前に作成されたトークンを含むシークレットの名前空間と名前を参照します。
   • Quay hostname: Quay レジストリーのホスト名。

手順

1. UI または kubectl のいずれかを使用して QuayRegistry を削除します。

   $ kubectl delete -n <namespace> quayregistry <quayecosystem-name>

2. Route を使用して外部アクセスを提供していた場合は、UI や kubectl を使用して元の Service を指すように Route を変更します。