新しく登場するDockerコマンド

今回、docker container runで実行する際に、-dオプションを使用してバックグラウンドで起動します。

1. docker container runの-dオプション

今回、docker container runで実行する際に、-dオプションを使用してバックグラウンドで起動します。

-dは、Detached(切り離された)モードの略で、コンテナをバックグラウンドで実行し、ターミナルの操作権を即座にユーザに戻すためのオプションです。

docker container run -d my-image

この記述は、コンテナを裏側(バックグラウンド)で起動し続けることを意味しています。

通常、このオプションをつけずに起動すると、コンテナのログが画面に流れ続け、そのコンテナが終了するまでターミナルで他のコマンドを入力することができなくなります。また、その状態でターミナルを閉じてしまうと、コンテナも道連れになって停止してしまいます。

Webサーバやデータベースのように、常駐して動き続ける必要のあるアプリケーションを動かす際は、この-dオプションを使って「コンテナの実行プロセスをターミナルから切り離す」という設定を行うのが一般的です。

2. docker container runの-pオプション

-pは、コンテナ内の特定ポートに、自分のPC(ホスト)からアクセスできるようにポートを接続(公開)して起動するためのオプションです。

docker container run -p 8080:80 my-image

-pで8080:80と記述することで、「自分のPCの8080番ポート(左側)」に来たアクセスを、「コンテナ内の80番ポート(右側)」に転送する設定になります。

今回のハンズオンでは、Goアプリケーションが8080番ポートで起動するため、-p 8080:8080と記述します。

docker container run -p 8080:8080 my-image

これは「ホストの8080番ポート」と「コンテナの8080番ポート」を同じ番号で繋ぐ設定です。ホストとコンテナで同じポート番号を使用する場合は、このように左右を同じ値にします。

コンテナ内のアプリケーションは独自のポートで動作していますが、そのままでは外部からアクセスできません。このオプションを使ってホストとコンテナのポートを繋ぐことで、ブラウザやcurlコマンドからアクセス可能になります。

3. docker container logs

今回、コンテナの内部で何が起きているかを確認するために、docker container logsコマンドを使用します。

これは、実行中のコンテナが出力したメッセージ(標準出力・標準エラー出力)を、後から確認するためのコマンドです。

docker container logs my-go-container

この記述は、指定したコンテナ(ここではmy-go-container)がこれまでに書き出したログ情報を、現在のターミナルに表示させることを意味しています。

先ほどの-dオプションを使用してバックグラウンドで起動した場合、Webサーバの起動メッセージやエラーログなどは画面に一切表示されず、裏側で隠れてしまいます。

「起動したはずなのにアクセスできない」といったトラブルの際には、まずこのコマンドを実行します。そうすることで、「実はポート番号が間違っていた」「プログラムがエラーで落ちていた」といった内部の状況を、あたかもその場で実行したかのように確認することができます。

4. docker container exec

これは、すでにバックグラウンドで動いているコンテナに対して、外から別のコマンドを割り込ませて実行するためのコマンドです。

4.1 単発コマンドの実行

まずは、起動中のコンテナに対して、コマンドを一つだけ実行したい場合の記述です。

docker container exec my-go-container ls -l /app

この記述は、「my-go-containerの中で ls -l /app コマンドを実行して、その結果を表示しろ」という命令になります。

この使い方は、コンテナの中に入り込む(ログインする)わけではありません。外から命令を投げ込んで、その実行結果だけを受け取るイメージです。「ファイルが正しく作られたか確認したい」「設定ファイルの中身をcatコマンドで軽く確認したい」といった、一時的な確認作業を行う際に便利です。

4.2 -itオプション(対話モードでの実行)

一方で、コンテナの中に入って、連続してコマンドを実行したい場合には -it オプションを使用します。

docker container exec -it my-go-container sh

この記述は、コンテナの中で sh(シェル)を起動し、その操作を自分のターミナルと繋ぐことを意味しています。ここで登場する -it は、2つの重要な役割を持っています。

  • -i(interactive)は「双方向」という意味で、自分のキーボードからの入力をコンテナに届けるための設定です。これがないと、コマンドを打ってもコンテナは反応しません。
  • -t(tty)は「端末」という意味で、コンテナからの出力を手元の画面で見やすく表示するための設定です。

これらを組み合わせることで、あたかもコンテナの中にログインしたかのように、対話形式で次々とコマンドを打ちながら調査を行うことができるようになります。

5. まとめ(コマンド一覧)

最後に、今回登場したコマンドを下記表にまとめておきます。

コマンド 説明
docker container run -d コンテナをバックグラウンドで実行
docker container run -p <ホスト>:<コンテナ> ポートを接続してコンテナを起動
docker container logs <コンテナ名> コンテナのログを確認
docker container exec <コンテナ名> <コマンド> 起動中のコンテナでコマンドを実行
docker container exec -it <コンテナ名> sh コンテナ内に入って対話的に操作