自动化部署

介绍

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

  具体的配置文件如下： ```yaml

  配置文件

  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

<a name="xWz2A"></a>
### Nginx 配置
```nginx
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 运行

.\awesome-runner.exe

mac、linux 运行

./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。

ssh-keygen -t rsa

github webhook 配置

Payload Url 和 Secret，可在web后台项目配置中找到，分别对应通知地址和秘钥，复制粘贴保存即可。

gitlab webhook 配置

配置链接和私密授权码即可

gitee webhook 配置

需要注意的是，gitee 的签名方式需要选择签名秘钥，否则可能无法通过验证。