第 6 章使用 Operator 部署 Red Hat Quay

Red Hat Quay on OpenShift Container Platform 可以使用命令行界面或 OpenShift Container Platform 控制台进行部署。这些步骤基本是相同的。

6.1. 从命令行部署 Red Hat Quay
复制链接

使用以下步骤使用命令行界面(CLI)从部署 Red Hat Quay。

先决条件

已使用 CLI 登录 OpenShift Container Platform。

步骤

输入以下命令创建一个命名空间，如 quay-enterprise ：
```
$ oc new-project quay-enterprise
```

可选。如果要预配置 Red Hat Quay 部署的任何方面，请为配置捆绑包创建一个 Secret ：

$ oc create secret generic quay-enterprise-config-bundle --from-file=config-bundle.tar.gz=/path/to/config-bundle.tar.gz

在名为 quayregistry.yaml的文件中创建 QuayRegistry 自定义资源

对于最小部署，使用所有默认值：

quayregistry.yaml:

apiVersion: quay.redhat.com/v1
kind: QuayRegistry
metadata:
  name: example-registry
  namespace: quay-enterprise

可选。如果要有一些未管理的组件，请在 spec 字段中添加此信息。最小部署可能类似以下示例：

带有非受管组件的 quayregistry.yaml 示例

apiVersion: quay.redhat.com/v1
kind: QuayRegistry
metadata:
  name: example-registry
  namespace: quay-enterprise
spec:
  components:
    - kind: clair
      managed: false
    - kind: horizontalpodautoscaler
      managed: false
    - kind: mirror
      managed: false
    - kind: monitoring
      managed: false

可选。如果您已创建了配置捆绑包，如 init-config-bundle-secret，请在 quayregistry.yaml 文件中引用它：

带有配置捆绑包的 quayregistry.yaml 示例

apiVersion: quay.redhat.com/v1
kind: QuayRegistry
metadata:
  name: example-registry
  namespace: quay-enterprise
spec:
  configBundleSecret: init-config-bundle-secret

可选。如果您配置了代理，您可以使用 Red Hat Quay、Clair 和 mirror 覆盖添加信息：

配置了代理的 quayregistry.yaml 示例

  kind: QuayRegistry
  metadata:
    name: quay37
  spec:
    configBundleSecret: config-bundle-secret
    components:
      - kind: objectstorage
        managed: false
      - kind: route
        managed: true
      - kind: mirror
        managed: true
        overrides:
          env:
            - name: DEBUGLOG
              value: "true"
            - name: HTTP_PROXY
              value: quayproxy.qe.devcluster.openshift.com:3128
            - name: HTTPS_PROXY
              value: quayproxy.qe.devcluster.openshift.com:3128
            - name: NO_PROXY
              value: svc.cluster.local,localhost,quay370.apps.quayperf370.perfscale.devcluster.openshift.com
      - kind: tls
        managed: false
      - kind: clair
        managed: true
        overrides:
          env:
            - name: HTTP_PROXY
              value: quayproxy.qe.devcluster.openshift.com:3128
            - name: HTTPS_PROXY
              value: quayproxy.qe.devcluster.openshift.com:3128
            - name: NO_PROXY
              value: svc.cluster.local,localhost,quay370.apps.quayperf370.perfscale.devcluster.openshift.com
      - kind: quay
        managed: true
        overrides:
          env:
            - name: DEBUGLOG
              value: "true"
            - name: NO_PROXY
              value: svc.cluster.local,localhost,quay370.apps.quayperf370.perfscale.devcluster.openshift.com
            - name: HTTP_PROXY
              value: quayproxy.qe.devcluster.openshift.com:3128
            - name: HTTPS_PROXY
              value: quayproxy.qe.devcluster.openshift.com:3128

输入以下命令在指定命名空间中创建 QuayRegistry ：
```
$ oc create -n quay-enterprise -f quayregistry.yaml
```

输入以下命令来查看何时填充 status.registryEndpoint ：

$ oc get quayregistry -n quay-enterprise example-registry -o jsonpath="{.status.registryEndpoint}" -w

其他资源

有关如何跟踪 Red Hat Quay 部署的进度的更多信息，请参阅监控和调试部署过程。

6.1.1. 使用 API 创建第一个用户
复制链接

使用以下步骤在 Red Hat Quay 组织中创建第一个用户。

先决条件

配置选项 FEATURE_USER_INITIALIZE 必须设为 True。
数据库中不能已存在任何用户。

步骤

此流程通过指定 "access_token": true 来请求 OAuth 令牌。

打开 Red Hat Quay 配置文件并更新以下配置字段：

FEATURE_USER_INITIALIZE: true
SUPER_USERS:
     -  quayadmin

输入以下命令停止 Red Hat Quay 服务：
```
$ sudo podman stop quay
```

输入以下命令启动 Red Hat Quay 服务：

$ sudo podman run -d -p 80:8080 -p 443:8443 --name=quay -v $QUAY/config:/conf/stack:Z  -v $QUAY/storage:/datastorage:Z {productrepo}/{quayimage}:{productminv}

运行以下 CURL 命令以使用用户名、密码、电子邮件和访问令牌生成新用户：

$ curl -X POST -k  http://quay-server.example.com/api/v1/user/initialize --header 'Content-Type: application/json' --data '{ "username": "quayadmin", "password":"quaypass12345", "email": "quayadmin@example.com", "access_token": true}'

如果成功，命令会返回带有用户名、电子邮件和加密密码的对象。例如：

{"access_token":"6B4QTRSTSD1HMIG915VPX7BMEZBVB9GPNY2FC2ED", "email":"quayadmin@example.com","encrypted_password":"1nZMLH57RIE5UGdL/yYpDOHLqiNCgimb6W9kfF8MjZ1xrfDpRyRs9NUnUuNuAitW","username":"quayadmin"} # gitleaks:allow

如果用户已在数据库中，则返回错误：

{"message":"Cannot initialize user in a non-empty database"}

如果您的密码至少不是八个字符或包含空格，则返回错误：

{"message":"Failed to initialize user: Invalid password, password must be at least 8 characters and contain no whitespace."}

输入以下命令登录到您的 Red Hat Quay 部署：

$ sudo podman login -u quayadmin -p quaypass12345 http://quay-server.example.com --tls-verify=false

输出示例

Login Succeeded!

6.1.2. 使用命令行查看创建的组件
复制链接

使用以下步骤查看部署的 Red Hat Quay 组件。

先决条件

您已在 OpenShift Container Platform 上部署了 Red Hat Quay。

步骤

输入以下命令查看部署的组件：

$ oc get pods -n quay-enterprise

输出示例

NAME                                                   READY   STATUS      RESTARTS   AGE
example-registry-clair-app-5ffc9f77d6-jwr9s            1/1     Running     0          3m42s
example-registry-clair-app-5ffc9f77d6-wgp7d            1/1     Running     0          3m41s
example-registry-clair-postgres-54956d6d9c-rgs8l       1/1     Running     0          3m5s
example-registry-quay-app-79c6b86c7b-8qnr2             1/1     Running     4          3m42s
example-registry-quay-app-79c6b86c7b-xk85f             1/1     Running     4          3m41s
example-registry-quay-app-upgrade-5kl5r                0/1     Completed   4          3m50s
example-registry-quay-database-b466fc4d7-tfrnx         1/1     Running     2          3m42s
example-registry-quay-mirror-6d9bd78756-6lj6p          1/1     Running     0          2m58s
example-registry-quay-mirror-6d9bd78756-bv6gq          1/1     Running     0          2m58s
example-registry-quay-postgres-init-dzbmx              0/1     Completed   0          3m43s
example-registry-quay-redis-8bd67b647-skgqx            1/1     Running     0          3m42s

6.1.3. Pod 横向自动扩展
复制链接

默认部署显示以下正在运行的 pod：

两个用于 Red Hat Quay 应用程序本身的 pod (example-registry-quay-app可以')
一个 Red Hat Quay 日志记录的 Redis pod (example-registry-quay-redis可以)
一个数据库 pod for PostgreSQL，供 Red Hat Quay 用于元数据存储(example-registry-quay-database114)
两个 Quay 镜像 pod (example-registry-quay-mirror114)
Clair 应用程序的两个 pod (example-registry-clair-app114)
用于 Clair 的 PostgreSQL pod (example-registry-clair-postgres suppress)

水平 PPod 自动扩展默认配置为 受管，Quay 的 pod 数量，Clair 和存储库镜像设置为 2。这有助于在通过 Red Hat Quay Operator 更新或重新调度事件期间更新或重新配置 Red Hat Quay 时停机。您可以输入以下命令来查看 HPA 对象的信息：

$ oc get hpa -n quay-enterprise

输出示例

NAME                           REFERENCE                                 TARGETS           MINPODS   MAXPODS   REPLICAS   AGE
example-registry-clair-app     Deployment/example-registry-clair-app     16%/90%, 0%/90%   2         10        2          13d
example-registry-quay-app      Deployment/example-registry-quay-app      31%/90%, 1%/90%   2         20        2          13d
example-registry-quay-mirror   Deployment/example-registry-quay-mirror   27%/90%, 0%/90%   2         20        2          13d

第 6 章使用 Operator 部署 Red Hat Quay

6.1. 从命令行部署 Red Hat Quay
复制链接

6.1.1. 使用 API 创建第一个用户
复制链接

6.1.2. 使用命令行查看创建的组件
复制链接

6.1.3. Pod 横向自动扩展
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第 6 章 使用 Operator 部署 Red Hat Quay

6.1. 从命令行部署 Red Hat Quay复制链接链接已复制到粘贴板!

6.1.1. 使用 API 创建第一个用户复制链接链接已复制到粘贴板!

6.1.2. 使用命令行查看创建的组件复制链接链接已复制到粘贴板!

6.1.3. Pod 横向自动扩展复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第 6 章使用 Operator 部署 Red Hat Quay

6.1. 从命令行部署 Red Hat Quay
复制链接

6.1.1. 使用 API 创建第一个用户
复制链接

6.1.2. 使用命令行查看创建的组件
复制链接

6.1.3. Pod 横向自动扩展
复制链接