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で入り:
whoamimkdir -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として使う