Jenkins Pipeline使用Filesystem List Parameter的语法及支持性咨询

Filesystem List Parameter 插件支持在Jenkins Pipeline中使用，两种常用Pipeline语法的使用示例如下：

1. 声明式Pipeline用法 #

pipeline {
    agent any
    parameters {
        filesystemListParameter(
            name: 'SELECTED_FILE',
            description: '选择目标路径下的指定文件',
            path: '/var/data/build/packages',
            pattern: '*.zip',
            defaultValue: '',
            sortOrder: 'ASC',
            reverse: false,
            caseInsensitive: false
        )
    }
    stages {
        stage('参数读取测试') {
            steps {
                echo "选中的文件为：${params.SELECTED_FILE}"
            }
        }
    }
}

2. 脚本式Pipeline用法 #

properties([
    parameters([
        filesystemListParameter(
            name: 'SELECTED_FILE',
            description: '选择目标路径下的指定文件',
            path: '/var/data/build/packages',
            pattern: '*.zip',
            defaultValue: '',
            sortOrder: 'ASC',
            reverse: false,
            caseInsensitive: false
        )
    ])
])

node {
    stage('参数读取测试') {
        echo "选中的文件为：${params.SELECTED_FILE}"
    }
}

常用配置参数说明 #

• name：必填，参数唯一标识，Pipeline中通过params.参数名读取选中值
• description：选填，参数选择页展示的说明文本
• path：必填，待扫描的文件/目录所在的Jenkins Agent节点本地路径
• pattern：选填，文件/目录匹配规则，支持通配符，不填默认返回路径下所有内容
• defaultValue：选填，参数默认选中值
• sortOrder：选填，排序规则，支持ASC（升序）、DESC（降序）、NONE（不排序）
• reverse：选填，是否反转排序结果，布尔类型
• caseInsensitive：选填，匹配规则是否忽略大小写，布尔类型

注意：首次在Pipeline中添加该参数后，需要执行一次Pipeline，参数才会正常展示在构建触发页的参数选择区域。

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