document/TranslateProject
2
0
Fork 0
mirror of https://github.com/LCTT/TranslateProject.git synced 2025-01-25 23:11:02 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #10170 from wxy/20170706-Docker-Guide-Dockerizing-Python-Django-Application

Browse Source 
PRF&PUB:20170706 Docker Guide Dockerizing Python Django Application
This commit is contained in:
Xingyu.Wang 2018-09-12 22:59:04 +08:00 committed by GitHub
commit 892cd7e7ff
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 133 additions and 128 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

261
translated/tech/20170706 Docker Guide Dockerizing Python Django Application.md → published/20170706 Docker Guide Dockerizing Python Django Application.md
View File

@ -1,57 +1,27 @@
Docker 指南：Docker 化 Python Django 应用程序 如何 Docker 化 Python Django 应用程序
====== ======
### 目录 Docker 是一个开源项目，为开发人员和系统管理员提供了一个开放平台，可以将应用程序构建、打包为一个轻量级容器，并在任何地方运行。Docker 会在软件容器中自动部署应用程序。
1. [我们要做什么？][6]
2. [步骤 1 - 安装 Docker-ce][7]
3. [步骤 2 - 安装 Docker-compose][8]
4. [步骤 3 - 配置项目环境][9]
1. [创建一个新的 requirements.txt 文件][1]
2. [创建 Nginx 虚拟主机文件 django.conf][2]
3. [创建 Dockerfile][3]
4. [创建 Docker-compose 脚本][4]
5. [配置 Django 项目][5]
5. [步骤 4 - 构建并运行 Docker 镜像][10]
6. [步骤 5 - 测试][11]
7. [参考][12]
Docker 是一个开源项目，为开发人员和系统管理员提供了一个开放平台，作为一个轻量级容器，它可以在任何地方构建，打包和运行应用程序。Docker 在软件容器中自动部署应用程序。
Django 是一个用 Python 编写的 Web 应用程序框架，遵循 MVC（模型-视图-控制器）架构。它是免费的，并在开源许可下发布。它速度很快，旨在帮助开发人员尽快将他们的应用程序上线。 Django 是一个用 Python 编写的 Web 应用程序框架，遵循 MVC（模型-视图-控制器）架构。它是免费的，并在开源许可下发布。它速度很快，旨在帮助开发人员尽快将他们的应用程序上线。
在本教程中，我将逐步向你展示在 Ubuntu 16.04 如何为现有的 Django 应用程序创建 docker 镜像。我们将学习如何 docker 化一个 Python Django 应用程序，然后使用一个 docker-compose 脚本将应用程序作为容器部署到 docker 环境。 在本教程中，我将逐步向你展示在 Ubuntu 16.04 中如何为现有的 Django 应用程序创建 docker 镜像。我们将学习如何 docker 化一个 Python Django 应用程序，然后使用一个 `docker-compose` 脚本将应用程序作为容器部署到 docker 环境。
为了部署我们的 Python Django 应用程序，我们需要其他 docker 镜像：一个用于 Web 服务器的 nginx docker 镜像和用于数据库的 PostgreSQL 镜像。 为了部署我们的 Python Django 应用程序，我们需要其它 docker 镜像：一个用于 Web 服务器的 nginx docker 镜像和用于数据库的 PostgreSQL 镜像。
### 我们要做什么？ ### 我们要做什么？
1. 安装 Docker-ce 1. 安装 Docker-ce
2. 安装 Docker-compose 2. 安装 Docker-compose
3. 配置项目环境 3. 配置项目环境
4. 构建并运行 4. 构建并运行
5. 测试 5. 测试
### 步骤 1 - 安装 Docker-ce ### 步骤 1 - 安装 Docker-ce
在本教程中，我们将重 docker 仓库安装 docker-ce 社区版。我们将安装 docker-ce 社区版和 docker-compose，其支持 compose 文件版本 3（to 校正者：此处不太明白具体意思）。 在本教程中，我们将从 docker 仓库安装 docker-ce 社区版。我们将安装 docker-ce 社区版和 `docker-compose`（其支持 compose 文件版本 3）。
在安装 docker-ce 之前，先使用 apt 命令安装所需的 docker 依赖项。 在安装 docker-ce 之前，先使用 `apt` 命令安装所需的 docker 依赖项。
``` ```
sudo apt install -y \ sudo apt install -y \
@ -71,7 +41,7 @@ sudo add-apt-repository \
   stable"    stable"
``` ```
[![安装 Docker-ce](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/1.png)][14] [![安装 Docker-ce](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/1.png)][14]
更新仓库并安装 docker-ce。 更新仓库并安装 docker-ce。
@ -87,16 +57,16 @@ systemctl start docker
systemctl enable docker systemctl enable docker
``` ```
接着，我们将添加一个名为 'omar' 的新用户并将其添加到 docker 组。 接着，我们将添加一个名为 `omar` 的新用户并将其添加到 `docker` 组。
``` ```
useradd -m -s /bin/bash omar useradd -m -s /bin/bash omar
usermod -a -G docker omar usermod -a -G docker omar
``` ```
[![启动 Docker](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/2.png)][15] [![启动 Docker](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/2.png)][15]
以 omar 用户身份登录并运行 docker 命令，如下所示。 以 `omar` 用户身份登录并运行 `docker` 命令，如下所示。
``` ```
su - omar su - omar
@ -107,13 +77,13 @@ docker run hello-world
[![检查 Docker 安装](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/3.png)][16] [![检查 Docker 安装](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/3.png)][16]
Docker-ce 安装已经完成。 Docker-ce 安装已经完成。
### 步骤 2 - 安装 Docker-compose ### 步骤 2 - 安装 Docker-compose
在本教程中，我们将使用最新的 docker-compose 支持 compose 文件版本 3。我们将手动安装 docker-compose。 在本教程中，我们将使用支持 compose 文件版本 3 的最新 `docker-compose`。我们将手动安装 `docker-compose`。
使用 curl 命令将最新版本的 docker-compose 下载到 `/usr/local/bin` 目录，并使用 chmod 命令使其有执行权限。 使用 `curl` 命令将最新版本的 `docker-compose` 下载到 `/usr/local/bin` 目录，并使用 `chmod` 命令使其有执行权限。
运行以下命令： 运行以下命令：
@ -122,7 +92,7 @@ sudo curl -L https://github.com/docker/compose/releases/download/1.21.0/docker-c
sudo chmod +x /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose
``` ```
现在检查 docker-compose 版本。 现在检查 `docker-compose` 版本。
``` ```
docker-compose version docker-compose version
@ -132,26 +102,26 @@ docker-compose version
[![安装 Docker-compose](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/4.png)][17] [![安装 Docker-compose](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/4.png)][17]
已安装支持 compose 文件版本 3 的 docker-compose 最新版本。 已安装支持 compose 文件版本 3 的 `docker-compose` 最新版本。
### 步骤 3 - 配置项目环境 ### 步骤 3 - 配置项目环境
在这一步中，我们将配置 Python Django 项目环境。我们将创建新目录 'guide01'，并使其成为我们项目文件的主目录，例如 Dockerfile，Django 项目，nginx 配置文件等。 在这一步中，我们将配置 Python Django 项目环境。我们将创建新目录 `guide01`，并使其成为我们项目文件的主目录，例如包括 Dockerfile、Django 项目、nginx 配置文件等。
登录到 'omar' 用户。 登录到 `omar` 用户。
``` ```
su - omar su - omar
``` ```
创建一个新目录 'guide01'，并进入目录。 创建一个新目录 `guide01`，并进入目录。
``` ```
mkdir -p guide01 mkdir -p guide01
cd guide01/ cd guide01/
``` ```
现在在 'guide01' 目录下，创建两个新目录 'project' 和 'config'。 现在在 `guide01` 目录下，创建两个新目录 `project` 和 `config`。
``` ```
mkdir project/ config/ mkdir project/ config/
@ -159,118 +129,151 @@ mkdir project/ config/
注意： 注意：
* 'project' 目录：我们所有的 python Django 项目文件都将放在该目录中。 * `project` 目录：我们所有的 python Django 项目文件都将放在该目录中。
* `config` 目录：项目配置文件的目录，包括 nginx 配置文件、python pip 的`requirements.txt` 文件等。
* 'config' 目录：项目配置文件的目录，包括 nginx 配置文件，python pip requirements 文件等。 #### 创建一个新的 requirements.txt 文件
### 创建一个新的 requirements.txt 文件 接下来，使用 `vim` 命令在 `config` 目录中创建一个新的 `requirements.txt` 文件。
接下来，使用 vim 命令在 'config' 目录中创建一个新的 requirements.txt 文件
``` ```
vim config/requirements.txt vim config/requirements.txt
``` ```
粘贴下面的配置。 粘贴下面的配置：
``` ```
Django==2.0.4  Django==2.0.4 
gunicorn==19.7.0  gunicorn==19.7.0 
psycopg2==2.7.4 psycopg2==2.7.4
``` ```
保存并退出。 保存并退出。
### 创建 Dockerfile #### 创建 Nginx 虚拟主机文件 django.conf
在 'guide01' 目录下创建新文件 'Dockerfile'。 在 `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 vim Dockerfile
``` ```
现在粘贴下面的 Dockerfile 脚本。 现在粘贴下面的 Dockerfile 脚本：
``` ```
FROM python:3.5-alpine FROM python:3.5-alpine
ENV PYTHONUNBUFFERED 1  ENV PYTHONUNBUFFERED 1 
RUN apk update && \ RUN apk update && \
    apk add --virtual build-deps gcc python-dev musl-dev && \    apk add --virtual build-deps gcc python-dev musl-dev && \
    apk add postgresql-dev bash    apk add postgresql-dev bash
RUN mkdir /config  RUN mkdir /config 
ADD /config/requirements.txt /config/  ADD /config/requirements.txt /config/ 
RUN pip install -r /config/requirements.txt RUN pip install -r /config/requirements.txt
RUN mkdir /src RUN mkdir /src
WORKDIR /src WORKDIR /src
``` ```
保存并退出。 保存并退出。
注意： 注意：
我们想要为我们的 Django 项目构建基于 Alpine Linux 的 Docker 镜像，Alpine 是最小的 Linux 版本。我们的 Django 项目将运行在带有 Python3.5 的 Alpine Linux 上，并添加 postgresql-dev 包以支持 PostgreSQL 数据库。然后，我们将使用 python pip 命令安装在 'requirements.txt' 上列出的所有 Python 包，并为我们的项目创建新目录 '/src'。 我们想要为我们的 Django 项目构建基于 Alpine Linux 的 Docker 镜像，Alpine 是最小的 Linux 版本。我们的 Django 项目将运行在带有 Python 3.5 的 Alpine Linux 上，并添加 postgresql-dev 包以支持 PostgreSQL 数据库。然后，我们将使用 python `pip` 命令安装在 `requirements.txt` 上列出的所有 Python 包，并为我们的项目创建新目录 `/src`。
### 创建 Docker-compose 脚本 #### 创建 Docker-compose 脚本
使用 [vim][18] 命令在 'guide01' 目录下创建 'docker-compose.yml' 文件。 使用 [vim][18] 命令在 `guide01` 目录下创建 `docker-compose.yml` 文件。
``` ```
vim docker-compose.yml vim docker-compose.yml
``` ```
粘贴以下配置内容。 粘贴以下配置内容：
``` ```
version: '3' version: '3'
services: services:
  db:   db:
    image: postgres:10.3-alpine      image: postgres:10.3-alpine
    container_name: postgres01     container_name: postgres01
  nginx:   nginx:
    image: nginx:1.13-alpine     image: nginx:1.13-alpine
    container_name: nginx01     container_name: nginx01
    ports:     ports:
      - "8000:8000"       - "8000:8000"
    volumes:     volumes:
      - ./project:/src       - ./project:/src
      - ./config/nginx:/etc/nginx/conf.d       - ./config/nginx:/etc/nginx/conf.d
    depends_on:     depends_on:
      - web       - web
  web:   web:
    build: .     build: .
    container_name: django01     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"     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:     depends_on:
      - db       - db
    volumes:     volumes:
      - ./project:/src       - ./project:/src
    expose:     expose:
      - "8000"       - "8000"
    restart: always     restart: always
``` ```
保存并退出。 保存并退出。
注意： 注意：
使用这个 docker-compose 文件脚本，我们将创建三个服务。使用 PostgreSQL alpine Linux 创建名为 'db' 的数据库服务，再次使用 Nginx alpine Linux 创建 'nginx' 服务，并使用从 Dockerfile 生成的自定义 docker 镜像创建我们的 python Django 容器。 使用这个 `docker-compose` 文件脚本，我们将创建三个服务。使用 alpine Linux 版的 PostgreSQL 创建名为 `db` 的数据库服务，再次使用 alpine Linux 版的 Nginx 创建 `nginx` 服务，并使用从 Dockerfile 生成的自定义 docker 镜像创建我们的 python Django 容器。
[![配置项目环境](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/5.png)][19] [![配置项目环境](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/5.png)][19]
### 配置 Django 项目 #### 配置 Django 项目
将 Django 项目文件复制到 'project' 目录。 将 Django 项目文件复制到 `project` 目录。
``` ```
cd ~/django cd ~/django
cp -r * ~/guide01/project/ cp -r * ~/guide01/project/
``` ```
进入 'project' 目录并编辑应用程序设置 'settings.py'。 进入 `project` 目录并编辑应用程序设置 `settings.py`。
``` ```
cd ~/guide01/project/ cd ~/guide01/project/
@ -279,29 +282,29 @@ vim hello_django/settings.py
注意： 注意：
我们将部署名为 'hello_django' 的简单 Django 应用程序。 我们将部署名为 “hello_django” 的简单 Django 应用程序。
在 'ALLOW_HOSTS' 行中，添加服务名称 'web'。 在 `ALLOW_HOSTS` 行中，添加服务名称 `web`。
``` ```
ALLOW_HOSTS = ['web'] ALLOW_HOSTS = ['web']
``` ```
现在更改数据库设置，我们将使用 PostgreSQL 数据库，'db' 数据库作为服务运行，使用默认用户和密码。 现在更改数据库设置，我们将使用 PostgreSQL 数据库来运行名为 `db` 的服务，使用默认用户和密码。
``` ```
DATABASES = {  DATABASES = { 
    'default': {    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'postgres',        'NAME': 'postgres',
        'USER': 'postgres',        'USER': 'postgres',
        'HOST': 'db',        'HOST': 'db',
        'PORT': 5432,        'PORT': 5432,
    }    }
} }
``` ```
至于 'STATIC_ROOT' 配置目录，将此行添加到文件行的末尾。 至于 `STATIC_ROOT` 配置目录，将此行添加到文件行的末尾。
``` ```
STATIC_ROOT = os.path.join(BASE_DIR, 'static/') STATIC_ROOT = os.path.join(BASE_DIR, 'static/')
@ -309,21 +312,21 @@ STATIC_ROOT = os.path.join(BASE_DIR, 'static/')
保存并退出。 保存并退出。
[![配置 Django 项目](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/6.png)][20] [![配置 Django 项目](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/6.png)][20]
现在我们准备在 docker 容器下构建和运行 Django 项目。 现在我们准备在 docker 容器下构建和运行 Django 项目。
### 步骤 4 - 构建并运行 Docker 镜像 ### 步骤 4 - 构建并运行 Docker 镜像
在这一步中，我们想要使用 'guide01' 目录中的配置为我们的 Django 项目构建一个 Docker 镜像。 在这一步中，我们想要使用 `guide01` 目录中的配置为我们的 Django 项目构建一个 Docker 镜像。
进入 'guide01' 目录。 进入 `guide01` 目录。
``` ```
cd ~/guide01/ cd ~/guide01/
``` ```
现在使用 docker-compose 命令构建 docker 镜像。 现在使用 `docker-compose` 命令构建 docker 镜像。
``` ```
docker-compose build docker-compose build
@ -331,7 +334,7 @@ docker-compose build
[![运行 docker 镜像](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/7.png)][21] [![运行 docker 镜像](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/7.png)][21]
启动 docker-compose 脚本中的所有服务。 启动 `docker-compose` 脚本中的所有服务。
``` ```
docker-compose up -d docker-compose up -d
@ -348,7 +351,7 @@ docker-compose ps
docker-compose images docker-compose images
``` ```
现在，你将在系统上运行三个容器并列出 Docker 镜像，如下所示。 现在，你将在系统上运行三个容器，列出 Docker 镜像，如下所示。
[![docke-compose ps 命令](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/9.png)][23] [![docke-compose ps 命令](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/9.png)][23]
@ -356,17 +359,19 @@ docker-compose images
### 步骤 5 - 测试 ### 步骤 5 - 测试
打开 Web 浏览器并使用端口 8000 键入服务器地址，我的是：http://ovh01:8000/ 打开 Web 浏览器并使用端口 8000 键入服务器地址，我的是：`http://ovh01:8000/`。
现在你将获得默认的 Django 主页。 现在你将看到默认的 Django 主页。
[![默认 Django 项目主页](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/10.png)][24] [![默认 Django 项目主页](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/10.png)][24]
接下来，通过在 URL 上添加 “/admin” 路径来测试管理页面。 接下来，通过在 URL 上添加 `/admin` 路径来测试管理页面。
```
http://ovh01:8000/admin/ http://ovh01:8000/admin/
```
然后你将会看到 Django admin 登录页面。 然后你将会看到 Django 管理登录页面。
[![Django administration](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/11.png)][25] [![Django administration](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/11.png)][25]
@ -383,7 +388,7 @@ via: https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-
作者：[Muhammad Arul][a] 作者：[Muhammad Arul][a]
译者：[MjSeven](https://github.com/MjSeven) 译者：[MjSeven](https://github.com/MjSeven)
校对：[校对者ID](https://github.com/校对者ID) 校对：[wxy](https://github.com/wxy)
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出