Docker Compose は、マルチコンテナ Docker アプリケーションを管理するための不可欠なツールです。この実験（Lab）では、Docker Compose を使い始める際に多くのユーザーが遭遇する一般的な「zsh: command not found: docker-compose」エラーの解決方法を説明します。
この実験（Lab）を完了することで、Docker Compose を正しくインストールし、パス関連の問題をトラブルシューティングし、Docker Compose を使用してシンプルなマルチコンテナアプリケーションを実行する方法を習得できます。これらのスキルは、コンテナ化されたアプリケーションを扱う開発者にとって基本となります。
トラブルシューティングを開始する前に、Docker Compose が何であり、Docker エコシステムにおいてなぜ重要なのかを理解しましょう。
Docker は、開発者がコンテナ内でアプリケーションを構築、パッケージ化、実行できるようにするプラットフォームです。コンテナは、アプリケーションを実行するために必要なすべて（コード、ランタイム、システムツール、ライブラリ、設定）を含む、軽量で分離された環境です。
Docker Compose は、マルチコンテナ Docker アプリケーションを定義し、実行するためのツールです。Docker Compose を使用すると、YAML ファイルを使用して、アプリケーションのサービス、ネットワーク、およびボリュームを構成します。その後、単一のコマンドで、構成からすべてのサービスを作成して開始できます。
Docker がシステムに正しくインストールされているかどうかを確認しましょう。
docker --version次のような出力が表示されるはずです。
Docker version 20.10.21, build baeda1fこれにより、Docker がインストールされ、使用できる状態であることが確認されます。次に、Docker Compose を実行して、インストールされているかどうかを確認してみましょう。
docker-compose --versionDocker Compose がインストールされていない場合、次のエラーが表示されます。
zsh: command not found: docker-composeこのエラーメッセージは、この実験（Lab）の焦点です。次のステップで、この問題をトラブルシューティングして修正します。
Docker Compose は、マルチコンテナアプリケーションの管理に関して、いくつかの利点を提供します。
次のステップでは、Docker Compose をインストールし、「command not found」エラーを解決します。
Docker Compose が何であるかを理解したので、「command not found」エラーを解決するために、システムにインストールしましょう。
最初のステップは、Docker Compose バイナリをダウンロードすることです。公式の Docker Compose バイナリは GitHub で入手できます。curl コマンドを使用してダウンロードします。
sudo curl -L "https://github.com/docker/compose/releases/download/v2.17.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composeこのコマンドは、オペレーティングシステムのアーキテクチャに一致する Docker Compose バイナリをダウンロードし、/usr/local/bin/docker-compose に保存します。ファイルのダウンロードには少し時間がかかります。
バイナリをダウンロードした後、実行可能にする必要があります。
sudo chmod +x /usr/local/bin/docker-composeこのコマンドは、Docker Compose バイナリに実行権限を付与します。
次に、Docker Compose が正しくインストールされたことを確認しましょう。
docker-compose --version次のような出力が表示されるはずです。
Docker Compose version v2.17.2まだ「command not found」エラーが表示される場合は、/usr/local/bin ディレクトリがシステムの PATH に含まれていない可能性があります。この問題は、次のステップで対処します。
PATH 変数は、Linux の環境変数であり、コマンドを実行するときに、実行可能ファイルを検索するディレクトリをシェルに指示します。現在の PATH を表示するには、次を実行します。
echo $PATHコロン（:）で区切られたディレクトリのリストが表示されるはずです。/usr/local/bin がこのリストに含まれていない場合、シェルが docker-compose コマンドを見つけられない理由を説明できる可能性があります。
次のステップでは、Docker Compose の使用を妨げる可能性のある残りの問題をトラブルシューティングして解決します。
インストール後も「zsh: command not found: docker-compose」エラーが発生する場合は、いくつかの一般的な原因とその解決策をトラブルシューティングしましょう。
一般的な解決策の 1 つは、PATH に確実に含まれているディレクトリ（例：/usr/bin）に Docker Compose バイナリへのシンボリックリンクを作成することです。
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-composeこのコマンドは、Docker Compose バイナリへのシンボリックリンク（ショートカット）を /usr/bin ディレクトリに作成します。これは通常、デフォルトでシステムの PATH に含まれています。
シンボリックリンクを作成した後、Docker Compose をもう一度実行してみてください。
docker-compose --versionこれで、エラーなしで Docker Compose のバージョン情報が表示されるはずです。
新しいバージョンの Docker では、Compose はプラグインとして利用できます。この方法を使用したい場合は、次を試すことができます。
docker compose versiondocker と compose の間にハイフンがないことに注意してください。このコマンドが機能する場合、Docker Compose がプラグインとして利用可能であり、この構文で代わりにそれを使用できることを意味します。
Docker Compose を現在の場所に保持したいが、シンボリックリンクが機能しない場合は、ディレクトリを PATH に手動で追加できます。
echo 'export PATH=$PATH:/usr/local/bin' >> ~/.zshrc
source ~/.zshrcこれにより、/usr/local/bin が PATH に追加され、現在のセッションに変更が即座に適用されます。
どの解決策を使用したとしても、Docker Compose が正しく動作していることを確認してください。
docker-compose --version次のような出力が表示されるはずです。
Docker Compose version v2.17.2Docker Compose を正常にインストールして構成したので、次のステップでは、インストールをテストするために簡単な Docker Compose プロジェクトを作成します。
Docker Compose が正しくインストールされ、動作するようになったので、セットアップをテストするための簡単なプロジェクトを作成しましょう。Web サーバーと Redis データベースを備えた基本的な Web アプリケーションを作成します。
まず、プロジェクト専用のディレクトリを作成しましょう。
mkdir ~/project/docker-compose-test
cd ~/project/docker-compose-test次に、nano テキストエディタを使用して docker-compose.yml ファイルを作成しましょう。
nano docker-compose.yml次の内容をファイルにコピーして貼り付けます。
version: "3"
services:
web:
image: nginx:alpine
ports:
- "8080:80"
volumes:
- ./html:/usr/share/nginx/html
redis:
image: redis:alpineこの Docker Compose ファイルは、2 つのサービスを定義しています。
web: ローカルディレクトリからコンテンツを提供する Nginx Web サーバーredis: キャッシュまたはセッションデータを保存するための Redis データベースCtrl+O を押して Enter キーを押し、ファイルを保存し、Ctrl+X を押して nano を終了します。
Web サービスが提供する簡単な HTML ページを作成しましょう。
mkdir -p html
nano html/index.html次の内容をファイルにコピーして貼り付けます。
<!DOCTYPE html>
<html>
<head>
<title>Docker Compose Test</title>
</head>
<body>
<h1>Hello from Docker Compose!</h1>
<p>If you can see this, your Docker Compose setup is working correctly.</p>
</body>
</html>Ctrl+O を押して Enter キーを押し、ファイルを保存し、Ctrl+X を押して nano を終了します。
次に、Docker Compose プロジェクトを開始しましょう。
docker-compose up -d-d フラグは、コンテナをバックグラウンドで実行します（デタッチモード）。次のような出力が表示されるはずです。
Creating network "docker-compose-test_default" with the default driver
Pulling web (nginx:alpine)...
Pulling redis (redis:alpine)...
[...]
Creating docker-compose-test_web_1 ... done
Creating docker-compose-test_redis_1 ... doneサービスが正しく実行されていることを確認しましょう。
docker-compose ps次のような出力が表示されるはずです。
Name Command State Ports
------------------------------------------------------------------------------------
docker-compose-test_redis_1 docker-entrypoint.sh redis ... Up 6379/tcp
docker-compose-test_web_1 /docker-entrypoint.sh ngin ... Up 0.0.0.0:8080->80/tcpこれで、LabEx インターフェースで Web ブラウザを開き、http://localhost:8080 に移動して、Web アプリケーションにアクセスできます。「Hello from Docker Compose!」メッセージが表示されるはずです。
または、curl を使用して、コマンドラインから Web サーバーを確認することもできます。
curl http://localhost:8080先ほど作成した HTML コンテンツが表示されるはずです。
テストが完了したら、Docker Compose プロジェクトを停止できます。
docker-compose down次のような出力が表示されるはずです。
Stopping docker-compose-test_web_1 ... done
Stopping docker-compose-test_redis_1 ... done
Removing docker-compose-test_web_1 ... done
Removing docker-compose-test_redis_1 ... done
Removing network docker-compose-test_defaultおめでとうございます！Docker Compose を正常にインストールし、「command not found」エラーを解決し、簡単なマルチコンテナアプリケーションでセットアップをテストしました。
この実験では、以下の方法を学びました。
これらのスキルは、Docker と Docker Compose を使用するための確固たる基盤を提供します。これで、Docker Compose を自信を持って使用して、複雑なマルチコンテナアプリケーションを定義、デプロイ、および管理できます。
さらに学習するには、環境変数、ネットワーク、ボリューム、およびスケーリングサービスなど、より高度な Docker Compose の機能を検討してください。また、本番環境での Docker Compose について、および CI/CD パイプラインとの統合方法についても学習することをお勧めします。
