如何在管道步骤中使用 Jenkins 侧边栏链接插件？

我正在开发这个插件https://plugins.jenkins.io/sidebar-link/在詹金斯侧栏中添加链接。该插件与 jenkins 项目配置一起使用。现在我正在尝试添加一个管道步骤来调用此插件。

我已经尝试过下面的代码行，但它不起作用

sidebarLinks {
            link("my_url", "the title", 'image path')
        }

我已经阅读了有关此问题的帖子，但没有找到可接受的回复。 我认为 jenkins 插件没有很好的文档记录。

有谁知道我如何将它与管道一起使用？

Updated

我正在使用用 Groovy 编写的共享库。该库包含所有管道方法。

@Library('[email protected]') _
pipeline {
   stages {
      ...
      stage('Add side link') {
            steps {
                addLink()
            }
        }
   }
}

共享库方面，我有一个 addLink.groovy 文件。

def call(){

    properties {
        sidebarLinks {
            link("url", 'Title', 'icon_path')
        }
    }
}

我有以下错误：

错误：

要了解如何在声明式管道中执行某些操作，您可以使用 http://JENKINS_URL/directive-generator/ 上的指令生成器。这提供了类似于作业配置的用户界面。然而，在选择“选项”->“添加”->“sidebarLinks”->填写字段->“生成”后，由于内部服务器错误，不会生成任何内容。

以下声明式管道语法适用于单个作业：

pipeline {
    agent any
    
    options {
        sidebarLinks([
            [displayName: 'Side Bar Example', iconFileName: '', urlName: 'http://example.com']
        ])
    }

    stages {
        stage('Hello') {
            steps {
                echo 'Hello World'
            }
        }
    }
}

但是，您提到您希望通过使用共享管道库在不同的作业中重用这些链接。不幸的是，共享管道库无法修改options声明式管道的一部分，除了生成你的整个pipeline { }在一个单一的def call().

幸运的是，脚本化管道可以覆盖配置的该部分。使用 http://JENKINS_URL/pipeline-syntax/ 上的代码片段生成器，您可以生成以下代码，并将其放入共享管道库中，例如在var/mySidebar.groovy:

def call() {
    properties([
        sidebarLinks([[
            displayName: 'My fancy sidebar url', iconFileName: '', urlName: 'https://example.com'
        ]])
    ])
}

然后，您可以在脚本化管道中使用它：

library('my-sidebar')

mySidebar()

node() {
    stage('Hello') {
        sh 'echo "Hello World!"'
    }
}

Or a script声明式管道的块：

library('my-sidebar')

script {
    mySidebarScripted()
}

pipeline {
    agent any
    
    stages {
        stage('Hello') {
            steps {
                echo 'Hello World'
            }
        }
    }
}