关于Jenkins Pipeline内置代理未创建工作目录的原因咨询

原因分析 #

• 内置代理（主节点代理）的工作目录初始化逻辑和普通节点代理存在差异：普通节点代理会在作业启动时自动创建对应工作目录，但内置代理仅在有实际文件写入操作时才会生成工作目录。你执行echo "hello, world" > txt.txt的操作触发了文件写入，因此目录被自动创建，后续复制操作得以正常执行。
• 被委托作业尝试复制文件时，委托作业的工作目录尚未完成初始化（无任何写入操作触发目录创建），所以cp命令会提示目标目录不存在。

解决方法 #

1. 提前主动初始化工作目录 #

在委托作业的Pipeline最开始，执行简单的目录创建操作，确保目录提前存在：

mkdir -p "${WORKSPACE}"

或者用更轻量的方式，仅触发目录创建后清理临时标记文件：

touch "${WORKSPACE}/.init-marker" && rm "${WORKSPACE}/.init-marker"

2. 调整Pipeline执行顺序 #

在调用被委托作业前，先完成工作目录初始化步骤，示例Pipeline代码：

pipeline {
  agent { label '' } // 内置代理配置
  stages {
    stage('初始化工作目录') {
      steps {
        sh 'mkdir -p "${WORKSPACE}"'
      }
    }
    stage('调用委托作业') {
      steps {
        build job: '目标委托作业名', parameters: [string(name: 'PARAM1', value: 'xxx')]
      }
    }
  }
}

3. 在被委托作业中添加目录检查 #

在执行cp命令前，先检查并创建目标目录，避免依赖委托作业的目录状态：

TARGET_DIR="/path/to/delegate-job-workspace"
mkdir -p "$TARGET_DIR" && cp result.txt "$TARGET_DIR"

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