第 4 章 管理备用内容源
备用内容源定义了在同步期间下载内容的替代路径。内容本身从备用内容源下载,而元数据则从 Satellite 服务器或上游 URL 下载,具体取决于配置。如果内容位于本地文件系统或最接近的网络上,您可以使用备用内容源来加快同步。您可以为 Satellite 服务器和 Capsule 设置备用内容源。您必须在创建后或进行任何更改后刷新备用内容源。每周 cron 作业会刷新所有备用内容源。您还可以使用 Satellite Web UI 或 Hammer CLI 手动刷新备用内容源。与 Satellite 服务器关联的备用内容源或附加到多个组织的胶囊服务器会影响所有组织。
备用内容源有三种类型:
- Custom
- 自定义备用内容源从网络或文件系统上的任何上游存储库下载内容。
- 简化
- 简化备用内容源,从您的 Satellite 服务器中为所选产品复制上游存储库信息。从胶囊连接到上游存储库比从 Satellite 服务器的连接更快的情况,简化的备用内容源是理想的选择。在创建简化的备用内容源时,选择红帽产品将从红帽 CDN 下载内容到胶囊。
- RHUI
- RHUI 备用内容源从 Red Hat Update Infrastructure 服务器下载内容。Satellite Web UI 提供了示例,可帮助您查找网络路径和导入身份验证凭据。RHUI 备用内容源必须是 RHUI 版本 4 或更高版本,并使用默认安装配置。例如,不支持 AWS RHUI,因为它使用具有唯一身份验证要求的安装场景。
Alternate Content Sources 的权限要求
非管理员用户必须具有以下权限来管理备用内容源:
-
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. 配置自定义备用内容源
先决条件
- 如果存储库需要 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。
- 输入以逗号分隔的子路径列表。
- 如果需要,请提供手动 身份验证或内容 身份验证凭证。
- 如果需要 SSL 验证,请启用 验证 SSL 并选择 SSL 证书。
- 检查详情并点 Add。
- 导航到 Content > Alternate Content Sources > 点新创建的备用内容源 > Select Refresh 旁的垂直 ellipsis。
CLI 过程
在 Satellite 服务器上输入以下命令:
# hammer alternate-content-source create \ --alternate-content-source-type custom \ --base-url "https://local-repo.example.com:port" \ --name "My_ACS_Name" \ --smart-proxy-ids My_Capsule_ID
检查新创建的备用内容源是否已列出:
# hammer alternate-content-source list
刷新备用内容源:
# hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID
添加要同步备用内容源的 Capsule:
# hammer alternate-content-source update \ --id My_Alternate_Content_Source_ID \ --smart-proxy-ids My_Capsule_ID
刷新备用内容源:
# hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID