Syncd: 一款Go语言开发的开源自动化部署工具

Syncd - 自动化部署工具

syncd是一款开源的代码部署工具，它具备简单、高效、易用等特色，能够提升团队的工做效率.

项目地址 github.com/dreamans/sy…

目录

• 特性
• 原理
• 安装
• 使用
• 帮助
• 受权

特性

• Go语言开发，编译简单、运行高效
• Web界面访问，交互友好
• 灵活的角色权限配置
• 支持Git仓库
• 分支、tag上线
• 部署hook支持
• 完善的上线工做流
• 邮件通知机制

原理

Git

Syncd服务经过git-ssh(或password)方式从仓库中拉取指定tag(分支)代码

构建

运行配置好的构建脚本, 编译成可上线的软件包

在这一环节中，可运行单元测试 (例如 go test php phpunit, 下载依赖 (如 go: glide install php: composer install), 编译软件包 (如 js: npm build go: go build xx.go java: javac xx.java c: cc xx.c) 等.

分发

经过 scp 命令分发软件包到各机房生产服务器的临时目录, 远程执行 pre-deploy 配置的命令, 执行完毕后解压缩软件包到目标目录，而后执行 post-deploy 命令

分发上线过程是串行执行，而且任意步骤执行失败整个上线单会终止上线并将状态置为上线失败，须要点击 再次上线 重试.

未来会支持同一集群服务器并行执行, 集群之间串行发布的特性

SSH信任

生产服务器与部署服务器之间经过ssh-key创建信任

配置方法请参考 秘钥配置 章节

安装

准备工做

• Go

推荐Go1.10以上版本, 用来编译源代码

• Nginx

Web服务依赖Nginx

• MySQL

系统依赖Mysql存储持久化数据, 推荐版本 Mysql 5.7

• Linux + Bash

系统会使用到 git, ssh, scp 等命令，因此目前只推荐在Linux上使用, 而且须要提早安装或更新这些命令道最新版本

• 秘钥配置

因为部署服务器(Syncd服务所在的服务器)与生产服务器(代码部署目标机)之间经过ssh协议通讯，因此须要将部署机的公钥 (通常在这里: ~/.ssh/id_rsa.pub)加入到生产机的信任列表中(通常在这里 ~/.ssh/authorized_keys)

可以使用 ssh-copy-id 命令添加，或手动拷贝. 拷贝后不要忘记进行测试连通性 ssh {生产机用户名}@{生产机地址}

最后建议将如下配置加入到部署服务器ssh配置/etc/ssh/ssh_config中，关闭公钥摘要的显示提示，防止后台脚本运行失败

Host *
    StrictHostKeyChecking no
复制代码

请注意: ssh目录权限需按此设置，不然会出现没法免密登陆的状况

~/.ssh  0700
~/.ssh/authorized_keys 0600
复制代码

安装

• 运行如下命令

curl https://raw.githubusercontent.com/dreamans/syncd/master/install.sh |bash
复制代码

当前路径中若生成 syncd-deploy 或者 syncd-deploy-xxx 目录则代表安装成功

生成的 syncd-deploy 目录可拷贝或移动到你想要的地方，但不要试图将此目录拷贝到其余服务器上运行，会形成不可预料的结果.

• 数据库依赖

你须要将 github.com/dreamans/syncd/syncd.sql 数据表结构和数据导入到MySQL数据库中

• 修改配置文件

修改 syncd-deploy/etc/syncd.ini 中相关配置信息, 具体配置描述可参考注释

• 启动服务

cd syncd-deploy

➜  syncd-deploy ./bin/syncd -c ./etc/syncd.ini
                                          __
   _____   __  __   ____     _____   ____/ /
  / ___/  / / / /  / __ \   / ___/  / __  /
 (__  )  / /_/ /  / / / /  / /__   / /_/ /
/____/   \__, /  /_/ /_/   \___/   \__,_/
        /____/

Service:              syncd
Version:              1.0.0
Config Loaded:        ./etc/syncd.ini
Log:                  stdout
Database:             127.0.0.1
Mail Enable:          0
HTTP Service:         :8868
Start Running...

复制代码

• 添加Nginx配置

upstream syncdServer {
    server 127.0.0.1:8868 weight=1;
}
server {
    listen       80;
    server_name  deploy.syncd.cc; # 此处替换成你的真实域名
    access_log   logs/deploy.syncd.cc.log;

    location / {
        try_files $uri $uri/ /index.html;
        root /path/syncd-deploy/public; # 此处/path请替换成真实路径
        index index.html index.htm;
    }

    location ^~ /api/ {
        proxy_pass          http://syncdServer;
        proxy_set_header    X-Forwarded-Host $host:$server_port;
        proxy_set_header    X-Real-IP     $remote_addr;
        proxy_set_header    Origin        $host:$server_port;
        proxy_set_header    Referer       $host:$server_port;
    }
}
复制代码

重启nginx服务

修改hosts

若域名未解析，可修改hosts进行临时解析

sudo vim /etc/hosts

127.0.0.1  deploy.syncd.cc;
复制代码

安装完成

打开浏览器，访问 http://deploy.syncd.cc

初始帐号:

用户名: syncd
邮箱: syncd@syncd.cc
密码: syncd.cc
复制代码

!!!登陆后请尽快修改密码

使用

系统使用流程图

使用截图

帮助

遇到问题请提 issue

或者加微信进讨论群

受权

本项目采用 MIT 开源受权许可证，完整的受权说明已放置在 LICENSE 文件中