Docker指南:Dockerizing Python Django应用程序

在本教程中,我将逐步向您展示如何在Ubuntu 16.04中为现有Django应用程序项目创建docker镜像。我们将学习......

Docker指南:Dockerizing Python Django应用程序

Docker是一个开源项目,为开发人员和系统管理员提供了一个开放平台,可以在任何地方构建,打包和运行应用程序作为轻量级容器。 Docker自动在软件容器内部署应用程序。

Django是一个用python编写的Web应用程序框架,遵循MVC(模型 - 视图 - 控制器)架构。 它是免费提供的,并在开源许可下发布。 它速度快,旨在帮助开发人员尽快在线获取应用程序。

在本教程中,我将逐步向您展示如何在Ubuntu 16.04中为现有Django应用程序项目创建docker镜像。 我们将学习如何对python Django应用程序进行docker化,然后使用docker-compose脚本将应用程序作为容器部署到docker环境。

为了部署我们的python Django应用程序,我们需要额外的docker镜像。 我们需要一个用于Web服务器的nginx docker镜像和用于数据库的PostgreSQL镜像。

我们将要做什么?

  1. 安装Docker-ce
  2. 安装Docker-compose
  3. 配置项目环境
  4. 构建并运行
  5. 测试

第1步 - 安装Docker-ce

在本教程中,我们将从docker存储库安装docker-ce社区版。 我们将安装docker-ce社区版和docker-compose,支持撰写文件版本3。

在安装docker-ce之前,使用apt命令安装所需的docker依赖项。

sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    software-properties-common

现在通过运行以下命令添加docker密钥和存储库。

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"

安装Docker-ce

更新存储库并安装docker-ce。

sudo apt update
sudo apt install -y docker-ce

安装完成后,启动docker服务并使其在每次系统引导时启动。

systemctl start docker
systemctl enable docker

接下来,我们将添加一个名为“omar”的新用户并将其添加到docker组。

useradd -m -s /bin/bash omar
usermod -a -G docker omar

启动Docker

以omar用户身份登录并运行docker命令,如下所示。

su - omar
docker run hello-world

确保从Docker获取hello-world消息。

检查Docker安装

Docker-ce安装已完成。

第2步 - 安装Docker-compose

在本教程中,我们将使用最新的docker-compose支持撰写文件版本3.我们将手动安装docker-compose。

使用curl命令将最新版本的docker-compose下载到'/ usr / local / bin'目录,并使用chmod使其可执行。

运行以下命令。

sudo curl -L https://github.com/docker/compose/releases/download/1.21.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

现在检查docker-compose版本。

docker-compose version

并确保您获得最新版本的docker-compose 1.21。

安装Docker-compose

已安装docker-compose支持撰写文件版本3的最新版本。

第3步 - 配置项目环境

在这一步中,我们将配置python Django项目环境。 我们将创建新目录'guide01'并使其成为我们项目文件的主目录,例如Dockerfile,Django项目,nginx配置文件等。

登录'omar'用户。

su - omar

创建新目录'guide01'并转到目录。

mkdir -p guide01
cd guide01/

现在在'guide01'目录中,创建新目录'project'和'config'。

mkdir project/ config/

注意:

  • 目录'project':我们所有的python Django项目文件都将放在该目录中。
  • 目录'config':项目配置文件的目录,包括nginx配置文件,python pip需求文件等。

创建一个新的requirements.txt文件

接下来,使用vim命令在'config'目录中创建新文件'requirements.txt'。

vim config/requirements.txt

粘贴下面的配置。

Django==2.0.4  
gunicorn==19.7.0 
psycopg2==2.7.4

保存并退出。

创建Nginx虚拟主机文件django.conf

在config目录下,创建'nginx'配置目录并添加虚拟主机配置文件django.conf。

mkdir -p config/nginx/
vim config/nginx/django.conf

在那里粘贴以下配置。

upstream web {
  ip_hash;
  server web:8000;
}

# portal
server {
  location / {
        proxy_pass http://web/;
    }
  listen 8000;
  server_name localhost;

  location /static {   
    autoindex on;   
    alias /src/static/;   
  }
}

保存并退出。

创建Dockerfile

在'guide01'目录中创建新的'Dockerfile'。

运行以下命令。

vim Dockerfile

现在粘贴下面的Dockerfile脚本。

FROM python:3.5-alpine
ENV PYTHONUNBUFFERED 1 

RUN apk update && \
    apk add --virtual build-deps gcc python-dev musl-dev && \
    apk add postgresql-dev bash

RUN mkdir /config 
ADD /config/requirements.txt /config/ 
RUN pip install -r /config/requirements.txt
RUN mkdir /src
WORKDIR /src

保存并退出。

注意:

我们希望为基于Alpine Linux(最小的Linux)的Django项目构建Docker镜像。 我们的Django项目将运行安装了python 3.5的Alpine Linux,并为PostgreSQL数据库支持添加postgresql-dev软件包。 然后我们将使用python pip命令安装'requirements.txt'文件中列出的所有python包,并为我们的项目创建新的'/ src'。

创建Docker-compose脚本

使用下面的vim命令在'guide01'目录下创建'docker-compose.yml'文件。

vim docker-compose.yml

在那里粘贴以下配置。

version: '3'
services:
  db:
    image: postgres:10.3-alpine
    container_name: postgres01
  nginx:
    image: nginx:1.13-alpine
    container_name: nginx01
    ports:
      - "8000:8000"
    volumes:
      - ./project:/src
      - ./config/nginx:/etc/nginx/conf.d
    depends_on:
      - web
  web:
    build: .
    container_name: django01
    command: bash -c "python manage.py makemigrations && python manage.py migrate && python manage.py collectstatic --noinput && gunicorn hello_django.wsgi -b 0.0.0.0:8000"
    depends_on:
      - db
    volumes:
      - ./project:/src
    expose:
      - "8000"
    restart: always

保存并退出。

注意:

使用这个docker-compose文件脚本,我们将创建三个服务。 使用PostgreSQL alpine Linux创建名为'db'的数据库服务,再次使用Nginx alpine Linux创建'nginx'服务,并使用从Dockerfile生成的自定义docker镜像创建我们的python Django容器。

配置项目环境

配置Django项目

将Django项目文件复制到“项目”目录。

cd ~/django
cp -r * ~/guide01/project/

转到“项目”目录并编辑应用程序设置“settings.py”。

cd ~/guide01/project/
vim hello_django/settings.py

注意:

我们将部署名为'hello_django'应用程序的简单Django应用程序。

在“ALLOW_HOSTS”行中,添加服务名称“web”。

ALLOW_HOSTS = ['web']

现在更改数据库设置。 我们将使用PostgreSQL数据库,该数据库作为名为“db”的服务运行,具有默认用户和密码。

DATABASES = {  
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'postgres',
        'USER': 'postgres',
        'HOST': 'db',
        'PORT': 5432,
    }
}

对于'STATIC_ROOT'配置目录,将此行添加到文件行的末尾。

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

保存并退出。

配置Django项目

现在我们准备在docker容器下构建和运行Django项目。

第4步 - 构建并运行Docker镜像

在这一步中,我们想要使用'guide01'目录中的配置为我们的Django项目构建一个Docker镜像。

转到'guide01'目录。

cd ~/guide01/

现在使用docker-compose命令构建docker镜像。

docker-compose build

运行码头图像

启动docker-compose脚本中的所有服务。

docker-compose up -d

等待几分钟让Docker构建我们的Python镜像并下载nginx和postgresql docker镜像。

使用docker-compose构建图像

完成后,使用以下命令检查运行容器并在系统上列出docker镜像。

docker-compose ps
docker-compose images

现在,您将在系统上运行三个容器并列出Docker映像,如下所示。

docke-compose ps命令

我们的Python Django应用程序现在在docker容器内运行,并且已经创建了我们服务的docker镜像。

第5步 - 测试

打开Web浏览器并使用端口8000键入服务器地址,我的是: http:// ovh01:8000 /

现在您将获得默认的Django主页。

默认的Django项目主页

接下来,通过在URL上添加“/ admin”路径来测试管理页面。

HTTP:// ovh01:8000 /管理/

您将看到Django管理员登录页面。

Django管理

Dockerizing Python Django应用程序已成功完成。

参考