专栏首页运维录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
  • Gunicorn运行与配置方法

    Gunicorn“绿色独角兽”是一个被广泛使用的高性能的Python WSGI UNIX HTTP服务器,移植自Ruby的独角兽(Unicorn )项目,使用p...

    砸漏
  • 机器学习的AdaBoost算法

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

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

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

    WindCoder
  • Android Native 内存泄漏系统化解决方案

    导读:C++内存泄漏问题的分析、定位一直是Android平台上困扰开发人员的难题。因为地图渲染、导航等核心功能对性能要求很高,高德地图APP中存在大量的C++代...

    砸漏
  • 体系化并不是一件简单的事情

    昨天在说桥水基金的创始人的时候,提到了对他影响深远的一个东西就是做任何事的原则,就是把所有的事情都体系化,不管是在生活,还是在工作中,所有的事情都可以体系化。

    信安本原
  • Oracle 20c 新特性:自动的区域图 - Automatic Zone Maps

    导读:Zone Maps 是一个独立的访问结构,可以为表独立建立。在表和索引扫描期间,区块图可以根据表列上的谓词来修剪表的磁盘块和分区表的潜在完整分区。区块映射...

    数据和云
  • 机器学习里的bias的一些处理方法和思考

    机器学习的bias对性能影响很大,常常会使一个线下优秀的模型线上落不了地,或者闹出新闻里的笑话.在机器学习竞赛或数据集里,很多时候对bias的处理在test上带...

    统计学家

扫码关注云+社区

领取腾讯云代金券