diff --git a/translated/tech/20170706 Docker Guide Dockerizing Python Django Application.md b/translated/tech/20170706 Docker Guide Dockerizing Python Django Application.md new file mode 100644 index 0000000000..98fd65b47d --- /dev/null +++ b/translated/tech/20170706 Docker Guide Dockerizing Python Django Application.md @@ -0,0 +1,415 @@ +Docker 指南: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 在软件容器中自动部署应用程序。 + +Django 是一个用 Python 编写的 Web 应用程序框架,遵循 MVC(模型-视图-控制器)架构。它是免费的,并在开源许可下发布。它速度很快,旨在帮助开发人员尽快将他们的应用程序上线。 + +在本教程中,我将逐步向你展示在 Ubuntu 16.04 如何为现有的 Django 应用程序创建 docker 镜像。我们将学习如何 docker 化一个 Python Django 应用程序,然后使用一个 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,其支持 compose 文件版本 3(to 校正者:此处不太明白具体意思)。 + +在安装 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](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/1.png)][14] + +更新仓库并安装 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](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/2.png)][15] + +以 omar 用户身份登录并运行 docker 命令,如下所示。 + +``` +su - omar +docker run hello-world +``` + +确保你能从 Docker 获得 hello-world 消息。 + + [![检查 Docker 安装](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/3.png)][16] + + Docker-ce 安装已经完成。 + + ### 步骤 2 - 安装 Docker-compose + +在本教程中,我们将使用最新的 docker-compose 支持 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](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/4.png)][17] + +已安装支持 compose 文件版本 3 的 docker-compose 最新版本。 + +### 步骤 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 文件等。 + +### 创建一个新的 requirements.txt 文件 + +接下来,使用 vim 命令在 'config' 目录中创建一个新的 requirements.txt 文件 + +``` +vim config/requirements.txt +``` + +粘贴下面的配置。 + +``` +Django==2.0.4  + gunicorn==19.7.0  + psycopg2==2.7.4 +``` + +保存并退出。 + +### 创建 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 +``` + +保存并退出。 + +注意: + +我们想要为我们的 Django 项目构建基于 Alpine Linux 的 Docker 镜像,Alpine 是最小的 Linux 版本。我们的 Django 项目将运行在带有 Python3.5 的 Alpine Linux 上,并添加 postgresql-dev 包以支持 PostgreSQL 数据库。然后,我们将使用 python pip 命令安装在 'requirements.txt' 上列出的所有 Python 包,并为我们的项目创建新目录 '/src'。 + +### 创建 Docker-compose 脚本 + +使用 [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 +``` + +保存并退出。 + +注意: + +使用这个 docker-compose 文件脚本,我们将创建三个服务。使用 PostgreSQL alpine Linux 创建名为 'db' 的数据库服务,再次使用 Nginx alpine Linux 创建 'nginx' 服务,并使用从 Dockerfile 生成的自定义 docker 镜像创建我们的 python Django 容器。 + + [![配置项目环境](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/5.png)][19] + + ### 配置 Django 项目 + +将 Django 项目文件复制到 'project' 目录。 + +``` +cd ~/django +cp -r * ~/guide01/project/ +``` + +进入 '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 项目](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/6.png)][20] + +现在我们准备在 docker 容器下构建和运行 Django 项目。 + +### 步骤 4 - 构建并运行 Docker 镜像 + +在这一步中,我们想要使用 'guide01' 目录中的配置为我们的 Django 项目构建一个 Docker 镜像。 + +进入 'guide01' 目录。 + +``` +cd ~/guide01/ +``` + +现在使用 docker-compose 命令构建 docker 镜像。 + +``` +docker-compose build +``` + +[![运行 docker 镜像](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/7.png)][21] + +启动 docker-compose 脚本中的所有服务。 + +``` +docker-compose up -d +``` + +等待几分钟让 Docker 构建我们的 Python 镜像并下载 nginx 和 postgresql docker 镜像。 + +[![使用 docker-compose 构建镜像](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/8.png)][22] + +完成后,使用以下命令检查运行容器并在系统上列出 docker 镜像。 + +``` +docker-compose ps +docker-compose images +``` + +现在,你将在系统上运行三个容器并列出 Docker 镜像,如下所示。 + +[![docke-compose ps 命令](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/9.png)][23] + +我们的 Python Django 应用程序现在在 docker 容器内运行,并且已经创建了为我们服务的 docker 镜像。 + +### 步骤 5 - 测试 + +打开 Web 浏览器并使用端口 8000 键入服务器地址,我的是:http://ovh01:8000/ + +现在你将获得默认的 Django 主页。 + +[![默认 Django 项目主页](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/10.png)][24] + +接下来,通过在 URL 上添加 “/admin” 路径来测试管理页面。 + +http://ovh01:8000/admin/ + +然后你将会看到 Django admin 登录页面。 + +[![Django administration](https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/11.png)][25] + +Docker 化 Python Django 应用程序已成功完成。 + +### 参考 + +* [https://docs.docker.com/][13] + + +-------------------------------------------------------------------------------- + +via: https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/ + +作者:[Muhammad Arul][a] +译者:[MjSeven](https://github.com/MjSeven) +校对:[校对者ID](https://github.com/校对者ID) + +本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出 + +[a]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/ +[1]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#create-a-new-requirementstxt-file +[2]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#create-the-nginx-virtual-host-file-djangoconf +[3]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#create-the-dockerfile +[4]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#create-dockercompose-script +[5]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#configure-django-project +[6]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#what-we-will-do +[7]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#step-install-dockerce +[8]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#step-install-dockercompose +[9]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#step-configure-project-environment +[10]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#step-build-and-run-the-docker-image +[11]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#step-testing +[12]:https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/#reference +[13]:https://docs.docker.com/ +[14]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/1.png +[15]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/2.png +[16]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/3.png +[17]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/4.png +[18]:https://www.howtoforge.com/vim-basics +[19]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/5.png +[20]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/6.png +[21]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/7.png +[22]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/8.png +[23]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/9.png +[24]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/10.png +[25]:https://www.howtoforge.com/images/docker_guide_dockerizing_python_django_application/big/11.png