JIRA+Confluence双平台实操：智行者IC社区三连弹

本人实际测试了JIRA v8.22.6以及Confluence v7.19.3，经历了权限链断开、空间页面遗失、工单同步不成功这样的一些状况，新手只要依照步骤一步一步去进行操作，便能够轻松地绕开这类常见问题。

如何一键打通JIRA工单与Confluence需求文档

进入Confluence空间需要第一步操作该步骤，在左侧导航栏的位置找到「Space settings」，然后从这里朝着「Integrations」方向进行查找，接着在「Integrations」里找到「JIRA」部分，点击「JIRA」标识下面的「Configure」标志。在弹出带有JIRA服务器地址名字的栏位当中输入你所在那家公司的内网上面规定的JIRA域名，在输入域名的同时勾选「Allow linking JIRA issues to pages」这个选项。此处在的固定参数是：名为JIRA项目密钥需得要用大写字母，举例来说像PROJ这样的，若用小写字母将会致使后续工单引用出现404。

新手要避开坑，在配置完成之后进行测试链接的时候，出现了报错，报错内容是「Remote JIRA not accessible」。大概有八成的可能性是Confluence这台服务器里头的hosts文件当中没有写入JIRA的IP映射。其解决办法是，通过SSH登录到Confluence服务器，使用vi /etc/hosts，添加一行“192.168.1.100 jira.yourcompany.com”，然后重启两个服务就可以了。

第二步：回到Confluence的随便哪一个页面，往里面输入“/jira”从而调出宏菜单，从中选择「JIRA Issues」。于过滤条件框当中输入JQL语句，最优参数的推荐数值是“project = PROJ AND status in (Open, ‘In Progress’)”，之所以这样的理由是只去拉取活跃的工单，以此来避免页面被已经关闭的旧数据给撑爆。设置显示条数上限为50条。

刚刚接触的朋友们要注意避开这些坑，页面加载完成后呈现的结果全部都是“No issues found”。仔细查看一下JQL里状态字段的引号情况，In Progress带有空格时一定要使用单引号将其括起来。还有一个容易出错的地方是权限方面，Confluence的连接用户必须具备JIRA项目的“浏览”权限，不然的数据话就无法把数据拉取出来。前往JIRA后台给该用户添加一个“jira-users”组。

怎么给智行者社区成员分配协作权限才不出错

方案A：运用Confluence空间自身所具备的「Permissions」功能，进入到「Space settings」，再进入「Permissions」，针对「tech-team」组勾选「View」以及「Add Page」，针对项目管理员勾选「Admin」。方案B：不设置组权限，而是直接借助页面级别的「Restrictions」为每一个成员单独进行勾选。

两种实操方案进行对比，方案A适用于五十人以上的大团队，其权限能够批量继承，管理起来较为轻松，然而细粒度却比较差，方案B适用于少于十人的核心开发组，每页都能够单独控制谁可以查看以及谁能够修改，但是一旦页面数量增多，维护量就会呈现爆炸式增长。取舍的逻辑是，如果在智行者IC社区里管理的是公共知识库，像是架构图、设计文档之类的，那就使用方案A，如果管理的是个人实验笔记或者未定稿方案，那就使用方案B。

给新手的避坑提示，在权限配好之后，有成员反馈说能看到空间列表，然而点进去却显示报403错误。绝大多数情况是由于空间首页的「Space home」权限没有勾选。解决的办法是，处于这样权限配置不足的状况时，在Permissions页面里，要把「tech – team」组的「View」权限勾选上，然后下拉到最底部点击「Save all」，注意不可以仅仅只进行页面层面的保存操作，以确保权限配置完整无误。

步骤三：当进行新页面创建之际，于右侧的「Restrictions」面板那儿点击「Edit restrictions」，进而选择「Only specific people」。接着输入你打算进行开放操作的用户名，随后点击「Apply」。请记住，在此处不要勾选「Restrict view and edit separately」，因为这容易致使混乱产生。

【新手需防入坑】，常见出现的报错为：“您并不具备权限去查看此页面状况，请与管理员展开联系。”，核心的缘由在于：你期望开放给A，然而页面是从上级页面所继承而来的权限，对B造成了限制。快速予以解决的办法是：点击页面右上角的「…」，接着点击「Page restrictions」，随后点击「Remove restrictions」以彻底解除继承，之后再去重新开展设置。整个流程所耗费时间不超过30秒。

社区源码评审批次拉取总是失败怎么解

高频出现的完整报错是，“Confluence在从PROJ-1234获取JIRA附件时出现‘文件未找到’”。这个报错在智行者IC社区的JIRA与Confluence的联动之中反复地出现。周全完备一单式搞定流程：首先，凭借管理员账号登录Confluence后台，而后进入「General configuration」，接着点选「Attachment storage」，最后确认存储模式乃是“File System”。第二个步骤，经由SSH连接到Confluence服务器，对/var/atlassian/application-data/confluence/attachments目录的磁盘空间状况进行检查——很大概率是磁盘已被写满了。第三个步骤，在通过df -h予以确认之后，对/tmp之下的旧日志文件展开清理以释放空间，或者施行磁盘扩容操作。第四步，返回JIRA，将PROJ – 1234这个工单的附件予以删除，而后再次进行上传，接着在Confluence页面里实施刷新操作，此时附件便会正常显示出来。

【新手防踩坑】，在完成上面那些步骤的操作之后，要是依旧出现报错情况，不用着急去重新安装。先查看Confluence的系统日志：通过执行“tail -100 /var/atlassian/application-data/confluence/logs/atlassian-confluence.log”命令，然后去搜索“OutOfMemoryError”，要是确定是内存溢出问题，那就需要把-Xmx参数的值调高。在社区当中，大概5%的案例会碰到这个场景，它不适用日常小规模评审，其替代方案是，直接让小组成员把代码贴到Confluence代码块里，而不是用JIRA附件，如此便能省掉存储瓶颈。