容器与云原生 / 系统课时

推送自定义镜像

推送自定义镜像

本课解决“如何把本地镜像按远程仓库规则命名并完成发布”的问题。你将构建一个最小 Web 镜像,添加完整标签,推送后再重新拉取验证。

学习目标

  • 看懂远程镜像名称的命名规则
  • 使用 docker tag 为本地镜像添加发布标签
  • 完成推送、删除本地副本和重新拉取验证

远程名称决定推送位置

Docker Hub 上常见名称为 <DOCKER_ID>/<REPOSITORY>:<TAG>。私有 Registry 则通常在前面增加域名和端口,例如 registry.example.com/team/app:1.0.0。

docker tag 不会复制镜像层,只会为同一个本地镜像增加新的引用。只有引用中包含正确的远程命名空间,docker push 才会把内容推送到目标 Repository。

构建并推送主示例

下面创建一个完整的 Nginx 静态页面镜像。执行前请先完成登录,并把 <DOCKER_ID> 替换为自己的 Docker Hub 用户名。

bash
set -e

rm -rf docker-publish-demo
mkdir docker-publish-demo
cd docker-publish-demo

cat > Dockerfile <<'EOF'
FROM nginx:1.27-alpine
COPY index.html /usr/share/nginx/html/index.html
EOF

cat > index.html <<'EOF'
<h1>Docker publish demo</h1>
EOF

docker build -t publish-demo:1.0.0 .
docker tag publish-demo:1.0.0 <DOCKER_ID>/publish-demo:1.0.0
docker push <DOCKER_ID>/publish-demo:1.0.0

docker image rm <DOCKER_ID>/publish-demo:1.0.0
docker pull <DOCKER_ID>/publish-demo:1.0.0

预期结果

text
构建阶段结束时出现命名成功信息。
推送阶段结束时出现 digest: sha256:<DIGEST>。
删除后重新拉取成功,最终显示 Status: Downloaded newer image 或 Image is up to date。

实际构建日志、Digest 和层数量会不同。若 Repository 不存在,Docker Hub 通常会在首次成功推送时创建;组织命名空间则需要确认账号具有写入权限。

常见失败的定位顺序

出现 requested access to the resource is denied 时,先检查是否登录了正确账号,再检查命名空间是否属于该账号或已授权组织,最后确认令牌是否具有写入权限。

出现网络超时或上传中断时,可以直接重试。Registry 会根据层摘要判断已存在的内容,通常不会重复上传全部镜像层。

推送完成不等于应用可用。还应在干净环境重新拉取,并运行容器验证页面、端口、启动命令和运行时依赖。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

推送自定义镜像

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通