alicek106/pycharm-remote-builder

镜像概述

alicek106/pycharm-remote-builder镜像旨在为PyCharm IDE提供远程Python解释器环境，帮助开发者在容器中快速构建一致的运行环境，无需本地配置复杂依赖，提升跨环境开发的便捷性与一致性。

核心功能

• 支持通过SSH协议作为PyCharm的远程解释器
• 兼容Docker原生、Kubernetes集群及Helm Chart多种部署方式
• 通过脚本机制实现容器内环境变量传递至IDE
• 提供代码自动上传与部署配置能力

使用场景

1. 本地环境与目标运行环境存在差异时的开发调试
2. 团队协作中统一开发环境，避免环境不一致问题
3. 需要隔离运行环境的Python项目开发

配置说明

1. SSH连接与远程解释器设置

1. 打开PyCharm → File → Settings → Project: [项目名] → Project Interpreter
2. 点击齿轮图标 → Add Remote → 勾选SSH Credential
3. 填写信息：用户名root、默认密码theoryofhappiness、端口为容器映射端口（如本地50000）
4. 选择解释器路径：/root/python_env.sh

2. 部署与自动上传配置

1. Tools → Deployment → Configuration... → 设置SFTP主机和端口
2. Mapping标签页：将deployment path on server设为/root/src
3. 点击Upload to [服务器信息]完成代码上传

3. 环境变量配置

容器启动时通过entrypoint.sh导出环境变量至env_var.sh，python_env.sh读取该文件使变量生效，确保远程运行时环境一致。

部署示例

Docker原生部署

bash
# 拉取镜像
docker pull alicek106/pycharm-remote-builder:latest

# 运行容器（映射本地50000端口到容器22端口）
docker run -d -p 50000:22 --name pycharm-remote alicek106/pycharm-remote-builder:latest

Kubernetes部署

bash
kubectl apply -f kube-deployment.yaml

注：部署文件默认NodePort为30000，如需使用22端口需修改Kubernetes API Server参数（不推荐）。

Helm安装

bash
helm install -f chart/pycharm-remote-builder/values.yaml chart/pycharm-remote-builder/

贡献

欢迎社区成员提交代码改进或功能建议！