Docker 接続設定

PyCharm から Docker エンジン API へアクセスするための設定を指定します。 PyCharm で Docker 統合を利用する方法の詳細については、 Docker を参照してください。

PyCharm が Docker デーモンと対話するために使用する Docker CLI 実行可能ファイルのパスを指定できます。

PyCharm は、デフォルトのインストール場所にある Docker CLI 実行可能ファイルを自動的に検出できるはずです。 ただし、Docker をカスタムの場所にインストールした場合は、パスを手動で指定する必要がある場合があります。

Docker executable

ベース Docker CLI 実行可能ファイルへのパスを指定します。 デフォルトの場所:

macOS および Linux	/usr/local/bin/docker
Windows	C:\Program Files\Docker\Docker\resources\bin\docker.exe

Docker Compose executable

Docker Compose スタンドアロン実行可能ファイルへのパスを指定します。 デフォルトでは、Compose V2 は Docker CLI プラットフォームに統合され、 docker compose コマンドを介して Docker Compose に同じ実行可能ファイルを使用します。

Compose V1 を使用している場合、メインの Docker 実行可能ファイルは Docker Compose では機能しません。 この場合、 docker-compose へのパスを指定する必要があります。 詳細については、「docker-compose 対 docker compose(英語) 」を参照してください。

それぞれが個別の Docker デーモンへの接続を表す、複数の Docker 構成を追加できます：

Docker

新しい Docker 構成を追加します。

削除 Alt+Delete

選択した Docker 構成を削除します。

Docker 構成ごとに、名前を指定し、オペレーティングシステムに応じて接続タイプを選択します：

Docker for Windows

Windows で Docker Desktop を使用する場合には、このオプションがおすすめです。

Mac 用 Docker

macOS で Docker Desktop を使用する場合は、このオプションが推奨されます。

Unix socket

Linux で Docker Desktop を使用する場合には、このオプションがおすすめです。

TCP socket

Docker エンジン API(英語) への URL を手動で構成します。

エンジン API URL フィールドでは、リモート Docker デーモンまたは任意の Docker ソケットパス (カスタムローカルソケットを含む) への TCP 接続を指定できます。 例: ルートレスモード(英語)では、Docker デーモンは一意の識別子を持つ systemd ユーザーサービスを介して実行されるため、ソケットパスは unix:///run/user/1000/docker.sock のようなものになります。

デフォルトでは、macOS および Linux では、Docker デーモンは unix:///var/run/docker.sock の Unix ソケットで Docker エンジン API 要求をリッスンします。

Windows で Docker デスクトップ(英語)を使用している場合は、 npipe:////./pipe/docker_engine の名前付きパイプまたは tcp://localhost:2375 の TCP ソケットを介して Docker エンジンに接続できます。

Docker エンジン API と同等の API を備えた Podman(英語) に接続することもできます。 詳細については、 Podman​​ を参照してください。

SSH

既存の SSH 構成 を介してリモート Docker デーモンに接続するか、新しい構成を作成します。

WSL

Windows Subsystem for Linux（WSL）で実行されている Docker デーモンに接続します。

Minikube

minikube(英語) を実行している場合は、このオプションを選択して、minikube の Docker エンジン環境を自動的に検出して接続します。

PyCharm が minikube を検出できない場合やリモートで実行されている場合は、 minikube docker-env コマンドを実行して必要な接続情報を取得し、 TCP ソケットの下に次を設定してください：

• エンジン API URL: DOCKER_HOST の値 (tcp の代わりにプロトコルとして https を使用)

• Certificates folder: DOCKER_CERT_PATH の値

仮想マシンのパスマッピング

Docker 接続構成オプションの表では、ローカルファイルシステムと Docker エンジンを実行している仮想マシン間のマッピングを構成して、コンテナー内のボリュームマウントに使用できるようにすることができます。

追加 Alt+Insert

新しいマッピングを追加します。

削除 Ctrl+Y

選択したマッピングを削除します。

編集 Enter

選択したマッピングを編集します。

Virtual machine path

この Docker エンジンの実行に使用される仮想マシン内ディレクトリへのパスです。

ローカルパス

仮想マシン内の対応するディレクトリにマッピングするローカルフォルダーへのパスです。 このフォルダーの外側を bind-mount することは、この Docker エンジンが実行するコンテナにはできません。

例: Docker コンテナーにバインドマウントしたすべてのファイルを /Users/jsmith/docker-share に保持するとします。 Docker エンジン接続用に、このディレクトリを仮想マシン上の /dockerShare にマップできます。 この Docker エンジンは、 /Users/jsmith/docker-share からマップしたファイルにアクセスできるため、 /dockerShare からコンテナーにファイルを効果的にバインドマウントします。

コンテナを実行するユーザーとしては影響ありません。bind mount やボリュームは、ホストマシン上のパスとコンテナ内のパスとのマッピングとして引き続き設定します。 ただし、マッピングしたディレクトリの外側を仮想マシンにマウントすることはできません。

コンテナーを実行し、ホスト上のアプリケーションアーティファクト /Users/jsmith/docker-share/out を含むディレクトリをコンテナー内の /usr/local/tomcat/webapps にマウントするとします。 この場合、Docker エンジンは仮想マシンマッピングを通じてファイルにアクセスできる場所であるため、実際には /dockerShare/out をマウントします。

ボリュームとバインドマウントの詳細については、「Docker でデータを管理する(英語) 」を参照してください。