如何在Jenkins流水线中创建CIFS Share配置并自定义cifsPublisher参数

一、直接内联主机/凭证/共享配置实现 #

Jenkins CIFS Publisher插件原生支持两种配置模式：引用全局预定义configName、直接内联config参数块，你需求的配置方式可以直接落地，注意以下几点即可：

1. 域用户的用户名需要用双反斜杠转义，格式为域名\\用户名
2. 禁止明文硬编码密码，优先通过Jenkins凭证管理器存储凭证，用凭证ID绑定后引用
3. 保证你的CIFS Publisher插件版本 ≥ 1.37，该版本开始正式支持内联配置

可用的Pipeline配置示例：

// 优先用凭证绑定获取敏感信息，不要明文写在代码中
withCredentials([usernamePassword(credentialsId: '你的CIFS凭证ID', usernameVariable: 'CIFS_USER', passwordVariable: 'CIFS_PWD')]) {
    cifsPublisher(publishers: [
        [
            config: [
                hostName: '192.168.xxx.xxx', // 目标主机IPv4
                user: CIFS_USER,
                password: CIFS_PWD,
                share: 'baseDirectory' // 共享根目录
            ],
            transfers: [
                [
                    cleanRemote: true,
                    excludes: '',
                    flatten: false,
                    makeEmptyDirs: false,
                    noDefaultExcludes: false,
                    patternSeparator: '[, ]+',
                    remoteDirectory: "/public/",
                    remoteDirectorySDF: false,
                    removePrefix: '/share',
                    sourceFiles: "share/**"
                ]
            ],
            usePromotionTimestamp: false,
            useWorkspaceInPromotion: false,
            verbose: true
        ]
    ])
}

二、大规模CIFS配置管理优化方案 #

针对你业务持续增长、CIFS配置越来越多的痛点，可以用以下方案降低管理成本：

• 封装Jenkins共享库公共方法：把重复的传输配置、参数校验逻辑都抽成公共方法，业务任务调用时只需要传差异参数（主机、凭证ID、共享目录、源文件路径、目标路径）即可，单任务配置代码可以缩短到10行以内
  示例调用形式：

// 共享库封装后的调用，仅需要传差异参数
customCifsPublish(
    host: '192.168.1.101',
    credentialId: 'biz-cifs-creds',
    share: 'biz-share',
    source: 'dist/**',
    targetDir: '/release/v1.0.0/'
)

• 配置中心化存储：把所有CIFS目标的配置信息（主机、共享名、凭证ID、路径规则）统一存在YAML/JSON配置文件里，和业务代码同仓管理，新增CIFS目标只需要修改配置文件，不需要调整Jenkins任务逻辑
• 凭证统一管理：所有CIFS凭证都存在Jenkins凭证管理器，按业务/权限分组，只通过ID引用，避免凭证泄露，也方便定期轮换凭证

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