はじめに

　「dockerってめっちゃ使われてるし、よし、勉強しよ」と思って始めた当初から、「え？何が違うの？？」と戸惑ってました。曖昧なまま勉強を進めていると、何度もこの問いにぶつかるのでまとめようと思います。初心者の備忘録も兼ねてるので、間違いがあればご指摘ください。

公式をちゃんと読もう

　やっぱりこういう時には公式リファレンスです。

up ・ run ・ start の違いは何ですか？

一般的には docker-compose up が使われるでしょう。 up を使うと docker-compose.yml ファイル中で定義したサービスの開始または再起動を行います。デフォルトは「アタッチド」モードであり、全てのコンテナのログが画面上に表示されます。「デタッチド」モード（ -d ）では、Compose はコンテナを実行すると終了しますが、コンテナは後ろで動き続けます。

docker-compose run コマンドは「ワンオフ」（one-off；１つだけ、偶発的）または「アドホック」（adhoc；臨時）なタスクの実行に使います。実行するにはサービス名の指定が必要であり、特定のサービス用のコンテナを起動し、かつ依存関係のあるコンテナも起動します。 run の利用時は、テストの実行であったり、データ・ボリューム・コンテナに対するデータの追加・削除といった管理タスクです。 run コマンドは実際には docker run -ti を処理しており、コンテナに対してインタラクティブなターミナルを開き、コンテナのプロセスが終了すると、その時点の該当する終了コードを返します。

docker-compose start コマンドは既に作成済みのコンテナの再起動には便利です。しかし止まっているコンテナを起動するだけであり、新しいコンテナは作成しません。

　upは全サービスを開始or再起動してくれます。とりあえず一括で立ち上げて、全体に不備がないか確認できますね。

　runは一つのコンテナにのみフォーカスします。用途として想定されるのは、『テスト実行』『データの追加・削除』など。あるコンテナで色々作業したいときに便利ですね。depends_onなど依存関係があってもちゃんと考慮して立ち上げてくれます。

　startは元々ある停止中コンテナを再起動するだけです。事前にコンテナを作っておかないといけません。

まとめてみる

　公式とその他記事を参考にして、まとめてみました。

コマンド	対象	イメージ作成	コンテナ構築	コンテナ起動	いつ使うか
up	全てのサービス	初回のみ	初回のみ	○	全てのサービスを開始or再起動したい
run	１つのサービス	○	○	○	あるコンテナを一から作り作業をしたい
start	作成済の全てのコンテナ	✕	✕	○	停止させていたコンテナを再起動させたい

　ちなみに、Dockerfileの更新を反映させてupを使いたい場合は、--buildオプションをつけます。すなわち上の表で、upの『初回のみ』となっている部分が--buildのおかげで○になりますね。

おわりに

　これでやっと迷わずコマンドを打てそうです。やっぱり記事にすると頭の中が整理されて、細かいところまでクリアになるので良いですねー！

参考

よくある質問と回答 — Docker-docs-ja 20.10 ドキュメント
docker-compose up とか build とか start とかの違いを理解できていなかったのでまとめてみた - Qiita
docker-compose upって何？ - Qiita