如何在Jenkins声明式流水线矩阵中设置动态阶段名称？

问题原因 #

声明式流水线对语法有严格限制，stage的名称必须是静态字符串字面量，不允许直接在stage()的括号中使用变量插值（比如${appName}），这就是你遇到Expected string literal错误的原因。

解决方法 #

要在Matrix结构中生成包含appName变量的动态阶段名，需要借助脚本式流水线的灵活性，将动态阶段嵌套在script块中。

示例代码 #

pipeline {
    agent any
    stages {
        stage('Matrix Build') {
            matrix {
                axes {
                    axis {
                        name 'appName'
                        values 'foo', 'bar'
                    }
                }
                stages {
                    // 外层声明式阶段作为容器，内部用脚本式实现动态命名
                    stage('Dynamic Stage Wrapper') {
                        steps {
                            script {
                                // 这里可以使用变量插值生成动态阶段名
                                stage("Prepare ${appName}") {
                                    steps {
                                        echo "正在准备应用: ${appName}"
                                        // 这里添加你的准备步骤，比如拉取代码、安装依赖等
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}

说明 #

• 外层的Dynamic Stage Wrapper是一个静态命名的声明式阶段，用于符合Matrix结构的语法要求。
• 内部的script块中使用脚本式流水线的stage语法，支持通过${appName}动态生成阶段名称。
• 运行后，Matrix会为每个appName值（foo、bar）生成对应的Prepare foo和Prepare bar阶段。

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