CentOS应用-Confluence运维

Jungout

已于 2023-12-14 21:51:53 修改

阅读量1.2k

点赞数 27

分类专栏： Linux应用环境配置文章标签：运维 centos linux java

于 2023-11-30 13:40:32 首次发布

本文链接：https://blog.csdn.net/Canz245630/article/details/134710043

版权

Linux应用环境配置专栏收录该内容

8 篇文章 0 订阅

订阅专栏

1. 介绍说明

Confluence是一种企业级的团队协作和知识管理软件，由公司Atlassian开发和维护。它提供了一个集中的平台，用于创建、组织和共享团队的文档、知识库、项目计划、会议记录、技术文档等。

Confluence具有以下主要功能和特点：

文档协作：团队成员可以在Confluence上创建和编辑文档，并通过评论、反馈和协作功能进行实时协作。
知识管理：Confluence提供了一个结构化的知识库，可以存储和共享团队的知识、经验和最佳实践。
项目管理：Confluence可以用于创建和跟踪项目计划、任务列表、问题和需求。
团队协作：Confluence支持团队成员之间的协作和沟通，包括共享文件、讨论、提问和回答等。
内容搜索和发现：Confluence具有强大的搜索功能，可以快速找到需要的信息，并支持按标签、作者、日期等进行过滤和排序。
扩展性和定制性：Confluence可以通过插件和集成来扩展其功能，例如与JIRA、HipChat和其他Atlassian产品的集成。

Confluence被广泛应用于各种组织和行业，包括软件开发团队、项目管理团队、技术支持团队、人力资源部门、销售和市场团队等，以促进团队合作、知识共享和信息管理。

Confluence官网链接-中文：https://www.atlassian.com/zh/software/confluence
Confluence软件下载-中文：https://www.atlassian.com/zh/software/confluence/download-archives
Confluence环境要求-原版：https://confluence.atlassian.com/doc/supported-platforms-207488198.html
Confluence安装步骤-原版：https://confluence.atlassian.com/doc/installing-confluence-on-linux-from-archive-file-255362363.html

Confluence版本	JKD支持	MySQL支持
Server 7.13	java1.8，11	MySQL 5.7，MySQL 8
Server 7.20	java11	MySQL 8
Server 8.5	java11，17	MySQL 8

2. 环境要求

2.1. 准备工作

1、下载 atlassian-confluence-x.x.x.tar.gz 软件安装包

2、下载 mysql-connector 数据库连接驱动，注意区分版本

3、获取正版授权代码或代理激活程序

2.2. 环境要求

1、JDK：用于运行confluence主要程序

2、Nginx：用于配置confluence服务的反向代理，不演示安装

3、MySQL：用于保存confluence的数据记录，不演示安装

2.3. 其他说明

1、confluence 8后续版本不支持 java1.8，推荐使用 java11或17 发行版。

2、confluence 8后续版本不支持mysql 5.7，推荐使用 mysql 8 发行版。

3、mysql 8提供的数据库要求默认字符集必须为 utf8mb4。

4、mysql 8数据库的事务隔离级别必须为 read-committed。

2.4. 安装环境

本次演示安装java的运行环境，实际上运行confluence服务只需要配置java环境和数据库就能够正常使用。本次演示confluence 8 版本，因此采用 java 17 和 mysql 8 进行部署

#1、下载jdk软件包
wget  https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.tar.gz

#2、解压jdk至目录/opt/apps
tar -xf jdk-17_linux-x64_bin.tar.gz -C /opt/apps/

#3、配置软链接管理目录
cd /opt/apps
ln -s jdk-17.0.8 jdk

#4、配置java环境变量
tee <<EOF >/etc/profile.d/jdk17.sh
export JAVA_HOME=/opt/apps/jdk
export CLASSPATH=\$JAVA_HOME/lib/
export PATH=xxxx:\$JAVA_HOME/bin:\$PATH
EOF

#5、重新加载环境变量
source /etc/profile

#6、验证java的运行
java -version

3. 搭建步骤

3.1. 创建目录

#1.创建confluence的home目录，也就是数据目录。
mkdir -p /data/confluence

3.3. 安装应用

#1.解压confluence的程序包
cd /opt/src
tar -xvf atlassian-confluence-7.13.7.tar.gz

#2.将解压内容拷贝至confluence的install目录，此处使用软链接。
mv atlassian-confluence-7.13.7/* /opt/apps/confluence-7.13.7

#3.创建软链管理confluence的install目录
cd /opt/apps
ln -s confluence-7.13.7 confluence

3.4. 配置目录

#1.编辑confluence初始化的配置文件
vim /opt/apps/confluence/confluence/WEB-INF/classes/confluence-init.properties

#2.追加一行配置home目录
# confluence.home=c:/confluence
confluence.home=/data/confluence

3.5. 添加代理

本次添加的代理jar包是一个破解程序，仅作为测试演示，请大家购买正版使用。

#1.解压atlassian-agent代理
cd /opt/src
tar -xvf atlassian-agent-v1.3.1.tar.gz

#2.将解压的目录移动至confluence的install目录，并重命名为agent
mv atlassian-agent-v1.3.1 /opt/apps/confluence/agent

#3.编辑confluence环境设置的脚本
vim /opt/apps/confluence/bin/setenv.sh

#4.在CATALINA_OPTS参数后追加一条agent运行
CATALINA_OPTS="-javaagent:/opt/apps/confluence/agent/atlassian-agent.jar"

#第3第和4步的快捷命令
sed -i '/export CATALINA_OPTS/i\CATALINA_OPTS="-javaagent:/opt/apps/confluence/agent/atlassian-agent.jar"' /opt/apps/confluence/bin/setenv.sh

3.6. 添加驱动

由于许可限制，我们无法将MySQL或Oracle数据库驱动程序与Confluence捆绑在一起，因此您需要手动下载并安装下面列出的驱动程序，然后才能设置Confluence。Database JDBC Drivers

#1.解压mysql-jdbc驱动程序
cd /opt/src
tar -xvf mysql-connector-java-5.1.49.tar.gz

#2.拷贝mysql-jdbc驱动至confluence的lib目录
cd /opt/src/mysql-connector-java-5.1.49/
cp mysql-connector-java-5.1.49* /opt/apps/confluence/confluence/WEB-INF/lib/

3.7. 启动应用

#1.创建confluence用户
groupadd confluence && useradd confluence -g confluence

#2.授权confluence用户
chown -R confluence /data/confluence*
chown -R confluence /opt/apps/confluence*

chmod -R u=rwx,go-rwx /data/confluence*
chmod -R u=rwx,go-rwx /opt/apps/confluence*

#1.启动confluence
cd /opt/apps/confluence/bin
./start-confluence.sh

4. 应用配置

4.1. 初始化配置

访问confluence服务地址，http://ip-host:8090，进行下一步配置。

在这里插入图片描述

4.1.1. 授权应用

#1.利用agent授权应用
java -jar /opt/apps/confluence/agent/atlassian-agent.jar -p conf -m confluence@admin.com -n confluence -o confluence -s B6YP-26MS-TEPP-ZGEP	#服务器ID

====================================================
=======     Atlassian Crack Agent v1.3.1     =======
=======           https://zhile.io           =======
=======          QQ Group:                   =======
====================================================

Your license code(Don't copy this line!!!): 

AAABhg0ODAoPeJxtUV1PwjAUfe+vWOKjGXZjTCBpImxDUAZT5ge+lXFxla4jbQfir7fAjMaQ3If23
Pacc8+9SCuwppm2HGxht+t5XbdlRWFqudhtokAC1awUIdVADojtYFMo2lJeHTtkRbkCFILKJNsck
SfBWcE0LC3OMhAKrMXeyrXeqO7V1VfOODRYiabynQqmTiRZKVa8ApEBOhwbNNNsC0TLClBQCm3uU
UwZ//Pwhi4LJhpZWaBaZkhVTuJgFwz6Sbmcg36447m3VBMv77Q+d2/bOF04vfxhR+O29j1v8Xr/M
bjk1Zo/z/MXXvaHPUJO+jNNpQZZD3eExieRdL+BCS2ABNM4jh6DUW+MjDOhQVDjKvrcMLmv42p3b
HxtCtV/RyEZj8JZNLHHjt/xOyZQv+XiFpqB3II07b4/T2zXj2d2GiWJ/XYbJWgN+2eQ6hCT42N8j
dvNpvNDeV4vqWSWUwX/11YH9UPnniabVMUC5HT1pAxObAcZh+SMy3oRx+l/9/ANtvm8qjAsAhQLJ
orIlTKwwxucqVNhuE/AlWrUFAIUWt91P7Vdg6kkNYti/WAGfZ0gVuE=X02iu

在这里插入图片描述

4.1.2. 设置数据库

遵循confluence数据库设置的要求，配置数据库。

Database Setup For MySQL | Confluence Data Center and Server 8.6 | Atlassian Documentation

#1.创建confluence数据库，设置字符集为utf8mb4。
create database confluencedb default character set utf8mb4 collate utf8mb4_bin;

#2.创建confluence用户，并设置密码。
create user 'confluenceuser'@'%' IDENTIFIED BY 'Wt@confluence2024';

#3.授权confluence用户权限给confluence数据库。
grant all privileges on confluencedb.* to 'confluenceuser'@'%';

#4.刷新数据库
FLUSH PRIVILEGES;

配置confluence服务连接数据库的信息，测试连接性。

在这里插入图片描述

4.1.3. 创建管理员

在这里插入图片描述

4.2 管理应用

4.2.1. 一般配置

1、更新服务器主页的URL

在这里插入图片描述

2、更新站点Logo和图标

4.2.2. 用户管理

confluence提供LDAP用户同步服务，LDAP目录将定期同步Confluence。

#1.用户对象过滤器：
(&(objectCategory=Person)(sAMAccountName=*))

#2.用户名属性：
sAMAccountName

4.2.3. 插件管理

confluence应用商店拥有许多的插件提供使用，由于其昂贵的费用让我们只能望而却步。本次添加的代理jar包是一个破解程序，仅作为测试演示，请大家购买正版使用。

confluence应用商店中，选择免费试用并下载插件。
在插件管理中，查看使用插件的密钥ID，代理agent工具根据密钥ID生成许可。

#1.注册密钥ID许可的命令
java -jar /opt/apps/confluence/agent/atlassian-agent.jar -p '应用密钥' -m confluence@admin.com -n confluence -o confluence -s 'confluence服务器ID'

Easy Heading Pro [提供右侧的悬浮目录栏]
Table Filter and Charts for Confluence [提供表格过滤功能]
Markdown Extensions for Confluence [Markdown拓展]
Questions for Confluence [知识问答功能]
HideElements for Confluence [功能隐藏插件]
Scroll PDF/WORD Exporter [文档导出插件]
Draw.io Confluence Plugin [DrawIO画图插件]
Comala Document Management [文档审批插件]

5. 运维管理

5.1. Nginx代理

Running Confluence behind NGINX with SSL

5.1.1. Set Context

Edit /conf/server.xml

#1.查看默认配置
<Context path="${confluence.context.path}/synchrony-proxy" docBase="../synchrony-proxy" debug="0" reloadable="false">

#2.修改上下文路径
<Context path="/confluence" docBase="../confluence" debug="0" reloadable="false">

Edit /confluence.cfg.xml

#1.查看默认配置
<property name="confluence.webapp.context.path"></property>

#2.修改confluence配置
<property name="confluence.webapp.context.path">/confluence</property>

5.1.2. Configure Tomcat

Edit /conf/server.xml

<Server port="8000" shutdown="SHUTDOWN" debug="0">
    <Service name="Tomcat-Standalone">
        
        <Connector port="8090" connectionTimeout="20000" redirectPort="8443"
                   maxThreads="48" minSpareThreads="10"
                   enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
                   protocol="org.apache.coyote.http11.Http11NioProtocol"
                   scheme="https" secure="true" proxyName="confluence.jungout.com.cn" proxyPort="3000"/>
        
    </Service>
</Server>

5.1.3. Configure Nginx

Edit /conf/nginx.cnf

server {
    #listen confluence.jungout.com.cn:80;
    server_name confluence.jungout.com.cn;

    listen 3000 ssl http2;
    ssl_certificate       /opt/apps/nginx/ssl/_.jungout.com.cn.pem;
    ssl_certificate_key   /opt/apps/nginx/ssl/_.jungout.com.cn.key;
    ssl_session_timeout  1d;
    ssl_session_cache shared:MozSSL:10m;
    ssl_session_tickets off;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-
RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers on;

location /synchrony {
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://localhost:8091/synchrony;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
    }
  location /confluence {
        client_max_body_size 100m;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://localhost:8090/confluence;
    }
}

5.2. 性能优化

5.5.1. 内存堆栈

Edit /bin/setenv.sh

# Set the Java heap size
CATALINA_OPTS="-Xms1024m -Xmx2048m ${CATALINA_OPTS}"

# Default values for small to medium size instances
CATALINA_OPTS="-XX:ReservedCodeCacheSize=256m ${CATALINA_OPTS}"

5.3. 版本升级

5.3.1. 更换版本

#1.停止confluence服务
/opt/apps/confluence/bin/stop-confluence.sh

#2.获取confluence最新的长线支持版本
wget https://product-downloads.atlassian.com/software/confluence/downloads/atlassian-confluence-7.20.3.tar.gz

#3.解压缩新版本程序包
tar xf atlassian-confluence-7.13.20.tar.gz 

#4.拷贝软件程序包至/opt/apps/目录，并重命名
mv atlassian-confluence-7.13.20 /opt/apps/confluence-7.13.20

#5.将管理confluence的软链指向新的程序包
cd /opt/apps/
ln -snf confluence-7.13.20 confluence

5.3.2. 复制应用

#1.拷贝mysql-jdbc驱动至confluence的lib目录
cd /opt/src/mysql-connector-j-8.1.0/
cp mysql-connector-j-8.1.0.jar /opt/apps/confluence/confluence/WEB-INF/lib/

#2.拷贝confluence的agent脚本
cd /opt/apps/confluence-7.13.7/
cp -r agent /opt/apps/confluence/

5.3.3. 复制配置

#1.拷贝confluence的home目录配置文件
cd /opt/apps/confluence-7.13.7/confluence/WEB-INF/classes/
cp confluence-init.properties /opt/apps/confluence/confluence/WEB-INF/classes/

#2.重新配置setenv.sh脚本
vim /opt/apps/confluence/bin/setenv.sh

#3.在CATALINA_OPTS参数后追加一条agent运行
CATALINA_OPTS="-javaagent:/opt/apps/confluence/agent/atlassian-agent.jar"

#4.拷贝confluence的server.xml文件
cd /opt/apps/confluence/conf
cp server.xml /opt/apps/confluence/conf/

5.3.4. 重启应用

#1.启动confluence服务
/opt/apps/confluence/bin/start-confluence.sh

6.故障处理

6.1. 服务异常

6.1.1. 数据库连接异常

#报错1:Mysql SSL连接异常
Mon May 23 05:09:23 EDT 2022 WARN: Establishing SSL connection without server's identity verification is not recommended. According to MySQL 5.5.45+, 5.6.26+ and 5.7.6+ requirements SSL connection must be established by default if explicit option isn't set. For compliance with existing applications not using SSL the verifyServerCertificate property is set to 'false'. You need either to explicitly disable SSL by setting useSSL=false, or set useSSL=true and provide truststore for server certificate verification.

#处理1：修改confluence连接数据库的文件
vim /data/confluence/confluence.cfg.xml
<property name="hibernate.connection.url">jdbc:mysql://192.168.10.46:3308/confluence?useSSL=false</property>

6.1.2. 无法访问端口

#报错2：端口已开启，外部无法访问

#处理2：开启防火墙端口例外，放行3000端口
firewall-cmd --zone=public --add-port=3000/tcp --permanent
firewall-cmd --reload

6.2. 使用异常

6.2.1. 字体无法显示

调用宏函数输入中文后，无法正常显示字体

在这里插入图片描述

#1.创建中文字体目录
mkdir /usr/share/fonts/chinese

#2上传本地windows的黑体字体至 /usr/share/fonts/chinese目录下即可：
simhei.ttf

#3.修改目录的权限
chmod -R 755 /usr/share/fonts/chinese

#4.修改/bin/setenv.sh，增加以下语句
CATALINA_OPTS="-Dfile.encoding=UTF-8 ${CATALINA_OPTS}"