davidj/django-production-py3

镜像概述

本Docker镜像基于Ubuntu Trusty系统构建，提供Python 3.4.x版本的Django生产环境，集成uWSGI应用服务器和nginx反向代理，专为Apache Mesos/Marathon集群部署设计。

核心功能

• 构建Python 3.4.x + Django的生产环境
• 集成uWSGI作为应用服务器
• 集成nginx作为反向代理
• 支持Apache Mesos/Marathon集群部署

使用场景

适用于需要在生产环境中部署Django应用的场景，尤其是基于Apache Mesos/Marathon的容器化集群环境。

配置说明

目录结构

部署Django应用时，需确保项目目录结构如下：

.
├── example-project
│   ├── example_app
│   │   ├── __init__.py
│   │   ├── settings.py
│   │   ├── urls.py
│   │   └── wsgi.py
│   ├── manage.py
│   ├── ExampleApp
│   │   ├── admin.py
│   │   ├── __init__.py
│   │   ├── models.py
│   │   ├── tests.py
│   │   └── views
│   │       ├── __init__.py
│   │       ├── ExampleView.py
│   │       └── Health.py
│   ├── static
│   │   └── favicon.ico
│   └── templates
│       └── base.html
├── requirements.txt
└── start.sh

• 将pip依赖写入根目录的requirements.txt
• 创建start.sh文件配置项目参数

start.sh配置示例

bash
#!/bin/bash

django-nginx-setup --working-directory example-project --static-directory static --static-alias /static --wsgi-module example_app.wsgi

运行容器

bash
docker run -d -p 8125:80 -v /path/to/your/directory:/app davidj/django-production

运行后可访问http://localhost:8125查看站点。

故障排除

1. 添加项目路径：若运行时找不到项目，可编辑wsgi.py添加路径：

python
import sys

path = '/app/example-project/'

if path not in sys.path:
    sys.path.append(path)

2. ALLOWED_HOSTS配置：若未使用域名，可在settings.py中设置：

python
ALLOWED_HOSTS = [
    '.ec2.internal',  # AWS环境使用
    '0.0.0.0',  # HAProxy健康检查使用
    '127.0.0.1',
    'localhost'
]

3. 健康检查URL：Marathon不支持APPEND_SLASH重定向，需确保URL模式兼容带/和不带/的情况：

python
from ExampleApp.views import *
from django.views.decorators.csrf import csrf_exempt

urlpatterns = patterns(
    url(r'^health/?$', csrf_exempt(Health.as_view())),
)