メインコンテンツへスキップ

PyCharm から GCP(Compute Engine)を使って Python を実行するまでの流れ

    Pythonコード実行時にローカルPCが遅い、環境構築が面倒。
    そんなときに便利なのが PyCharm × GCP(Compute Engine) の構成。

    この記事では、

    PyCharmで書いたPythonコードを、
    GCP上の高速CPU VMで実行できるようにするまで

    を、実際につまずきやすいポイント込みでまとめる。


    目的と全体像

    やりたいことはこれ:

    • コード編集:PyCharm(ローカル)

    • 実行環境:Compute Engine(GCPのVM)

    つまり
    「IDEはローカル、Pythonはクラウドで動かす」。


    1. GCPでVMを作成する

    VMの基本設定(GPUなし・CPUのみ)

    • マシンタイプ:e2-standard-2(vCPU 2 / メモリ 8GB)

    • OS:Ubuntu 22.04 LTS

    • リージョン:us-central1 など

    • 外部IP:あり(SSH用)

    ※ e2-micro(無料枠)はかなり遅いので注意

    VM作成後、起動しておく。


    2. VMにPython仮想環境(venv)を作る

    GCPコンソールの SSH(ブラウザ) でVMに入り、以下を実行。

    sudo apt update
    sudo apt install -y python3 python3-venv python3-pip
    
    python3 -m venv ~/venv
    source ~/venv/bin/activate
    pip install -U pip
    

    この時点で
    /home/ユーザー名/venv/bin/python
    という 既存のPython環境 ができている。

    ⚠️ 重要
    → この venv は PyCharmに「作らせない」
    → 「既存の環境」として使う


    3. SSH鍵を用意する(超重要)

    ローカルPCで鍵を作成:

    ssh-keygen -t ed25519 -f ~/.ssh/gcp_pycharm
    
    • パスフレーズ:未設定なら Enter

    できるもの:

    • 秘密鍵:gcp_pycharm

    • 公開鍵:gcp_pycharm.pub

    公開鍵をVMに登録

    VMにブラウザSSHで入り:

    whoami
    mkdir -p ~/.ssh
    chmod 700 ~/.ssh
    touch ~/.ssh/authorized_keys
    chmod 600 ~/.ssh/authorized_keys
    

    ローカルの gcp_pycharm.pub の中身を
    authorized_keys に 1行そのまま 追加。


    4. PyCharmでSSH Interpreterを設定する

    設定場所

    Settings → Project → Python Interpreter → ⚙️ Add Interpreter

    選ぶもの

    • SSH Interpreter

    • 接続情報:

      • Host:VMの外部IP

      • Username:whoami の結果

      • Authentication:Private key

      • Key file:~/.ssh/gcp_pycharm

    🔴 最大の注意点

    ここで 絶対に 選ぶのは:

    ✅ Existing interpreter
    ❌ New environment
    ❌ virtualenv を作成

    Interpreter path

    /home/ユーザー名/venv/bin/python
    

    ※ ~ は使わない


    5. ファイル同期(Deployment)を設定

    PyCharmで書いた .py をVMでも実行するために必要。

    設定

    Settings → Build, Execution, Deployment → Deployment

    • Type:SFTP

    • Host:VMのIP

    • Root path:/home/ユーザー名

    • Mappings:

      • Local:プロジェクトフォルダ

      • Remote:/home/ユーザー名/project など

    Automatic Upload をONにする。


    6. 実行テスト

    test.py:

    import sys
    print(sys.executable)
    

    出力が:

    /home/ユーザー名/venv/bin/python
    

    → 成功(VMで実行されている)


    よくあるエラーと原因

    ❌ virtualenv: destination already exists

    原因:

    • PyCharmが venvを作ろうとしている

    対策:

    • Existing interpreter を選ぶ


    ❌ Permission denied (publickey)

    原因:

    • 公開鍵が authorized_keys に入っていない

    • ユーザー名が違う

    対策:

    • whoami と SSH接続ユーザーを一致させる


    ❌ ModuleNotFoundError

    原因:

    • pipしたPythonと、実行Pythonが違う

    対策:

    source ~/venv/bin/activate
    pip install <module>
    

    まとめ

    • PyCharm × GCP VM は一度つなげば快適

    • 最大の罠は:

      • venvを「作ろうとする」こと

      • SSHユーザー名の不一致

    • 正解は:

      • 既存venvをSSH Interpreterとして使う


    あなたへのおすすめ