自动化发布利器-Spug部署篇

写在前面：
开源项目地址：https://github.com/openspug/spug.git
感谢Spug项目人员，请帮忙一起支持下，点star~

工作之余写一下自己的经验，以便后期翻阅，不足之处请留言，我会及时更改。
之前使用过walle 1.0、walle 2.0、syncd等自动化发布，但根据公司业务最后选择了spug，所以还是适合自己的最好。下面简单介绍下在Ubuntu环境中的部署细节(部署篇)，以及我们在用的生产环境的案例(案例篇)

一键安装部署

暂不介绍，看官网即可（CentOS或Ubuntu都可用）

Docker部署

暂不介绍，看官网即可（后面闲下来再补吧）
需要注意的是，如果要构建项目，或者 command not found 问题，
建议按照自身需要修改 Dockerfile 重新构建下 docker image，比如安装jdk/yarn/node等依赖项及编译环境

手动部署

环境版本

OS Version：Ubuntu 16.04.6 LTS
Python: 3.6.10
MySQL：5.7
Redis：3.0.6

安装环境

# 安装MySQL
sudo apt-get update
sudo apt-get install mysql-server mysql-client libmysqlclient-dev
sudo mysql -V

# 安装Redis
sudo apt-get update
sudo  apt-get install redis-server
sudo redis-server -v

# 安装git
sudo apt-get remove git-core
sudo add-apt-repository ppa:git-core/ppa
sudo apt update
sudo apt install git
sudo git version

# 安装系统依赖
sudo apt-get update
sudo apt-get install python3-dev python3-venv \
libsasl2-dev libldap2-dev gcc nginx supervisor
---
需要的依赖包暂时记不起还有什么了，之前部署好就没在管，所以如果有安装依赖的问题，可以在下面留言
---

安装Spug

# 拉取 spug 项目
mkdir /data/spug && git clone https://github.com/openspug/spug /data/spug && cd /data/spug
git checkout v2.3.2   # x.x.x 为指定的发行版本，例如 git checkout v2.3.2 , 可前往项目地址查看最新版本

# 下载 spug 前端文件
wget https://github.com/openspug/spug/releases/download/v2.3.2/spug_web_2.3.2.tar.gz
tar xf spug_web_2.3.2.tar.gz -C /data/spug/spug_web/

# 创建虚拟运行环境
cd /data/spug/spug_api
python3 -m venv venv
source venv/bin/activate

# 安装python包
# 安装完后 pip list 下，检查下是否全部安装了
pip install -r requirements.txt -i https://pypi.doubanio.com/simple/
pip install gunicorn mysqlclient -i https://pypi.doubanio.com/simple/

配置Spug

# 创建配置文件
# 在 spug_api/spug/ 目录下创建 overrides.py 文件，
# 启动后端服务后会自动覆盖默认的配置，避免直接修改 settings.py 以便于后期获取新版本。
$ vi spug_api/spug/overrides.py

DEBUG = False
ALLOWED_HOSTS = ['127.0.0.1']

DATABASES = {
    'default': {
        'ATOMIC_REQUESTS': True,
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'spug',             # 替换为自己的数据库名，请预先创建好编码为utf8mb4的数据库
        'USER': 'spug_user',        # 数据库用户名
        'PASSWORD': 'spug_passwd',  # 数据库密码
        'HOST': '127.0.0.1',        # 数据库地址
        'OPTIONS': {
            'charset': 'utf8mb4',
            'sql_mode': 'STRICT_TRANS_TABLES',
            #'unix_socket': '/opt/mysql/mysql.sock' # 如果是本机数据库,且不是默认安装的Mysql,需要指定Mysql的socket文件路径
        }
    }
}

初始化数据库

cd /data/spug/spug_api
python manage.py initdb

#创建默认管理员账号
$ python manage.py useradd -u admin -p spug.dev -s -n 管理员

# -u 用户名
# -p 密码
# -s 超级管理员
# -n 用户昵称

配置启动脚本

# 创建启动脚本
$ vi /etc/supervisord.d/spug.ini

[program:spug-api]
command = bash /data/spug/spug_api/tools/start-api.sh
autostart = true
stdout_logfile = /data/spug/spug_api/logs/api.log
redirect_stderr = true

[program:spug-ws]
command = bash /data/spug/spug_api/tools/start-ws.sh
autostart = true
stdout_logfile = /data/spug/spug_api/logs/ws.log
redirect_stderr = true

[program:spug-worker]
command = bash /data/spug/spug_api/tools/start-worker.sh
autostart = true
stdout_logfile = /data/spug/spug_api/logs/worker.log
redirect_stderr = true

[program:spug-monitor]
command = bash /data/spug/spug_api/tools/start-monitor.sh
autostart = true
stdout_logfile = /data/spug/spug_api/logs/monitor.log
redirect_stderr = true

[program:spug-scheduler]
command = bash /data/spug/spug_api/tools/start-scheduler.sh
autostart = true
stdout_logfile = /data/spug/spug_api/logs/scheduler.log
redirect_stderr = true

---
关于如何改装一下listen address 和 port
$ vim /data/spug/spug_api/tools/start-api.sh
exec gunicorn -b 192.168.1.10:9101 -w 2 --threads 8 --access-logfile - spug.wsgi
$ vim /data/spug/spug_api/tools/start-api.sh
exec daphne -b 192.168.1.10 -p 9102 spug.asgi:application

注：记得Nginx那块也得改下
---

配置Nginx配置文件

$ vi /etc/nginx/conf.d/spug.conf

server {
        listen 80;
        server_name localhost;     # 修改为自定义的访问域名
        root /data/spug/spug_web/build/;
        client_max_body_size 20m;   # 该值会影响文件管理器可上传文件的大小限制，请合理调整

        location ^~ /api/ {
                rewrite ^/api(.*) $1 break;
                proxy_pass http://127.0.0.1:9101; # 如有修改脚本，记得改端口
                proxy_redirect off;
                proxy_set_header X-Real-IP $remote_addr;
        }

        location ^~ /api/ws/ {
                rewrite ^/api(.*) $1 break;
                proxy_pass http://127.0.0.1:9102; # 如有修改脚本，记得改端口
                proxy_http_version 1.1;
                proxy_set_header Upgrade $http_upgrade;
                proxy_set_header Connection "Upgrade";
                proxy_set_header X-Real-IP $remote_addr;
        }

        error_page 404 /index.html;
}

更新升级


$ cd spug_api
$ source venv/bin/activate
$ python manage.py update
# 下载 spug 前端文件替换
wget https://github.com/openspug/spug/releases/download/vx.x.x/spug_web_x.x.x.tar.gz
tar xf spug_web_x.x.x.tar.gz -C /data/spug/spug_web/

自动化发布利器-Spug部署篇

一键安装部署

Docker部署

手动部署

环境版本

安装环境

安装Spug

配置Spug

初始化数据库

配置启动脚本

配置Nginx配置文件

更新升级