专栏首页运维录Django容器(下): 使用Gunicorn管理Django

Django容器(下): 使用Gunicorn管理Django

开始之前


在上一篇文章《Django容器(上): 自定义基础镜像》我们已经封装好了Django项目的基础镜像,接下来需要在基础镜像之上做些收尾工作,主要以下几点:

  • 在基础镜像中加入项目代码。
  • 配置 Gunicorn 管理 Django 应用。
  • 配置 Supervisor 管理 Nginx 与 Gunicorn进程。

一些问题


为什么使用 Gunicorn 管理 Django 应用?

Gunicorn (Green Unicorn)是一个高效的 Python WSGI Server,常用来管理多个进程。

如果有进程挂了Gunicorn 可以把它启动起来,防止长时间停止服务。

此外 Gunicorn 还可以动态调整 worker的数量,请求多时增加 worker的数量,相反则减少。

为什么使用 Nginx 代理 Gunicorn 应用?

当访问网站时,服务器会接收到不同类型的资源请求:a. Pic、Css、Js 等静态资源文件。b. 详情页等需要调用数据库动态获取的数据。

对于动态数据请求,文章数据需要 Django 从数据库中获取Nginx会把这个请求转发给 Django处理。

对于静态资源请求,只需要 Nginx 去项目所在的目录直接获取,不再麻烦Django

相比 Django框架内置的Web服务器,Nginx可以更高效的处理静态文件请求。

因此生产环境推荐使用 Nginx + Gunicorn + Django 的方式。

梳理一下本项目中进程关系
使用 `supervisor` 来管理 'gunicorn' 与 'Nginx'进程。
使用 `gunicorn` 来管理 'django'应用,实现管理多个'worker'进程。
使用 `nginx` 反向代理 'gunicorn' 应用,实现"动/静态分离"。

操作步骤


1. 项目镜像构建目录

tree -L 1 ./
./
├── base       # 基础镜像目录
├── Dockerfile # 项目 Dockerfile
└── start      # 项目代码目录  

2 directories, 1 file

2. Dockerfile 文件

cat Dockerfile

# use start-base image
FROM start-base

# nginx
COPY base/conf/nginx.conf /etc/nginx/nginx.conf
COPY base/conf/default.conf /etc/nginx/conf.d/default.conf
COPY base/conf/ssl /etc/nginx/ssl

# django
COPY start /start
WORKDIR /start
# 收集静态文件到 STATIC_ROOT 中,项目中为 /start/static
RUN python manage.py collectstatic -l --noinput

# supervisor
COPY base/conf/supervisord.conf /etc/supervisor/supervisord.conf
CMD ["/usr/bin/supervisord","-c","/etc/supervisor/supervisord.conf"]

相关命令可以参考 《如何使用 Dockerfile自定义镜像?》 这篇文章。

3. supervisor 配置文件

cat base/conf/supervisord.conf

[supervisord]
nodaemon=true
pidfile=/var/run/supervisord.pid
logfile=/var/log/supervisor/supervisord.log

[program:nginx]
command=/usr/sbin/nginx -g "daemon off;"

[program:gunicorn]
command=gunicorn -w 2 -b unix:/var/run/django.socket web.wsgi:application
stderr_logfile=/var/log/gunicorn.stderr
stdout_logfile=/var/log/gunicorn.stdout

supervisor 配置可以参考《为什么需要自定义一个基础镜像? 》 这篇文章。gunicorn 选项请参考下面。

4. nginx 配置文件

cat base/conf/default.conf

server {

    listen 80;
    listen 443 ssl;
    server_name  www.zongming.net;
    # 其它配置项省略...

    # 保持与 django MEDIA_URL 一致
    location ^~ /attachments {
        alias /start/uploads/;
        expires 180d;
    }

    # 保持与 django STATIC_URL 一致
    location ^~ /static {
        root /start/;
        expires 180d;
    }

    location / {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $http_host;
        proxy_pass http://unix:/var/run/django.socket;
        proxy_redirect default;
    }

    access_log  /var/log/nginx/access.log access;
    error_log  /var/log/nginx/error.log;
}

注意,proxy_pass代理的 sokect文件路径,与 supervisor中保持一致。

nginx 代理配置项可以参考《Nginx Proxy 反向代理》 这篇文章。

5. 构建项目镜像

docker build -t start:0.0.1 .
Sending build context to Docker daemon  3.5mb
Step 1/9 : FROM python:3
# ...省略
Successfully built cd2a8533ab3d
Successfully tagged start:0.0.1

6. 验证django容器

a. 创建容器

docker run --name test -d start:0.0.1
66655a0cff8b#省略..2f59ce1cd14d03e606581

b. 容器进程

pstree 15585
supervisord─┬─gunicorn───2*[gunicorn]
            └─nginx───nginx

c. 访问服务

curl www.demo.com
HTTP/1.1 200 OK
Server: nginx
Date: Thu, 19 Jan 2018 04:37:12 GMT
Content-Type: text/html; charset=utf-8
Connection: keep-alive
Keep-Alive: timeout=10
Vary: Accept-Encoding
X-Frame-Options: SAMEORIGIN

命令帮助

语法: gunicorn [OPTIONS] APP_MODULE
示例: gunicorn -w 2 -b unix:/var/run/django.socket web.wsgi:application
`web` 为 django项目应用名称,例如示例中的 Django工程是使用以下命令创建的。
# 创建 start 项目
django-admin startproject start
# 创建 web 应用
python manage.py startapp web

选项
-b BIND
指定要绑定的服务器套接字。服务器套接字可以是:
`$(HOST)`, `$(HOST):$(PORT)`, `unix:$(PATH)`中的任何一个。IP 是有效的`$(HOST)`。
默认值为 ['127.0.0.1:8000']

-w WORKERS
处理请求的工作进程数。此值通常应为服务器中每个核心(CPU) 2-4之间,默认值为1。

小结


最后来总结下文章中的知识点

  • 使用 supervisor 在 docker 容器中管理 nginx、gunicorn进程。
  • Gunicorn是一个高效的 Python WSGI Server,常用来管理多个进程。
  • 对于 django项目,推荐生产环境使用 Nginx + Gunicorn + Django 的方式

本文分享自微信公众号 - 运维录(gh_70d95b8f5f7c),作者:东南

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2019-12-19

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 如何为Nginx 配置SSL证书?

    用户通过http协议访问网站时,浏览器和服务器之间是明文传输,这就意味着用户填写的密码、帐号、交易记录等机密信息都是明文,随时可能被泄露、窃取、篡改,被黑客加以...

    用户1560186
  • 把 Docker镜像装到仓库需要几步?

    使用docker tag 命令为镜像打上标记,比如为网易蜂巢(已改名网易云)镜像仓库推送镜像,首先需要为镜像做好标记;

    用户1560186
  • 如何为 Nginx 添加一个模块?

    这篇文章发布于2013年,介绍如何为nginx添加模块,由于时间久远可能有些内容已经过时,不过"静态添加模块"方法仍然可以使用(从1.9.11版本开始支持loa...

    用户1560186
  • 机器学习的AdaBoost算法

    首先,AdaBoost是Adaptive Boosting的缩写。基本上,Ada Boosting是第一个为二进制分类开发的真正成功的增强算法。此外,它是理解助...

    February
  • Discuz用户id被占用的解决方法

    如图放出pre_common_member表的设置,pre_ucenter_member方法相同:

    汐楓
  • yii2 modal弹窗之ActiveForm ajax表单异步验证

    前面我们讲述了yii2中如何使用modal以及yii2 gridview列表内更新操作如何使用modal的问题,本以为modal要告一段落可以开始新的话题了,但...

    botkenni
  • 从《2015年中国互联网安全报告》看安全趋势发展(下载)

    大数据文摘
  • select from update row的实现

    DTCC大会上,阿里江疑的演讲中提到一个:select from update hot row;

    bisal
  • 从SAP最佳业务实践看企业管理(59)-SOP-收入计划

    成功企业的共同特点: 抓住一个市场机遇,发挥其竞争优势 坚持其强项 企业永续经营的根本是持续获得利润,而企业的利润来源与产品品质(Quality)、成本(C...

    SAP最佳业务实践
  • 学习笔记---JavaEE复习回顾十一

    第三个阶段:RUNTIME 级别,是写好的源码经过编译成字节码, 由类加载器调入JDK运行时内存的阶段。

    互联网CEO

扫码关注云+社区

领取腾讯云代金券

玩转腾讯云 有奖征文活动