Jenkins文件夹项目[编辑 | 编辑源代码]

介绍[编辑 | 编辑源代码]

Jenkins文件夹项目（Jenkins Folders）是一种用于组织和管理Jenkins任务的层级结构功能。它允许用户将多个任务（如自由风格项目、流水线项目等）分组到逻辑文件夹中，从而提高任务管理的清晰度和可维护性。文件夹可以嵌套，支持权限控制，并能够为子文件夹和任务继承父文件夹的配置。

文件夹项目特别适用于以下场景：

大型项目或团队需要按模块、环境或团队划分任务。
需要为不同文件夹设置不同的权限（如开发团队仅能访问开发环境任务）。
通过层级结构减少任务列表的复杂度。

核心功能[编辑 | 编辑源代码]

1. 层级组织[编辑 | 编辑源代码]

文件夹支持嵌套结构，例如：

2. 权限继承[编辑 | 编辑源代码]

通过Jenkins的Role-Based Strategy插件，可以为文件夹配置独立的权限（如读取、运行、配置）。子文件夹和任务默认继承父文件夹的权限。

3. 共享配置[编辑 | 编辑源代码]

在文件夹级别可以定义共享的库（如Pipeline共享库）或环境变量，子任务自动继承这些配置。

创建文件夹项目[编辑 | 编辑源代码]

通过UI创建[编辑 | 编辑源代码]

1. 在Jenkins首页点击New Item。 2. 输入名称并选择Folder类型。 3. 点击OK并保存。

通过Pipeline脚本创建[编辑 | 编辑源代码]

使用Jenkins的DSL（领域特定语言）动态创建文件夹：

  
// 创建文件夹  
folder('Backend') {  
    displayName('Backend Services')  
    description('所有后端相关任务')  
}  

// 在文件夹内创建任务  
pipelineJob('Backend/API-Tests') {  
    definition {  
        cps {  
            script(readFileFromWorkspace('api-tests.jenkinsfile'))  
            sandbox()  
        }  
    }  
}

实际案例[编辑 | 编辑源代码]

案例1：按环境组织任务[编辑 | 编辑源代码]

假设项目有开发（Dev）、测试（Test）、生产（Prod）三个环境，每个环境包含构建、测试、部署任务：

案例2：团队权限隔离[编辑 | 编辑源代码]

为文件夹`Team-A`配置权限，仅允许`team-a`组的成员访问。
使用以下脚本限制权限（需安装Role-Based Strategy插件）：

  
import com.michelin.cio.hudson.plugins.rolestrategy.RoleBasedAuthorizationStrategy  
import hudson.security.ProjectMatrixAuthorizationStrategy  

// 分配权限  
def strategy = new RoleBasedAuthorizationStrategy()  
strategy.addRole('team-a', 'Team-A/*', ['Job/Read', 'Job/Build'])  
Jenkins.instance.setAuthorizationStrategy(strategy)

高级用法[编辑 | 编辑源代码]

动态文件夹生成[编辑 | 编辑源代码]

结合Jenkins Job DSL插件，根据外部输入（如Git仓库列表）动态生成文件夹和任务：

  
def repos = ['service-auth', 'service-payment', 'service-order']  

repos.each { repo ->  
    folder("Microservices/${repo}") {  
        description("${repo}微服务任务")  
    }  

    pipelineJob("Microservices/${repo}/build") {  
        definition {  
            cpsScm {  
                scm {  
                    git("git@github.com:myorg/${repo}.git")  
                }  
                scriptPath('Jenkinsfile')  
            }  
        }  
    }  
}

文件夹属性扩展[编辑 | 编辑源代码]

通过`properties`块为文件夹添加自定义属性（如日志保留策略）：

  
folder('Logs') {  
    properties {  
        logRotator {  
            daysToKeep(30)  
            numToKeep(100)  
        }  
    }  
}

常见问题[编辑 | 编辑源代码]

Q: 文件夹和视图（View）有何区别？

文件夹是物理层级，影响任务的实际路径（如`Backend/Deploy`）。
视图是逻辑分组，仅用于筛选显示（如“所有测试任务”）。

Q: 如何批量迁移任务到文件夹？ 使用Jenkins CLI或REST API：

  
# 移动任务到文件夹  
curl -X POST "http://jenkins/job/TaskName/move?newName=Folder/TaskName"

总结[编辑 | 编辑源代码]

Jenkins文件夹项目是管理复杂任务集的核心工具，通过层级化、权限控制和配置共享显著提升可维护性。结合Pipeline和DSL，还能实现自动化的大规模任务编排。