Docker Builderコマンド

DockerのManagement Commands調べる Builder編

Docker Builderコマンド

Author: a_yoshii / Update: 2020 10 04

前回 の記事でDockerのコマンドについて1つずつ調べていくと書きましたが,今回はその1回目としてDocker Builderを確認していきます.


Docker Builder のサブコマンドを確認

まずはDocker Builderのサブコマンドを確認します.

公式ドキュメント

ドキュメントにはどういった意図のコマンド群かは記載されていませんが, 名前の通りDockerイメージのビルドに関するコマンドを束ねているようです. サブコマンドとして,build, pruneの2つのコマンドが用意されています.

念の為,Usageも確認してみましょう.

$ docker builder

Usage:	docker builder COMMAND

Manage builds

Commands:
  build       Build an image from a Dockerfile
  prune       Remove build cache

Run 'docker builder COMMAND --help' for more information on a command.

Usageと公式ドキュメント,どちらも上記の情報以上のことは書いてないようです.


Docker Builder Buildコマンド

これは通常のDocker BuildコマンドのAliasのようです.

公式ドキュメントでは,docker builder buildとdocker build両方のページがあります.

docker builder build

docker build

見てみるとわかりますが,builder buildコマンドよりbuildコマンドのページが圧倒的に情報が多いです. Buildコマンドに関しては,様々な方による解説記事がいくらでも見つかると思いますので,この場では割愛します.


Docker Builder Pruneコマンド

Build Cacheを削除するコマンドです.

docker builder prune

docker system dfコマンドでDockerのディスク使用量が確認すると,その際にBuild Cacheも確認できるようです. ただし,docker system dfのドキュメントではBuild Cacheには言及されていません.

$ docker system df
TYPE                TOTAL               ACTIVE              SIZE                RECLAIMABLE
Images              20                  1                   10.62GB             10.62GB (100%)
Containers          1                   1                   1.084MB             0B (0%)
Local Volumes       1                   0                   6.962kB             6.962kB (100%)
Build Cache         0                   0                   0B                  0B

今回はこのBuild Cacheの値の変化でdocker builder pruneコマンドの影響を確認しようとしましたが, DockerfileからのビルドやマルチステージビルドではBuild Cacheの値が増えなかったので, 効果が確認できませんでした.

そのため,残念ですがdocker builder pruneコマンドについては一旦置いておいて,他のコマンドの調査でBuild Cacheに関して何かわかれば追記していこうと思います.

今回はbuild, prune共にあまり情報が得られませんでしたが,次回はめげずにdocker config系のコマンドを見ていこうと思います.