1. 将证书文件和主密钥文件复制到您的配置目录中，确保分别命名为 ssl.cert 和 ssl.key ：

   $ cp ~/ssl.cert $QUAY/config
   $ cp ~/ssl.key $QUAY/config
   $ cd $QUAY/config

2. 编辑 config.yaml 文件，并指定您希望 Quay 处理 TLS：

   config.yaml

   ...
   SERVER_HOSTNAME: quay-server.example.com
   ...
   PREFERRED_URL_SCHEME: https
   ...

3. 停止 Quay 容器并重启 registry：

   $ sudo podman rm -f quay
   $ sudo podman run -d --rm -p 80:8080 -p 443:8443 \
     --name=quay \
     -v $QUAY/config:/conf/stack:Z \
     -v $QUAY/storage:/datastorage:Z \
     registry.redhat.io/quay/quay-rhel8:v3.8.5

1. 以配置模式启动 Quay 容器：

   $ sudo podman run --rm -it --name quay_config -p 80:8080 -p 443:8443 registry.redhat.io/quay/quay-rhel8:v3.8.5 config secret

2. 在 Server Configuration 部分中，选择 Red Hat Quay handle TLS for TLS。上传之前创建的证书文件和私钥文件，确保 Server Hostname 与创建证书时使用的值匹配。验证并下载更新的配置。

3. 停止 Quay 容器，然后重启 registry：

   $ sudo podman rm -f quay
   $ sudo podman run -d --rm -p 80:8080 -p 443:8443 \
   --name=quay \
   -v $QUAY/config:/conf/stack:Z \
   -v $QUAY/storage:/datastorage:Z \
   registry.redhat.io/quay/quay-rhel8:v3.8.5

1. 将 root CA 文件复制到整合的系统范围信任存储中：

   $ sudo cp rootCA.pem /etc/pki/ca-trust/source/anchors/

2. 更新系统范围的信任存储配置：

   $ sudo update-ca-trust extract

3. 您可以使用 trust list 命令来确保 Quay 服务器已配置：

   $ trust list | grep quay
       label: quay-server.example.com

   现在，当您通过 https://quay-server.example.com 访问 registry 时，锁定图标会显示连接安全：

   

4. 要从系统范围的信任中删除 root CA，请删除该文件并更新配置：

   $ sudo rm /etc/pki/ca-trust/source/anchors/rootCA.pem
   $ sudo update-ca-trust extract
   $ trust list | grep quay
   $

1. 查看添加到容器中的证书

   $ cat storage.crt
   -----BEGIN CERTIFICATE-----
   MIIDTTCCAjWgAwIBAgIJAMVr9ngjJhzbMA0GCSqGSIb3DQEBCwUAMD0xCzAJBgNV
   [...]
   -----END CERTIFICATE-----

2. 创建 certs 目录并复制证书

   $ mkdir -p quay/config/extra_ca_certs
   $ cp storage.crt quay/config/extra_ca_certs/
   $ tree quay/config/
   ├── config.yaml
   ├── extra_ca_certs
   │   ├── storage.crt

3. 使用 podman ps 获取 Quay 容器的 CONTAINER ID ：

   $ sudo podman ps
   CONTAINER ID        IMAGE                                COMMAND                  CREATED             STATUS              PORTS
   5a3e82c4a75f        <registry>/<repo>/quay:v3.8.5 "/sbin/my_init"          24 hours ago        Up 18 hours         0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp, 443/tcp   grave_keller

4. 使用该 ID 重启容器：

   $ sudo podman restart 5a3e82c4a75f

5. 检查复制到容器命名空间中的证书：

   $ sudo podman exec -it 5a3e82c4a75f cat /etc/ssl/certs/storage.pem
   -----BEGIN CERTIFICATE-----
   MIIDTTCCAjWgAwIBAgIJAMVr9ngjJhzbMA0GCSqGSIb3DQEBCwUAMD0xCzAJBgNV

1. 首先使用 base64 编码证书内容：

   $ cat ca.crt
   -----BEGIN CERTIFICATE-----
   MIIDljCCAn6gAwIBAgIBATANBgkqhkiG9w0BAQsFADA5MRcwFQYDVQQKDA5MQUIu
   TElCQ09SRS5TTzEeMBwGA1UEAwwVQ2VydGlmaWNhdGUgQXV0aG9yaXR5MB4XDTE2
   MDExMjA2NTkxMFoXDTM2MDExMjA2NTkxMFowOTEXMBUGA1UECgwOTEFCLkxJQkNP
   UkUuU08xHjAcBgNVBAMMFUNlcnRpZmljYXRlIEF1dGhvcml0eTCCASIwDQYJKoZI
   [...]
   -----END CERTIFICATE-----
   
   $ cat ca.crt | base64 -w 0
   [...]
   c1psWGpqeGlPQmNEWkJPMjJ5d0pDemVnR2QNCnRsbW9JdEF4YnFSdVd3PT0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=

2. 使用 kubectl 工具编辑 quay-enterprise-config-secret。

   $ kubectl --namespace quay-enterprise edit secret/quay-enterprise-config-secret

3. 为证书添加一个条目，并在条目下粘贴完整的 base64 编码字符串：

     custom-cert.crt:
   c1psWGpqeGlPQmNEWkJPMjJ5d0pDemVnR2QNCnRsbW9JdEF4YnFSdVd3PT0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=

4. 最后，回收所有 Red Hat Quay Pod。使用 kubectl delete 删除所有 Red Hat Quay Pod。Red Hat Quay Deployment 将自动使用新证书数据调度替代 pod。

流程

1. 在 Red Hat Quay 安装目录中，为 Clair 数据库数据创建新目录：

   $ mkdir /home/<user-name>/quay-poc/postgres-clairv4

2. 输入以下命令为 postgres-clairv4 文件设置适当的权限：

   $ setfacl -m u:26:-wx /home/<user-name>/quay-poc/postgres-clairv4

3. 输入以下命令部署 Clair Postgres 数据库：

   $ sudo podman run -d --name postgresql-clairv4 \
     -e POSTGRESQL_USER=clairuser \
     -e POSTGRESQL_PASSWORD=clairpass \
     -e POSTGRESQL_DATABASE=clair \
     -e POSTGRESQL_ADMIN_PASSWORD=adminpass \
     -p 5433:5433 \
     -v /home/<user-name>/quay-poc/postgres-clairv4:/var/lib/pgsql/data:Z \
     registry.redhat.io/rhel8/postgresql-13:1-109

4. 为您的 Clair 部署安装 Postgres uuid-ossp 模块：

   $ podman exec -it postgresql-clairv4 /bin/bash -c 'echo "CREATE EXTENSION IF NOT EXISTS \"uuid-ossp\"" | psql -d clair -U postgres'

   输出示例

   CREATE EXTENSION

   注意

   Clair 要求将 uuid-ossp 扩展添加到其 Postgres 数据库中。对于具有适当权限的用户，Clair 将自动添加扩展。如果用户没有正确的权限，则必须在启动 Clair 前添加扩展。

   如果没有扩展，当 Clair 尝试启动时会显示以下错误： ERROR: Please load the "uuid-ossp" 扩展。(SQLSTATE 42501).

5. 如果 Quay 容器正在运行，并在配置模式中重启它，将现有配置载入为卷：

   $ sudo podman run --rm -it --name quay_config \
     -p 80:8080 -p 443:8443 \
     -v $QUAY/config:/conf/stack:Z \
     registry.redhat.io/quay/quay-rhel8:v3.8.2 config secret

6. 登录到配置工具，再单击 UI 的 Security Scanner 部分中的 Enable Security Scanning。
7. 使用 quay-server 系统上尚未使用的端口设置 Clair 的 HTTP 端点，例如 8081。

8. 使用 Generate PSK 按钮创建预共享密钥(PSK)。

   安全扫描器 UI

   

9. 验证并下载 Red Hat Quay 的 config.yaml 文件，然后停止运行配置编辑器的 Quay 容器。

10. 将新配置捆绑包提取到 Red Hat Quay 安装目录中，例如：

    $ tar xvf quay-config.tar.gz -d /home/<user-name>/quay-poc/

11. 为您的 Clair 配置文件创建一个文件夹，例如：

    $ mkdir /etc/opt/clairv4/config/

12. 进入 Clair 配置文件夹：

    $ cd /etc/opt/clairv4/config/

13. 创建 Clair 配置文件，例如：

    http_listen_addr: :8081
    introspection_addr: :8088
    log_level: debug
    indexer:
      connstring: host=quay-server.example.com port=5433 dbname=clair user=clairuser password=clairpass sslmode=disable
      scanlock_retry: 10
      layer_scan_concurrency: 5
      migrations: true
    matcher:
      connstring: host=quay-server.example.com port=5433 dbname=clair user=clairuser password=clairpass sslmode=disable
      max_conn_pool: 100
      run: ""
      migrations: true
      indexer_addr: clair-indexer
    notifier:
      connstring: host=quay-server.example.com port=5433 dbname=clair user=clairuser password=clairpass sslmode=disable
      delivery_interval: 1m
      poll_interval: 5m
      migrations: true
    auth:
      psk:
        key: "MTU5YzA4Y2ZkNzJoMQ=="
        iss: ["quay"]
    # tracing and metrics
    trace:
      name: "jaeger"
      probability: 1
      jaeger:
        agent_endpoint: "localhost:6831"
        service_name: "clair"
    metrics:
      name: "prometheus"

    有关 Clair 的配置格式的更多信息，请参阅 Clair 配置参考。

14. 使用容器镜像启动 Clair，从您创建的文件中挂载在配置中：

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

    注意

    也有可能运行多个 Clair 容器，但对于单一容器以外的部署场景，我们强烈建议使用 Kubernetes 或 OpenShift Container Platform 等容器编配器。

流程

1. 输入以下命令拉取示例镜像：

   $ podman pull ubuntu:20.04

2. 输入以下命令将镜像标记到 registry：

   $ sudo podman tag docker.io/library/ubuntu:20.04 <quay-server.example.com>/<user-name>/ubuntu:20.04

3. 输入以下命令将镜像推送到 Red Hat Quay registry：

   $ sudo podman push --tls-verify=false quay-server.example.com/quayadmin/ubuntu:20.04

4. 通过 UI 登录您的 Red Hat Quay 部署。
5. 单击存储库名称，如 quayadmin/ubuntu。

6. 在导航窗格中，点 Tags。

   报告概述

   

7. 点镜像报告（如 45 个介质 ）以显示更详细的报告：

   报告详情

   

流程

1. 通过 Web UI 登录 Red Hat Quay。
2. 选择要配置外部应用的机构。
3. 在导航窗格中，选择 Applications。
4. 选择 Create New Application 并为新应用程序输入一个名称，例如 openshift。
5. 在 OAuth Applications 页面中，选择您的应用程序，例如 openshift。
6. 在导航窗格中，选择 Generate Token。

7. 选择以下字段：

   • 管理机构
   • 管理软件仓库
   • 创建软件仓库
   • 查看所有可见的软件仓库
   • 对任何可访问的软件仓库的读/写
   • 管理用户
   • 阅读用户信息
8. 查看分配的权限。
9. 选择 Authorize Application，然后选择 Authorize Application 来确认授权。

10. 保存生成的访问令牌。

    重要

    从 Red Hat Quay 3.7 开始，没有令牌管理。您无法列出令牌、删除令牌或修改令牌。生成的访问令牌仅显示一次，在关闭页面后无法重新探测。

流程

1. 打开 Web 控制台的 Administrator 视角，并进入导航窗格中的 Operators → OperatorHub。
2. 搜索 Quay Bridge Operator，点 Quay Bridge Operator 标题，然后点 Install。
3. 选择要安装的版本，如 stable-3.7，然后单击 Install。
4. 安装完成后，点 View Operator 进入 Quay Bridge Operator 的 Details 页面。另外，您可以点击 Installed Operators → Red Hat Quay Bridge Operator 进入 Details 页面。

1. 以配置模式启动 Quay 容器，再选中 Enable Repository Mirroring 复选框。如果要要求 HTTPS 通信并在镜像过程中验证证书，请选择 HTTPS 和证书验证复选框。

   

2. 验证并下载 配置文件，然后使用更新的配置文件在 registry 模式中重新启动 Quay。

流程

1. 在部署的 config.yaml 文件中，添加 FEATURE_LISTEN_IP_VERSION 参数并将其设置为 IPv6，例如：

   ---
   FEATURE_GOOGLE_LOGIN: false
   FEATURE_INVITE_ONLY_USER_CREATION: false
   FEATURE_LISTEN_IP_VERSION: IPv6
   FEATURE_MAILING: false
   FEATURE_NONSUPERUSER_TEAM_SYNCING_SETUP: false
   ---

2. 启动或重启您的 Red Hat Quay 部署。

3. 输入以下命令检查您的部署是否侦听 IPv6：

   $ curl <quay_endpoint>/health/instance
   {"data":{"services":{"auth":true,"database":true,"disk_space":true,"registry_gunicorn":true,"service_key":true,"web_gunicorn":true}},"status_code":200}

流程

1. 在部署的 config.yaml 文件中，添加 FEATURE_LISTEN_IP_VERSION 参数并将其设置为 双栈，例如：

   ---
   FEATURE_GOOGLE_LOGIN: false
   FEATURE_INVITE_ONLY_USER_CREATION: false
   FEATURE_LISTEN_IP_VERSION: dual-stack
   FEATURE_MAILING: false
   FEATURE_NONSUPERUSER_TEAM_SYNCING_SETUP: false
   ---

2. 启动或重启您的 Red Hat Quay 部署。

3. 输入以下命令检查您的部署是否在侦听这两个频道：

   1. 对于 IPv4，输入以下命令：

      $ curl --ipv4 <quay_endpoint>
      {"data":{"services":{"auth":true,"database":true,"disk_space":true,"registry_gunicorn":true,"service_key":true,"web_gunicorn":true}},"status_code":200}

   2. 对于 IPv6，输入以下命令：

      $ curl --ipv6 <quay_endpoint>
      {"data":{"services":{"auth":true,"database":true,"disk_space":true,"registry_gunicorn":true,"service_key":true,"web_gunicorn":true}},"status_code":200}

流程

1. 在部署的 config.yaml 文件中，添加 LDAP_SUPERUSER_FILTER 参数，并添加您要配置为超级用户的组，例如 root ：

   ---
   AUTHENTICATION_TYPE: LDAP
   ---
   LDAP_ADMIN_DN: uid=<name>,ou=Users,o=<organization_id>,dc=<example_domain_component>,dc=com
   LDAP_ADMIN_PASSWD: ABC123
   LDAP_ALLOW_INSECURE_FALLBACK: false
   LDAP_BASE_DN:
       - o=<organization_id>
       - dc=<example_domain_component>
       - dc=com
   LDAP_EMAIL_ATTR: mail
   LDAP_UID_ATTR: uid
   LDAP_URI: ldap://<example_url>.com
   LDAP_USER_FILTER: (memberof=cn=developers,ou=Users,o=<example_organization_unit>,dc=<example_domain_component>,dc=com)
   LDAP_SUPERUSER_FILTER: (<filterField>=<value>)
   LDAP_USER_RDN:
       - ou=<example_organization_unit>
       - o=<organization_id>
       - dc=<example_domain_component>
       - dc=com

2. 启动或重启您的 Red Hat Quay 部署。

流程

1. 创建新机构或选择一个现有组织。最初，没有配置配额，如 Organization Settings 选项卡中可以看到：

   

2. 以超级用户身份登录 registry，再导航到 Super User Admin Panel 上的 Manage Organizations 选项卡。点击您要为其创建存储配额限制的机构的 Options 图标：

   

3. 单击 Configure Quota，再输入初始配额，例如 10 MB。然后点 Apply 和 Close ：

   

4. 检查在超级用户面板的 Manage Organizations 选项卡中是否显示 0 (10 MB )：

   

   所消耗的配额信息也可直接在 Organization 页面中可用：

   初始消耗的配额

   

5. 要将配额增加到 100MB，请导航到超级用户面板上的 Manage Organizations 选项卡。单击 Options 图标，再选择 Configure Quota，将配额设置为 100 MB。点 Apply，然后点 Close ：

   

6. 从命令行将示例镜像推送到机构：

   示例命令

   $ podman pull ubuntu:18.04
   
   $ podman tag docker.io/library/ubuntu:18.04 example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org/testorg/ubuntu:18.04
   
   $ podman push --tls-verify=false example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org/testorg/ubuntu:18.04

7. 在超级用户面板中，会显示每个机构消耗的配额：

   

8. Organization 页面显示镜像使用的配额的总比例：

   第一个镜像使用的总配额

   

9. 拉取、标签和推送第二个镜像，如 nginx ：

   示例命令

   $ podman pull nginx
   
   $ podman tag docker.io/library/nginx example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org/testorg/nginx
   
   $ podman push --tls-verify=false example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org/testorg/nginx

10. Organization 页面显示该机构中每个存储库使用的配额的总比例：

    每个软件仓库使用的总配额

    

11. 创建 拒绝 和警告 限制：

    从超级用户面板中，导航到 Manage Organizations 选项卡。单击机构的 Options 图标，然后选择 Configure Quota。在 Quota Policy 部分，将 Action 类型设置为 Reject，将 Quota Threshold 设置为 80 并点 Add Limit ：

    

12. 要创建 警告 限制，请选择 Warning 作为 Action 类型，将 Quota Threshold 设置为 70，然后点 Add Limit ：

    

13. 点配额弹出窗口中的 Close。这些限制可在 Organization 页面的 Settings 选项卡中查看，但不能编辑：

    

14. 推送超过拒绝限制的镜像：

    由于拒绝限制(80%)已设置为当前存储库大小（～83%），因此会自动拒绝下一个推送。

    镜像拉取示例

    $ podman pull ubuntu:20.04
    
    $ podman tag docker.io/library/ubuntu:20.04 example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org/testorg/ubuntu:20.04
    
    $ podman push --tls-verify=false example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org/testorg/ubuntu:20.04

    超过配额时的输出示例

    Getting image source signatures
    Copying blob d4dfaa212623 [--------------------------------------] 8.0b / 3.5KiB
    Copying blob cba97cc5811c [--------------------------------------] 8.0b / 15.0KiB
    Copying blob 0c78fac124da [--------------------------------------] 8.0b / 71.8MiB
    WARN[0002] failed, retrying in 1s ... (1/3). Error: Error writing blob: Error initiating layer upload to /v2/testorg/ubuntu/blobs/uploads/ in example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org: denied: Quota has been exceeded on namespace
    Getting image source signatures
    Copying blob d4dfaa212623 [--------------------------------------] 8.0b / 3.5KiB
    Copying blob cba97cc5811c [--------------------------------------] 8.0b / 15.0KiB
    Copying blob 0c78fac124da [--------------------------------------] 8.0b / 71.8MiB
    WARN[0005] failed, retrying in 1s ... (2/3). Error: Error writing blob: Error initiating layer upload to /v2/testorg/ubuntu/blobs/uploads/ in example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org: denied: Quota has been exceeded on namespace
    Getting image source signatures
    Copying blob d4dfaa212623 [--------------------------------------] 8.0b / 3.5KiB
    Copying blob cba97cc5811c [--------------------------------------] 8.0b / 15.0KiB
    Copying blob 0c78fac124da [--------------------------------------] 8.0b / 71.8MiB
    WARN[0009] failed, retrying in 1s ... (3/3). Error: Error writing blob: Error initiating layer upload to /v2/testorg/ubuntu/blobs/uploads/ in example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org: denied: Quota has been exceeded on namespace
    Getting image source signatures
    Copying blob d4dfaa212623 [--------------------------------------] 8.0b / 3.5KiB
    Copying blob cba97cc5811c [--------------------------------------] 8.0b / 15.0KiB
    Copying blob 0c78fac124da [--------------------------------------] 8.0b / 71.8MiB
    Error: Error writing blob: Error initiating layer upload to /v2/testorg/ubuntu/blobs/uploads/ in example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org: denied: Quota has been exceeded on namespace

15. 超过限制时，会在 UI 中显示通知：

    配额通知

    

流程

1. 备份独立部署的 Quay config.yaml ：

   $ mkdir /tmp/quay-backup
   $ cp /path/to/Quay/config/directory/config.yaml /tmp/quay-backup

2. 创建独立 Quay 部署所使用的数据库的备份：

   $ pg_dump -h DB_HOST -p 5432 -d QUAY_DATABASE_NAME -U QUAY_DATABASE_USER -W -O > /tmp/quay-backup/quay-database-backup.sql

3. 如果还没有安装 AWS CLI。

4. 创建 ~/.aws/ 目录：

   $ mkdir ~/.aws/

5. 从独立部署的 Quay config.yaml 获取 access_key 和 secret_key ：

   $ grep -i DISTRIBUTED_STORAGE_CONFIG -A10 /tmp/quay-backup/config.yaml

   输出示例：

   DISTRIBUTED_STORAGE_CONFIG:
       minio-1:
           - RadosGWStorage
           - access_key: ##########
             bucket_name: quay
             hostname: 172.24.10.50
             is_secure: false
             port: "9000"
             secret_key: ##########
             storage_path: /datastorage/registry

6. 将 Quay config.yaml 文件中的 access_key 和 secret_key 存储在 ~/.aws 目录中：

   $ touch ~/.aws/credentials

7. 可选：检查您的 access_key 和 secret_key 是否已存储：

   $ cat > ~/.aws/credentials << EOF
   [default]
   aws_access_key_id = ACCESS_KEY_FROM_QUAY_CONFIG
   aws_secret_access_key = SECRET_KEY_FROM_QUAY_CONFIG
   EOF

   输出示例：

   aws_access_key_id = ACCESS_KEY_FROM_QUAY_CONFIG
   aws_secret_access_key = SECRET_KEY_FROM_QUAY_CONFIG

   注意

   如果 aws cli 没有从 '~/.aws/credentials 文件中 自动收集 access_key 和 secret_key，您可以通过运行 aws 配置并手动输入凭证来配置 它们。

8. 在 quay-backup 目录中，创建一个 bucket_backup 目录：

   $ mkdir /tmp/quay-backup/bucket-backup

9. 从 S3 存储备份所有 Blob：

   $ aws s3 sync --no-verify-ssl --endpoint-url https://PUBLIC_S3_ENDPOINT:PORT s3://QUAY_BUCKET/ /tmp/quay-backup/bucket-backup/

   注意

   PUBLIC_S3_ENDPOINT 可以从 DISTRIBUTED_STORAGE_CONFIG 中的 hostname 下的 Quay config.yaml 文件中读取。如果端点不安全，请在端点 URL 中使用 http 而不是 https。

1. 缩减 Red Hat Quay Operator：

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

2. 缩减应用程序和镜像部署：

   $ oc scale --replicas=0 deployment QUAY_MAIN_APP_DEPLOYMENT QUAY_MIRROR_DEPLOYMENT

3. 将数据库 SQL 备份复制到 Quay PostgreSQL 数据库实例：

   $ oc cp /tmp/user/quay-backup/quay-database-backup.sql quay-enterprise/quayregistry-quay-database-54956cdd54-p7b2w:/var/lib/pgsql/data/userdata

4. 从 Operator 创建的 config.yaml 文件获取数据库密码：

   $ oc get deployment quay-quay-app -o json | jq '.spec.template.spec.volumes[].projected.sources' | grep -i config-secret

   输出示例：

         "name": "QUAY_CONFIG_SECRET_NAME"

   $ oc get secret quay-quay-config-secret-9t77hb84tb -o json | jq '.data."config.yaml"' | cut -d '"' -f2 | base64 -d -w0 > /tmp/quay-backup/operator-quay-config-yaml-backup.yaml

   cat /tmp/quay-backup/operator-quay-config-yaml-backup.yaml | grep -i DB_URI

   输出示例：

   postgresql://QUAY_DATABASE_OWNER:PASSWORD@DATABASE_HOST/QUAY_DATABASE_NAME

5. 在数据库 pod 中执行 shell：

   # oc exec -it quay-postgresql-database-pod -- /bin/bash

6. 输入 psql ：

   bash-4.4$ psql

7. 丢弃数据库：

   postgres=# DROP DATABASE "example-restore-registry-quay-database";

   输出示例：

   DROP DATABASE

8. 创建新数据库并设置与相同名称的所有者：

   postgres=# CREATE DATABASE "example-restore-registry-quay-database" OWNER "example-restore-registry-quay-database";

   输出示例：

   CREATE DATABASE

9. 连接到数据库：

   postgres=# \c "example-restore-registry-quay-database";

   输出示例：

   You are now connected to database "example-restore-registry-quay-database" as user "postgres".

10. 为 Quay 数据库创建 pg_trmg 扩展：

    example-restore-registry-quay-database=# create extension pg_trgm ;

    输出示例：

    CREATE EXTENSION

11. 退出 postgres CLI 以重新输入 bash-4.4:

    \q

12. 为您的 PostgreSQL 部署设置密码：

    bash-4.4$ psql -h localhost -d "QUAY_DATABASE_NAME" -U QUAY_DATABASE_OWNER -W < /var/lib/pgsql/data/userdata/quay-database-backup.sql

    输出示例：

    SET
    SET
    SET
    SET
    SET

13. 退出 bash 模式：

    bash-4.4$ exit

14. 为 Red Hat Quay Operator 创建新的配置捆绑包。

    $ touch config-bundle.yaml

15. 在您的新 config-bundle.yaml 中，包括 registry 所需的所有信息，如 LDAP 配置、密钥和其他旧 registry 有的修改。运行以下命令，将 secret_key 移到 config-bundle.yaml 中：

    $ cat /tmp/quay-backup/config.yaml | grep SECRET_KEY > /tmp/quay-backup/config-bundle.yaml

    注意

    您必须手动复制所有 LDAP、OIDC 和其他信息，并将其添加到 /tmp/quay-backup/config-bundle.yaml 文件中。

16. 在 OpenShift 集群中创建配置捆绑包 secret：

    $ oc create secret generic new-custom-config-bundle --from-file=config.yaml=/tmp/quay-backup/config-bundle.yaml

17. 扩展 Quay pod:

    $ oc scale --replicas=1 deployment quayregistry-quay-app
    deployment.apps/quayregistry-quay-app scaled

18. 扩展镜像 pod：

    $ oc scale --replicas=1  deployment quayregistry-quay-mirror
    deployment.apps/quayregistry-quay-mirror scaled

19. 对 QuayRegistry CRD 进行补丁，使其包含对新自定义配置捆绑包的引用：

    $ oc patch quayregistry QUAY_REGISTRY_NAME --type=merge -p '{"spec":{"configBundleSecret":"new-custom-config-bundle"}}'

    注意

    如果 Quay 返回一个 500 个内部服务器错误，您可能需要将 DISTRIBUTED_STORAGE_CONFIG 的位置 更新为 默认值。

20. 在 /.aws/ 目录中创建一个新的 AWS credentials.yaml，并从 Operator 创建的 config.yaml 文件包含 access_key 和 secret_key ：

    $ touch credentials.yaml

    $ grep -i DISTRIBUTED_STORAGE_CONFIG -A10 /tmp/quay-backup/operator-quay-config-yaml-backup.yaml

    $ cat > ~/.aws/credentials << EOF
    [default]
    aws_access_key_id = ACCESS_KEY_FROM_QUAY_CONFIG
    aws_secret_access_key = SECRET_KEY_FROM_QUAY_CONFIG
    EOF

    注意

    如果 aws cli 没有从 '~/.aws/credentials 文件中 自动收集 access_key 和 secret_key，您可以通过运行 aws 配置并手动输入凭证来配置 它们。

21. 记录 NooBaa 的公共可用端点：

    $ oc get route s3 -n openshift-storage -o yaml -o jsonpath="{.spec.host}{'\n'}"

22. 将备份数据同步到 NooBaa 后端存储：

    $ aws s3 sync --no-verify-ssl --endpoint-url https://NOOBAA_PUBLIC_S3_ROUTE /tmp/quay-backup/bucket-backup/* s3://QUAY_DATASTORE_BUCKET_NAME

23. 将 Operator 扩展至 1 个 pod：

    $ oc scale –replicas=1 deployment quay-operator.v3.6.4 -n openshift-operators

流程

1. 创建临时备份目录，如 quay-backup ：

   $ mkdir /tmp/quay-backup

2. 以下示例命令表示 Red Hat Quay 启动的本地目录，例如 /opt/quay-install ：

   $ podman run --name quay-app \
      -v /opt/quay-install/config:/conf/stack:Z \
      -v /opt/quay-install/storage:/datastorage:Z \
      registry.redhat.io/quay/quay-rhel8:v3.8.5

   运行以下命令，切换到容器中的 bind-mounts 到 /conf/stack 的目录，如 /opt/quay-install ：

   $ cd /opt/quay-install

3. 输入以下命令将 Red Hat Quay 部署的内容压缩到 quay-backup 目录中的存档中：

   $ tar cvf /tmp/quay-backup/quay-backup.tar.gz *

   输出示例：

   config.yaml
   config.yaml.bak
   extra_ca_certs/
   extra_ca_certs/ca.crt
   ssl.cert
   ssl.key

4. 输入以下命令备份 Quay 容器服务：

   $ podman inspect quay-app | jq -r '.[0].Config.CreateCommand | .[]' | paste -s -d ' ' -
   
     /usr/bin/podman run --name quay-app \
     -v /opt/quay-install/config:/conf/stack:Z \
     -v /opt/quay-install/storage:/datastorage:Z \
     registry.redhat.io/quay/quay-rhel8:v3.8.5

5. 输入以下命令将 conf/stack/config.yaml 文件的内容重定向到临时 quay-config.yaml 文件：

   $ podman exec -it quay cat /conf/stack/config.yaml > /tmp/quay-backup/quay-config.yaml

6. 输入以下命令获取位于临时 quay-config.yaml 中的 DB_URI ：

   $ grep DB_URI /tmp/quay-backup/quay-config.yaml

   输出示例：

   $ postgresql://<username>:test123@172.24.10.50/quay

7. 输入以下命令将 PostgreSQL 内容提取到备份 .sql 文件中的临时备份目录中：

   $ pg_dump -h 172.24.10.50  -p 5432 -d quay  -U  <username>   -W -O > /tmp/quay-backup/quay-backup.sql

8. 输入以下命令输出 DISTRIBUTED_STORAGE_CONFIG 的内容：

   DISTRIBUTED_STORAGE_CONFIG:
      default:
       - S3Storage
       - s3_bucket: <bucket_name>
         storage_path: /registry
         s3_access_key: <s3_access_key>
         s3_secret_key: <s3_secret_key>
         host: <host_name>

9. 使用在第 7 步中获取的 access_key 凭证导出 AWS_ACCESS_KEY_ID ：

   $ export AWS_ACCESS_KEY_ID=<access_key>

10. 使用在第 7 步中获取的 secret_key 导出 AWS_SECRET_ACCESS_KEY ：

    $ export AWS_SECRET_ACCESS_KEY=<secret_key>

11. 将 quay 存储桶从 DISTRIBUTED_STORAGE_CONFIG 的主机名 同步到 /tmp/quay-backup/blob-backup/ 目录：

    $ aws s3 sync s3://<bucket_name>  /tmp/quay-backup/blob-backup/ --source-region us-east-2

    输出示例：

    download: s3://<user_name>/registry/sha256/9c/9c3181779a868e09698b567a3c42f3744584ddb1398efe2c4ba569a99b823f7a to registry/sha256/9c/9c3181779a868e09698b567a3c42f3744584ddb1398efe2c4ba569a99b823f7a
    download: s3://<user_name>/registry/sha256/e9/e9c5463f15f0fd62df3898b36ace8d15386a6813ffb470f332698ecb34af5b0d to registry/sha256/e9/e9c5463f15f0fd62df3898b36ace8d15386a6813ffb470f332698ecb34af5b0d

流程

1. 在 Red Hat Quay 容器中创建一个将 bind-mount 到 /conf/stack 的新目录：

   $ mkdir /opt/new-quay-install

2. 将 在独立部署中备份 Red Hat Quay 中创建的临时备份目录的内容复制到在第 1 步中创建的 new-quay-install1 目录中：

   $ cp /tmp/quay-backup/quay-backup.tar.gz /opt/new-quay-install/

3. 输入以下命令进入 new-quay-install 目录：

   $ cd /opt/new-quay-install/

4. 提取 Red Hat Quay 目录的内容：

   $ tar xvf /tmp/quay-backup/quay-backup.tar.gz *

   输出示例：

   config.yaml
   config.yaml.bak
   extra_ca_certs/
   extra_ca_certs/ca.crt
   ssl.cert
   ssl.key

5. 输入以下命令从备份 config.yaml 文件中重新调用 DB_URI ：

   $ grep DB_URI config.yaml

   输出示例：

   postgresql://<username>:test123@172.24.10.50/quay

6. 运行以下命令来进入 PostgreSQL 数据库服务器：

   $ sudo postgres

7. 输入以下命令，输入 psql 并在 IANA10.50 中创建一个新数据库，以恢复 quay 数据库，如 example_restore_registry_quay_database ：

   $ psql "host=172.24.10.50  port=5432 dbname=postgres user=<username>  password=test123"
   postgres=> CREATE DATABASE example_restore_registry_quay_database;

   输出示例：

   CREATE DATABASE

8. 运行以下命令连接到数据库：

   postgres=# \c "example-restore-registry-quay-database";

   输出示例：

   You are now connected to database "example-restore-registry-quay-database" as user "postgres".

9. 运行以下命令，为 Quay 数据库创建 pg_trmg 扩展：

   example_restore_registry_quay_database=> CREATE EXTENSION IF NOT EXISTS pg_trgm;

   输出示例：

   CREATE EXTENSION

10. 输入以下命令退出 postgres CLI：

    \q

11. 运行以下命令，将数据库备份导入到您的新数据库：

    $ psql "host=172.24.10.50 port=5432 dbname=example_restore_registry_quay_database user=<username> password=test123"  -W <  /tmp/quay-backup/quay-backup.sql

    输出示例：

    SET
    SET
    SET
    SET
    SET

    在重启 Red Hat Quay 部署前，将 config.yaml 中的 DB_URI 从 postgresql://<username>:test123@172.24.10.50/quay 更新至 postgresql://<username>:test123@172.24.10.50/example-restore-registry-quay-database。

    注意

    DB_URI 格式为 DB_ URI postgresql://<login_user_name>:<login_user_password>@<postgresql_host>/<quay_database>。如果您要从一个 PostgreSQL 服务器移动到另一个 PostgreSQL 服务器，请同时更新 < login_user_name>、< login_user_password> 和 <postgresql_host > 的值。

12. 在 /opt/new-quay-install 目录中，打印 DISTRIBUTED_STORAGE_CONFIG 捆绑包的内容：

    $ cat config.yaml | grep DISTRIBUTED_STORAGE_CONFIG -A10

    输出示例：

    DISTRIBUTED_STORAGE_CONFIG:
       default:
    DISTRIBUTED_STORAGE_CONFIG:
       default:
        - S3Storage
        - s3_bucket: <bucket_name>
          storage_path: /registry
          s3_access_key: <s3_access_key>
          s3_secret_key: <s3_secret_key>
          host: <host_name>

    注意

    在重启 Red Hat Quay 部署前，必须更新 /opt/new-quay-install 中的 DISTRIBUTED_STORAGE_CONFIG。

13. 使用第 13 步中获取的 access_key 凭证导出 AWS_ACCESS_KEY_ID ：

    $ export AWS_ACCESS_KEY_ID=<access_key>

14. 使用在第 13 步中获取的 secret_key 导出 AWS_SECRET_ACCESS_KEY ：

    $ export AWS_SECRET_ACCESS_KEY=<secret_key>

15. 输入以下命令创建新的 s3 存储桶：

    $ aws s3 mb s3://<new_bucket_name>  --region us-east-2

    输出示例：

    $ make_bucket: quay

16. 输入以下命令将所有 Blob 上传到新的 s3 存储桶：

    $ aws s3 sync --no-verify-ssl \
    --endpoint-url <example_endpoint_url> 1
    /tmp/quay-backup/blob-backup/. s3://quay/

    1

    Red Hat Quay registry 端点必须在备份和恢复前相同。

    输出示例：

    upload: ../../tmp/quay-backup/blob-backup/datastorage/registry/sha256/50/505edb46ea5d32b5cbe275eb766d960842a52ee77ac225e4dc8abb12f409a30d to s3://quay/datastorage/registry/sha256/50/505edb46ea5d32b5cbe275eb766d960842a52ee77ac225e4dc8abb12f409a30d
    upload: ../../tmp/quay-backup/blob-backup/datastorage/registry/sha256/27/27930dc06c2ee27ac6f543ba0e93640dd21eea458eac47355e8e5989dea087d0 to s3://quay/datastorage/registry/sha256/27/27930dc06c2ee27ac6f543ba0e93640dd21eea458eac47355e8e5989dea087d0
    upload: ../../tmp/quay-backup/blob-backup/datastorage/registry/sha256/8c/8c7daf5e20eee45ffe4b36761c4bb6729fb3ee60d4f588f712989939323110ec to s3://quay/datastorage/registry/sha256/8c/8c7daf5e20eee45ffe4b36761c4bb6729fb3ee60d4f588f712989939323110ec
    ...

17. 在重启 Red Hat Quay 部署前，更新 config.yaml 中的存储设置：

    DISTRIBUTED_STORAGE_CONFIG:
       default:
    DISTRIBUTED_STORAGE_CONFIG:
       default:
        - S3Storage
        - s3_bucket: <new_bucket_name>
          storage_path: /registry
          s3_access_key: <s3_access_key>
          s3_secret_key: <s3_secret_key>
          host: <host_name>

流程

1. 输入以下命令来确保垃圾回收正常工作：

   $ sudo podman logs <container_id>

   输出示例：

1. 删除镜像标签。

2. 输入以下命令以确保标签已被删除：

   $ podman logs quay-app

   输出示例：