devbox
繁依Fanyi0
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

开源工具专题-04 Atlassian Crowd部署备份及迁移_crowd 部署

作者：繁依Fanyi0 | 2024-06-07 08:32:38

赞

踩

crowd 部署

开源工具专题-04 Atlassian Crowd部署备份及迁移

注：

  • 本教程由羞涩梦整理同步发布，本人技术分享站点：blog.hukanfa.com
  • 转发本文请备注原文链接，本文内容整理日期：2024-05-29
  • csdn 博客名称：五维空间-影子，欢迎关注

1 安装部署

1.1 制作镜像

注：官方镜像也是可以用的，但这里需要做些定制操作所以干脆自行制作镜像

  • 操作如下

    • 前置环境准备
    # 创建目录
mkdir DiyCrowdImage && cd DiyCrowdImage

# 下载crwod包
wget https://product-downloads.atlassian.com/software/crowd/downloads/atlassian-crowd-3.7.2.tar.gz

# 下载jdk 官网：https://www.oracle.com/cn/java/technologies/downloads/
链接：https://pan.baidu.com/s/1rEJbDiGD2iwyv6NVxex_Kw?pwd=ud62 

# 下载 Atlassian Crack Agent 作者：https://zhile.io/2018/12/20/atlassian-license-crack.html
链接：https://pan.baidu.com/s/1q9XU9o7LUjYC5howh_ZSPg?pwd=20ia

# 下载mysql5.7驱动包 官网：https://downloads.mysql.com/archives/c-j/
5.1.49 链接：https://pan.baidu.com/s/1ulTRJfEmV0X7I8JMueNFsw?pwd=a7cq 

# 准备完毕，目录下的文件如下所示
DiyCrowdImage/
├── atlassian-agent.jar
├── atlassian-crowd-3.7.2.tar.gz
├── Dockerfile
├── jdk-8u411-linux-x64.tar.gz
└── mysql-connector-java-5.1.49-bin.jar

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • Dockerfile
    FROM hukanfa/rockylinux:9.3-base-v1.0
# 设置环境变量
ENV crowdData=/data \
    crowdHome=/app/crowd \
    crowdTomcatHome=/app/crowd/apache-tomcat \
    crowdInitConfig=/app/crowd/crowd-webapp/WEB-INF/classes/crowd-init.properties \
    crowdVersion=3.7.2
# 创建目录
RUN mkdir -p /app /data
# java
#ADD jdk1.8.0_77.tar.gz  /usr/local/
ADD jdk-8u411-linux-x64.tar.gz /usr/local
# crowd
ADD atlassian-crowd-${crowdVersion}.tar.gz /app/
# rename
RUN mv /app/atlassian-crowd-${crowdVersion} ${crowdHome} \ 
    && mv /usr/local/jdk1.8.0_411  /usr/local/jdk
# java 全局声明
ENV PATH=/usr/local/jdk/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

# 拷贝破解agent 和 mysql 驱动
COPY atlassian-agent.jar /app/crowd/apache-tomcat/bin/
COPY mysql-connector-java-5.1.49-bin.jar /app/crowd/apache-tomcat/lib/

# 设置 crowd.home
RUN echo "crowd.home=${crowdData}" >> ${crowdInitConfig}
# 在声明java参数前插入加载agent的启动配置
RUN sed -ri "/export JAVA_OPTS/i JAVA_OPTS=\"-javaagent:\$CATALINA_HOME\/bin\/atlassian-agent.jar \${JAVA_OPTS}\" " ${crowdTomcatHome}/bin/setenv.sh

# 卷声明
VOLUME ["/data","/app/crowd/apache-tomcat/conf"]

# 工作目录
WORKDIR $crowdTomcatHome

# 端口
EXPOSE 8095

# 启动
CMD ["bin/catalina.sh", "run", "$@"]

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 构建镜像
    # 此镜像已经同步推送到hub.docker.com，可直接拉取
docker build -t hukanfa/crowd:3.7.2-agent-mysql-v1.0 .

    • 1
    • 2
    • 创建容器
    ### 宿主机是 centos 直接执行以下命令
docker run -itd --privileged=true -p 8095:8095 --name crowd hukanfa/atlassian-crowd:3.7.2-agent-mysql-v1.0
  
### 宿主机是 Rockylinux9.3 需要做些设置
# 路径： /usr/lib/systemd/system/docker.service  增加 --default-ulimit nofile
[Service]
Type=notify
ExecStart=/usr/bin/dockerd --default-ulimit nofile=65535:65535 -H fd:// --containerd=/run/containerd/containerd.sock
ExecReload=/bin/kill -s HUP $MAINPID
  
# 重载配置
systemctl daemon-reload
# 重启docker服务
systemctl restart docker
# 最后执行下面命令
docker run -itd --privileged=true -p 8095:8095 --name crowd hukanfa/atlassian-crowd:3.7.2-agent-mysql-v1.0

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16

    • 访问http://ip:8095，出现以下界面说明镜像制没问题

      image-20240520145259833

1.2 创建容器

  • 操作如下

    • docker-compose.yaml
    version: '3'
services:
  confluence:
    image: hukanfa/atlassian-crowd:3.7.2-agent-mysql-v1.0
    container_name: crowd-srv
    user: root
    privileged: true
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
    ports:
      - "8095:8095"
    volumes:
      - ./data:/data
      - ./webConf:/app/crowd/apache-tomcat/conf

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 拷贝文件
    # 创建临时容器
docker run -itd --privileged=true -p 8095:8095 --name crowd hukanfa/atlassian-crowd:3.7.2-agent-mysql-v1.0
# 进入容器
docker exec -it crowd /bin/bash
# 打包配置目录
tar -zcvf conf.tar.gz ./conf/

# 另开窗口，拷贝到外面
docker cp crowd:/app/crowd/apache-tomcat/conf.tar.gz ./
# 解压
tar -zxvf conf.tar.gz 
# 重命名
mv conf webConf

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 创建容器
    docker-compose up -d

    • 1
    • mysql5.7
    # mysq请自行部署，提供5.7容器方式部署demo下载链接，解压运行即可
https://pan.baidu.com/s/1bWL03T9q0PwDbUINu4HnOA?pwd=0m1t 

# my.cnf 文件需加入以下配置
[mysqld]
...
transaction-isolation = READ-COMMITTED

# 创建用户及数据库并授权,crowd 此版本只支持 utf8 格式
CREATE USER 'crowd'@'%' IDENTIFIED BY 'UxqibGbgx3';
create database crowd CHARACTER SET utf8 COLLATE utf8_bin;
GRANT ALL ON crowd.* TO 'crowd'@'%';
flush privileges;

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

1.3 初始配置

  • 操作如下

    • 访问http://ip:8095，点击 Set up Crowd

    image-20240520164308888

    • 复制 Server ID
    # Server ID 
B8VY-UDPW-7NRD-1R6H
# 获取 License_key
docker exec -it crowd-srv java -jar /app/crowd/apache-tomcat/bin/atlassian-agent.jar \
-p crowd \
-m hukanfa@example.com \
-n crowd_license \
-o https://www.hukanfa.com \
-s B8VY-UDPW-7NRD-1R6H  # 替换为 Server ID
# 将生成的 license 粘贴到页面的文本框中
AAABlQ0ODAoPeJxtkU+PmzAQxe/+FEg9ViQYCAmRLG0WiJYq5A8k2eZUedlJcBcMtQ0s/fQlCblUK
/niGc97P7/5FpVci2inmYaGnbntzk1X85J9fzdt5AmgipXcpwrItaIbE900UNDQvL51yJnmEpAPM
hWsulUOPGcFU/Cu5SwFLkF767RMqUrOx+O/GcthxEq0ERfKmbyLPLpt246y+oPyMx2lZYFSUbbvo
9VdZt9VsKYFEG8TRUHshYvV8CBRVCgQA4tXckVTFUSU5WRQe4JPWlS981V1wHqhMiORZ3jLnfds8
fZPieVlcZz4S/YzOf/4HU7G1ml/CQ+LOrPGu/gUFssudrffG7trjp5ZmdaOoN6FK+CUpxB8Vkx0Q
1YzVzem/UEDfeiTVegnwVpf4Sl2sGu7jotte/hCD8waIErUgBIQDYh+4Hl2POkHf/uqT9exr+PYe
UEf0B1ByGtq2DGMqTGzLPww+ZpgW4s0oxL+3+LdeV0XbyA254PsZYmOH/E8XEzUQ5MvwIecbyu5S
f0aJv8BzejCkzAsAhRxb9+rU5GnV6uaUHhvmZmjvJH3nwIUFbxqhLgFf/XCrc+hXhWVHrLkVnY=X
02jj

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19

    image-20240520165042878

    image-20240529142939120

    • 下一步，选择 Continue

    image-20240529143003281

    • 数据库配置
    # JDBC_URL 前面配置的账号密码： crowd  UxqibGbgx3
jdbc:mysql://192.168.26.5:3307/crowd?autoReconnect=true&characterEncoding=utf8&useUnicode=true

    • 1
    • 2

    image-20240520170137846

    重要：数据库初始化完成后，需要把库和相关表字符集调整成utf8mb4

    ### 目的：支持带有表情包的用户名称，兼容其他数据源的数据迁移导入而不报错
# 修改数据库字符集
ALTER DATABASE crowd CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci;
# 修改用户表字符集
ALTER TABLE cwd_user CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

    • 1
    • 2
    • 3
    • 4
    • 5
    • 下一步：访问设置

    image-20240529143514582

    image-20240520170538645

    • 管理员账号密码设置

    image-20240520170647075

    • 下面直接点继续

    image-20240520170824596

    • 以上所有配置完成会跳转到登录界面，至此，初始配置已完成

    image-20240520170931286

1.4 Jvm管理(可选)

  • 说明

    • 本节主要介绍如何手动管理crowd(tomcat)的jvm大小
    • 也可忽略，使用默认配置即可

  • 操作如下

    • setenv.sh 调整
    # 容器内路径： /app/crowd/apache-tomcat/bin/setenv.sh ，主要是前三行
jvmXms=${JVM_TOMCAT_XMS:=128m}
jvmXmx=${JVM_TOMCAT_XMX:=512m}
JAVA_OPTS="-Xms${jvmXms} -Xmx${jvmXmx} -Dfile.encoding=UTF-8 $JAVA_OPTS"

JAVA_OPTS="-javaagent:$CATALINA_HOME/bin/atlassian-agent.jar ${JAVA_OPTS}" 
export JAVA_OPTS

# set the location of the pid file
if [ -z "$CATALINA_PID" ] ; then
    if [ -n "$CATALINA_BASE" ] ; then
        CATALINA_PID="$CATALINA_BASE"/work/catalina.pid
    elif [ -n "$CATALINA_HOME" ] ; then
        CATALINA_PID="$CATALINA_HOME"/work/catalina.pid
    fi
fi
export CATALINA_PID

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • docker-compose.yaml
    version: '3'
services:
  confluence:
    image: hukanfa/atlassian-crowd:3.7.2-agent-mysql-v1.0
    container_name: crowd-srv
    user: root
    privileged: true
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
      - JVM_TOMCAT_XMS="500m"
      - JVM_TOMCAT_XMX="2000m"
    ports:
      - "8095:8095"
    volumes:
      - ./data:/data
      - ./webConf:/app/crowd/apache-tomcat/conf
      - ./setenv.sh:/app/crowd/apache-tomcat/bin/setenv.sh

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 查看调整
    [root@hukanfa crowd]# docker top crowd-srv

    • 1

    image-20240529165257539

    • 界面 System Information 显示的 JVM statistics 也相应变化

    image-20240529165434379

2 数据备份

  • 说明

    • Crowd 是账号统一管理及认证平台，其数据安全必须得到可靠保障
    • Crowd 数据备份有2种途径
      • 1 界面设置定时备份规则，会生成.xml格式的备份文件
      • 2 数据库载体的备份，不管是用 hsqldb 还是 mysql 都应做相应的备份措施

  • 操作如下

    • 路径：右上角小齿轮 > Backup

    image-20240520185502604

    • 备份文件存放路径
    # 最多保留50份备份
/data/shared/backups

    • 1
    • 2

3 数据迁移&恢复

  • 说明

    • Crowd 支持通过导入备份的xml格式文件进行数据迁移或恢复

  • 数据迁移注意事项说明

    • 此次将3.7.0版本且数据源是HSQLDB的实例数据迁移到3.7.2版本的mysql
    • 若想保持 3.7.0 版本的管理员用户迁移后密码不变，需在新建3.7.2版本实例时，在以下页面设置相同密码

    image-20240520170647075

    • 在 3.7.2 实例所有设置完成后，到数据库cwd_user表中将该用户的credential字段值记录下来
    • 将 3.7.0 实例备份出的xml文件导入到 3.7.2 完成后，再比对导入前和导入后的credential值是否一致，若不一致则用前面记录的值更新导入后的即可
    • 其他非以上初始界面添加的用户密码不变，将和 3.7.0 的一致

  • 操作如下

    • 直接从备份目录中选择指定的备份文件进行恢复
    # 
/home/hukanfa/crowd/data/shared/backups
[root@hukanfa backups]# ls
atlassian-crowd-2024-05-21-020000-automated-backup-3.7.0.xml

    • 1
    • 2
    • 3
    • 4
    • 界面操作恢复操作
    # 注意，在4.1.3节初始配置中提到。数据迁移操作需对crowd数据库和cwd_user表字符集先转成utf8mb4先
/data/shared/backups/atlassian-crowd-2024-05-21-020000-automated-backup-3.7.0.xml

    • 1
    • 2

    image-20240521103751449

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/繁依Fanyi0/article/detail/684655
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号