docker image tag
描述 | 建立指向 SOURCE_IMAGE 的標籤 TARGET_IMAGE |
---|---|
用法 | docker image tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG] |
別名 | docker tag |
描述
Docker 映象引用包含幾個描述映象儲存位置和身份的元件。這些元件是
[HOST[:PORT]/]NAMESPACE/REPOSITORY[:TAG]
HOST
- 指定映象所在的登錄檔位置。如果省略,Docker 預設為 Docker Hub (
docker.io
)。 PORT
- 登錄檔的可選埠號,如果需要(例如,
:5000
)。 NAMESPACE/REPOSITORY
- 名稱空間(可選)通常代表使用者或組織。倉庫是必需的,用於標識特定映象。如果省略名稱空間,Docker 預設為
library
,這是為 Docker 官方映象保留的名稱空間。 TAG
- 一個可選的識別符號,用於指定映象的特定版本或變體。如果沒有提供標籤,Docker 預設為
latest
。
映象引用示例
example.com:5000/team/my-app:2.0
- 主機:
example.com
- 埠:
5000
- 名稱空間:
team
- 倉庫:
my-app
- 標籤:
2.0
alpine
- 主機:
docker.io
(預設) - 名稱空間:
library
(預設) - 倉庫:
alpine
- 標籤:
latest
(預設)
有關映象命名結構和規則的更多資訊,請參閱 分發參考,作為該格式的權威定義。
示例
按 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