526互联

Gitlab13.1.11配置支持PlantUML

发布时间 2023-09-08 10:28:54作者: xuege

Gitlab配置支持PlantUML

1 环境说明

  • Gitlab版本：13.1.11

  • PlantUML: 1.2023.10

  • Graphviz: 8.1.0

2 部署方式说明

PlantUML独立于Gitlab部署，部署环境为Anolis OS release 7.9。

PlantUML: 源码 编译成war包，用Tomcat10部署，JDK用SUN JDK11.0.6。

Graphviz: 源码编译安装

PlantUML以https方式提供给gitlab调用。

3 实施步骤

  1. 安装一些依赖包

    # yum -y install expat  expat-devel glibc-common fonts-arphic-uming  kde-l10n-Chinese

  2. 安装Graphviz， 从官网下载8.1.0版本， 然后按如下进行安装

    # tar zxvf graphviz-8.1.0.tar.gz 
# cd graphviz-8.1.0/
# ./configure --prefix=/usr/local/graphviz-8.1.0
# mkdir -p /opt/local
# ln -s /usr/local/graphviz-8.1.0/bin /opt/local/bin

  3. 安装Tomcat10， JDK11.0.6， 略

  4. 安装plantuml,这里用的是war包，用打war包，需要用安装mvn

    # wget https://dlcdn.apache.org/maven/maven-3/3.8.8/binaries/apache-maven-3.8.8-bin.tar.gz
# tar zxvf apache-maven-3.8.8-bin.tar.gz 
# mv apache-maven-3.8.8 /usr/local/
# vim /etc/profile ## 添加一行
PATH=$PATH:/usr/local/apache-maven-3.8.8/bin
# source /etc/profile

# git clone https://github.com/plantuml/plantuml-server.git
# cd plantuml-server
# mvn package  # war包在target目录下

  5. 将war包放置在Tomcat的webapps下，启动Tomcat。

  6. 配置nginx，用途是在Nginx上配置https（也可以在Tomcat中配置），具体过程略。

  7. 我最终对gitlab提供的plantuml 服务为https://xxxx/plantuml

  8. 配置gitlab（xxx换成自己实质的域名）

    # vim /etc/gitlab/gitlab.rb   # 增加2行
nginx['custom_gitlab_server_config'] = "location /-/plantuml { \n rewrite ^/-/(plantuml.*) /$1 break;\n proxy_cache off; \n proxy_pass https://xxxx/plantuml; \n}\n"
gitlab_rails['env'] = { 'PLANTUML_ENCODING' => 'deflate' }

  9. 用管理员账号登录gitlab web Admin Area->Settings->Integrations->PlantUML, 输入PlantUML， 比如我这里的就是https://xxxx/plantuml

  10. 可以到plantuml 去找demo测试, 在gitlab的README中，用plantuml包起来。 比如：

注意事项

  1. 可能PlantUML会出现中文乱码情况， 解决方法：在Tomcat里面配置utf-8字符集， 并且PlantUML 服务器yum安装支持中文集。

  2. 有些图形显示不了的话，可能是graphviz 版本与plantuml版本兼容问题，我这里用的版本测试。 用graphviz低版本会有问题。

  3. 不配置成https的话，有些浏览器会显示不了（比如高版本的chrome）

参考

PlantUML | GitLab