diff --git a/translated/tech/20170706 Docker Guide Dockerizing Python Django Application.md b/translated/tech/20170706 Docker Guide Dockerizing Python Django Application.md index 98fd65b47d..e89a2065f5 100644 --- a/translated/tech/20170706 Docker Guide Dockerizing Python Django Application.md +++ b/translated/tech/20170706 Docker Guide Dockerizing Python Django Application.md @@ -1,57 +1,27 @@ -Docker 指南:Docker 化 Python Django 应用程序 +如何 Docker 化 Python Django 应用程序 ====== -### 目录 - -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 在软件容器中自动部署应用程序。 +Docker 是一个开源项目,为开发人员和系统管理员提供了一个开放平台,可以将应用程序构建、打包为一个轻量级容器,并在任何地方运行。Docker 会在软件容器中自动部署应用程序。 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 - 2. 安装 Docker-compose - 3. 配置项目环境 - 4. 构建并运行 - 5. 测试 ### 步骤 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 \ @@ -71,7 +41,7 @@ sudo add-apt-repository \    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。 @@ -87,16 +57,16 @@ systemctl start docker systemctl enable docker ``` -接着,我们将添加一个名为 'omar' 的新用户并将其添加到 docker 组。 +接着,我们将添加一个名为 `omar` 的新用户并将其添加到 `docker` 组。 ``` useradd -m -s /bin/bash 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 @@ -107,13 +77,13 @@ docker run hello-world [![检查 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 ``` -现在检查 docker-compose 版本。 +现在检查 `docker-compose` 版本。 ``` 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] -已安装支持 compose 文件版本 3 的 docker-compose 最新版本。 +已安装支持 compose 文件版本 3 的 `docker-compose` 最新版本。 ### 步骤 3 - 配置项目环境 -在这一步中,我们将配置 Python Django 项目环境。我们将创建新目录 'guide01',并使其成为我们项目文件的主目录,例如 Dockerfile,Django 项目,nginx 配置文件等。 +在这一步中,我们将配置 Python Django 项目环境。我们将创建新目录 `guide01`,并使其成为我们项目文件的主目录,例如包括 Dockerfile、Django 项目、nginx 配置文件等。 -登录到 'omar' 用户。 +登录到 `omar` 用户。 ``` su - omar ``` -创建一个新目录 'guide01',并进入目录。 +创建一个新目录 `guide01`,并进入目录。 ``` mkdir -p guide01 cd guide01/ ``` -现在在 'guide01' 目录下,创建两个新目录 'project' 和 'config'。 +现在在 `guide01` 目录下,创建两个新目录 `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 ``` -粘贴下面的配置。 +粘贴下面的配置: ``` Django==2.0.4  - gunicorn==19.7.0  - psycopg2==2.7.4 +gunicorn==19.7.0  +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 ``` -现在粘贴下面的 Dockerfile 脚本。 +现在粘贴下面的 Dockerfile 脚本: ``` FROM python:3.5-alpine - ENV PYTHONUNBUFFERED 1  +ENV PYTHONUNBUFFERED 1  - RUN apk update && \ -     apk add --virtual build-deps gcc python-dev musl-dev && \ -     apk add postgresql-dev bash +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 +RUN mkdir /config  +ADD /config/requirements.txt /config/  +RUN pip install -r /config/requirements.txt +RUN mkdir /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 ``` -粘贴以下配置内容。 +粘贴以下配置内容: ``` 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 + 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 容器。 +使用这个 `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 cp -r * ~/guide01/project/ ``` -进入 'project' 目录并编辑应用程序设置 'settings.py'。 +进入 `project` 目录并编辑应用程序设置 `settings.py`。 ``` 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'] ``` -现在更改数据库设置,我们将使用 PostgreSQL 数据库,'db' 数据库作为服务运行,使用默认用户和密码。 +现在更改数据库设置,我们将使用 PostgreSQL 数据库来运行名为 `db` 的服务,使用默认用户和密码。 ``` DATABASES = {  -     'default': { -         'ENGINE': 'django.db.backends.postgresql_psycopg2', -         'NAME': 'postgres', -         'USER': 'postgres', -         'HOST': 'db', -         'PORT': 5432, -     } - } +    'default': { +        'ENGINE': 'django.db.backends.postgresql_psycopg2', +        'NAME': 'postgres', +        'USER': 'postgres', +        'HOST': 'db', +        'PORT': 5432, +    } +} ``` -至于 'STATIC_ROOT' 配置目录,将此行添加到文件行的末尾。 +至于 `STATIC_ROOT` 配置目录,将此行添加到文件行的末尾。 ``` 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 项目。 ### 步骤 4 - 构建并运行 Docker 镜像 -在这一步中,我们想要使用 'guide01' 目录中的配置为我们的 Django 项目构建一个 Docker 镜像。 +在这一步中,我们想要使用 `guide01` 目录中的配置为我们的 Django 项目构建一个 Docker 镜像。 -进入 'guide01' 目录。 +进入 `guide01` 目录。 ``` cd ~/guide01/ ``` -现在使用 docker-compose 命令构建 docker 镜像。 +现在使用 `docker-compose` 命令构建 docker 镜像。 ``` 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-compose 脚本中的所有服务。 +启动 `docker-compose` 脚本中的所有服务。 ``` docker-compose up -d @@ -348,7 +351,7 @@ docker-compose ps docker-compose images ``` -现在,你将在系统上运行三个容器并列出 Docker 镜像,如下所示。 +现在,你将在系统上运行三个容器,列出 Docker 镜像,如下所示。 [![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 - 测试 -打开 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] -接下来,通过在 URL 上添加 “/admin” 路径来测试管理页面。 +接下来,通过在 URL 上添加 `/admin` 路径来测试管理页面。 +``` http://ovh01:8000/admin/ +``` -然后你将会看到 Django admin 登录页面。 +然后你将会看到 Django 管理登录页面。 [![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] 译者:[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/) 荣誉推出