Docker部署Django+nginx+uwsgi环境

Cenos7环境下使用Docker部署Django+nginx+uwsgi环境

一、系统要求

　　此处略，详见

二、项目目录结构

1.各容器之间关系

2.项目目录

　　此环境使用docker-compose来编排各个容器的的配置，包括构建django镜像，项目目录结构如下图：

三、重点配置文件介绍

0.相关变量配置 .env文件

1.docker-compose编排工具文件配置 docker-compose.yml

version: '3'
services:

  ### Django Project-1 container #########################################
  book:
      build:
        #构建django项目book容器的路径
        context: ./build/django
      volumes: #项目数据持久化配置---包括项目、uwsgi配置文件
        - ${PROJECT_FOLDER}/book:/usr/src/app/book:rw
        - ./work/components/uwsgi/book/uwsgi.ini:/etc/uwsgi/book/uwsgi.ini:rw
      restart: always #系统重启后容器自动启动
      privileged: true   #容器启动后是否有系统权限
      networks:   #定义该容器的网桥名称和IP地址
          net-django:
            ipv4_address: 10.127.2.5
      command: uwsgi --ini /etc/uwsgi/book/uwsgi.ini   #容器启动后执行的命令，必须要此命令，以项目uwsgi配置文件启动uwsgi

  ### Django Project-2 container #########################################
  hos:
      build:
        #构建django项目hos容器的路径
        context: ./build/django
      volumes: #项目数据持久化配置---包括项目、uwsgi配置文件
        - ${PROJECT_FOLDER}/hos:/usr/src/app/hos:rw
        - ./work/components/uwsgi/hos/uwsgi.ini:/etc/uwsgi/hos/uwsgi.ini:rw
      restart: always  #系统重启后容器自动启动
      privileged: true  #容器启动后是否有系统权限
      networks:   #定义该容器的网桥名称和IP地址
          net-django:
            ipv4_address: 10.127.2.4
      command: uwsgi --ini /etc/uwsgi/hos/uwsgi.ini   #容器启动后执行的命令，必须要此命令，以项目uwsgi配置文件启动uwsgi

  ### Nginx container #########################################
  nginx: 
    image: nginx:1.17-alpine  #定义nginx使用的镜像，直接从docker hub上获取
    ports:    #定义nginx开放的web端口 80和8080
      - "80:80"
      - "8080:8080"
    volumes:   #nginx数据持久化配置---包括项目、项目nginx配置文件和nginx日志文件
      - ${PROJECT_FOLDER}/:/usr/src/app:rw
      - ./work/components/nginx/config/nginx.conf:/etc/nginx/nginx.conf:rw  #windows需要rw权限才能开启nginx服务
      - ./work/components/nginx/config/conf.d:/etc/nginx/conf.d:rw
      - ./work/components/nginx/log:/var/log/nginx:rw
    restart: always   #系统重启后容器自动启动
    privileged: true  #容器启动后是否有系统权限
    networks:     #定义nginx容器的网桥名称和IP地址
      net-django:
        ipv4_address: 10.127.2.3

  ### Mariadb container #########################################
  mariadb:
      image: mariadb:10.4.7   #定义mariadb使用的镜像，直接从docker hub上获取
      ports:   #定义mariadb开放的数据库端口 根据.env配置变量获取 ${MYSQL_PORT}端口
        - "${MYSQL_PORT}:3306"  # ${MYSQL_PORT}表示地址映射后的端口，3306表示mariadb容器内的端口
      volumes:   #mariadb数据持久化配置---包括数据库存储位置、数据库配置文件和数据库日志文件路径
        - ./work/components/mariadb/data:/var/lib/mysql:rw
        - ./work/components/mariadb/config/mysql.cnf:/etc/mysql/conf.d/mysql.cnf:rw
        - ./work/components/mariadb/log:/var/log/mysql:rw
      restart: always   #系统重启后容器自动启动
      privileged: true   #容器启动后是否有系统权限
      environment:   
        MYSQL_ROOT_PASSWORD: ${MYSQL_PASSWORD}   #通过系统变量${MYSQL_PASSWORD} 设置mariadb镜像定义的变量MYSQL_ROOT_PASSWORD
      networks:    #定义mariadb容器的网桥名称和IP地址
        net-django:  
          ipv4_address: 10.127.2.2

### Add Network Bridge info #########################################
networks:   #定义整个docker-compose编排的容器使用的网桥名称和IP地址网段，注意 x.x.x.1不能使用
  net-django:
    ipam:
      config:
        - subnet: 10.127.2.0/24

2.构建django镜像文件Dockerfile配置 Dockerfile

#定义该镜像使用的基础镜像为：python:3.7.4-stretch
FROM python:3.7.4-stretch

#定义容器的工作目录
WORKDIR /usr/src/app

#拷贝pip安装项目所需要的包名称和第三方django xadmin管理后台
COPY requirements.txt ./
COPY xadmin-django2.zip ./

#安装
RUN pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple && 
    pip install ./xadmin-django2.zip

#开放的端口
EXPOSE 8000

3.mariadb数据库配置文件

# The MySQL  Client configuration file.
#
# For explanations see
# http://dev.mysql.com/doc/mysql/en/server-system-variables.html

[mysql]

[mysqld]
sql-mode="STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"
innodb_force_recovery = 1
character-set-server=utf8
explicit_defaults_for_timestamp=true

4.uwsgi配置文件

说明：uwsgi是通过pip install uwsgi方式安装的

[uwsgi]
uid = www-data
gid = www-data
master = true

;django项目目录路径
chdir     = /usr/src/app/book/

;项目的wsgi测试服务器配置文件位置
wsgi-file = /usr/src/app/book/book/wsgi.py
module = hos.wsgi

;定义socket的地址和端口
socket    = 10.127.2.5:8000
processes = 8
threads   = 1
enable-threads = true
chmod-socket = 664
chown-socket = book:www-data
vacuum = true

;定义静态文件
static-map=/static=/usr/src/app/book/static
buffer-size  = 65535

[uwsgi]
uid = www-data
gid = www-data
master = true

;django项目目录路径
chdir     = /usr/src/app/hos/

;项目的wsgi测试服务器配置文件位置
wsgi-file = /usr/src/app/book/hos/wsgi.py
module = hos.wsgi

;定义socket的地址和端口
socket    = 10.127.2.4:8000
processes = 8
threads   = 1
enable-threads = true
chmod-socket = 664
chown-socket = hos:www-data
vacuum = true

;定义静态文件
static-map=/static=/usr/src/app/hos/static
buffer-size  = 65535

5.nginx主配置文件和项目配置文件

user  nginx;
worker_processes  1;

pid        /var/run/nginx.pid;
error_log  /var/log/nginx/error.log warn;

events {
    worker_connections  1024;
}


http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log /dev/null;
    access_log  /var/log/nginx/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    keepalive_timeout  65;

    #gzip  on;

    include /etc/nginx/conf.d/*.conf;
}

server {
    client_max_body_size 1024m;
    listen       80;
    server_name  localhost;
    charset  utf-8;

    location / {
        include uwsgi_params;
        #定义uwsgi的socket，即django项目容器的地址和端口
        uwsgi_pass 10.127.2.5:8000;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    
    #定义项目静态文件目录，注意alias和root的区别
    location /static {
        alias /usr/src/app/book/static;
    }

    error_page 404 /404.html;
            location = /40x.html {
        }

    error_page 500 502 503 504 /50x.html;
        location = /50x.html {
    }

}

server {
    client_max_body_size 1024m;
    listen       8080;
    server_name  localhost;
    charset  utf-8;
    
    location / {
        include uwsgi_params;
        #定义uwsgi的socket，即django项目容器的地址和端口
        uwsgi_pass 10.127.2.4:8000;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    
    #定义项目静态文件目录，注意alias和root的区别
    location /static {
        alias /usr/src/app/hos/static;
    }

    error_page 404 /404.html;
            location = /40x.html {
        }

    error_page 500 502 503 504 /50x.html;
        location = /50x.html {
    }

}

6.django项目配置文件

 (1) book/book/setting.py文件中数据库设置

• 数据库IP地址为容器2-mairadb的ip:10.127.2.2
• 端口为3306

DATABASES = {
    'default': {
        # 连接的数据库类型
        'ENGINE': 'django.db.backends.mysql',
        # 数据库的地址
        'HOST': '10.127.2.2',
        # 数据库使用的端口
        'PORT': '3306',
        # 所连接的数据库名字
        'NAME': 'book',
        # 连接数据库的用户名
        'USER': 'root',
        # 连接数据库的密码
        'PASSWORD': 'DockerLNMP'
    }
}

(2) book/book/setting.py文件中静态文件设置

STATIC_URL = '/static/'
STATIC_ROOT=os.path.join(BASE_DIR,"/static/")

STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static'),

(3)项目的wsgi.py文件设置

import os
import sys
from django.core.wsgi import get_wsgi_application

sys.path.append("/usr/src/app/book/")

# os.environ.setdefault("DJANGO_SETTINGS_MODULE", "book.settings")
os.environ["DJANGO_SETTINGS_MODULE"] = "book.settings"

application = get_wsgi_application()

import os
import sys

from django.core.wsgi import get_wsgi_application

sys.path.append("/usr/src/app/hos/")

# os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'hos.settings')
os.environ["DJANGO_SETTINGS_MODULE"] = "hos.settings"

application = get_wsgi_application()

四、启动与停止

 1.启动-构建镜像&&启动容器

docker-compose up 或者 docker-compose up -d 后台运行

2.停止

docker-compose stop  #停止容器的运行

3.停止并删除容器

docker-compose down

4.收集django项目的静态文件

　　python manage.py collectstatic 收集静态文件

django项目使用 python manage.py collectstatic 命令收集静态文件

注意：成功收集静态文件后，重启django、nginx容器或者重启与此项目相关的所有容器，docker-compose restart 容器名称 或者 docker-compose restart 

4.其他

(1)docker images 或者 docker image ls 查看本地的镜像

(2)docker ps -a

通过以上信息得出：

• 查看镜像得知2个django项目book和hos都是使用同一镜像(因为IMAGE ID相同)，只是镜像名称不一样，加载的django项目源代码和uwsgi配置文件不同而已
• 宿主机3306端口与数据库容器(docker-django-nginx-uwsgi_mariadb_1)的3306端口成映射关系，若为了数据安全，可不与宿主机端口进行绑定
• 宿主机80端口与nginx服务80端口成绑定关系，宿主机8080端口与nginx服务8080端口成绑定关系

Github项目地址