第 4 章 管理备用内容源
备用内容源定义在同步期间下载内容的备用路径。内容本身从备用内容源下载,而元数据则从 Satellite 服务器或上游 URL 下载,具体取决于配置。如果内容位于本地文件系统或接近网络中,您可以使用备用内容源加快同步。您可以为 Satellite 服务器和 Capsule 设置备用内容源。您必须在创建后或进行任何更改后刷新备用内容源。每周 cron 作业会刷新所有备用内容源。您还可以使用 Satellite Web UI 或hammer CLI 手动刷新备用内容源。与 Satellite 服务器关联的备用内容源或附加到多个组织的胶囊服务器会影响所有组织。
有三种备用内容源:
- Custom
- 自定义备用内容源从网络或文件系统的任何上游存储库下载内容。
- 简化的
- 简化备用内容源,从您的 Satellite 服务器复制上游存储库信息,以用于所选产品。简化的备用内容源非常适合,从 Capsule 到上游存储库的连接比 Satellite 服务器更快。在创建简化的备用内容源时选择红帽产品,将从红帽 CDN 将内容下载到 Capsule 中。
- RHUI
- RHUI 备用内容源从 Red Hat Update Infrastructure 服务器下载内容。Satellite Web UI 提供了一些示例,可帮助您找到网络路径并导入身份验证凭据。RHUI 备用内容源必须是 RHUI 版本 4 或更高版本,并使用默认安装配置。例如,不支持 AWS RHUI,因为它使用具有唯一身份验证要求的安装场景。
Alternate 内容源的权限要求
非管理员用户必须具有以下权限来管理备用内容源:
-
view_smart_proxies
-
view_content_credentials
-
view_organizations
-
view_products
除了以上权限外,根据用户可以执行的操作,分配特定于备用内容源的权限:
-
view_alternate_content_sources
-
create_alternate_content_sources
-
edit_alternate_content_sources
-
destroy_alternate_content_sources
4.1. 配置自定义 Alternate 内容源
前提条件
- 如果存储库需要 SSL 身份验证,请将 SSL 证书和密钥导入到 Satellite。如需更多信息,请参阅 管理内容 中的 导入自定义 SSL 证书。
-
请注意,备用内容源路径由您提供的子路径附加的基本 URL 组成。例如,如果您的基本 URL 是
https://server.example.com
,并且您的子路径为rhel7/
和rhel8/
,则会搜索https://server.example.com/rhel7/
和https://server.example.com/rhel8/。
流程
- 在 Satellite Web UI 中,导航到 Content > Alternate Content Sources。
- 单击 Add Source,将 Source 类型设置为 Custom。
- 选择内容类型。
- 在 Name 字段中输入备用内容源的名称。
- 可选:在 Description 字段中,为 ACS 提供描述。
- 选择要同步备用内容源的 Capsule。
- 输入备用内容源的基本 URL。
- 输入以逗号分隔的 Subpath 列表。
- 如果需要,请提供 Manual Authentication 或 Content Authentication 凭证。
- 如果需要 SSL 验证,请启用 Verify SSL 并选择 SSL CA 证书。
- 查看详情并点 Add。
- 导航到 Content > Alternate Content Sources > 点新创建的备用内容源 > Select Refresh 旁的垂直 ellipsis。
CLI 过程
在 Satellite 服务器中输入以下命令:
# hammer alternate-content-source create \ --name "My_ACS_Name" \ --alternate-content-source-type custom \ --base-url "https://local-repo.example.com:port" \ --smart-proxy-ids Capsule_ID
检查是否列出了新创建的备用内容源:
# hammer alternate-content-source list
刷新备用内容源:
# hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID
添加要同步备用内容源的胶囊:
# hammer alternate-content-source update \ --id My_Alternate_Content_Source_ID \ --smart-proxy-ids Capsule_ID
刷新备用内容源:
# hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID