confluence 基础 *** 作

reference link : http://debugtalk.com/post/confluence-simple-tutorial/

1、常见 *** 作

熟悉了Confluence的基础概念，基本上就可以摸索着对Confluence进行上手了。不过，为了减少摸索时间，在这里我再将Confluence中的常用 *** 作进行说明。

创建空间（Space）

新建一个项目时，首先要做的就是创建一个空间，并进行初始化配置。

创建空间的方式很简单，可以从顶部菜单进行创建：【Spaces】->【Create Space】；也可以从Dashboard页面的Spaces页面中进行创建。

进入创建空间页面后，需要选择空间类型。这个需要根据空间的用途进行选择，对于团队协作的空间，推荐选择“Team Space”，如果实在不知道选择什么类型，选择“Blank Space”也是可以的。

然后是填写空间的基本信息。所有类型的空间都有两个必填字段，Space name和Space key。Space key可以理解为空间的ID，不同空间的Space key不能重复，但Space name是可以重复的。

另外，对于“Team Space”类型的空间，多了一个“Team members”字段，用于添加空间的成员。成员的名称是其公司邮箱的前缀。

需要说明的是，空间创建完成后，Space key字段是不能修改的，其它字段以及团队成员都可以进行修改。

创建空间后，根据项目需要，可以给空间设置权限。只有空间的管理员才能对空间权限进行配置。

*** 作方式如下：首先进入空间的页面，在空间左下角中，【Space tools】->【Permissions】，进入权限管理页面。

Confluence的权限控制比较完善，可以根据团队规范进行较为精细粒度的设置。

在Confluence中文件以树状结构进行组织。

推荐的创建方式是，先进入父目录的页面，然后再点击【Create】进行创建。在创建文档页面中，可以看到新建文档的“Parent”，表示新文档创建后将位于“Parent”文件的下一个层级中。

在新建文档时，需要选择文档模板。这个就根据文档的实际类型或用途进行选择即可，如果觉得都不合适，就选择“Blank page”。

编写文档

在编写文档时，页面遵循所见即所得的编辑方式，基本上跟在MS Word中的 *** 作类似。

Confluence也集成了许多编辑工具，可以很方便地插入图表、链接、附件、代办列表等等。如果还不满足需求，可以点击【Insert】->【Other macros】，查找更多的扩展插件。

例如，Confluence默认是不支持Markdown编辑模式的，如果想采用Markdown来编写文档，就可以通过上述方式到插件市场寻找Markdown的插件。

不过根据实践发现，当前Confluence的Markdown插件支持的还不够好，使用体验上不尽如人意。比较推荐的做法，还是在单独的Markdown编辑器上采用markdown语法进行编辑，编辑完成后进行预览，然后将渲染后的文档内容复制粘贴到Confluence中。

移动文档

很多时候我们需要调整目录结构，这就涉及到需要将文档移动到别的目录层级下。

*** 作方式如下：先进入到待移动的文档页面中，点击页面右上角的【…】->【Move】；

然后选择新的目录即可。

公司运行了jira，confluence，fisheye。但每次登录都需要输入多次用户名密码，觉得不太方便，所以需要对它们实现单点登录，crowd作为Atlassian单点登录的产品，可以用于集中用户、用户组管理，方便权限控制。

crowd安装参考： https://www.jianshu.com/p/2839c8bc409d

目标：在crowd创建一组用户分别用于jira，confluence，fisheye系统中。

实现：在同一个session的浏览器中可以在三个应用的切换。

crowd端添加应用程序,注意：要记住这块填写的密码，后面会用到

连接，添加远端jira的url地址

授权，可以选择特定的组进行认证，我这边所有用户都要认证。

登录Jira的管理部分

单击“ 用户管理”下左侧栏的“ 用户目录 ”标签。 标签。

点击“ 添加目录 ”。然后从下拉列表中选择“ Atlassian Crowd ”。单击“ 下一步 ”。

输入连接参数并保存。现在，新的Crowd目录应该出现在用户目录列表中,创建完如下，可以通过顺序调整内部目录和外部目录的权限：

上一步骤只是实现了集中认证，现在我们来配置jira的SSO单点登录

可以在Confluence中定义多个用户目录。但是，如果启用Crowd SSO集成，则只能从crowd.properties文件中定义的Crowd服务器进行身份验证。

要使用其他目录（例如Confluence Internal Directory）中的用户登录，您需要：

在Confluence管理控制台中，转到用户目录并禁用Crowd Server目录，或

通过恢复默认的Confluence身份验证器来禁用群组SSO。

禁用Crowd SSO的步骤：

crowd权限：

Fisheye 为Crowd目录提供 只读权限。Crowd目录中的用户，组和成员资格是从Crowd中检索的，只能从Crowd中进行修改。您无法使用鱼眼管理屏幕修改群组用户，组或成员身份。

设置Crowd目录后，您可以通过将以下设置添加到$FISHEYE_INST/config.xml 文件来启用或禁用Crowd SSO集成 （如果它们尚不存在，您可以创建缺少的xml节点）。默认情况下，如果未配置SSO，则会禁用SSO config.xml

坑，在填写这一步骤时，代理服务器用户名总是莫名自动填写上admin，导致没法通过，正常代理服务器这块不需要填写，后来发现原来是浏览器记住密码，默认填写导致，删除浏览器记住密码即可

corwd首先作为一个集中认证的地方，将用户同步到jira，wiki中，之后再各自对jira，wiki中添加的组做权限即可

解决：重新配置sso单点登录并且关注

vim confluence_home/confluence/WEB-INF/classes/seraph-config.xml 注释43行，取消注释48行

vim jira_home/atlassian-jira/WEB-INF/classes/seraph-config.xml 注释98行，取消注释94行

解决：修改http bind参数，默认是:8060 修改后可以在/fisheye/fecru-4.7.0/config.xml中查看到

参考： https://confluence.atlassian.com/fisheye041/configuring-the-fisheye-web-server-847745899.html

crowd对接jenkins

---