PhpStorm 2024.1 ヘルプ

Docker compose 実行構成

このタイプの構成を使用して、マルチコンテナー Docker アプリケーションを実行します。

Docker は、docker compose(英語) コマンドを使用して、マルチコンテナーアプリケーションを定義、構成、実行します。コンテナーを構築、作成、起動、アタッチする主なコマンドは docker compose up(英語) です。

デフォルトでは、Docker Compose 構成には以下のオプションがあります。

項目

説明

名前

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

複数のインスタンスを許可する

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、PhpStorm は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

プロジェクトファイルとして保存

実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、.idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

デフォルトでは無効になっており、PhpStorm は実行構成設定を .idea/workspace.xml に保存します。

サーバー

実行構成に使用する Docker デーモン接続を選択します。

ファイルを作成する

必要なサービスを定義する作成ファイルを指定します。Docker Compose は指定された順序で構成を構築するため、後続のファイルはすべてオーバーライドされ、前のファイルの同じサービスのフィールドに追加されます。

これは、docker compose コマンドで -f オプションを使用するのと似ています。

サービス

構築、作成、開始するサービスを指定します。

The Browse icon をクリックして、YML ファイルにリストされているサービスを選択します。

docker-compose browse icon

起動前

実行構成を開始する前に実行するタスクのリストを指定します。例: 別の構成を実行し、必要なアーティファクトを構築し、外部ツールまたは Web ブラウザーを実行します。

the Add button をクリックするか、Alt+Insert を押して、使用可能なタスクの 1 つを追加します。

the Up button および the Down button を使用してリスト内のタスクを移動し、タスクを実行する順序を変更します。タスクを選択し、the Edit button をクリックしてタスクを編集します。the Remove button をクリックして、選択したタスクをリストから削除します。

このページを表示する

実際に起動する前に、実行構成設定を表示してください。

ツールウィンドウをアクティブにする

構成のタイプに応じて、この実行構成を開始するときに実行デバッグサービスツールウィンドウを開きます。このオプションが無効になっている場合は、ツールウィンドウを手動で開くことができます。

  • 表示 | ツールウィンドウ | 実行または Alt+4

  • 表示 | ツールウィンドウ | デバッグまたは Alt+5

  • 表示 | ツールウィンドウ | サービスまたは Alt+8

オプションを変更メニューを使用して、実行構成に詳細オプションを追加します。

項目

説明

プロジェクト名

Docker Compose の代替プロジェクト名を指定してください。デフォルトでは、これは現在のディレクトリの名前です。

これは、docker compose コマンドで -p オプションを使用するのと似ています。

環境変数

Docker Compose 環境変数(英語)を指定します。これらは Docker Compose プロセスでのみ使用されます。それらはどのコンテナーにも渡されません。

環境変数ファイル

Docker Compose 環境変数(英語)を定義するカスタム環境ファイル(英語)へのパスを指定します。

これは、docker compose コマンドで --env-file オプションを使用するのと似ています。

デフォルトでは、Docker Compose 実行構成は、Docker Compose ファイルを含むディレクトリで .env という名前のファイルを探します。

BuildKit を有効にする

イメージを構築するときは、BuildKit バックエンド(英語)を使用してください。

これは、docker build コマンドを呼び出すときに DOCKER_BUILDKIT=1 環境変数を設定するのと似ています。

` ダウンでボリュームを削除します

コンテナーを停止および削除するときは、Docker Compose ファイルで宣言されている名前付きボリュームおよびコンテナーに接続されている匿名ボリュームも削除してください。

これは、docker compose down コマンドで -v または --volumes オプションを使用するのと似ています。

互換モードの有効化

v3 サービス定義を v2 互換パラメーターに変換します。

これは、docker compose コマンドで --compatibility オプションを使用するのと似ています。

` ダウンのイメージを削除する

コンテナーを停止および削除するときに削除するイメージを構成します。サービスで使用されているすべてのイメージを削除するか、image フィールドにカスタムタグが設定されていないイメージのみを削除するかを選択できます。

これは、docker compose down コマンドで --rmi オプションを使用するのと似ています。

タイムアウト

正常にシャットダウンしないコンテナーを強制的に終了するには、タイムアウトを秒単位で設定します。

Docker は通常、SIGTERM を使用してコンテナーを正常に終了しようとしますが、無期限に実行される可能性があります。Docker が SIGKILL を送信してシャットダウンを強制するまでのタイムアウトを設定します。

これは、docker compose up コマンドで -t または --timeout オプションを使用するのと似ています。

終了コード

選択したサービスコンテナーの終了コードを返します。

選択したサービス内のコンテナーが停止するたびに、その終了コードを返し、サービス内の他のすべてのコンテナーを停止します。

これは、docker compose up コマンドで --exit-code-from オプションを使用するのと似ています。

scale のオーバーライド

各サービスで開始するコンテナーの数を設定します。

このオプションは、Docker Compose ファイルに scale パラメーターが存在する場合、それをオーバーライドします。

これは、docker compose up コマンドで --scale オプションを使用するのと似ています。

依存関係の再作成

サービスの開始時に依存コンテナーを再作成します。

これは、docker compose up コマンドで --always-recreate-deps オプションを使用するのと似ています。

匿名ボリュームの再作成

以前のコンテナーからデータを取得するのではなく、匿名ボリュームを再作成します。

これは、docker compose up コマンドで -V または --renew-anon-volumes オプションを使用するのと似ています。

孤立したコンテナーの除去

Docker Compose ファイルで定義されていないサービスのコンテナーを削除します。

これは、docker compose up コマンドで --remove-orphans オプションを使用するのと似ています。

開始

起動するサービスを構成します:

  • 選択項目と依存関係 : デフォルトでは、Docker Compose は指定されたすべてのサービスとリンクされたサービスを開始します。

  • なし : サービスを作成した後は、サービスを開始しないでください。これは、docker compose up コマンドで --no-start オプションを使用するのと似ています。

  • 選択したサービス : リンクされたサービスを開始しないでください。これは、docker compose up コマンドで --no-deps オプションを使用するのと似ています。

アタッチ先

出力ストリームを表示するコンテナーを構成します:

  • 選択したサービス : デフォルトでは、Docker Compose は、指定されたサービスの開始されたすべてのコンテナーに接続します。

  • なし : コンテナーに取り付けないでください。これは、docker compose up コマンドで -d または --detach オプションを使用するのと似ています。

  • 選択項目と依存関係 : 指定されたサービスおよびリンクされたサービスのコンテナーにアタッチします。これは、docker compose up コマンドで --attach-dependencies オプションを使用するのと似ています。

コンテナーの再作成

どのコンテナーを停止して新しいコンテナーと置換するかを構成します:

  • 変更された構成 : デフォルトでは、Docker Compose は、対応する構成またはイメージが変更された場合にのみコンテナーを再作成します。

  • すべて : 対応する構成またはイメージが変更されていない場合でも、サービス内のすべてのコンテナーを再作成します。これは、docker compose up コマンドで --force-recreate オプションを使用するのと似ています。

  • なし : 対応する構成が変更された場合でも、サービス内のコンテナーを再作成しないでください。これは、docker compose up コマンドで --no-recreate オプションを使用するのと似ています。

ビルド

コンテナーを起動する前にビルドするイメージを構成します:

  • 欠落しているイメージのみ : デフォルトでは、Docker Compose は使用できないイメージのみをビルドし、可能な場合は以前にビルドしたイメージを使用します。

  • なし : イメージを作成しないでください。以前に作成したイメージを常に使用するか、一部のイメージが利用できない場合はエラーをスローします。これは、docker compose up コマンドで --no-build オプションを使用するのと似ています。

  • 常時 : コンテナーを起動する前に、必ずイメージを作成してください。これは、docker compose up コマンドで --build オプションを使用するのと似ています。

コンテナーの停止

サービス内のコンテナーを停止する方法を構成します。デフォルトでは、Docker Compose はサービス内の他のコンテナーを停止しません。手動で停止する必要があります。

ただし、サービス内のいずれかのコンテナーが停止した場合は、すべてのコンテナーを停止することを選択できます。これは、docker compose up コマンドで --abort-on-container-exit オプションを使用するのと似ています。

関連ページ:

Docker ツール設定

PhpStorm が Docker デーモンと対話するために使用する Docker CLI 実行可能ファイルへのパスを指定します。Docker プラグインを有効にするこの機能は、デフォルトで PhpStorm にバンドルされて有効になっている Docker プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、Docker プラグインを見つけて、プラグイン名の横にあるチェックボックスを...

Docker

Docker は、分離された再現可能な環境で実行可能ファイルをデプロイおよび実行するためのツールです。これは、たとえば、本番環境と同じ環境でコードをテストする場合に役立ちます。PhpStorm は Docker 機能を統合し、Docker イメージの作成、Docker コンテナーの実行、Docker Compose アプリケーションの管理、パブリックおよびプライベート Docker レジストリの使用など、IDE から直接実行するための支援を提供します。Docker プラグインを有効にするこの機能は...

実行ツールウィンドウ

実行ツールウィンドウには、アプリケーションによって生成された出力が表示されます。各タブの外観は、実行中のアプリケーションの種類によって異なり、追加のツールボックスとペインを含めることができます。Vue.js アプリケーションをデバッグする、Angular アプリケーションをデバッグする、Vite アプリケーションをデバッグする、React アプリケーションをデバッグするから詳細を学びます。ツールウィンドウのタブ:タブをピン留め複数のアプリケーションを実行している場合、各アプリケーションは、適用...

デバッグツールウィンドウ

デバッガーセッションを開始すると、デバッグツールウィンドウが表示されます。このウィンドウを使用して、デバッガーセッションを制御し、プログラムデータ(フレーム、変数など)を表示および分析し、さまざまなデバッガーアクションを実行します。これは、デバッグツールウィンドウの概要です。ツールウィンドウの使用に関する一般的な手順については、ツールウィンドウを参照してください。ツールウィンドウのタブを切り替えるには、とを押します。セッション:使用可能なデバッグセッションは、デバッグツールウィンドウの上部

サービスツールウィンドウ

サービスツールウィンドウを使用すると、実行 / デバッグ構成、データベースセッション、Docker 接続など、ソフトウェア開発中に役立つさまざまなサービスを管理できます。プラグイン開発者は、IntelliJ プラットフォーム API を通じて他のサービスを追加できます。メインツールバーには、すべてのサービスタイプに共通の次のボタンとメニューが含まれています。すべて展開リスト内のすべての項目を展開します。すべて折りたたむリスト内のすべての項目を折りたたみます。グループ化サービスのリストを整理する方...

Docker Compose

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