流程

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

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

2. 输入以下命令进入 $QUAY/config 目录：

   $ cd $QUAY/config

3. 编辑 config.yaml 文件，并指定您希望 Red Hat Quay 处理 TLS/SSL：

   config.yaml

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

4. 可选：输入以下命令将 rootCA.pem 文件的内容应用到 ssl.cert 文件的末尾：

   $ cat rootCA.pem >> ssl.cert

5. 输入以下命令停止 Quay 容器：

   $ sudo podman stop quay

6. 输入以下命令重启 registry：

   $ 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.15

流程

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

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

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

4. 输入以下命令停止 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.15

流程

1. 输入以下命令将 rootCA.pem 文件复制到整合的系统范围信任存储中：

   $ 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. 要从系统范围的信任中删除 rootCA.pem 文件，请删除该文件并更新配置：

   $ 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.15 "/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 \
     {postgresimage}

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 \
     {productrepo}/{quayimage}:{productminv} 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.15

    注意

    也有可能运行多个 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 不提供令牌管理。您无法列出令牌、删除令牌或修改令牌。生成的访问令牌仅显示一次，在关闭页面后无法重新获取。

流程

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 mirror 复选框。如果您要在镜像过程中需要 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. 以超级用户身份登录注册表，再导航到 Super User Admin Panel 上的 Manage Organizations 选项卡。点您要为其创建存储配额限制的机构 Options 图标：

   

3. 单击 Configure Quota 并输入初始配额，如 10 MB。然后点击" 应用 "和 "关闭" ：

   

4. 检查所消耗的配额是否在超级用户面板的 Manage Organizations 选项卡中显示 0 为 10 MB ：

   

   消耗的配额信息也可以在 Organization 页面中直接提供：

   初始消耗配额

   

5. 若要将配额增加到 100MB，请导航到 superuser 面板上的 Manage Organizations 选项卡。单击 Options 图标并选择 Configure Quota，将配额设置为 100 MB。点击" 应用 "，然后选择 "关闭" ：

   

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. 创建 reject 和 warning 限制：

    从 superuser 面板中，前往 Manage Organizations 选项卡。单击组织的 Options 图标，然后选择 Configure Quota。在 Quota Policy 部分中，Action type 设置为 Reject，将 Quota Threshold 设为 80，再单击 Add Limit:

    

12. 要创建 警告 限制，请选择 Warning 作为 Action 类型，将 Quota Threshold 设置为 70，再单击 Add Limit:

    

13. 在弹出配额上点 Close。限制可在 机构 页面的 Settings 标签页中查看，但不能编辑：

    

14. 推送超过 reject 限值的镜像：

    因为 reject 限制(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. 将 access_key 和 secret_key 从 Quay config.yaml 文件存储在 ~/.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 目录中，创建一个存储桶_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 可从 DISTRIBUTE D_STORAGE_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. Enter 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.15

   运行以下命令，更改到容器内 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.15

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 内容提取到 backup .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 的 hostname 的 /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 容器内创建一个将绑定挂载到 /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 并在 172.24.10.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>

   输出示例：

   gcworker stdout | 2022-11-14 18:46:52,458 [63] [INFO] [apscheduler.executors.default] Job "GarbageCollectionWorker._garbage_collection_repos (trigger: interval[0:00:30], next run at: 2022-11-14 18:47:22 UTC)" executed successfully

2. 删除镜像标签。

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

   $ podman logs quay-app

   输出示例：

   gunicorn-web stdout | 2022-11-14 19:23:44,574 [233] [INFO] [gunicorn.access] 192.168.0.38 - - [14/Nov/2022:19:23:44 +0000] "DELETE /api/v1/repository/quayadmin/busybox/tag/test HTTP/1.0" 204 0 "http://quay-server.example.com/repository/quayadmin/busybox?tab=tags" "Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Firefox/102.0"

流程

1. 在 Web 浏览器中，导航到 https://{quay-ip-endpoint}/health/instance。

2. 您使用健康实例页面，它会返回类似如下的信息：

   {"data":{"services":{"auth":true,"database":true,"disk_space":true,"registry_gunicorn":true,"service_key":true,"web_gunicorn":true}},"status_code":200}

   对于 Red Hat Quay，"status_code": 200 表示实例是健康的。相反，如果您收到 "status_code": 503，则部署有问题。