対象イメージ <TARGET_IMAGE>
に 元イメージ <SOURCE_IMAGE>
を参照する タグ <tag>
を作成します。
$ docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
イメージ名は、構成名をスラッシュ記号で区切る構成です。オプションで先頭にレジストリのホスト名を追加します。ホスト名は標準 DNS ルールに完全に従う必要がありますが、アンダースコア記号は使えません。ホスト名を使う場合は、オプションでポート番号を :8000
の形式で指定できます。ホストの指定が無ければ、デフォルトで Docker の公開レジストリのある registry-1.docker.io
を使います。構成名は(アルファベット)小文字、数字、セパレータ(分離記号)を含みます。セパレータの定義はピリオド、1つか2つのアンダースコア、複数のダッシュです。セパレータは、コンポーネント名の始めと終わりで使えません。
タグ名に含められるのは有効な ASCII 文字で、(アルファベット)小文字と大文字、数字、アンダースコア、ピリオド、ダッシュです。タグ名はピリオドやダッシュで開始できません。そして最大で 128 文字です。
自分自身でイメージを名前とタグでグループ化し、 アップロード後は リポジトリを通したイメージを共有 <contributing-to-docker-hub>
できます。
コマンドの使用例は、以下の 使用例のセクション <docker_tag-examples>
をご覧ください。
ローカルにある ID 「0e5574283393」イメージを、「fedora」リポジトリの「version 1.0」とタグ付けします。
docker tag 0e5574283393 fedora/httpd:version1.0
ローカルにある名前が 「httpd」のイメージを、「fedora」リポジトリの「version 1.0」とタグ付けします。
docker tag httpd fedora/httpd:version1.0
タグ名を指定しなければ、既存のローカル・バージョンのエイリアス httpd:latest
が作成されるのでご注意ください。
ローカルにある名前が 「httpd」でタグが「test」イメージを、「fedora」リポジトリの「version 1.0.test」とタグ付けします。
docker tag httpd:test fedora/httpd:version1.0.test
コマンド | 説明 |
---|---|
docker <docker> |
Docker CLI の基本コマンド |