PyCharm 2026.1 Help

Docker Compose を使用してインタープリターを構成する

前提条件

次の前提条件が満たされていることを確認してください:

  • 安定したインターネット接続があるため、PyCharm は busybox:latestBusyBox Docker 公式イメージ の最新版)をダウンロードして実行できます。 Docker を使用してインタープリターを正常に構成したら、オフラインにすることができます。

  • Docker がインストールされています。 Docker はさまざまなプラットフォームにインストールできますが、ここでは macOS(英語) インストールを使用します。

    このチュートリアルを異なるプラットフォームで繰り返す必要がある場合は、 Windows(英語) および Linux(英語) に Docker インストールを使用してください (Ubuntu、他のディストリビューション関連の手順も利用できます)。

  • Docker の使用を開始する前に、 Docker プラグインが有効になっていることを確認してください。 プラグインは PyCharm にバンドルされており、デフォルトで有効になっています。 プラグインが有効になっていない場合は、 プラグインのインストール の説明に従って、 プラグイン​ 設定ページ  Ctrl+Alt+S で有効にしてください。

    設定 ダイアログ (Ctrl+Alt+S) で、 ビルド、実行、デプロイ | Docker を選択し、 Docker デーモンに接続<あなたの operating system> のための Docker を選択します。 例: macOS にいる場合は、 Mac 用 Docker を選択します。 詳細については、 Docker 設定を参照してください。

例を準備する

Django プラグインを有効化

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

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

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

別のコンテナーで実行されている PostgreSQL データベースで Django アプリケーションを使用してみましょう。

  1. 'ようこそ' 画面の左側のペインで、 クローン をクリックします。

  2. バージョン管理から取得 ダイアログで、 リモートリポジトリ(英語)の URL を指定し、 クローン をクリックします。

  3. PyCharm は、 requirements.txt ファイルに記録されているプロジェクト要件に基づいて仮想環境を作成することを提案します。

    仮想環境の作成

    OK をクリックして環境を作成します。

  4. IDE が提供するもう 1 つのヒントは、データソースの検出です。 データベースに接続 をクリックしてデータベースを設定します。

    データソースの検出

    不足しているドライバーをダウンロードし、残りの構成オプションを確認する必要がある場合があります。

    データソースの設定

これが完了すると、例の準備が整い、docker containers の構成を開始できます。

この Django のサポート アプリケーションでは、データベース用とアプリケーション用のコンテナーをそれぞれ作成します。 Docker Compose は 2 つのコンテナーをリンクします。

Docker と Docker Compose のファイルを追加

  1. Project ツールウィンドウで、プロジェクトルートを右クリックし、コンテキストメニューから 新規 | ファイル を選択します。 ファイル名を入力します: Dockerfile

  2. 次のコードをコピーして Dockerfile ファイルに貼り付けます。

    FROM python:3.6.7 WORKDIR /app # By copying over requirements first, we make sure that Docker will cache # our installed requirements rather than reinstall them on every build COPY requirements.txt /app/requirements.txt RUN pip install -r requirements.txt # Now copy in our code, and run it COPY . /app EXPOSE 8000 CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]
  3. 次に、プロジェクトルートをもう一度右クリックし、コンテキストメニューから 新規 | ファイル を選択して、 docker-compose.yml ファイルを作成します。

  4. 次のコードをコピーして docker-compose.yml ファイルに貼り付けます。

    version: '2' services: web: build: . ports: - "8000:8000" volumes: - .:/app links: - db db: image: "postgres:9.6" ports: - "5432:5432" environment: POSTGRES_PASSWORD: hunter2

    このファイルは、 webdb の 2 つのサービスを定義し、リンクします。

Docker の設定

例の準備ができたため、Docker を設定しましょう。

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | Docker を選択します。

  2. Add a docker server をクリックして、Docker サーバーを作成します。 推奨されるデフォルト値を受け入れます。

    Docker 設定

    Docker をカスタムの場所にインストールした場合は、Docker CLI 実行可能ファイルへのパスを指定する必要がある場合があります。

    変更を保存するには、 OK をクリックします。

Docker Compose をリモートインタープリターとして設定する

ここで、Docker Compose に基づいてリモートインタープリターを定義しましょう。

  1. 次のいずれかを実行します:

    • Python インタープリターセレクターをクリックして 新しいインタープリターを追加 を選択します。

    • Ctrl+Alt+S を押して 設定 を開き、 Python | インタープリター に移動します。

    • Python インタープリターセレクターをクリックして インタープリターの設定 を選択します。 利用可能なインタープリターのリストの横にある インタープリターの追加 リンクをクリックします。

  2. 利用可能なインタープリターのリストの横にある インタープリターの追加 リンクをクリックし、 Docker Compose について を選択します。

  3. サーバー ドロップダウンで Docker 構成を選択します。

  4. 構成ファイル docker-compose.yml ファイルを指定し、サービスを選択します。

    新しい Docker Compose ターゲットの作成

    必要に応じて、 環境変数(英語)を指定して プロジェクト名を作成する(英語)を編集します。

  5. PyCharm が新しいターゲットを作成し構成するまで待ちます:

    Docker Compose ターゲットの構成
  6. Select an interpreter to use in the container. 環境タイプは、 Pythonconda 、または uv から選択できます。

  7. OK をクリックしてください。

    構成されたリモートインタープリターがリストに追加されます。

Docker ツールウィンドウを使用する

Docker を構成すると、PyCharm のメインウィンドウ下部に サービス ツールウィンドウが表示されます。 services グループの横にあるガターで docker-compose updocker-compose up をクリックすると、 db および web サービスを起動できます。

Docker ウィンドウ

サービス ツールウィンドウで docker コンテナーを管理する方法の詳細については、 Docker を参照してください。

データベース資格情報を構成する

Django プロジェクトの settings.py ファイルの DATABASES セクションを変更して、データベース構成の詳細を追加します。

DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql', 'NAME': 'postgres', 'USER': 'postgres', 'PASSWORD': 'hunter2', 'HOST': 'db' } }

アプリケーションの実行

  1. メインメニューから ツール | 「manage.py」タスクを実行する を選択し、 migrate と入力してマイグレーションを実行し、Django のサポート アプリケーションを実行します。

  2. Django サーバーの実行 / デバッグ構成を作成します。 これを行うには、メインメニューから 実行 | 実行構成の編集 を選択します。

    実行 / デバッグ構成 ダイアログで、 Add Run/Debug configuration for a Django Server新規構成の追加 をクリックし、 Django サーバー を選択します。

    Django サーバーの実行 / デバッグ構成
  3. ホスト フィールドを 0.0.0.0 に設定して、Docker コンテナーが外部要求に対して開かれていることを確認します。 このアドレスでサーバーを起動できるようにするには、 settings.py ALLOWED_HOSTS リストに 0.0.0.0 を追加します。

  4. 新しく作成した構成を実行するには、メインメニューから 実行 | 実行 'RunDjangoApp' を選択します。

    Docker compose run

Web ブラウザーで出力を確認するには、 http://localhost:8000 にアクセスしてください。

Django アプリケーションの出力

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

実行 / デバッグ構成を作成すると、アプリケーションをデバッグすることもできます。

  1. ブレークポイントを設定します (Django アプリケーションの場合は、テンプレートで設定できます)。

  2. 次のいずれかを実行します:

    • メインメニューから 実行 | デバッグ 'RunDjangoApp' を選択します。

    • RunDjangoApp 構成を選択した状態で、実行 / デバッグ構成ドロップダウンの横にある Start Debuggerデバッグ をクリックします。

コンテナー内のアプリケーションのデバッグの詳細については、 Docker コンテナーでデバッグするを参照してください。

2026 年 6 月 1 日