PyCharm 2026.2 Help

Docker Compose

Docker Compose(英語) は、マルチコンテナーアプリケーションを実行するために使用されます。 例: Web サーバー、バックエンドデータベース、アプリケーションコードを個別のサービスとして実行できます。 必要に応じてコンテナーを追加することで各サービスを拡張できます。 これにより、本番環境と同様に、動的な環境で効率的な開発とテストを実行できます。

Docker プラグインを有効化

この機能は Docker プラグインに依存しており、PyCharm にはデフォルトでバンドルされ有効になっています。 関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン​ を選択します。

  2. インストール済み タブを開き、 Docker プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

PyCharm は Docker Compose ファイルを認識し、 アイコンでマークします。 また、Docker Compose ファイルで定義されたさまざまなサービスを実行するための ガターアイコンも追加します。

Docker Compose ファイル

Docker Compose ファイルを作成する

  1. プロジェクト ツールウィンドウ（Alt+1 ）で、プロジェクトルートを右クリックし、 新規 を選択するか Alt+Insert を押してから、 Docker Compose ファイル を選択します。

    docker-compose.yml を作成する

  2. 表示されるポップアップで、デフォルトの Docker Compose ファイル名をそのまま使用するか、カスタムの名前を指定して Enter を押してください。

    docker-compose.yml を作成する

サービス構成を完了する

  1. エディターで Docker Compose ファイルを開きます。

  2. サービス名の入力を開始してください。 PyCharm で サービス のポップアップが表示され、該当する構成を選択できます。

    Docker Compose 補完。 サービスを選択する

マルチコンテナー Docker アプリケーションの実行

  1. 1 つまたは複数の Docker Compose ファイル(英語)で必要なサービスを定義します。

  2. メインメニューで 実行 | 実行構成の編集 へ移動します。

  3. 追加アイコン をクリックし、 Docker（ドッカー） をポイントして、 Docker Compose をクリックします。

    Docker Compose 構成

  4. サービス定義で Docker Compose ファイルを指定します。 必要に応じて、この構成で開始するサービスを定義し、 環境変数(英語)を指定し、対応するコンテナーを起動する前にイメージのビルドを強制することができます (つまり、 docker compose up(英語) コマンドに --build オプションを追加します)。

    利用可能なオプションの詳細については、「Docker compose 実行構成 」を参照してください。

  5. OK をクリックして Docker Compose 実行構成を保存し、メインツールバーで選択して 実行ボタン をクリックするか、 Shift+F10 を押して構成を開始します。

Docker Compose がマルチコンテナーアプリケーションを実行するとき、 サービス ツールウィンドウ（Alt+8 ）を使って特定のサービスを制御し、 コンテナーと対話できます。 Docker Compose の一部として実行されるコンテナーは、専用の Compose ノードにリストされ、 コンテナー ノード（スタンドアロンコンテナー専用）には表示されません。

エディターで Docker Compose ファイルを開くと、PyCharm がサービスのステータスや使用可能なポートアクションを示す インレイヒント を表示します。

  • サービスステータス

    各サービス名の横にステータスのインレイヒントが表示され、そのサービスが実行中か失敗しているかを示します。 インレイヒントをクリックすると、 サービス ツールウィンドウでコンテナーログに移動します。

    エディター内の Docker Compose ファイルでのサービスステータス

  • ポートアクション（URL を開く）

    ポートを公開しているサービスには、PyCharm がエディター内で直接クイックアクションを提供します：

    • ブラウザーで開く ：サービスの URL をデフォルトブラウザーで開きます。

    • データベースに接続 ：対応するデータベース接続ワークフローを開き、データベースの確認や IDE から直接クエリの実行が可能です。 詳細については、 データソース を参照してください。

サービスをスケールする

  1. サービス ツールウィンドウで、スケーリングするサービスを選択して スケールボタン をクリックするか、コンテキストメニューから スケール を選択します。

  2. 「スケール 」ダイアログで、このサービスに必要なコンテナーの数を指定し、「OK 」をクリックします。

実行中のサービスを停止する

  • サービス ツールウィンドウで、サービスを選択して The Stop button をクリックするか、コンテキストメニューから 停止 を選択します。

実行中のサービスをすべて停止する

  • サービス ツールウィンドウで、 Compose ノードを選択して The Stop button をクリックするか、コンテキストメニューから 停止 を選択します。

アプリケーションをダウンさせる

  • サービス ツールウィンドウで、 Compose ノードを選択して ダウンボタン をクリックするか、コンテキストメニューから 下 を選択します。

これにより、関連するすべてのネットワーク、ボリューム、イメージとともにコンテナーが停止および削除されます。

アプリケーションの実行に使用された Docker Compose ファイルを開く

  • サービス ツールウィンドウで、 Compose ノードまたはネストされたサービスノードを右クリックし、コンテキストメニューで ソースに移動 をクリックするか、 F4 を押します。

アプリケーションをデバッグする

  1. アプリケーション用の 実行 / デバッグ構成を作成します。

  2. ツールバーの 実行 / デバッグ構成 リストから構成を選択し、 Shift+F9 を押します。

2026 年 7 月 14 日
Docker compose 実行構成Docker のトラブルシューティング