容器镜像仓库
私有 Registry
-
拉取私有 Docker 镜像时,CapRover 需要对应的 registry 凭据。
-
在 dashboard 的 Cluster / Registries 中添加远程 registry,填写域名、用户名、密码或只读 token,以及可选的镜像前缀。
-
如果设置了前缀,CapRover 会将 pull 凭据匹配到以
DOMAIN/PREFIX/开头的镜像名;未设置前缀时则匹配DOMAIN/。 -
将 CapRover 构建的镜像标记到默认 push registry 时也会使用这个前缀。
-
使用凭据前先核对完整的镜像名称。
-
例如
ghcr.io/my-org/my-api:tag,registry 域名应为ghcr.io,镜像前缀为对应 owner 或组织路径,凭据必须具有读取该 package 的权限。 -
对
registry.gitlab.com/my-group/my-project/image:tag,使用匹配的 GitLab registry 路径以及最小范围的读取凭据。 -
部署时使用完整的 registry 镜像名,并确保每个目标节点都能够拉取该镜像。
-
CI 成功推送镜像,并不会自动让 CapRover 获得拉取权限。
-
如果只需要拉取预构建镜像,无需将该 registry 设置为 CapRover 构建镜像的默认 push registry。
默认 Push Registry
-
default push registry 用于存储 CapRover 构建的镜像,让其他 Swarm 节点可以拉取。
-
在 dashboard 的 Cluster / Registries 中选择所有节点都能访问的 registry,并配置凭据。
-
单节点服务器可以不配置它。通过 CapRover 的集群向导添加新节点之前,必须先设置 default push registry。
-
如果应用在配置 registry 之前已经构建过,需要重新部署这些应用,将镜像推送到 registry 供新节点拉取。
-
添加 worker 前,先验证一次新部署能够成功推送镜像。
-
部署和故障恢复期间需要持续访问 registry。删除或禁用凭据,可能导致集群节点无法拉取应用镜像。
可以使用自托管 registry或其他远程 registry。仅用于拉取预构建镜像的凭据与默认 push registry 是两个独立需求。
自托管 Registry
-
CapRover 可以为自己的集群管理 Docker registry。
-
通过 dashboard 的 Cluster / Registries 配置。如果计划添加节点,可以将其选为 default push registry。
-
跨节点部署应用之前,先确保所有节点均能访问 registry。
-
CapRover 自托管 registry 使用
996/tcp端口。 -
只向需要访问的客户端或集群节点开放该端口,并启用适当的身份验证。
-
即使 registry 和 CapRover 位于同一台物理服务器,也存在单点依赖。如果服务器或镜像存储不可用,新节点可能无法拉取镜像。
开启 default push 后,重新部署之前构建的应用以发布镜像,然后按照多节点部署指南添加并验证 worker。