docker tag の使い方

イメージに別名をつける

書き方

docker tag 元のイメージ 新しい名前:タグ

同じイメージに別の名前(タグ)をつけます。中身はコピーされません。レジストリに送るときは、レジストリの場所を名前の先頭につけます。

例

$ docker tag myapp:1.0 myapp:latest

myapp:1.0 に latest という別名もつけます。中身はコピーされず、同じイメージを 2 つの名前で呼べるようになります。

$ docker tag myapp:1.0 localhost:5000/myapp:1.0

名前の先頭にレジストリの場所をつけます。こうしておくと docker push でそのレジストリに送れます。

$ docker tag myapp:1.0 123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/myapp:1.0

Amazon ECR に送るための名前をつけます。アカウント ID とリージョンが名前に入ります。

$ docker images myappREPOSITORY   TAG       IMAGE ID       CREATED          SIZE
myapp        1.0       5d1c2b3a4f6e   10 minutes ago   182MB
myapp        latest    5d1c2b3a4f6e   10 minutes ago   182MB

タグを付けたあとに確かめると、同じ IMAGE ID の行が増えているのが分かります。

よくある間違い・注意

  • タグは後から別のイメージに付け替えられます。同じタグに違う中身を入れると、どれが動いているか分からなくなるので、版ごとに新しいタグにします。
  • 名前に使えるのは小文字・数字・. _ - です。大文字を入れるとエラーになります。

実際に打って練習する

Docker コースの Lv20「ENTRYPOINT・ARG・タグ」で覚えます(第2章 造船所(イメージを作る))。ブラウザの中のシミュレーターで、本物と同じように打って確かめられます。

Lv1〜7 はログインすると無料で試せます(それより先はゴールド以上のプランで遊べます)。

Docker コマンド一覧(使い方と例)へ戻る