概念验证 - 部署 Red Hat Quay

流程

1. 安装最新的 RHEL 9 服务器。如果想桌面，您可以执行最小 shell 访问安装，或者 Server 加上 GUI。
2. 注册并订阅您的 RHEL 服务器系统，如 如何使用 Red Hat Subscription-Manager 在红帽客户门户网站中注册和订阅 RHEL 系统

3. 输入以下命令注册您的系统并列出可用的订阅。选择可用的 RHEL 服务器订阅，附加到池 ID，并升级到最新版本：

   # subscription-manager register --username=<user_name> --password=<password>
   # subscription-manager refresh
   # subscription-manager list --available
   # subscription-manager attach --pool=<pool_id>
   # yum update -y

   Copy to Clipboard Toggle word wrap

流程

1. 按照 Red Hat Container Registry Authentication 过程将身份验证设置为 registry.redhat.io。通过设置身份验证，您可以拉取 Quay 容器。

   注意

   这与早期版本的 Red Hat Quay 不同，当镜像托管在 Quay.io 上时。

2. 输入以下命令登录到 registry：

   $ sudo podman login registry.redhat.io

   Copy to Clipboard Toggle word wrap

   您会被会提示输入您的用户名和密码。

流程

1. 输入以下命令为主机系统获取您的静态 IP 地址：

   $ ip a

   Copy to Clipboard Toggle word wrap

   输出示例

   ---
       link/ether 6c:6a:77:eb:09:f1 brd ff:ff:ff:ff:ff:ff
       inet 192.168.1.132/24 brd 192.168.1.255 scope global dynamic noprefixroute wlp82s0
   ---

   Copy to Clipboard Toggle word wrap

2. 将 IP 地址和本地主机名（例如 quay-server.example.com ）添加到 /etc/hosts 文件中，该文件将用于访问 Red Hat Quay 端点。您可以输入以下命令确认 IP 地址和主机名已添加到 /etc/hosts 文件中：

   $ cat /etc/hosts

   Copy to Clipboard Toggle word wrap

   输出示例

   192.168.1.138 quay-server.example.com

   Copy to Clipboard Toggle word wrap

流程

1. 在安装文件夹中，由 $QUAY 变量表示，请输入以下命令为数据库数据创建一个目录：

   $ mkdir -p $QUAY/postgres-quay

   Copy to Clipboard Toggle word wrap

2. 输入以下命令设置适当的权限：

   $ setfacl -m u:26:-wx $QUAY/postgres-quay

   Copy to Clipboard Toggle word wrap

3. 启动 Postgres 容器，使用数据库数据的卷定义指定用户名、密码和数据库名称和端口：

   $ sudo podman run -d --rm --name postgresql-quay \
     -e POSTGRESQL_USER=quayuser \
     -e POSTGRESQL_PASSWORD=quaypass \
     -e POSTGRESQL_DATABASE=quay \
     -e POSTGRESQL_ADMIN_PASSWORD=adminpass \
     -p 5432:5432 \
     -v $QUAY/postgres-quay:/var/lib/pgsql/data:Z \
     registry.redhat.io/rhel8/postgresql-13

   Copy to Clipboard Toggle word wrap

4. 运行以下命令，确保安装了 Postgres pg_trgm 模块：

   $ sudo podman exec -it postgresql-quay /bin/bash -c 'echo "CREATE EXTENSION IF NOT EXISTS pg_trgm" | psql -d quay -U postgres'

   Copy to Clipboard Toggle word wrap
   注意

   Quay 容器需要 pg_trgm 模块。

流程

1. 输入以下命令创建一个用于部署 Red Hat Quay 容器的最小 config.yaml 文件：

   $ touch config.yaml

   Copy to Clipboard Toggle word wrap

2. 将以下 YAML 配置复制并粘贴到 config.yaml 文件中：

   BUILDLOGS_REDIS:
       host: quay-server.example.com
       password: strongpassword
       port: 6379
   CREATE_NAMESPACE_ON_PUSH: true
   DATABASE_SECRET_KEY: a8c2744b-7004-4af2-bcee-e417e7bdd235
   DB_URI: postgresql://quayuser:quaypass@quay-server.example.com:5432/quay
   DISTRIBUTED_STORAGE_CONFIG:
       default:
           - LocalStorage
           - storage_path: /datastorage/registry
   DISTRIBUTED_STORAGE_DEFAULT_LOCATIONS: []
   DISTRIBUTED_STORAGE_PREFERENCE:
       - default
   FEATURE_MAILING: false
   SECRET_KEY: e9bd34f4-900c-436a-979e-7530e5d74ac8
   SERVER_HOSTNAME: quay-server.example.com
   SETUP_COMPLETE: true
   USER_EVENTS_REDIS:
       host: quay-server.example.com
       password: strongpassword
       port: 6379

   Copy to Clipboard Toggle word wrap

3. 创建一个目录来复制 Red Hat Quay 配置捆绑包：

   $ mkdir $QUAY/config

   Copy to Clipboard Toggle word wrap

4. 将 Red Hat Quay 配置文件复制到目录中：

   $ cp -v config.yaml $QUAY/config

   Copy to Clipboard Toggle word wrap

流程

1. 输入以下命令创建一个将存储 registry 镜像的本地目录：

   $ mkdir $QUAY/storage

   Copy to Clipboard Toggle word wrap

2. 设置目录以存储 registry 镜像：

   $ setfacl -m u:1001:-wx $QUAY/storage

   Copy to Clipboard Toggle word wrap

流程

1. 要从 Red Hat Quay registry 中测试推送和拉取镜像，首先从外部 registry 拉取示例镜像：

   $ sudo podman pull busybox

   Copy to Clipboard Toggle word wrap

   输出示例

   Trying to pull docker.io/library/busybox...
   Getting image source signatures
   Copying blob 4c892f00285e done
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures
   22667f53682a2920948d19c7133ab1c9c3f745805c14125859d20cede07f11f9

   Copy to Clipboard Toggle word wrap

2. 输入以下命令查看镜像的本地副本：

   $ sudo podman images

   Copy to Clipboard Toggle word wrap

   输出示例

   REPOSITORY                          TAG      IMAGE ID       CREATED         SIZE
   docker.io/library/busybox           latest   22667f53682a   14 hours ago    1.45 MB

   Copy to Clipboard Toggle word wrap

3. 输入以下命令标记此镜像，这会准备镜像以将其推送到 registry：

   $ sudo podman tag docker.io/library/busybox quay-server.example.com/quayadmin/busybox:test

   Copy to Clipboard Toggle word wrap

4. 将镜像推送到 registry。在这一步后，您可以使用浏览器在存储库中查看标记的镜像。

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

   Copy to Clipboard Toggle word wrap

   输出示例

   Getting image source signatures
   Copying blob 6b245f040973 done
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures

   Copy to Clipboard Toggle word wrap

5. 要从命令行测试对镜像的访问，首先删除镜像的本地副本：

   $ sudo podman rmi quay-server.example.com/quayadmin/busybox:test

   Copy to Clipboard Toggle word wrap

   输出示例

   Untagged: quay-server.example.com/quayadmin/busybox:test

   Copy to Clipboard Toggle word wrap

6. 再次拉取镜像，这次从 Red Hat Quay registry 中拉取镜像：

   $ sudo podman pull --tls-verify=false quay-server.example.com/quayadmin/busybox:test

   Copy to Clipboard Toggle word wrap

   输出示例

   Trying to pull quay-server.example.com/quayadmin/busybox:test...
   Getting image source signatures
   Copying blob 6ef22a7134ba [--------------------------------------] 0.0b / 0.0b
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures
   22667f53682a2920948d19c7133ab1c9c3f745805c14125859d20cede07f11f9

   Copy to Clipboard Toggle word wrap

流程

1. 单击 UI 导航窗格中的当前用户名或 avatar，以访问 Red Hat Quay UI 上的 Superuser Admin 面板。然后，单击 Superuser Admin Panel。

   

   在本页中，您可以管理用户、您的机构、服务密钥、查看更改日志、查看使用情况日志，并为您的机构创建全局消息。

流程

1. 将 root CA 文件复制到 /etc/containers/certs.d/ 或 /etc/docker/certs.d/ 之一。使用服务器主机名决定的确切路径，并将文件命名为 ca.crt ：

   $ sudo cp rootCA.pem /etc/containers/certs.d/quay-server.example.com/ca.crt

   Copy to Clipboard Toggle word wrap

2. 在登录到 Red Hat Quay registry 时，验证您不再需要使用 the -tls-verify=false 选项：

   $ sudo podman login quay-server.example.com

   Copy to Clipboard Toggle word wrap

   输出示例

   Login Succeeded!

   Copy to Clipboard Toggle word wrap

流程

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

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

   Copy to Clipboard Toggle word wrap

2. 输入以下命令更新系统范围的信任存储配置：

   $ sudo update-ca-trust extract

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   

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

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

   Copy to Clipboard Toggle word wrap

   $ sudo update-ca-trust extract

   Copy to Clipboard Toggle word wrap

   $ trust list | grep quay

   Copy to Clipboard Toggle word wrap

流程

1. 在 Red Hat Quay config.yaml 文件中，将 FEATURE_LISTEN_IP_VERSION 字段设置为 IPv6。例如：

   # ...
   FEATURE_LISTEN_IP_VERSION: dual-stack
   # ...

   Copy to Clipboard Toggle word wrap

2. 输入以下命令启动 Quay registry 容器，为配置数据指定适当的卷，并为镜像数据指定本地存储。请注意，如果您使用双栈，则必须在启动容器时指定显式 IPv6 端口映射。

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

   Copy to Clipboard Toggle word wrap