Jenkins-Kubernetes环境下获取Slave节点Git仓库路径及文件排查

算力阿峰

2026-5-15

解决Jenkins Slave工作区路径与文件查看问题

我来帮你搞定这两个问题，之前在Kubernetes上部署Jenkins Slave时也踩过类似的路径坑，分享下实用的解决方法：

1. 如何列出Slave节点上的文件夹文件？

根据你的Slave节点系统类型（Linux/Windows），在Jenkins Pipeline中添加对应的shell命令步骤即可：

针对Linux/Unix Slave：

查看当前目录下的所有文件（含隐藏文件）：
```
sh 'ls -la'
```
递归查看工作区下的所有文件：
```
sh 'find ${WORKSPACE} -type f'
```
查看指定路径的文件（比如你怀疑的${WORKSPACE}）：
```
sh 'ls -la ${WORKSPACE}'
```

针对Windows Slave：

用cmd命令查看：
```
bat 'dir /s ${WORKSPACE}'
```

用PowerShell递归查看：

powershell 'Get-ChildItem -Path ${WORKSPACE} -Recurse'

2. 如何获取Slave节点的正确工作区路径？

Jenkins本身提供了WORKSPACE环境变量，但有时候因为Slave配置、Pipeline的agent设置（比如自定义工作区）会出现偏差，你可以通过以下方式确认：

直接打印工作区路径：

在Pipeline中添加步骤输出变量值：

echo "当前工作区路径：${WORKSPACE}"
// 或者用script块更灵活
script {
    println "Slave工作区路径：${env.WORKSPACE}"
}

确认当前所在目录：

执行系统命令查看当前路径，这是最直接的验证方式：

Linux Slave：
```
sh 'pwd'
```
Windows Slave：
```
bat 'cd'
```

针对Kubernetes Slave的额外提示：

如果你用的是Jenkins Kubernetes插件创建的Slave，默认工作区通常在容器的/home/jenkins/agent/workspace/<你的Job名称>路径下。另外要注意PVC挂载的路径是否正确，有时候克隆的代码会挂载到指定的PVC目录下，这时候可以结合df -h命令查看挂载点。

结合你的场景排查：

你提到克隆Git仓库后${WORKSPACE}/flowchart为空，建议先执行sh 'ls -la ${WORKSPACE}'确认Git克隆下来的文件结构——有可能仓库本身就没有flowchart文件夹，或者克隆时路径有嵌套（比如仓库被克隆到了${WORKSPACE}/<仓库名称>下），这时候你的chart_dir路径就需要调整为${WORKSPACE}/<仓库名称>/flowchart。

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

Jenkins-Kubernetes环境下获取Slave节点Git仓库路径及文件排查

1. 如何列出Slave节点上的文件夹文件？ #

针对Linux/Unix Slave： #

针对Windows Slave： #

2. 如何获取Slave节点的正确工作区路径？ #

直接打印工作区路径： #

确认当前所在目录： #

针对Kubernetes Slave的额外提示： #

结合你的场景排查： #