如何在Ubuntu Jenkins流水线服务器配置Python虚拟环境并解决相关问题？

一、修复Python虚拟环境创建失败问题 #

当前报错是因为Ubuntu系统缺少python3-venv包，导致ensurepip不可用，按以下步骤解决：

1. 在Jenkins服务器上安装依赖包
   登录到Ubuntu服务器，执行以下命令：

   sudo apt update
   sudo apt install python3.10-venv python3-pip -y
   

   注意：如果Jenkins使用的Python版本不是3.10，替换为对应版本的包（比如python3.8-venv），可通过python3 --version查看当前Python版本。

2. 优化Jenkins流水线脚本
   修改后的脚本加入依赖升级和单独的依赖安装阶段，确保虚拟环境正常工作：

   pipeline {
       agent any
   
       stages {
           stage('Setup Virtual Environment') {
               steps {
                   sh '''
                       # 升级ensurepip确保可用
                       python3 -m ensurepip --upgrade
                       # 创建虚拟环境
                       python3 -m venv venv
                   '''
               }
           }
   
           stage('Install Dependencies') {
               steps {
                   sh '''
                       . venv/bin/activate && pip install --upgrade pip
                       # 在此添加测试脚本所需的依赖安装命令，例如：
                       # . venv/bin/activate && pip install pytest requests
                   '''
               }
           }
   
           stage('Run Tests') {
               steps {
                   sh '. venv/bin/activate && python test_sign_in.py'
               }
           }
       }
   
       post {
           always {
               // 可选：执行完成后清理虚拟环境
               sh 'rm -rf venv'
           }
       }
   }
   

二、解决Jenkins提示“docker not found”问题 #

1. 确认Docker安装并配置Jenkins用户权限

   • 先检查服务器是否安装Docker，未安装则执行：

     sudo apt update
     sudo apt install docker.io -y
     sudo systemctl enable --now docker
     

   • 将Jenkins用户加入docker组，使其无需sudo即可调用Docker：

     sudo usermod -aG docker jenkins
     

   • 重启Jenkins服务使权限生效：

     sudo systemctl restart jenkins
     

2. 验证Docker插件配置（若使用插件）
   若已安装Jenkins Docker插件，进入全局工具配置，确认Docker的安装路径设置为/usr/bin/docker（默认路径）。

内容的提问来源于stack exchange，提问作者rana