Jenkins Groovy脚本数组迭代变量在Shell命令内无值问题排查

核心问题在于Groovy变量无法直接在Shell块中引用——Shell块是独立的子进程，Groovy的局部变量不会自动传递到Shell环境中。而aws_region能正常使用，大概率是你在调用Shell时已经通过Groovy字符串插值（双引号包裹）传递了该变量，而instance_id没有做同样的处理。

以下是两种可靠的解决方式：

1. 使用Groovy字符串插值（双引号包裹Shell命令） #

Groovy的双引号字符串支持变量插值，会先将Groovy变量替换为实际值，再把完整命令传递给Shell执行。注意如果Shell命令本身包含双引号，需要用反斜杠转义，避免和Groovy的外层双引号冲突。

示例修改后的代码：

def getEarliestLaunchTime(String asgName, String aws_region) {
    // 获取ASG实例ID数组
    def instanceIds = sh(
        script: "aws autoscaling describe-auto-scaling-groups --auto-scaling-group-names ${asgName} --region ${aws_region} --query 'AutoScalingGroups[0].Instances[].InstanceId' --output text",
        returnStdout: true
    ).trim().split('\t')

    for (instance_id in instanceIds) {
        println "当前实例ID：${instance_id}" // Groovy层正常打印
        // 用双引号包裹Shell命令，让Groovy插值instance_id变量
        def launchTime = sh(
            script: "aws ec2 describe-instances --instance-ids ${instance_id} --region ${aws_region} --query \"Reservations[0].Instances[0].LaunchTime\" --output text",
            returnStdout: true
        ).trim()
        println "实例${instance_id}启动时间：${launchTime}"
    }
}

2. 通过Jenkins环境变量传递 #

将Groovy的instance_id赋值给Jenkins的env全局环境变量，这样Shell进程会继承该环境变量，直接用$INSTANCE_ID即可引用。这种方式适合复杂Shell命令，避免频繁转义引号。

示例修改后的代码：

def getEarliestLaunchTime(String asgName, String aws_region) {
    def instanceIds = sh(
        script: "aws autoscaling describe-auto-scaling-groups --auto-scaling-group-names ${asgName} --region ${aws_region} --query 'AutoScalingGroups[0].Instances[].InstanceId' --output text",
        returnStdout: true
    ).trim().split('\t')

    for (instance_id in instanceIds) {
        println "当前实例ID：${instance_id}"
        // 把Groovy变量注入到Jenkins环境变量
        env.INSTANCE_ID = instance_id
        // Shell中直接引用环境变量$INSTANCE_ID
        def launchTime = sh(
            script: 'aws ec2 describe-instances --instance-ids $INSTANCE_ID --region ${aws_region} --query "Reservations[0].Instances[0].LaunchTime" --output text',
            returnStdout: true
        ).trim()
        println "实例${instance_id}启动时间：${launchTime}"
    }
}

注意事项 #

• 如果使用双引号插值，Shell命令中的特殊字符（如空格、双引号）需要用反斜杠转义，防止Groovy解析出错。
• 使用环境变量方式时，env是全局变量，若流水线存在并行执行逻辑，需注意变量被覆盖的风险（串行循环场景下无此问题）。

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