如何从外部文件加载Jenkins参数，统一管理Landscape选项？

针对你有100多个Jenkinsfile需要统一维护Landscape选项的问题，推荐两种无需逐个修改文件的方案：

方案一：使用Jenkins共享库（推荐） #

这是Jenkins官方推荐的代码复用方式，适合大规模流水线场景：

1. 创建共享库
   在Jenkins中配置一个共享库（路径：系统管理 → 全局工具配置 → 配置共享库），然后在共享库的vars目录下新建getLandscapeChoices.groovy文件，内容如下：

   def call() {
       // 统一维护所有Landscape选项，新增/删除直接修改此处
       return ['DEV', 'TEST', 'PROD', 'UAT'].join('\n')
   }
   

2. 修改Jenkinsfile引用共享库
   每个Jenkinsfile顶部引入共享库，然后在参数中调用这个方法：

   @Library('你的共享库名称') _
   
   pipeline {
       agent any
   
       options {
           timeout(time: 2, unit: 'HOURS')
       }
   
       parameters {
           choice(
               name: 'Landscape',
               choices: getLandscapeChoices(), // 替换为共享库方法
               description: 'Landscape'
           )
       }
       stages {
           // 你的流水线阶段逻辑
       }
   }
   

   以后要新增选项，只需要修改共享库中的getLandscapeChoices.groovy，所有Jenkinsfile会自动同步更新，完全不用逐个修改文件。

方案二：使用Jenkins全局环境变量 #

如果不想搭建共享库，也可以用全局环境变量实现：

1. 配置全局环境变量
   登录Jenkins后台，进入「系统管理」→「系统配置」→「全局属性」，勾选「环境变量」，新增一个变量：

   • 名称：LANDSCAPE_CHOICES
   • 值：DEV\nTEST\nPROD\nUAT（用\n分隔选项）

2. 修改Jenkinsfile引用环境变量
   在每个Jenkinsfile的参数中直接引用这个环境变量：

   pipeline {
       agent any
   
       options {
           timeout(time: 2, unit: 'HOURS')
       }
   
       parameters {
           choice(
               name: 'Landscape',
               choices: "${env.LANDSCAPE_CHOICES}", // 引用全局环境变量
               description: 'Landscape'
           )
       }
       stages {
           // 你的流水线阶段逻辑
       }
   }
   

   这种方式无需搭建共享库，但需要Jenkins管理员权限，且选项变更时要修改全局配置，灵活性不如共享库。

关键提示 #

不要尝试直接在parameters块中读取外部文件——因为参数是在流水线启动之前解析的，此时Jenkins还未创建工作区，无法读取任何文件，这也是你之前用Groovy方法失败的核心原因。

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