周末,在一个技术群里面有同学在问Django开发部署,所以今天给大家分享一下基于Docker下Python Django框架的部署。
首先我们要知道Django常见的两种部署方式:
- Django + Nginx + uWSGI
- Django+ Nginx + Gunicorn
限于篇幅情况,今天我们主要聊第一种 uWSGI 配合 Nginx的部署方式。
首先我们要知道我们发布上线的步骤,这里面我们以Docker容器化为例子:
1.通过自动化脚本,把代码同步到线上服务器(通过fabric或者ansible等)
2.重启supervisord(进程管理工具,通过uWSGI 控制Django服务启动)
3.通过docker-compose 更新docker镜像(如果有镜像有变更,比如装了包到容器里面)
4.做数据表migrate,比如数据表进行了变更(如果是关系型数据库)
5.通过docker-compose重启docker容器
这上面5个步骤,只要配置好了对应的配置文件(nginx,uWSGI,supervisor等),我们就能通过一个发布脚本进行一键进行代码发布上线。
下面分别简单阐述一下,Nginx,Supervisor,uWSGI,Docker-compose等配置文件及用法。
Nginx
Nginx是一个高性能的HTTP和反向代理服务器。
我们要进行服务部署,首先我们Nginx需要进行配置好对应的配置文件。
把配置文件放在/etc/nginx/sites-enabled/ 目录下面,这儿你也可以放在项目里面通过ln 进行链接过去。
之所以这样配置是因为我们主配置文件/etc/nginx/nginx.conf是include /etc/nginx/sites-enabled/ 目录的原因。
这里我们配置文件命名为 api.yourdomain.com.conf
配置文件如下
# api.yourdomain.com.conf server { listen 80; charset utf-8; server_name api.yourdomain.com; # DNS解析到当前nginx服务器 location / { proxy_pass http://127.0.0.1:9527; # 代理的端口 proxy_pass_header Server; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Scheme $scheme; } access_log /test/log/nginx.access.log; error_log /test/log/nginx.error.log; }
uWSGI
配置好了nginx,接下来就是uWSGI配置了。uWSGI是一个Web服务器,它实现了WSGI协议、uwsgi、http等协议。
后面我们会说uWSGI 和 Gunicorn 他们都是实现了WSGI server协议的服务器。
通过uWSGI我们可以获得更好的服务性能,详细日志,多应用管理等多种定制功能。下面我们简单来看下配置文件。
# /yourdir/uwsgi.ini [uwsgi] chdir = /yourdir/ # 执行目录 module = yourproject.wsgi # wsgi文件 master = true processes = 1 # 一般越多进程处理能力越强,由于这里是测试设为1 vacuum = true http = 0.0.0.0:9527 # virtualenv = /home/test/project/python/yourproject/venv 这里我们用了docker就不用考虑virtualenv情况 env = DJANGO_SETTINGS_MODULE=yourproject.settings harakiri = 30 # 当进程被卡住的时间超过特定的秒数后就销毁这个进程 no-orphans # 在没有主进程的情况下自动结束工作进程。
为了方便展示以及解读,这里面我删除精简了一些配置,具体线上配置更为复杂一些,具体情况请具体进行配置。
另外这里面我们需要知道uWSGI 是一个语言无关的服务器,这里面我们可以部署Django,也可以部署Flask,Web2py等等。你这儿可以把他等同 Python manage.py runserver 这条命令,区别在一个在测试环境和线上环境。
Supervisor
supervisor我在Linux系列文章第一篇Linux系列开坑记(一)-常用的3个命令,就分享过了,这里直接列一个配置文件出来。
[supervisord] nodaemon=true logfile=/data/log/supervisord.log pidfile=/var/run/supervisord.pid [program:your_app_name] process_name=app%(process_num)s command=uwsgi -i /yourdir/uwsgi.ini --touch-reload=/yourdir/uwsgi.ini directory=/yourdir ;执行命令时切换工作目录 user=sitin ; 使用sitin来启动进程 stopsignal=HUP autostart = true autorestart=true ;自动重启 redirect_stderr = true ;重定向日志 stdout_logfile = /data/log/stdout-%(program_name)s.log logfile_maxbytes=300MB logfile_backups=5 numprocs=3 ;启动3个 9527,9528,9529 numprocs_start=9527 ; 从9527开始
这里面supervisor控制服务uWSGI进行服务启动,我们可以进行start,restart,stop等操作。
Docker-compose
Docker-compose是进行容器编排,方便我们进行容器管理。我们配置好了上面的文件,再来看下docker-compose的配置文件,这里同样我在之前docker文章进行分享过了,参考 Docker容器化部署实践Docker Compose
version: "3" # 注意版本号 services: # 一个应用的容器,可以包括多个相同镜像容器实例 dev: image: hub.yourdomain.com/test:1.0 # 镜像地址 command: supervisord -c /yourdir/supervisord.conf # 容器执行命令 container_name: test # 容器名 restart: always volumes: - ./docker:/data # 挂载地址 ports: - "9527:9527" #端口 environment: - PYTHONPATH=/data - XXX_API_SETTINGS=XXX.config.dev - DJANGO_SETTINGS_MODULE=yourproject.settings network_mode: bridge extra_hosts: # 配置额外的host名称 - "test.yourdomain.com:127.0.0.1" external_links: # 链接到外部容器 - redis:redis - mysql:mysql
看到这儿想必有同学已经有些晕了,我们再来理一下这里的逻辑。
- 我们通过docker-compose配置文件,进行控制supervisor启动
- Supervisor控制uWSGI端口服务启动
- uWSGI把整个Django应用拉动起来(这里类似python manage.py runserver)
- 而我们浏览器请求到达Nginx之后被反向代理到uWSGI端口服务上面,从而访问到我们Django应用。
- 至此就是整个应用的部署配置(除了没有自动化发布脚本以外)
最后
通过上面的配置文件,我们介绍了整个Django应用发布过程的涉及到的主要步骤,实际情况会稍微复杂点儿。更多详细优化参数大家可以去进行了解。今天我们uWSGI的部署就先到这儿,下一期我们再进行分享Gunicorn部署方式。
容器化部署实践,我打算从基础操作到实战应用以一个系列进行分享,今天是第四篇docker部署Django应用,后期我将持续分享更多相关内容,从容器化入门使用到部署实践编排技术,欢迎大家持续进行关注。