PyCharm 2026.1 Help

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

導入

PyCharm と Docker の連携により、Docker コンテナーにデプロイされたさまざまな構成の開発環境でアプリケーションを実行できます。

前提条件

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

  • Docker のドキュメント(英語)に従って、Docker がインストールされます。

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

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

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

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

例の準備

Python プロジェクトを作成QuadraticEquation追加 Solver.py ファイルを追加し、次のコードをコピーして貼り付けてください:

import math class Solver: def demo(self, a, b, c): d = b ** 2 - 4 * a * c if d > 0: disc = math.sqrt(d) root1 = (-b + disc) / (2 * a) root2 = (-b - disc) / (2 * a) return root1, root2 elif d == 0: return -b / (2 * a) else: return "This equation has no roots" if __name__ == '__main__': solver = Solver() while True: a = int(input("a: ")) b = int(input("b: ")) c = int(input("c: ")) result = solver.demo(a, b, c) print(result)

リモートインタープリターとしての Docker の設定

それでは、Docker ベースのリモートインタープリターを定義しましょう。

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

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

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

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

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

  3. Docker server ドロップダウンで既存の Docker 構成を選択します。

    または、 をクリックし、次の手順を実行して新しい Docker 構成を作成します。

    Docker 構成を作成する

    The Add button をクリックして Docker 構成を追加し、Docker デーモンへの接続方法を指定します。

    接続設定は、Docker のバージョンとオペレーティングシステムによって異なります。 詳細については、 Docker 接続設定 を参照してください。

    ダイアログの下部に Connection successful メッセージが表示されます。

    Docker 接続設定

    Windows で Docker または macOS を使用するときに、Docker デーモンを実行している仮想マシンにローカルパスをマッピングする方法の詳細については、 仮想マシンのパスマッピング を参照してください。 マッピングされたローカルパスの外部にあるディレクトリに対してボリュームやバインドマウントを使用することはできません。

    このテーブルは、Docker がネイティブに実行され、任意のディレクトリをコンテナーにマウントできる Linux ホストでは使用できません。

  4. 次のアクションは、ビルド済みのイメージを Docker レジストリからプルするか、イメージを Dockerfile からローカルにビルドするかによって異なります。

    Docker イメージのプル

    Pull or use existing を選択し、 Image tag フィールドで目的のイメージのタグを指定します。

    イメージをプルして Docker インタープリターを作成する
    Docker イメージのビルド

    Build を選択し、必要に応じて Dockerfile および Context folder フィールドのデフォルト値を変更します。

    イメージのビルドによる Docker インタープリターの作成

    必要に応じて、 Optional セクションを展開し、次のように指定します。

    Image tag

    ビルドされたイメージのオプションの名前とタグを指定します。

    これは、将来的にイメージを参照できます。 フィールドを空白のままにすると、イメージにはランダムな一意の識別子のみが含まれます。

    Build options

    サポートされている docker build オプション(英語)を設定します。

    例: --label オプションを使用して、ビルドされたイメージのメタデータを指定できます。

    Build args

    ビルドプロセス中に通常の環境変数のようにアクセスできるビルド時変数の値を指定しますが、中間イメージや最終イメージには保持されません。

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

    これらの変数は、 ARG 命令を使用して Dockerfile で定義する必要があります。 例: 使用するベースイメージのバージョンの変数を定義できます。

    ARG PY_VERSION=latest FROM python:$PY_VERSION

    この場合、 PY_VERSION 変数はデフォルトで latest に設定され、ビルド時の引数として再定義しない限り、Dockerfile は Python の最新バージョンのイメージを生成します。 PY_VERSION=3.10 を設定すると、Docker は代わりに python:3.10 をプルし、Python バージョン 3.10 のコンテナーを実行します。

    PY_VERSION 引数の再定義は、次のコマンドラインオプションの設定に似ています。

    --build-arg PY_VERSION=3.10

    複数の引数をスペースで区切って指定できます。

  5. PyCharm が Docker デーモンに接続し、コンテナーのイントロスペクションを完了するまで待ちます。

    Docker コンテナーのイントロスペクションが完了しました
  6. Docker コンテナーで使用するインタープリターを選択してください。 環境タイプは、 Pythonconda 、または uv から選択できます。

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

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

Docker コンテナーでアプリケーションを実行する

ガターで、 main 句の横にある アイコンをクリックし、 実行 'solver' を選択します。

「実行」コンテキストメニュー

スクリプトは 実行 ツールウィンドウで起動されます。 スクリプトに値を指定します。

Docker コンテナーでサンプルを実行する

サービス ツールウィンドウに切り替えて、コンテナーの詳細をプレビューします。 コンテナー ノードを展開し、実行中のコンテナーを選択します。

サービスツールウィンドウの Docker コンテナー

ログ タブにも同じ実行結果が含まれていることに注意してください。

Docker コンテナーでのアプリケーションのデバッグ

次に、アプリケーションをデバッグしましょう。 そのために、行番号をクリックして、 d を計算する行にブレークポイントを置きましょう。 次に、ガターの をクリックし、 デバッグ 'solver' を選択します。

ブレークポイントを設定してデバッガーを起動する

デバッガーは Docker コンテナーでも実行されます。

Docker コンテナーでデバッグする

ただし、このコンテナーの ID は異なるため、名前も異なります。

要約

PyCharm を使って行ったことをまとめましょう:

  • プロジェクトを作成し、Python スクリプトを追加しました。

  • リモートインタープリターを設定しました。

  • Docker コンテナーでスクリプトを実行し、デバッグしました。

  • 最後に、Docker ツールウィンドウを起動し、ターミナルですべての詳細を確認しました。

追加情報については、次のビデオチュートリアルを参照してください。

2026 年 6 月 1 日