# Dkit

**Repository Path**: runner/Dkit

## Basic Information

- **Project Name**: Dkit
- **Description**: 部署管理工具.可以管理svn仓库和服务器,方便的设置哪个svn分枝部署到哪些服务器上,并可以给svn设置hook,实现代码提交自动部署.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2015-02-07
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#Dkit
自动部署工具.目前只支持linux+svn,可以管理svn仓库和服务器,方便的设置哪个svn分枝部署到哪台服务器上,并可以hook svn仓库,svn提交时自动化部署.

# 运行环境
* 需要python3.3及以上python版本;
* 必须安装到svn server同一台机器;
* 最好以root权限运行。因为设置svn的hook时，需要覆盖svn的post-commit文件，并且给它执行权限;

# 下载
* 直接下载压缩包或通过git:

        git clone https://git.oschina.net/wei/Dkit.git

#安装
* 通过virtualenv安装（推荐）.比如我这里把创建的evn环境放到自己的home目录下:

        cd ~
        virtualenv -p python3 env3
        source ~/env3/bin/activate
        cd xx/xxx #跳回你下载的Dkit目录
        ./install.sh
* 直接安装

        alias python=python3
        ./install.sh
        
如果一切顺利,安装完成后你会看到初始用户名和密码(admin 12345).

#运行
* virtualenv安装后运行：

        source ~/env3/bin/activate
        python run.py
    
* 直接安装后运行：

        python3 run.py
    
默认的端口是5002.如果希望后台运行请自己编辑start.sh启动脚本,如果你用了virtualenv,需要在里改一下自己的env路径.

#使用前需要做的配置
* 1.你需要编辑一下目录下的`post-commit.temp`文件,设置一下`LC_CTYPE`变量和deploy.py路径.具体`post-commit.temp`里有注释;设置svn的hook时,将用这个文件覆盖svn的post-commit
* 2.进入系统后,请第一时间到"系统管理"->"系统设置"对svn参数进行设置.

#问题解决
* 如果安装时出现了如下错误(ubuntu下):

        ImportError: No module named 'pysqlite2'

    请安装下面的模块：

        sudo apt-get install install sqlite3 libsqlite3-dev
        
    如果重新安装还有问题，则需要重新编译安装你的python3.或者不用sqlite数据库，改用mysql(如果你已经有mysql的话),改用mysql可以如下操作:

        pip install pymysql

    然后编辑Dkit目录下的`config.py`,按下面修改mysql连接信息:

        SQLALCHEMY_DATABASE_URI='mysql+pymysql://username:password@host:port/dbname?charset=utf8'

    然后重新初始化数据库:

        python initdb.py

#用到的其他开源项目
* flask(以及flask的一些扩展,比如flask-sqlalchemy,flask-wtf等);
* eventlet;
* paramiko;
* UI使用了bootstrap3+jeasyUI