可视化、自动化一直程序员追求的工具化最高境界!通过可视化界面来实现自动化过程,从而提高生产、工作效率。所以,好用的工具是必须的前提。
今天,给大家介绍一款轻量级自动化部署服务:Go Runner!
介绍
Go Runner 是领先的开源自动化项目部署服务!支持各种 web、php、java、python、go 等代码的发布,所有操作可以通过 web 来一键完成。Go Runner 基于 go 构建安装简单,无需安装其他依赖环境,开箱即用。Go Runner 是一个可自由配置项目的开源上线部署系统。
特性
- 支持 gitlab、github、gitee仓库;
- 支持手动发布上线部署;
- 支持Test、Dev等多种环境webhook自动化部署,减少团队协作及开发成本;
- websocket 实时展示部署中的 shell console
下载
大家可以通过访问 https://gitee.com/marksirl/go-runner/releases 选择自己需要的安装包(根据操作系统)进行下载
安装
解压安装包,详细的目录结构如下
配置
配置 etc/config.yaml
具体的配置文件如下:
代码语言:javascript复制# 配置文件
Host: "127.0.0.1" # 运行addr
Port: "8080" # 运行端口
# webhook 自动化部署回调域名,根域名,如www.gn.com/www.ol.com
Domain: "http://go.runner.io"
# mysql (此处配置暂时不用理会)
MysqlDNS: mysql://root:123456@tcp(127.0.0.1:3306)/pave?charset=utf8mb4&parseTime=True&loc=Local
TimeZone: Asia/Shanghai
# 本地redis连接配置
RedisDNS: 61c07e1ae08d08a2@127.0.0.1:6379
# 默认redis使用库
DefaultDb: 1
# redis队列使用库
QueueDb: 12
# 消费者work数量
WorkNumber: 1
Nginx 配置
代码语言:javascript复制upstream runner {
server 0.0.0.0:8080 weight=1;
}
server {
listen 80;
server_name go.runner.io; # 域名设置
access_log /usr/local/var/log/nginx/runner.log; # 日志目录
error_log /usr/local/var/log/nginx/runner.error.log; # 日志目录
index index.html index.htm;
add_header Access-Control-Allow-Origin *;
add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS, PUT, DELETE, PATCH';
add_header Access-Control-Allow-Headers 'DNT,Keep-Alive,User-Agent,Cache-Control,Content-Type,Authorization,Access-Token';
# cors
if ($request_method = 'OPTIONS') {
return 204;
}
# api
location / {
client_max_body_size 50m;
client_body_buffer_size 128k;
proxy_connect_timeout 300;
proxy_send_timeout 300;
proxy_read_timeout 300;
proxy_buffer_size 4k;
proxy_buffers 4 32k;
proxy_busy_buffers_size 64k;
proxy_temp_file_write_size 64k;
# 将客户端的 Host 和 IP 信息一并转发到对应节点
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header REMOTE-HOST $remote_addr;
proxy_set_header HTTP-VIA $http_via;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# 转发Cookie,设置 SameSite
# proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";
proxy_cookie_path / "/; HttpOnly; SameSite=Lax";
# 执行代理访问真实服务器
proxy_pass http://runner;
}
# websocket
location /ws {
proxy_set_header Upgrade "websocket";
proxy_set_header Connection "upgrade";
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $host;
proxy_http_version 1.1;
# 转发到多个 ws server
proxy_pass http://runner;
}
}
运行项目
运行项目前请保证 data
目录和 runtime
目录的可写
权限
windows 用户打开cmd 运行
代码语言:javascript复制.awesome-runner.exe
mac、linux 运行
代码语言:javascript复制./awesome-runner
项目运行成功如下:
打开浏览器访问http://go.runner.io/web
进入 web 控制台
Web界面
项目部署脚本
需要明确部署脚本文件名为 xxx.runner-ci.yml
,它是存在于您的实际项目根目录下,随仓库提交更新下载,用于约束和申明部署时执行的脚本的配置文件。配置文件格式说明如下:
# 工作目录
webpath: /Users/zrone/Developments/dtest/runnnn
# 部署分支,至少一个,可以配置多个,用于自动化部署触发部署
only:
- master
- dev
- test
# 环境变量,用于脚本执行时申明环境变量,仅当前session有效,不会污染全局,可配置多个
environment:
workdir: /home/wwwroot/deploy
a: b
c: d
# pull前运行脚本
prepare:
- nginx -s stop
# pull 完成运行脚本
script:
- cd ${webpath} && pwd
# 发布运行脚本
release:
- nginx
- netstae -tunlp | grep 8080
Webhook 自动化部署配置
sshkey
自动化部署使用 webhook 通知实现,支持 gitlab/github/gitee,实现前建议配置 sshkey, 可通过以下代码生成 sshkey。
代码语言:javascript复制ssh-keygen -t rsa
github webhook 配置
Payload Url 和 Secret,可在web后台项目配置中找到,分别对应通知地址和秘钥,复制粘贴保存即可。
gitlab webhook 配置
配置链接和私密授权码即可
gitee webhook 配置
需要注意的是,gitee 的签名方式需要选择签名秘钥,否则可能无法通过验证。