如何在Jenkins Pipeline（agent none模式）中定义环境变量？

我来帮你拆解这两个问题的根源，然后给出正确的实现方案：

问题1：environment块中放置agent any的语法错误 #

你把agent any放在environment块里是完全错误的——environment块的唯一作用是定义环境变量的键值对，它不接受agent配置语句。Jenkins会把agent any当成无效的环境变量表达式，所以抛出语法错误。

问题2：缺失hudson.Launcher上下文的错误 #

当你移除agent any后，顶层agent none意味着整个Pipeline默认没有执行节点，而Print Debug Vars阶段里的sh步骤必须在某个agent节点上运行（需要hudson.Launcher上下文来执行shell命令），如果这个阶段没有指定agent，Jenkins找不到执行环境，就会抛出这个异常。

正确的Pipeline实现方案 #

根据你的需求，这里提供两种可行的写法：

方案1：顶层agent none，每个stage单独指定agent #

适合每个stage需要不同agent节点的场景：

#!/bin/groovy
pipeline {
    agent none // 全局不指定默认agent，每个stage自行声明
    environment {
        // environment块只保留环境变量定义
        INSTANCE_NAME = "Jenk"
    }
    stages {
        stage("Print Debug Vars"){
            agent any // 给这个stage指定任意可用agent，用来执行sh步骤
            steps {
                sh 'echo "INSTANCE_NAME is $INSTANCE_NAME"'
            }
        }
        stage("Git Checkout") {
            agent { label 'docker' } // 使用带docker标签的节点
            steps { 
                // 这里添加git checkout的具体步骤，例如：
                // git url: 'https://your-repo-url.git', branch: 'main'
            }
        }
        stage("Ansible Galaxy"){
            agent { label 'ansible' } // 使用带ansible标签的节点
            steps { 
                // 这里添加Ansible Galaxy的操作步骤，例如：
                // sh 'ansible-galaxy install -r requirements.yml'
            }
        }
    }
}

方案2：顶层指定默认agent，特定stage覆盖配置 #

如果大部分stage可以使用任意agent，只有少数需要特定标签节点，推荐这种写法：

#!/bin/groovy
pipeline {
    agent any // 全局默认使用任意可用agent
    environment {
        INSTANCE_NAME = "Jenk"
    }
    stages {
        stage("Print Debug Vars"){
            steps {
                // 直接使用全局默认agent执行sh步骤
                sh 'echo "INSTANCE_NAME is $INSTANCE_NAME"'
            }
        }
        stage("Git Checkout") {
            agent { label 'docker' } // 覆盖全局配置，使用带docker标签的节点
            steps { 
                // ... git checkout步骤
            }
        }
        stage("Ansible Galaxy"){
            agent { label 'ansible' } // 覆盖全局配置，使用带ansible标签的节点
            steps { 
                // ... Ansible操作步骤
            }
        }
    }
}

关键注意事项 #

• 所有包含运行时步骤（sh、git、ansible等）的stage，必须显式指定agent（要么继承顶层的agent配置，要么自己声明）。
• environment块只能用来定义KEY = VALUE格式的环境变量，不要放任何其他配置语句。

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