第 3 章 在部署前配置 Red Hat Quay
在 OpenShift Container Platform 上部署时,Red Hat Quay Operator 可以管理所有 Red Hat Quay 组件。但是,这是默认配置,当您想要对设置进行更多控制时,您可以在外部管理一个或多个组件。
使用以下模式配置非受管 Red Hat Quay 组件。
步骤
-
使用适当的设置创建
config.yaml配置文件。 输入以下命令,使用配置文件创建
Secret:$ oc create secret generic --from-file config.yaml=./config.yaml config-bundle-secret创建一个
quayregistry.yaml文件,标识非受管组件并引用创建的Secret,例如:QuayRegistryYAML 文件示例apiVersion: quay.redhat.com/v1 kind: QuayRegistry metadata: name: example-registry namespace: quay-enterprise spec: configBundleSecret: config-bundle-secret components: - kind: objectstorage managed: false使用
quayregistry.yaml文件部署 registry:$ oc create -n quay-enterprise -f quayregistry.yaml
3.1. 预配置 Red Hat Quay 以进行自动化 复制链接链接已复制到粘贴板!
Red Hat Quay 支持几个启用自动化的配置选项。用户可以在部署前配置这些选项,以减少与用户界面交互的需求。
3.1.1. 允许 API 创建第一个用户 复制链接链接已复制到粘贴板!
要创建第一个用户,用户需要将 FEATURE_USER_INITIALIZE 参数设置为 true,并调用 /api/v1/user/initialize API。与需要现有机构中 OAuth 应用的 OAuth 令牌生成的所有其他 registry API 调用不同,API 端点不需要身份验证。
部署 Red Hat Quay 后,用户可以使用 API 来创建用户,如 quayadmin,但没有创建其他用户。如需更多信息 ,请参阅使用 API 创建第一个用户。
3.1.2. 启用常规 API 访问 复制链接链接已复制到粘贴板!
用户应将 BROWSER_API_CALLS_XHR_ONLY 配置选项设置为 false,以允许常规访问 Red Hat Quay registry API。
3.1.3. 添加超级用户 复制链接链接已复制到粘贴板!
部署 Red Hat Quay 后,用户可以创建用户,并授予第一个用户管理员特权具有完整权限。用户可以使用 SUPER_USER 配置对象提前配置完整的权限。例如:
...
SERVER_HOSTNAME: quay-server.example.com
SETUP_COMPLETE: true
SUPER_USERS:
- quayadmin
...
3.1.4. 限制用户创建 复制链接链接已复制到粘贴板!
配置超级用户后,您可以通过将 FEATURE_USER_CREATION 设置为 false 来限制创建新用户到超级用户组的能力。例如:
...
FEATURE_USER_INITIALIZE: true
BROWSER_API_CALLS_XHR_ONLY: false
SUPER_USERS:
- quayadmin
FEATURE_USER_CREATION: false
...
3.1.5. 在 Red Hat Quay 3.8 中启用新功能 复制链接链接已复制到粘贴板!
要使用新的 Red Hat Quay 3.8 功能,请启用一些或全部的功能:
...
FEATURE_UI_V2: true
FEATURE_LISTEN_IP_VERSION:
FEATURE_SUPERUSERS_FULL_ACCESS: true
GLOBAL_READONLY_SUPER_USERS:
-
FEATURE_RESTRICTED_USERS: true
RESTRICTED_USERS_WHITELIST:
-
...
3.1.6. 在 Red Hat Quay 3.7 中启用新功能 复制链接链接已复制到粘贴板!
要使用新的 Red Hat Quay 3.7 功能,请启用一些或全部的功能:
...
FEATURE_QUOTA_MANAGEMENT: true
FEATURE_BUILD_SUPPORT: true
FEATURE_PROXY_CACHE: true
FEATURE_STORAGE_REPLICATION: true
DEFAULT_SYSTEM_REJECT_QUOTA_BYTES: 102400000
...
3.1.7. 推荐的自动化配置 复制链接链接已复制到粘贴板!
建议对自动化使用以下 config.yaml 参数:
...
FEATURE_USER_INITIALIZE: true
BROWSER_API_CALLS_XHR_ONLY: false
SUPER_USERS:
- quayadmin
FEATURE_USER_CREATION: false
...