docker image

Docker イメージ名

書式項目の説明
リポジトリ[:タグ]リポジトリ(必須): イメージの名前
タグ(省略可): バージョンや種類
【例】
 mysql
 nginx:latest
 ubuntu:22.04

Dockerイメージの移動

Dockerイメージがリモートレジストリ、ローカルイメージストレージ、Dockerfileの間を移動する流れ

  • docker image pull でリモートからローカルへダウンロードする。
  • docker image build でDockerfileから新規イメージを作成してローカルに保存する。
    build時にベースイメージが自動的にpullされる。
  • docker image push でローカルからリモートへアップロードする。

docker image ls コマンド
 【処理】 ローカルイメージストレージのイメージ一覧を表示する
 【書式】 docker image ls [オプション]

オプション内容
ls(デフォルト)イメージを表示する(タグ付きイメージのみ)
ls -a / --allイメージを表示する(中間イメージ含む)
ls -q / --quietイメージIDのみ表示する
ls --filter
【例】--filter "dangling=true"
【例】--filter "reference=nginx*"
【例】--filter "before=nginx:1.25"
フィルタをかける
タグなしイメージでフィルタ
名前でフィルタ
特定イメージより前でフィルタ
ls --format
【例】--format "{{.Repository}}:{{.Tag}}"
フォーマット指定
ls --no-truncサイズ表示なし

docker image build コマンド
 【処理】 ローカルイメージストレージにイメージを作成する
 【書式】 docker image build [オプション] パス

オプション内容
build .(デフォルト)カレントディレクトリの Dockerfile を使用する
全ファイルをビルドコンテキストにする
タグなしでイメージを作成する
build -t / --tag
【例】-t myapp:latest
タグを指定する
build -f / --file
【例】-f Dockerfile.prod
Dockerfileを指定する
build --build-arg
【例】--build-arg VERSION=1.0
ビルド引数を指定する
build --no-cacheキャッシュを使わない
build --target
【例】--target production
特定ターゲットまでビルド(マルチステージ)
build --platform
【例】--platform linux/amd64
プラットフォーム指定
build --exclude
【例】--exclude .git
ビルドコンテキスト除外
build --progress
【例】--progress=plain
進捗表示

docker image tag コマンド
 【処理】 ローカルイメージストレージのイメージにタグを付ける
 【書式】 docker image tag ソースイメージ名 ターゲットイメージ名

オプション内容
【例】
tag myapp:latest myapp:v1.0
イメージにタグを付ける

docker image push コマンド
 【処理】 ローカルイメージストレージからイメージをアップロードする
 【書式】 docker image push [オプション] イメージ名

オプション内容
push -a(--all)すべてのタグをpush
push -q / --quiet詳細表示なし
push --disable-content-trustレジストリ認証を無効化

docker image pull コマンド
 【処理】 ローカルイメージストレージへイメージをダウンロードする
 【書式】 docker image pull [オプション] イメージ名

オプション内容
pull -a(--all-tags)すべてのタグを表示する
pull --platform
【例】--platform linux/amd64
プラットフォーム指定
pull -q / --quietプル完了後に詳細表示しない

docker image rm コマンド
 【処理】 イメージを削除する
 【書式】 docker image rm [オプション] イメージ名

オプション内容
rm -f(--force)
【例】-f nginx:latest
強制削除
rm --no-prune
【例】--no-prune nginx:latest
タグのみ削除(イメージ本体は残す)