贝利信息

NEWS CENTER 新闻中心

Python自动化部署项目教程_JenkinsGitHubActions实战

日期：2026-01-02 00:00 / 作者：舞姬之光
上一篇 下一篇
Jenkins适合需灵活控制流程的Python项目，通过Jenkinsfile实现多环境自动化部署；GitHub Actions更轻量，适合GitHub托管的小型项目；部署前须检查依赖锁定、配置分离、启动脚本和.gitignore遗漏。

用 Jenkins 实现 Python 项目的自动化部署

Jenkins 是最成熟的 CI/CD 工具之一，适合需要灵活控制构建流程、多环境部署（如测试服/预发服/生产服）的 Python 项目。核心是把“代码提交 → 测试 → 打包 → 部署”这一串操作写成可重复执行的流水线。

关键准备动作：

pipeline {
    agent any
    environment {
        PYTHONPATH = "${WORKSPACE}"
    }
    stages {
        stage('Checkout') {
            steps { checkout scm }
        }
        stage('Install Dependencies') {
            steps { sh 'pip install -r requirements.txt' }
        }
        stage('Run Tests') {
            steps { sh 'pytest tests/ --tb=short' }
        }
        stage('Deploy to Staging') {
            when { branch 'develop' }
            steps { sh 'rsync -avz --delete ./ user@staging-server:/opt/myapp/' }
        }
        stage('Deploy to Production') {
            when { branch 'main' }
            steps { 
                input message: 'Deploy to production?', ok: 'Yes, proceed'
                sh 'rsync -avz --delete ./ user@prod-server:/opt/myapp/'
            }
        }
    }
}

注意：生产部署加了人工确认步骤，避免误触发；Python 服务建议配合 systemd 或 supervisor 管理进程启停。

用 GitHub Actions 替代 Jenkins 的轻量方案

如果你的项目托管在 GitHub、团队规模不大、不想维护 Jenkins 服务器，GitHub Actions 更简单直接——所有配置写在 .github/workflows/deploy.yml 里，无需额外运维。

一个典型的 Python Web 应用（如 Flask）自动部署示例：

name: Deploy to Server
on:
  push:
    branches: [main]

jobs:
deploy:
runs-on: ubuntu-latest
steps:
  • uses: actions/checkout@v4
  • name: Set up Python
uses: actions/setup-python@v5
with:
python-version: '3.11'
  • name: Install dependencies
run: pip install -r requirements.txt
  • name: Run tests
run: pytest tests/
  • name: Deploy via SSH
uses: appleboy/scp-action@v0.1.7
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.PRIVATE_KEY }}
source: "."
target: "/home/ubuntu/myapp/"
  • name: Restart service
uses: appleboy/ssh-action@v0.1.8
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USERNAME }}
key: ${{ secrets.PRIVATE_KEY }}
script: |
cd /home/ubuntu/myapp
git pull origin main
sudo systemctl restart myapp.service

敏感信息（如服务器密码或私钥）必须存为 GitHub 仓库的 Secrets，不可硬编码。

Python 项目部署前必须检查的 4 件事

不管用 Jenkins 还是 GitHub Actions，自动化部署失败往往源于本地疏忽。上线前快速核对：

常见问题与绕过技巧

实际跑通自动化部署常卡在这几个点：