SVNAdmin2 |
您所在的位置:网站首页 › v2可视化面板 › SVNAdmin2 |
SVNAdmin2 - 基于web的SVN管理系统
1. 介绍
SVNAdmin2 是一款通过图形界面管理服务端SVN的web程序。 正常情况下配置SVN仓库的人员权限需要登录到服务器手动修改 authz 和 passwd 两个文件,当仓库结构和人员权限上了规模后,手动管理就变的非常容易出错,本系统能够识别人员和权限并提供管理和拓展功能。 SVNAdmin2 支持SVN协议检出、HTTP协议检出,并且支持两种协议之间互相切换,支持docker部署或源码部署。 SVNAdmin2 支持进行LDAP的接入,进而达到使用原有的人员架构和分组规则的目的。 GitHub地址 Gitee地址 问题求助、功能建议、更新计划、SVN技术讨论,可加QQ群:633108141 项目演示地址:http://svnadmin.witersen.com (管理人员/admin/admin) 系统截图 ![]() docker > CentOS7 > CentOS8 > Rocky > Ubuntu>… Windows下如有需求,可使用 docker 版本 PHP版本:[php5.5 , php8.2] (开发基于php7.4所以推荐使用php7.4) 数据库:SQLite、MySQL Subversion:1.8+ 3. docker安装nas用户的docker部署教程在这里 3.1 适用于:快速部署看效果ps:镜像默认托管在docerhub,如果速度不佳,可以选择国内路线(docker pull registry.cn-hangzhou.aliyuncs.com/witersencom/svnadmin:[镜像版本号]) 此方式可快速部署程序体验效果,数据不存储在宿主机,生产环境使用请看3.2 docker run -d --name svnadmintemp -p 80:80 -p 3690:3690 --privileged witersencom/svnadmin:2.5.4 3.2 适用于:新用户正式使用 启动一个临时的容器用于复制配置文件出来 docker run -d --name svnadmintemp --privileged witersencom/svnadmin:2.5.4 /usr/sbin/init 把配置文件复制到本机的 /home/svnadmin 目录 cd /home/ docker cp svnadmintemp:/home/svnadmin ./ docker cp svnadmintemp:/etc/httpd/conf.d ./svnadmin/ docker cp svnadmintemp:/etc/sasl2 ./svnadmin/ 删除掉临时容器 docker stop svnadmintemp && docker rm svnadmintemp 启动正式的容器 docker run -d -p 80:80 -p 3690:3690 \ -v /home/svnadmin/:/home/svnadmin/ \ -v /home/svnadmin/conf.d/:/etc/httpd/conf.d/ \ -v /home/svnadmin/sasl2/:/etc/sasl2/ \ --privileged \ --name svnadmin \ witersencom/svnadmin:2.5.4 进入容器内进行文件授权 docker exec -it svnadmin bash chown -R apache:apache /home/svnadmin 3.3 适用于:旧用户升级ps: 2.4.3 及之前的用户要注意目录挂载多了 conf.d sasl2 升级之前要提前复制出来 2.3.x和2.4.x和2.5.x升级到2.5.4 (可以联网的用户) 进入容器内yum install -y unzipcd /var/www/html/server && php install.php退出容器停止旧的容器,拉取新容器,挂载本地的数据目录到新版本的容器即可 2.3.x和2.4.x和2.5.x升级到2.5.4 (不可联网的用户) 在有网络的环境下下载升级包,注意下载 update.tar.gz 而不是 update.zip提前下载好升级包并复制到容器中 /var/www/html/server/ 目录下cd /var/www/html/server/tar -zxvf update.tar.gzphp update/index.php退出容器停止旧的容器,拉取新容器,挂载本地的数据目录到新版本的容器即可 4. 源码安装svnadmin = web系统 + 后台进程,因此安装注意噢 4.1 适用于:CentOS7、Rocky等 安装解压缩等工具 yum install -y zip unzip wget vim which 安装sasl相关依赖(svn协议检出配置sasl认证如ldap要用到) yum install -y cyrus-sasl cyrus-sasl-lib cyrus-sasl-plain 安装PHP和相关扩展(CentOS7默认源中提供的PHP版本为5.4,而我们需要 5.5+,因此使用remi源) yum install -y epel-release yum-utils rpm -Uvh https://mirrors.aliyun.com/remi/enterprise/remi-release-7.rpm yum-config-manager --enable remi-php74 yum install -y php php-common php-cli php-fpm php-mysqlnd php-mysql php-pdo php-process php-json php-gd php-bcmath php-ldap php-mbstring 安装web服务器(推荐 apache 可使用http协议检出) yum install -y httpd mod_dav_svn mod_ldap systemctl start httpd systemctl enable httpd 安装任务计划组件(任务计划功能用到) yum install -y cronie at #启动atd(如果 ps aux | grep -v 'grep' | grep atd 的结果为空需要执行) atd #启动crond(如果 ps aux | grep -v 'grep' | grep crond 的结果为空需要执行) crond 下载解压代码包 cd /var/www/html/ && wget https://gitee.com/witersen/SvnAdminV2.0/releases/download/2.5.4/2.5.4.zip unzip 2.5.4.zip 安装Subversion(如果你安装过Subversion,本步骤可以略过)(注意需要Subversion >= 1.8) cd /var/www/html/server/ chown -R apache:apache /var/www/html/ #选项1 php install.php 修改Subversion的配置使其支持被本系统管理(如果你安装过Subversion,本步骤要执行) cd /var/www/html/server #选项1或选项2 php install.php 为数据目录授权属主和属组。php脚本web调用是以apache身份执行,因此apache用户需要对数据目录有权如果你使用其它web服务器如nginx tomcat 可以通过浏览器访问 你的机器IP/server/own.php 来获取属主和属组 chown -R apache:apache /home/svnadmin手动启动后台进程(启动方式一) #pwd #/var/www/html/server/ #后台运行 nohup php svnadmind.php start >/dev/null 2>&1 & #后台运行后输入exit退出一下 保证后台稳定运行 exit #停止后台 php svnadmind.php stop #调试模式 php svnadmind.php console通过系统管理启动后台进程(启动方式二) 新建系统服务文件 svnserve.service(centos一般为 /usr/lib/systemd/system/svnadmind.service、ubuntu 一般为 /lib/systemd/system/svnadmind.service) 写入以下内容(注意根据自己的代码部署路径调整) [Unit] Description=SVNAdmin After=syslog.target network.target [Service] Type=simple ExecStart=/usr/bin/php /var/www/html/server/svnadmind.php start [Install] WantedBy=multi-user.target 操作服务 #启动 systemctl daemon-reload systemctl start svnadmind #查看状态 systemctl status svnadmind #加入开机自启动 systemctl enable svnadmind 4.2 适用于:宝塔面板安装方式跟手动部署类似,只是宝塔系统了很多可视化操作很方便 参考视频:SVNAdmin V2.2.1 系统部署与使用演示视频【针对宝塔面板】 4.3 适用于:ubutntu18 步骤同1(注意需要以root用户执行 server/install.php 和 server/svnadmind.php )在ubuntu中软件包名称多与CentOS系列不同,需要用户自行处理 sudo apt-get update sudo apt-get install -y apache2 sudo apt-get install -y php sudo apt-get install -y php-cli sudo apt-get install -y php-fpm sudo a2enmod proxy_fcgi setenvif sudo systemctl restart apache2 sudo a2enconf php7.2-fpm sudo systemctl reload apache2 sudo apt-get install -y php-json sudo apt-get install -y php7.2-mysql sudo apt-get install -y php-mysql sudo apt-get install -y sqlite3 sudo apt-get install -y php7.2-sqlite sudo apt-get install -y php-gd sudo systemctl restart apache2 sudo apt-get install -y subversion subversion-tools cd /var/www/html wget xxx.zip unzip xxx.zip #选项2 sudo server/install.php chown -R apache:apache /home/svnadmin/ su root nohup php server/svnadmind.php start & 4.4 适用于:旧用户升级 2.3.x和2.4.x和2.5.x升级到2.5.4 yum install -y unzipcd /var/www/html/server && php install.php 5. 常见问题解答 5.1 使用此系统管理管理之前的仓库 ?确认之前SVN仓库的版本,如果是1.8+则无需担心,如果是1.8以下,则需要简单升级下仓库 安装本系统 执行 php server/install.php 使用内置的功能重新配置你的Subversion 将已有的一个或多个SVN仓库移动到 /home/svnadmin/rep/ 目录下 在导航SVN仓库中执行同步列表,即可识别SVN仓库 注意:如果你原来是一个仓库一套配置文件的方式,则还需要按照截图的方式稍微调整下你的配置文件。因为现在是多个仓库一套配置文件的管理方式。 ![]() 系统中使用了一些多进程的方案,而这在Windows下实现需要花费更多的时间 短期内没有支持Windows部署的计划 Windows下使用可通过docker版本 5.5 仓库初始化结构模板 ? 我们可以在创建仓库的时候选择创建指定内容结构的仓库,如包含 “trunk” “branches” “tags” 文件夹的结构,这一结构是可选的并且可调整的,我们可以手动调整 /home/svnadmin/templete/initStruct/01/ 下的目录结构 5.6 常用钩子推荐 ? 我们可以在目录 /home/svnadmin/hooks/ 下增加自己常用的钩子 /home/svnadmin/hooks/ 下建立文件夹 xx,名称任意在 xx 下新建文件 hookDescription 写入对此钩子的描述文本内容在 xx 下新建文件 hookName 写入钩子类型,如post-commit等在 xx 下新建文件 ,以钩子类型命名,如 post-commit ,然后写入具体钩子内容 5.7 管理员找回密码 使用默认的SQLite数据库 #使用sqlite数据库 yum install -y sqlite-devel cd /home/svnadmin sqlite3 svnadmin.db .header on .mode column select * from admin_users; 使用MySQL数据库 使用可视化工具登录到数据库查看 admin_users 数据表信息即可 5.8 关于大文件下载中断问题 当下载1G以及以上的大文件会出现下载被中断的问题,是因为文件下载为了安全没有使用http文件直链,而是通过php校验后读取文件流下载,所以会存在一个php-fpm最大执行时间的问题,因此你可以通过 设置 php-fpm.conf 配置文件的 request_terminate_timeout 为0 来取消超时限制 5.9 如果配置了多个仓库模板,如何在创建仓库时指定使用某个仓库模板? 例如: 在 /home/svnadmin/templete/initStruct/01 下面配置第一个仓库结构模板 在 /home/svnadmin/templete/initStruct/02 下面配置第二个仓库结构模板 如果在web中创建时,如何选用默认的 /home/svnadmin/templete/initStruct/02 下面的仓库结构模板? 【解决方案】 由于时间问题,开发时并没有对此功能做更多的详细开发,因此只预留了配置文件层面的修改途径,后续会将仓库模板功能加入到web配置,无需手动命令行管理 可以通过修改 config/svn.php 中的 templete_init_struct_01 值来修改 5.10 配置了自定义仓库模板但是创建仓库时没有生效 注意配置自定义仓库模板的位置 通常的位置在 /home/svnadmin/templete/initStruct/01 下面 而不是在项目代码相关的位置 5.11 数据长度超过8192 请向上调整参数:SOCKET_READ_LENGTH 【出现问题原因】 svn的用户量和权限配置数量增加,超过了默认值 【解决方案】 修改 config/daemon.php 文件中的参数 5.12 提示无法连接到LDAP服务器 确定以下两点 1、你的 ldap 服务器地址和端口真实有效 2、安装 svnadmin2 的机器确实可以通过 ldap 端口与你的 ldap 服务所在服务器通信 然后检查 svnadmin2 所在机器的 selinux 配置,通常 selinux 会禁止 http 连接 ldap 执行: getsebool -a | grep ldap 如果得到以下结果: httpd_can_connect_ldap --> off 证明需要我们手动开启 httpd_can_connect_ldap 这个选项 执行以下指令允许连接即可 setsebool -P httpd_can_connect_ldap=1 以上情况为 selinux 开启可能出现的,当关闭 selinux 后以上配置不再起作用 5.13 LDAP启用状态下用户已授权但是无权限浏览仓库 这种情况通常是因为源码安装过程中,少装了有关ldap 的模块或依赖,建议详细看文档 5.14 LDAP状态下用户列表同步成功但是无法登录(2.4.x版本之前的问题) 这种情况下通常是因为你的 Base DN 配置问题 假设 你的 base dn 填写为:dc=witersen,dc=com 你的 Attributes 填写为: cn 然后你过滤出用户:blue 那么 blue 作为一个 SVN 用户来登录系统的时候,系统会将 cn=blue,dc=witersen,dc=com 来作为用户 blue 的完整 dn 并且结合用户输入的密来一起请求 ldap 服务器进行校验,所以如果 blue 用户的真实 dn 是 cn=blue,ou=devGroup,dc=witersen,dc=com 就会造成同步成功登录失败的情况 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |