配置全局默认私有镜像仓库
备注
本页介绍了安装 Rancher 后如何从 Rancher UI 配置全局默认私有镜像仓库。
有关如何在 Rancher 安装期间设置私有镜像仓库的说明,请参阅离线安装指南。
私有镜像仓库是集群中私有、一致且集中的容器镜像源。你可以使用私有容器镜像仓库,在组织内共享自定义基础镜像。
在 Rancher 中设置私有镜像仓库主要有两种方式:
- 通过全局视图中的 Settings 选项卡设置全局默认镜像仓库。
- 在集群级别设置下的高级选项中设置私有镜像仓库。
全局默认镜像仓库适用于离线环境,可用于不需要凭证的镜像仓库。而集群级私有镜像仓库用于需要凭证的私有镜像仓库。
将不需要凭证的私有镜像仓库设置为默认镜像仓库
- 登录 Rancher 并配置默认管理员密码。
- 选择 ☰ > 全局设置。
- 转到
system-default-registry
并选择 ⋮ > 编辑设置。 - 输入你镜像仓库的主机名和端口(例如
registry.yourdomain.com:port
)。不要在文本前加上http://
或https://
。
结果:Rancher 会从你的私有镜像仓库中拉取系统镜像。
带 RKE2 下游集群的命名空间私有镜像仓库
默认情况下,大多数私有镜像仓库应该能与 RKE2 下游集群一起工作。
但是,如果你尝试设置 URL 格式为 website/subdomain:portnumber
的命名空间私有镜像仓库,则需要执行额外的步骤:
- 选择 ☰ > 集群管理。
- 在列表中找到 RKE2 集群,然后点击 ⋮ > 编辑配置。
- 从集群配置菜单中,选择镜像仓库。
- 在镜像仓库中,选择配置高级 Containerd Mirror 和仓库认证选项选项。
- 在 Mirrors 下的文本字段中,输入镜像仓库主机名和 Mirror 端点。
- 单击保存。
- 根据需要对每个下游 RKE2 集群重复操作。
创建集群时配置使用凭证的私有镜像仓库
无法为每个 Rancher 配置的集群全局设置具有授权认证的私有镜像仓库。因此,如果你希望 Rancher 配置的集群从使用凭证的私有镜像仓库中拉取镜像,则每次创建新集群时都必须通过高级集群选项传递镜像仓库凭证。
由于创建集群后无法配置私有镜像仓库,因此你需要在初始集群设置期间执行这些步骤。
- 选择 ☰ > 集群管理。
- 在集群页面上,单击创建。
- 选择集群类型。
- 在集群配置中,转到镜像仓库选项卡,然后选择为 Rancher 从私有镜像仓库中拉取镜像。
- 输入镜像仓库主机名和凭证。
- 单击创建。
结果:新集群将从私有镜像仓库中拉取镜像。