Docker pull コマンド
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 コマンド大全