是否可以在共享库（Jenkins）的声明性管道中包含调用？

Question

正如您所知道的，在Jenkins的共享库中，可以在Jenkinsfile中调用vars文件夹中文件的内容。

例如，在共享库的vars文件夹中，我们可以有一个名为build的文件。groovy在Jenkins文件中，我们可以通过以下方式调用它：

build{parameter1=“some param1”parameter2=“some param2”}

如本节所述。使用groovy文件并使用Jenkins文件中的call（）方法调用它们，我没有任何问题。

但是我想定制一个管道，并使其尽可能通用。所以我想调用包含在vars文件夹中但在同一管道中的groovy文件：调用泛型tage.groovy在共享库中包含在相同vars文件夹中的其他文件中。

所以我在vars文件夹中有一个groovy文件：genericStage。groovy我拥有的是：

Pipeline{
 agent{label myNode}

 stages{

  stage("init"){
   //steps

  }

  genericStage{
   parameter1 = "some param"
  }

 }

}

在一般阶段：

def call(Closure body) {
def config = [:]
body.resolveStrategy = Closure.DELEGATE_FIRST
body.delegate = config
body()

stage(config.parameter1){
    steps{
        //steps
    }
}   

}

但是我得到了错误：

Expected a stage @ line 125, column 6.
                genericStage{
    ^

1 error

at org.codehaus.groovy.control.ErrorCollector.failIfErrors(ErrorCollector.java:310)
at org.codehaus.groovy.control.CompilationUnit.applyToPrimaryClassNodes(CompilationUnit.java:1085)

那么，如何在同一个共享库中调用Jenkins文件呢？

Answer 1

在像这样定义DSL风格步骤的共享库方法中，您可以定义一块步骤和脚本，这些步骤和脚本执行一些您需要在作业或整个管道中的作业或阶段之间共享的公共处理。所以你的通用舞台。groovy只能包含“//steps”注释后面的内容，不能包含这样的阶段和步骤定义。我用这里的风格做了很多这种类型的库自定义步骤，但没有尝试在其中定义stage/步骤，效果很好。这里发生的情况是，管道验证/解析器在处理自定义步骤之前就已经无法使用主管道语法，因为您没有将其包装在stage和steps定义中。

如果您阅读了最后的文档链接，其中有一节介绍如何在共享库中定义完整的声明性管道。最后，它说“到目前为止，只有整个管道s可以在共享库中定义。这只能在vars/*.groovy中完成，并且只能在调用方法中完成。在单个构建中只能执行一个声明性管道，如果您尝试执行第二个管道，您的构建将因此失败。”这意味着像您这样的部分管道将无法工作，您应该只有步骤/脚本或完整的管道。