如何在Ubuntu上配置Python持续集成（CI）
持续集成（CI）是Python项目开发中的关键环节，通过自动化测试、依赖管理和代码质量检查，确保代码变更的可靠性。以下是在Ubuntu系统上配置Python CI的详细步骤，涵盖环境准备、工具选择及具体实现：
一、前置准备：Ubuntu环境配置
在配置CI之前，需确保Ubuntu系统具备基础的Python开发环境，包括Python解释器、包管理工具及虚拟环境。
1. 安装Python 3与pip
Ubuntu 20.04及以上版本默认安装Python 3.8+，可通过以下命令验证：
python3 --version # 查看Python版本
pip3 --version # 查看pip版本
若未安装，执行以下命令安装：
sudo apt update
sudo apt install -y python3 python3-pip
2. 安装虚拟环境工具
虚拟环境可隔离项目依赖，避免全局包冲突。安装python3-venv模块：
sudo apt install -y python3-venv
3. 创建并激活虚拟环境
在项目目录中创建虚拟环境（如myenv），并激活：
python3 -m venv myenv # 创建虚拟环境
source myenv/bin/activate # 激活环境（激活后命令行前缀显示虚拟环境名）
激活后，所有后续操作均在虚拟环境中进行。
二、选择持续集成工具
Ubuntu上常用的Python CI工具包括GitHub Actions（云端集成，无需自建服务器）、Jenkins（自托管，灵活扩展）及GitLab CI（适合GitLab仓库）。以下以GitHub Actions（最简配置）和Jenkins（自定义流程）为例说明。
三、使用GitHub Actions配置Python CI
GitHub Actions是GitHub提供的CI/CD服务，通过.github/workflows目录下的YAML文件定义流程。
1. 创建GitHub仓库
将Python项目推送到GitHub仓库（如yourusername/yourproject）。
2. 添加CI配置文件
在项目根目录创建.github/workflows/main.yml文件，内容如下：
name: Python CI # 流水线名称
on: # 触发条件（代码推送或PR时运行）
push:
branches: [ main ] # 主分支推送时触发
pull_request:
branches: [ main ] # PR到主分支时触发
jobs:
build: # 定义任务
runs-on: ubuntu-latest # 使用Ubuntu最新版作为运行环境
steps:
- name: Checkout code # 步骤1：拉取代码
uses: actions/checkout@v2
- name: Set up Python # 步骤2：设置Python版本
uses: actions/setup-python@v2
with:
python-version: '3.8' # 指定Python版本（需与项目要求一致）
- name: Install dependencies # 步骤3：安装依赖
run: |
python -m pip install --upgrade pip # 升级pip
pip install -r requirements.txt # 安装项目依赖
- name: Run tests # 步骤4：运行测试
run: |
pytest # 使用pytest运行测试（需项目已安装pytest）
3. 提交配置并触发CI
将.github/workflows/main.yml提交到GitHub仓库，推送代码或发起PR时，GitHub会自动运行CI流程。可在仓库的“Actions”标签页查看实时日志。
四、使用Jenkins配置Python CI
Jenkins是开源CI工具，需自建服务器（Ubuntu），适合需要自定义流程的项目。
1. 安装Jenkins
在Ubuntu上安装Jenkins：
wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt update
sudo apt install -y jenkins
sudo systemctl start jenkins # 启动Jenkins服务
sudo systemctl enable jenkins # 开机自启
访问http://，按提示完成初始配置（获取管理员密码并安装推荐插件）。
2. 安装必要插件
进入Jenkins“Manage Jenkins”→“Manage Plugins”，安装以下插件：
- Git（拉取代码）
- Pipeline（定义流水线）
- Python（可选，提供Python相关步骤）
3. 创建Pipeline Job
- 点击“New Item”，输入Job名称（如
Python-CI），选择“Pipeline”，点击“OK”。 - 在“Pipeline”配置页，选择“Pipeline script from SCM”（从SCM获取流水线脚本）。
- 设置SCM为“Git”，填写仓库URL（如
https://github.com/yourusername/yourproject.git）。 - 在“Script Path”中输入流水线脚本路径（如
Jenkinsfile，需在项目根目录创建）。
4. 编写Jenkinsfile
在项目根目录创建Jenkinsfile，定义流水线流程：
pipeline {
agent any // 使用任意可用节点
tools {
python 'Python3.8' // 指定Python版本（需提前在Jenkins中配置）
}
stages {
stage('Checkout') {
steps {
git branch: 'main', url: 'https://github.com/yourusername/yourproject.git' // 拉取代码
}
}
stage('Set up Python') {
steps {
sh 'python -m pip install --upgrade pip' // 升级pip
}
}
stage('Install Dependencies') {
steps {
sh 'pip install -r requirements.txt' // 安装依赖
}
}
stage('Run Tests') {
steps {
sh 'pytest' // 运行测试
}
}
}
post {
always {
echo 'CI process completed.' // 流水线结束后输出信息
}
}
}
5. 运行Pipeline
保存配置后，点击“Build Now”手动触发流水线，或在代码推送时自动触发（需配置Webhook）。可在“Build History”中查看执行结果。
五、关键注意事项
- 依赖管理：确保项目根目录有
requirements.txt文件（可通过pip freeze > requirements.txt生成），避免依赖遗漏。 - 测试框架：推荐使用
pytest（轻量高效），也可使用unittest（Python内置）。需在虚拟环境中安装测试框架：pip install pytest - 环境隔离：CI流程中务必使用虚拟环境，防止依赖冲突。
- 通知机制：可配置邮件、Slack等通知，及时获取CI结果（如Jenkins的“Post-build Actions”）。
- 缓存优化：对于频繁安装的依赖（如
pip包），可使用工具（如GitHub Actions的actions/cache）缓存，减少构建时间。
通过以上步骤，即可在Ubuntu上为Python项目配置高效的持续集成流程，确保代码质量与开发效率。
以上就是关于“如何在Ubuntu上配置Python持续集成”的相关介绍，筋斗云是国内较早的云主机应用的服务商，拥有10余年行业经验，提供丰富的云服务器、租用服务器等相关产品服务。云服务器资源弹性伸缩，主机vCPU、内存性能强悍、超高I/O速度、故障秒级恢复；电子化备案，提交快速，专业团队7×24小时服务支持！
简单好用、高性价比云服务器租用链接：https://www.jindouyun.cn/product/cvm