Docker pull コマンド

 Docker 命令大全Docker コマンド大全


docker pullこのコマンドは、Docker レジストリ(Docker Hub など)からローカルにイメージをプル(ダウンロード)するために使用します。

docker pullこのコマンドにより、ユーザーはローカルでコンテナを実行するために必要なイメージを取得できます。

構文

docker pull [OPTIONS] NAME[:TAG|@DIGEST]
  • NAME: イメージ名。通常はレジストリアドレスを含みます(例:docker.io/library/ubuntu)。
  • TAG(オプション): イメージタグ。デフォルトはlatest。
  • DIGEST(オプション): イメージのSHA256ダイジェスト。

よく使うオプション:

  • --all-tags, -a: 指定したイメージのすべてのタグをダウンロードします。
  • --disable-content-trust: イメージの署名検証をスキップします。

1、デフォルトタグ(latest)のイメージをプルする

docker pull ubuntu

これにより、Docker Hub から ubuntu という名前のイメージがプルされ、タグはデフォルトで latest になります。

2、特定のタグのイメージをプルする

docker pull ubuntu:20.04

これにより、Docker Hub から ubuntu という名前のイメージが、タグ 20.04 でプルされます。

3、特定のダイジェストのイメージをプルする

docker pull ubuntu@sha256:12345abcdef...

これにより、特定のSHA256ダイジェストを持つ ubuntu イメージがプルされます。

4、すべてのタグのイメージをプルする

docker pull --all-tags ubuntu

これにより、ubuntu イメージの利用可能なすべてのタグがプルされます。

5、カスタムレジストリからイメージをプルする

docker pull myregistry.com/myrepo/myimage:mytag

これにより、myregistry.com レジストリから、myrepo リポジトリ内の myimage イメージをタグ mytag でプルします。

例

1、Ubuntu イメージをプルする:

docker pull ubuntu

出力例:

Using default tag: latest
latest: Pulling from library/ubuntu
Digest: sha256:12345abcdef...
Status: Downloaded newer image for ubuntu:latest
docker.io/library/ubuntu:latest

2、指定されたタグの Ubuntu イメージをプルする

docker pull ubuntu:20.04

出力例:

20.04: Pulling from library/ubuntu
Digest: sha256:67890abcdef...
Status: Downloaded newer image for ubuntu:20.04
docker.io/library/ubuntu:20.04

注意事項

  • デフォルトのタグはlatestですが、予期しないバージョンをプルしないように、明示的にタグを指定することをお勧めします。
  • プルしたイメージを保存するための十分なディスク容量を確保してください。
  • 本番環境では、イメージの一意性と一貫性を確保するために、イメージのダイジェストを使用することをお勧めします。

docker pullこのコマンドは、Docker イメージを取得するための基本的なツールであり、イメージ名、タグ、またはダイジェストを指定することで、Docker レジストリから必要なイメージをダウンロードできます。


 Docker 命令大全Docker コマンド大全

その他の拡張