docker tag
为镜像创建新的标签(别名)
语法
docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
示例
添加版本标签
docker tag myapp:latest myapp:1.0.0
同一镜像可以有多个标签
标记为远程仓库格式
docker tag myapp:1.0 registry.example.com/team/myapp:1.0
推送到私有仓库前必须打标签
标记为 Docker Hub 格式
docker tag myapp:latest username/myapp:latest
推送到 Docker Hub 需要加用户名前缀
标记多个版本
docker tag myapp:latest myapp:1.2.0 docker tag myapp:latest myapp:1.2 docker tag myapp:latest myapp:1
语义化版本的多级标签
常见错误
Error response from daemon: No such image
源镜像不存在,用 docker images 确认镜像名和标签
invalid reference format
标签格式不合法,不能包含大写字母或特殊字符
技巧
- tag 不会复制镜像,只是创建一个指向同一镜像的新引用
- 推送前用 tag 把镜像名改为 仓库地址/镜像名:版本 格式
- CI/CD 中常用 git commit hash 作为镜像标签确保唯一性