从 Jenkinsfile 中的共享库导入类

我有一个具有以下结构的共享库存储库：

(root)
+- src             
|   +- com
|       +- company
|           +- DeploySteps.groovy
+- vars
|   +- MainDeploySteps.groovy

该库通过 Jenkinsfile 导入到作业中，如下所示：

library identifier: 'jenkinslib@master', retriever: modernSCM(
     [$class       : 'GitSCMSource',
      remote       : '[email protected] /cdn-cgi/l/email-protection:jenkinslib.git',
      credentialsId: 'jenkins-credentials'])

src/com/company/DeploySteps.groovy 中的存储库中的类有一个方法（例如 CheckoutSCM），我希望将其包含在 Jenkinsfile 中。

部署步骤.groovy：

def CheckoutSCM() {
    useful steps here
}

是否有可能在 Jenkinsfile 中包含此特定方法，例如

import com.company.DeploySteps

然后像这样使用它：

CheckoutSCM('repo-here')

稍后在 Jenkinsfile 中？我读文档 https://jenkins.io/doc/book/pipeline/shared-libraries/很多次但没有找到答案是否可以从src文件夹，不仅来自vars.

为什么我问因为现在导入时：import com.company.DeployUtils然后尝试调用方法CheckoutSCM()查看 Jenkins 控制台输出中的错误：

java.lang.NoSuchMethodError：找不到这样的 DSL 方法“CheckoutSCM” 步骤之间

下面列出了可用的方法，其中没有我的CheckoutSCM一定）

那么，是否有可能导入类src文件夹到 Jenkinsfile？

附：我可以在 Jenkinsfile MainDeploySteps 中访问

MainDeploySteps {}

不过没有任何问题。

我只是想添加一个答案来解决 OP 和后续评论中的几个问题。

我是否正确理解您的共享库仅公开“vars”目录中的全局变量，以将该变量包含到 Jenkinsfile 中？虽然尝试直接从“src”文件夹将其他任何内容包含到 Jenkinsfile 中并不是它的设计方式，因为“src”类旨在包含“vars”目录中的变量。

首先让我介绍一下共享库的背景知识。有 2 种类型称为动态共享库 https://www.jenkins.io/doc/book/pipeline/shared-libraries/#loading-libraries-dynamically（定义使用library步骤）和全局共享库 https://www.jenkins.io/doc/book/pipeline/shared-libraries/#automatic-shared-libraries（在 Jenkins 全局配置中定义并使用@Library注解）。两者之间的两个重要区别是：

• 沙箱限制不适用于全局共享库中的代码，因为此类库中的代码被视为trusted（毕竟是管理员全局配置的）。动态共享库的情况并非如此，因为它们是由用户定义的，因此不可信。
• 全局共享库中的类可以静态引用Jenkinsfile并作为编译的一部分得到解决Jenkinsfile，但这对于动态共享库是不可能的，因为这些库是在运行时定义的，并且类在编译时无法进行交叉检查。

来到OP，它使用动态共享库概念，这意味着类不能被静态引用。然而，动态共享库中有一些可以利用的功能。这些详细信息可以在文档中找到，但这里是一个摘要：

• library步骤返回库的表示形式，可以将其分配给变量以供进一步使用，例如def myLib = library identifier: ...
• 可以使用库对象上的完全限定名称来引用类，例如def myCls = myLib.com.mycom.mypkg.MyClass
• 您收到的不是实际的 Groovy 类，而是一个类似代理的对象，只允许对底层类进行有限的操作。
• 您可以使用实例化一个新实例new功能和它的工作原理非常相似new操作员。您传递的参数与传递给构造函数的参数相同，例如，myCls.new(arg1, arg2)
• 您可以获取静态变量（尽管无法设置它）或使用代理对象调用静态方法，就像它是真正的类一样。如果您使用实例化对象new无论如何，您也可以通过实例访问静态成员（正常的 Groovy 语义适用）。

在这两种类型的库中，var 文件使用相同的机制公开（也称为全局变量和自定义步骤），因此使用上没有区别。此外，var 文件在库的上下文中执行，因此在 var 文件中，您不需要特殊的语法来访问类，无论它们是在全局库还是动态共享库中。

现在要回答OP中的真正问题，可以调用CheckoutSCM来自动态共享库。如果它被定义为静态函数，则可以使用以下方式调用它myLib.com.company.DeploySteps.CheckoutSCM('repo-here')如果它被定义为非静态方法，则可以使用以下方式调用它myLib.com.company.DeploySteps.new(...).CheckoutSCM('repo-here')。然而在这两种情况下DeploySteps类将无法访问步骤 API，因此即使是简单的echo不管用。一种传统的解决方法是提供this的实例Jenkinsfile作为参数（例如，CheckoutSCM(this, 'repo-here')）然后被分配给steps函数内的参数（可以命名为任何名称）。然后，您将调用steps参数，例如steps.echo '...'.