jenkins lockbale resouce的api 请列出来并举例说明用法

Jenkins Lockable Resources Plugin 提供了一组 API 来管理和使用可锁定资源。以下是一些常用的 API，并附带用法示例：

1. lock(label: 'resource_label')

   • 这个 API 用于获得一个特定标签的可锁定资源。如果资源已被锁定，则当前构建将等待直到资源可用。
   • 用法示例：

     stage('Lock Resource') {
         steps {
             lock(label: 'my_resource') {
                 // 执行需要锁定资源的构建步骤
             }
         }
     }
     

2. lock(resource: 'resource_name')

   • 这个 API 用于获得一个特定名称的可锁定资源。如果资源已被锁定，则当前构建将等待直到资源可用。
   • 用法示例：

     stage('Lock Resource') {
         steps {
             lock(resource: 'my_resource') {
                 // 执行需要锁定资源的构建步骤
             }
         }
     }
     

3. unlock(label: 'resource_label')

   • 这个 API 用于释放指定标签的可锁定资源，以使其可供其他构建使用。
   • 用法示例：

     stage('Unlock Resource') {
         steps {
             unlock(label: 'my_resource')
         }
     }
     

4. unlock(resource: 'resource_name')

   • 这个 API 用于释放指定名称的可锁定资源，以使其可供其他构建使用。
   • 用法示例：

     stage('Unlock Resource') {
         steps {
             unlock(resource: 'my_resource')
         }
     }
     

这些是 Lockable Resources Plugin 提供的一些常用 API，可以帮助你在 Jenkins 中管理和使用可锁定资源