如何在 jenkins confluence 插件的 confluence 页面上包含宏？答案

【问题标题】：How can I include a macro on a confluence page from the jenkins confluence plugin?如何在 jenkins confluence 插件的 confluence 页面上包含宏？
【发布时间】：2017-10-25 08:37:12
【问题描述】：

我正在使用 Jenkins (ver. 1.642.4) 中的 confluence 插件将构建结果发布到 Confluence (6.0.7)

我正在使用 jenkins 插件“Confluence Publisher 1.8”。

Jenkins 构建作业中的脚本为某些类型的 cmets 解析一些 Git 分支。从该日志中，它会创建一个文本文件 (CHANGELOG-jenkins.md)，并发布到 Confluence。

为了以友好的方式显示文本，我使用了 Confluence Markdown 宏。 result for the page I create 我添加了宏，并添加了一个标记文本 {jenkins-marker:Release_Notes_Generator_Confluence}。 confluence 的 jenkins 插件然后可以在 Markdown 宏中写入并且文本正确呈现。

但是，我需要 jenkins 来创建一个新的 confluence 页面（每次构建），所以我需要一种方法来自动化宏插入和标记

如果页面不存在，jenkins 插件已经创建了一个页面。所以我需要能够在创建新页面后将降价宏添加到新页面。然后我还需要将令牌文本添加到宏中。

到目前为止，我还没有找到任何方法来做到这一点。似乎宏“必须”手动插入

https://confluence.atlassian.com/conf53/working-with-macros-411108564.html

【问题讨论】：

标签： git macros jenkins-plugins confluence

【解决方案1】：

如果有人有兴趣，我最终找到了替代方案（从长远来看可能是更好的解决方案）

我正在使用 confluence 的 REST API 将 markdown 宏添加到页面。我是t able to find any doc on JSON needed to add it, but luckily, its 一个相当简单的宏，因此发现所需字段并不难。这是最低要求。

<ac:structured-macro ac:name=\"markdown\">
    <ac:plain-text-body><![CDATA[<b>This is my code</b>]]></ac:plain-text-body>
</ac:structured-macro>

请求的 URL 和正文

https://<confluence_url>:443/rest/api/content/12944217


{
    "id": "12944217",
    "type": "page",
    "status": "current",
    "title": "Release Notes From Jenkins",
    "space": {
        "key": "THEKEY",
        "metadata": {}
    },
        "version": {
        "number": 51,
        "minorEdit": false,
        "hidden": false
    },
    "ancestors": [],
    "operations": [],
    "body": {
        "storage": {
            "value":"<p></ac:structured-macro></p><p><ac:structured-macro ac:name=\"markdown\"><ac:plain-text-body><![CDATA[<b>jenkins-marker:Release_Notes_Generator_Confluence</b>]]></ac:plain-text-body></ac:structured-macro></p>",
        "representation": "storage"
        }
},
"metadata": {}

}

【讨论】：