清理 Jenkins 工作区但保持 Python .venv 完整

这个问题与在 Jenkins 管道中使用 Python + Poetry 项目以及如何保留.venv/

设想：

我有一个触发 Python 项目的 Jenkins Pipeline 作业。该项目使用诗歌在工作空间内的 .venv 中创建虚拟环境。每次后续作业运行，它将按预期重新使用 .venv ，因此每个 pip 包不需要在每次运行时重新下载（除非poetry.lock 文件中有差异）。一切都按预期工作。

我想使用 Jenkins Workspace Cleanup Plugin 对管道进行更改，我想破坏工作区文件但保留一些文件，包括 pip/poetry/venv 环境文件。这是为了允许它重新使用上一次运行中仍然存储在 .venv 中的 pip 包——就像它在今天的工作管道上一样。

完整的管道文件示例在这篇文章的底部，但这是我添加到现有管道中的 cleanWs() 部分的片段：

post {
  always {
    cleanWs(
      deleteDirs: true,
      notFailBuild: true,
      patterns: [
        [pattern: '.venv', type: 'EXCLUDE'],
        [pattern: '.venv/**', type: 'EXCLUDE']
      ]
    )
  }
}

这是问题：

• 作业第一次运行时，它工作得非常好，工作区清理工作按预期工作。该.venv/目录按预期保留。

• （问题）在作业的后续运行中，诗歌将重新安装所有包并且不会重新使用 .venv 目录：

  Creating virtualenv test in /data/jenkins_home/workspace/test-cleanup/.venv-- 这会强制重新下载每个包，即使.venv已经存在。在作业运行之前已确认/data/jenkins_home/workspace/test-cleanup/.venv已存在。

• 这是奇怪的部分：如果我在 Jenkins 服务器上手动转到工作区目录并运行与预期完全相同的命令 ，它会被重用并且不会重新安装所有包。因此，它在作业中运行的处理方式有一些特定的内容，这使得它想要重新创建 .venv 目录。poetry install.venv

注意in-project = true已经为诗歌设置。所以它总是会尝试在当前工作目录中使用 .venv 。

例子：

这是一个按预期工作的简单示例管道。当poetry installstep 运行时，它不会在每次作业运行时重新下载所有包，只有第一次，或者如果有差异：

pipeline {

  agent any

  stages {

    stage("Prep Build Environment") {
      steps {

        script {
          scmVars = git branch: "main", poll: false, url: "[email protected]:my-org/private-repo.git"
        }

        sh "poetry install"
      }
    }
  }
}

这是添加的新Jenkinsfile 管道文件cleanWs()。添加后，项目将不再在每次运行时重新使用 .venv，即使它仍然存在：

pipeline {

  agent any

  stages {

    stage("Prep Build Environment") {
      steps {

        script {
          scmVars = git branch: "main", poll: false, url: "[email protected]:my-org/private-repo.git"
        }

        sh "poetry install"
      }
    }
  }

  post {
    always {
      cleanWs(
        deleteDirs: true,
        notFailBuild: true,
        patterns: [
          [pattern: '.venv', type: 'EXCLUDE'],
          [pattern: '.venv/**', type: 'EXCLUDE']
        ]
      )
    }
  }

}