docker image tag
描述 | 创建指向 SOURCE_IMAGE 的 TARGET_IMAGE 标签 |
---|---|
用法 | docker image tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG] |
别名 | docker tag |
描述
Docker 镜像引用包含多个组成部分,用于描述镜像的存储位置及其标识。这些组成部分包括:
[HOST[:PORT]/]NAMESPACE/REPOSITORY[:TAG]
主机
- 指定镜像所在的仓库位置。如果省略,Docker 默认使用 Docker Hub (`docker.io`)。
端口
- 仓库的可选端口号,如有需要(例如,`:5000`)。
命名空间/仓库
- 命名空间(可选)通常表示用户或组织。仓库是必需的,用于标识特定的镜像。如果省略命名空间,Docker 默认使用 `library`,这是为 Docker 官方镜像保留的命名空间。
标签
- 用于指定镜像特定版本或变体的可选标识符。如果未提供标签,Docker 默认使用 `latest`。
镜像引用示例
example.com:5000/team/my-app:2.0
- 主机:`example.com`
- 端口:`5000`
- 命名空间:`team`
- 仓库:`my-app`
- 标签:`2.0`
alpine
- 主机:`docker.io` (默认)
- 命名空间:`library` (默认)
- 仓库:`alpine`
- 标签:`latest` (默认)
有关镜像命名结构和规则的更多信息,请参阅 Distribution reference,它是该格式的规范定义。
示例
按 ID 引用镜像并打标签
要将 ID 为 `0e5574283393` 的本地镜像打上 `fedora/httpd:version1.0` 的标签
$ docker tag 0e5574283393 fedora/httpd:version1.0
按名称引用镜像并打标签
要将名为 `httpd` 的本地镜像打上 `fedora/httpd:version1.0` 的标签
$ docker tag httpd fedora/httpd:version1.0
请注意,由于未指定标签名,别名是为现有的本地版本 `httpd:latest` 创建的。
按名称和标签引用镜像并打标签
要将名称为 `httpd` 且标签为 `test` 的本地镜像打上 `fedora/httpd:version1.0.test` 的标签
$ docker tag httpd:test fedora/httpd:version1.0.test
为私有仓库的镜像打标签
要将镜像推送到私有仓库而不是公共 Docker 仓库,您必须包含仓库主机名和端口(如果需要)。
$ docker tag 0e5574283393 myregistryhost:5000/fedora/httpd:version1.0