容器与云原生 / 系统课时
推送自定义镜像
推送自定义镜像
本课解决“如何把本地镜像按远程仓库规则命名并完成发布”的问题。你将构建一个最小 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 会根据层摘要判断已存在的内容,通常不会重复上传全部镜像层。
推送完成不等于应用可用。还应在干净环境重新拉取,并运行容器验证页面、端口、启动命令和运行时依赖。
按自己的节奏,确认真正理解。