如何在Jenkins可锁定资源插件中获取锁定资源的名称

Question

我正在使用Jenkins Lockable Resources插件来决定在声明式管道中将哪个服务器用于各种构建操作。我已经设置了可锁定资源，如下表所示：

Resource Name       Labels

Win_Res_1           Windows
Win_Res_2           Windows
Win_Res_3           Windows
Lx_Res_1            Linux
Lx_Res_2            Linux
Lx_Res_3            Linux

我想锁定label，然后获取相应的锁定resource的名称。

我正在编写以下代码，但无法获得所需的r值

int num_resources = 1;
def label = "Windows"; /* I have hardcoded it here for simplicity. In actual code, I will get ${lable} from my code and its value can be either Windows or Linux. */

lock(label: "${label}", quantity: num_resources)
{
    def r = org.jenkins.plugins.lockableresources.LockableResourcesManager; /* I know this is incomplete but unable to get correct function call */
    println (" Locked resource r is : ${r} \n");

    /* r should be name of resource for example Win_Res_1. */
}

Lockable Resources Plugin的文档位于此处：https://jenkins.io/doc/pipeline/steps/lockable-resources/和https://plugins.jenkins.io/lockable-resources/

Answer 1

您可以使用variable工作流程步骤的lock参数获取锁定资源的名称。此选项定义环境变量的名称，该变量将存储锁定资源的名称。请考虑以下示例。

pipeline {
    agent any

    stages {
        stage("Lock resource") {
            steps {
                script {
                    int num = 1
                    String label = "Windows"

                    lock(label: label, quantity: num, variable: "resource_name") {
                        echo "Locked resource name is ${env.resource_name}"
                    }
                }
            }
        }
    }
}

在此示例中，可以使用env.resource_name变量访问锁定的资源名称。这是管道运行的输出。

[Pipeline] {
[Pipeline] stage
[Pipeline] { (Lock resource)
[Pipeline] script
[Pipeline] {
[Pipeline] lock
Trying to acquire lock on [Label: Windows, Quantity: 1]
Lock acquired on [Label: Windows, Quantity: 1]
[Pipeline] {
[Pipeline] echo
Locked resource name is Win_Res_1
[Pipeline] }
Lock released on resource [Label: Windows, Quantity: 1]
[Pipeline] // lock
[Pipeline] }
[Pipeline] // script
[Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // node
[Pipeline] End of Pipeline
Finished: SUCCESS

您可以看到Win_Res_1值已分配给env.resource_name变量。