記事の内容
概要
container lsは、起動中のコンテナ一覧を確認するコマンドになります。
ls
記述
docker container ls [オプション]
$ docker container ls
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
711e7a5aba86 nginx "/docker-entrypoint.…" 1 minutes ago Up 2 seconds 0.0.0.0:8080->80/tcp nginx
1dd77986cc2c ubuntu "bash" 1 minutes ago Up 2 minutes ubuntu
【説明】
列名 | 説明 |
---|---|
CONTAINER ID | コンテナID(ランダム) |
IMAGE | イメージ |
COMMAND | 実行プロセス |
CREATED | 作成時間 |
STATUS | ステータス |
PORTS | 公開ポート |
NAMES | コンテナ名(指定しなければランダム) |
オプション一覧
オプション | 説明 |
---|---|
-a | 全てのコンテナを表示 |
-f | コンテナをフィルタリング |
-q | コンテナIDのみ表示 |
–format | 出力形式を指定 |
-a
aオプションは、起動中以外のコンテナも確認できます。
ls -a
記述
docker container ls -a
docker container ls –all
$ docker container ls
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
38f48f724614 nginx "/docker-entrypoint.…" 1 minutes ago Up 2 minutes 0.0.0.0:8080->80/tcp nginx
1dd77986cc2c ubuntu "bash" 1 minutes ago Up 2 minutes ubuntu
【nginx停止後】
$ docker container ls --all
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
38f48f724614 nginx "/docker-entrypoint.…" 1 seconds ago Exited (0) 1 minutes ago nginx
1dd77986cc2c ubuntu "bash" 1 minutes ago Up 2 minutes ubuntu
-f
fオプションは、指定した条件に基づいてコンテナをフィルタリングできます。
ls -f
記述
docker container ls -f “指定条件”
docker container ls –filter “指定条件”
【状態に基づくフィルタリング】
【稼働中コンテナ一覧】
$ docker container ls -f "status=running"
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1dd77986cc2c ubuntu "bash" 1 minutes ago Up 2 minutes ubuntu
【終了済みコンテナ一覧】
$ docker container ls --filter "status=exited"
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
38f48f724614 nginx "/docker-entrypoint.…" 1 seconds ago Exited (0) 1 minutes ago nginx
【名前に基づくフィルタリング】
$ docker container ls -f "name=new_ubuntu"
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
95a3364cc44b ubuntu "bash" 1 minutes ago Up 2 minutes new_ubuntu
【ラベルに基づくフィルタリング】
$ docker ps -f 'label=image_type=test'
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
738bc4c12cc4 ubuntu "bash" 1 minutes ago Up 2 minutes test_ubuntu
【Labelチェック】
$ docker container inspect test_ubuntu
=======
省略
=======
"Labels": {
"maintainer": "NGINX Docker Maintainers \u003cdocker-maint@nginx.com\u003e",
"image_type": "test"
},
=======
省略
=======
【イメージに基づくフィルタリング】
$ docker container ls -f "ancestor=ubuntu"
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1dd77986cc2c ubuntu "bash" 1 minutes ago Up 2 minutes ubuntu
-q
qオプションは、起動中のコンテナIDを確認できます。
ls -q
記述
docker container ls -q
docker container ls –quiet
$ docker container ls -q
1dd77986cc2c
95a3364cc44b
738bc4c12cc4
–format
formatオプションは、出力形式をカスタマイズして表示することができます。
ls –format
記述
docker container ls –format “フォーマット指定”
$ docker container ls --format "ID:{{.ID}}\t Image:{{.Image}}\t Status:{{.Status}}"
ID:738bc4c12cc4 Image:nginx Status:Up 3 minutes
ID:95a3364cc44b Image:ubuntu Status:Up 2 minutes
ID:1dd77986cc2c Image:ubuntu Status:Up 1 minutes