docker ps
100%

Docker · レッスン 4

docker ps

Docker コンテナを一覧に表示し、実行中と終了済みのコンテナを見分けます。

Docker で起動した Web サーバーはまだ動いているでしょうか。docker ps で確かめましょう。イメージはプログラムと必要なファイルをまとめたものです。コンテナは、そのイメージから作ったインスタンスです。このコマンドには、実行した時点でのコンテナの一覧が表示されます。

実行中のコンテナを表示する

既定の docker ps は実行中のコンテナを一覧にします。サンプルは用意した環境の出力から必要な列だけを抜き出したものです。Docker を用意しなくても読み進められます。ターミナルで試すときは、プロンプトの $ より後ろのコマンドを入力してください。

$ docker ps
IMAGE         STATUS         NAMES
nginx:alpine  Up 4 minutes   web
nginx:alpine  Up 30 seconds  demo

列見出ししか表示されない場合、実行中のコンテナの一覧は空です。同じ環境に停止したコンテナが残っていることはあります。

docker ps を実行すると列見出しだけが表示されました。この結果から何が分かりますか?

名前と状態を読む

まず NAMES で目的のコンテナを探します。両方の行の IMAGE 列に、同じイメージ nginx:alpine が表示されています。右端で web を見つけ、同じ行の STATUS を読みます。Up 4 minutes は、このコンテナが約 4 分間動いているという意味です。

約 30 秒間動いているコンテナはどの行ですか?

終了済みのコンテナも表示する

あるはずのコンテナが見つからないときは、docker ps -a を試します。-a は --all の短縮形です。停止していても残っているコンテナを表示します。この例には、あらかじめ用意した preview という処理も含まれています。

$ docker ps -a
IMAGE         STATUS                         NAMES
nginx:alpine  Up 4 minutes                   web
nginx:alpine  Up 30 seconds                  demo
busybox:1.36  Exited (0) 2 minutes ago       report
busybox:1.36  Exited (1) About a minute ago  preview

コンテナでは、Web サーバーやスクリプトなどのメインプログラムが動きます。Exited はそのプログラムが終了したという意味です。括弧の数値は終了コードで、終了時にプログラムが返した結果を表します。通常、0 は成功、0 以外はエラーを示します。report の Exited (0) は、処理が正常に終わった場合の表示です。

実行中と終了済みのコンテナ、report の終了コード 0、preview の終了コード 1 を示す LabEx ターミナル

LabEx の画面では、例に出てくる四つのコンテナの名前と状態だけを表示しています。経過時間はコマンドを実行した時刻によって変わります。

終了コードから判断して、エラーの有無をどの行で調べますか?

次に確認することを決める

終了コードは調査の手がかりです。preview がエラーメッセージを出したか調べるには、docker logs の後にコンテナ名を書きます。Docker がそのコンテナから収集した出力が表示されます。

$ docker logs preview

Web サーバーが動いている場合、利用者がページを開けるかどうかも確認できます。実際にアクセスする必要があるコンピューターでページを開きます。Up はコンテナ内のプログラムの状態です。ブラウザーからのリクエストが成功すれば、そのコンピューターからページに接続できると分かります。

Docker が動くコンピューターではページを開けます。同僚は別のコンピューターから開く必要があります。どの確認で判断できますか?

レッスン完了

docker ps を完了しました

一覧からコンテナを見つけ、状態を読み、次に何を確認するかを決められるようになりました。

  • docker ps で実行中のコンテナを表示する。

  • 名前を手がかりにコンテナを探し、その状態を読む。

  • docker ps -a で終了済みのコンテナも表示する。

  • 状態だけで判断できないときは、ログやブラウザーのリクエストで確かめる。

学習進捗を保存

無料アカウントを作成してこのレッスンを保存し、どのデバイスからでも学習を続けられます。

無料アカウントを作成
次のレッスン
Docker に戻る