confluence知识库

第一章 部署安装篇

1.1 环境准备

linux 操作服务器:centos

ip:XXXX

port:12590

mysql数据库版本:5.7

下载相应软件包

confluence版本:7.19

链接:https://www.atlassian.com/software/confluence/download-archives

mysql驱动mysql-connector-java-8.0.23.jar

https://repo1.maven.org/maven2/mysql/mysql-connector-java/

confluence破解工具

atlassian-agent-v1.3.1.tar.gz

https://pan.baidu.com/s/19y5KHYrh8qjuEx6Ma2ZC8g

提取码:lhs5

1.2 安装confluence

1.2.1 上传安装包

创建安装目录,赋予执行权限

mkdir /data/confluence

mkdir /data/confluence/app

mkdir /data/confluence/data

chmod a+x atlassian-confluence-7.19.4-x64.bin

1.2.2 安装软件

# ./atlassian-confluence-7.19.4-x64.bin

注:安装前注意yum的配置,过程中会通过yum自动安装部分软件

选择自定义安装

修改安装目录和数据目录为指定规划目录

端口修改为指定其他端口,默认8090

配置成系统服务

成功安装后,启动服务

启动后,即可用http://ip:12590访问前台页面。

1.3 mysql数据库操作内容

注:这里使用了共用mysql数据库,省略mysql数据库安装过程(数据库安装也有很多教程,这里不做说明),剩下只需分配数据库账号,实例和相应权限即可。

1.3.1 创建confluence数据库

create database knowledgedb character set utf8 collate utf8_bin;

create user 'confluence'@'localhost' identified by 'XXXXX';

grant all privileges on confluence.* to confluence@'localhost';

SET GLOBAL tx_isolation='READ-COMMITTED';

flush privileges;

1.3.2 安装mysql 驱动

拷贝下载的mysql驱动至软件安装目录的lib目录下

cp mysql-connector-java-8.0.23.jar /data/confluence/app/confluence/WEB-INF/lib/

1.4 破解工具前置配置

#service confluence stop

#tar -xvf atlassian-agent-v1.3.1.tar.gz

#cd atlassian-agent-v1.3.1

#cp atlassian-agent.jar /data/confluence/

#vi /data/confluence/app/bin/setenv.sh

添加一行

CATALINA_OPTS="-javaagent:/opt/atlassian/confluence/atlassian-agent.jar ${CATALINA_OPTS}"

#service confluence start

1.5 confluence前台页面配置

访问地址ip:12590

可切换成中文,选择产品安装

进入许可证秘钥输入界面,此处先复制ID号

创建confluence的key

java -jar /data/confluence/atlassian-agent.jar -p conf -m [email protected] -n chao -o https://www.cnjzayuan.com -s ID号

复制上一步生产的秘钥到页面进行下一步

秘钥通过后进入数据库配置界面

输入数据库相关信息,并进行测试连接,成功后等待一会

创建空间

配置用户

第二章 日常使用篇

2.1 基础介绍

2.1.1 简介

Confluence是一个企业级的Wiki软件,可用于在企业、部门、团队内部进行信息共享和协同编辑。

团队将日常的工作任务进度管理、技术知识分享、开发文档、操作手册、文档附件都放置入Confluence中进行统一管理。

2.1.2 基础概念

  • Dashboard

Dashboard是Confluence系统的主页,在Dashboard界面中包含了Confluence站点中的所有空间列表,以及最近更新内容的列表。

  • 空间

空间是Confluence系统中的一个区域,用于存储wiki页面,并可实现对空间中的所有文档进行统一的权限管理。

通常,我们可以针对每个项目单独创建一个空间,然后将与该项目相关的文档信息放置到该空间中,并只对项目成员开设访问/编辑权限。

除了项目空间,每个成员都有一个个人空间。平时成员可以将工作总结或笔记等文档放置到自己的空间中;对于对团队有帮助的文档,就可以将文档移动至团队项目空间中。

可以理解为SVN或Git的一个库。

  • 页面

在Confluence系统中,页面是存储和共享信息的主要方式。页面可以互相链接、连接、组织和访问,并以树状结构进行组织,放置于空间之中。

页面遵循所见即所得的编辑方式,操作上简单易用。更强大的地方在于,页面支持大量的内容展现形式,除了富文本文档外,还包括图表、视频、附件(可预览)、流程图、公式等等;如果还不够,还可以通过海量的第三方插件进行扩展。

在页面中可以通过@其它成员,通知相关成员查看文档。文档保存成功后,被@的成员就会收到邮件,并可根据邮件中的链接访问到该文档,然后进行评论或者协同编辑。

  • 页面树

使用分层的页面树整理空间内容,让查找工作变得即快速又轻松。您可以将页面嵌套到相关的空间和页面下,以任何喜欢的方式整理页面。

  • 模板

创建页面时除了采用空白文档,也可以选择模板。模板是在空白文档的基础上,根据特定需求添加了一些文档要素,可辅助用户更好更快地创建文档。

Confluence内置了大量的模板,可辅助用于项目工作的各个环节,包括产品需求、会议记录、决策记录、指导手册(How-to)、回顾记录、工作计划、任务报告等等。并且由于Confluence和JIRA是同一家公司的产品,在Confluence中可以和JIRA进行无缝衔接,实现对产品质量实现更好的展现。

如果对Confluence自带的模板不满意,还可以对模板进行调整,或者根据自己的需求创建其它类型的模板。

  • 权限

在安全性方面,Confluence具有完善和精细的权限控制,可以很好地控制用户在Wiki中创建、编辑内容和添加注释。

权限控制分3个维度,分别是团队(Group),个人(Individual Users),匿名用户(Anonymous)。

使用团队级的权限控制时,需要在Confluence服务器中对公司员工进行分组,好处在于配置比较方便,只需要对整个团队进行统一的权限配置。

但在实际项目中,经常会存在同一个项目包含多个跨团队成员的情况,这个时候就不适合采用团队权限配置方式,只能采用逐个添加成员的方式,并对各个成员分别配置权限。

另外一种情况,就是对于未登录的用户,以及项目成员以外的用户,可以开设部分权限,例如只读(View)。

2.2 日常操作

官网指导手册https://www.atlassian.com/zh/software/confluence/guides

中文手册https://www.cwiki.us/display/CONFLUENCEWIKI/Pages+and+blogs

2.2.1创建用户

右上角选择用户管理,进入用户界面,选择添加用户

2.2.2创建空间

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

创建空间的方式很简单,可以从顶部菜单进行创建:【空间/Spaces】->【创建空间/Create Space】;也可以从【空间目录】页面中进行创建。

2.2.3配置空间权限

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

操作方式如下:首先进入空间的页面,在空间左下角中,【空间管理】->【权限】,进入权限管理页面。

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

2.2.4添加文档

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

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

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

2.2.5文档查看与操作

用户账户登录首页->选择要查看的【空间】->【目录】->选择对应的目录→查看您想看的文档 。

2.2.6编写文档

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

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

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

编写的文档也可以直接由word文件中导入,如下图所示,在编辑界面选择【插入文件和图片】(是一个小图标),点击【上传文件/Upload files】按钮选择需要上传的文件,上传完成后点击插入。然后点击【+】->【其它宏/Other macros】,找到【Office Word】点击,如下图所示,在左侧选【File Name】择上传的文件,点击插入按钮,文件插入成功,预览保存。

2.2.7移动文档

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

操作方式如下:先进入到待移动的文档页面中,点击页面右上角的【…】->【Move】;

2.2.8 创建目录

与创建文档方式一致,直接创建标题保存即可。

2.2.9 上传附件

2.2.10 文作为件导出

2.2.11 文档权限管理

需要管理员权限进行编辑

第三章 日常维护篇

3.1 性能调优

1) 用户资源配置优化

vi /etc/security/limits.conf

confluence soft nofile 1024000

confluence hard nofile 1024000

confluence soft core 1024000

confluence hard core 1024000

confluence soft nproc unlimited

confluence hard nproc unlimited

confluence soft stack unlimited

confluence hard stack unlimited

confluence soft memlock unlimited

confluence hard memlock unlimited

  1. jvm内存调整

修改程序启动配置文件

Vi /data/confluence/app/bin/setenv.sh|

3.2 日常问题分析

程序相关日志存在于/data/confluence/app/logs目录下,出现问题可结合分析处理。

3.3 维护命令

服务常用命令位置:/data/confluence/app/bin

服务启停service confluence stop/service confluence start

3.4 备份与恢复

1)Confluence的备份

管理员账号登录Confluence,点击右上角的"一般配置"-"每日备份管理",如下图(默认配置):

默认每天会自动备份一个zip打包的数据,存放在服务器的/data/confluence/data/backups路径下。还可以点击"编辑"进行自定义。

2)Confluence的恢复

可以点击"一般配置"-"备份与还原"里面的恢复进行数据恢复。可以将上面整体备份在/data/confluence/data/backups里面的数据然后点击"上传和恢复"即可进行数据恢复。

当备份数据比较大时,可以将备份数据拷贝到/data/confluence/data/restore路径下,从Confluence主目录中进行恢复。如下:

注意:针对某个空间的备份:

- 如果此空间不存在,则可以如同上面方法恢复数据:即将备份在/var/atlassian/application-data/confluence/temp/里面的数据拿到本地,然后点击"上传和恢复"即可进行数据恢复。

- 如果此空间已存在,则就不能使用上面方法,否则会报错"空间标识DATA已存在,请首先删除该空间,然后继续完成还原"。此种情况下,如果不删除该空间,则正确的数据恢复的方法是:点开该空间,分别点击左下角的"空间管理"-"概览"-"内容工具"-"导入",然后将服务器上备份数据的路径/data/confluence/data/temp/ 填写到"导入路径",进行导入操作即可。

猜你喜欢

转载自blog.csdn.net/vincent0920/article/details/128935917
今日推荐