如何使用 Docker 组件开发 Django 项目?

jopen 9年前

原文地址: Django Development With Docker Compose and Machine

以下为译文

Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的 Linux 机器上,也可以实现虚拟化。自2013年发布以来,无论是从 Github 上的代码活跃度,还是 Redhat 在 RHEL6.5 中集成对 Docker 的支持, 就连 Google 的 Compute Engine 也支持 Docker 在其之上运行。火热程度可见一斑!

本篇文章详细介绍了如何通过 Docker Machine 「系统配置」和 Docker Compose 「多容器应用组装」 提供堆栈完成 Postgres, Redis 和 Django 项目相结合的开发。

而在最后,该堆栈将包括如下每个服务的单独的容器:

  • 一个 Web/ Django 的容器
  • 一个 Nginx 的容器
  • 一个 Postgres 的容器
  • 一个 Redis 的容器
  • 一个 Data 容器

如何使用 Docker 组件开发 Django 项目?

本地设置

使用 Docker「v1.6.1」版本我们将使用到 Docker Compose 「v1.2.0」编排一个多容器组成的应用程序,使用 Docker Machine「v0.2.0」创建本地和云的 Docker 主机。按照指示,分别安装 Docker Compose 和 Machine,然后测试安装结果:

$ docker-machine --version   docker-machine version 0.2.0 (8b9eaf2)   $ docker-compose --version   docker-compose 1.2.0

接下来,根据以下项目结构从 realpython/dockerizing-django 克隆一份项目或自己创建项目:

├── docker-compose.yml   ├── nginx   │   ├── Dockerfile   │   └── sites-enabled   │   └── django_project   ├── production.yml   └── web   │   ├── Dockerfile   │   ├── docker_django   │   │   ├── __init__.py   │   │   ├── apps   │   │   │   ├── __init__.py   │   │   │   └── todo   │   │   │   ├── __init__.py   │   │   │   ├── admin.py   │   │   │   ├── models.py   │   │   │   ├── templates   │   │   │   │   ├── _base.html   │   │   │   │   └── home.html   │   │   │   ├── tests.py   │   │   │   ├── urls.py   │   │   │   └── views.py   │   │   ├── settings.py   │   │   ├── urls.py   │   └── wsgi.py   │   ├── manage.py   │   ├── requirements.txt   │   └── static   │   │   └── main.css</code>

现在我们准备容器运行……

Docker Machine

开启 Docker Machine,只需运行:

$ docker-machine create -d virtualbox dev;  INFO[0000] Creating CA: /Users/michael/.docker/machine/certs/ca.pem  INFO[0000] Creating client certificate: /Users/michael/.docker/machine/certs/cert.pem  INFO[0001] Downloading boot2docker.iso to /Users/michael/.docker/machine/cache/boot2docker.iso...  INFO[0035] Creating SSH key...  INFO[0035] Creating VirtualBox VM...  INFO[0043] Starting VirtualBox VM...  INFO[0044] Waiting for VM to start...  INFO[0094] "dev" has been created and is now the active machine.  INFO[0094] To point your Docker client at it, run this in your shell: eval "$(docker-machine env dev)" 

这个 create 命令设置一个新的 Machine「开发环境」。实际上,它是下载 Boot2Docker 并开始运行 VM。现在只要在开发环境下指定 Docker:

$ eval "$(docker-machine env dev)"

运行以下命令来查看当前正在运行的机器:

$ docker-machine ls   NAME  ACTIVE  DRIVER  STATE  URL   dev * virtualbox Running tcp://192.168.99.100:2376

接下来,我们会让 Django,Postgres 和 Redis 的容器运行起来。

Docker Compose

让我们看一看 docker-compose.yml 文件:

web:     restart: always     build: ./web     expose:      - "8000"     links:       - postgres:postgres         - redis:redis     volumes:       - /usr/src/app/static    env_file: .env    command: /usr/local/bin/gunicorn docker_django.wsgi:application -w 2 -b :8000     nginx:    restart: always    build: ./nginx/    ports:       - "80:80"     volumes:       - /www/static     volumes_from:       - web    links:       - web:web     postgres:     restart: always    image: postgres:latest     volumes_from:       - data    ports:       - "5432:5432"     redis:     restart: always    image: redis:latest     ports:       - "6379:6379"     data:       restart: always     image: postgres:latest     volumes:       - /var/lib/postgresql    command: true

在这里,我们定义了五个服务: Web、Nginx、Postgres、Redis 和 Data。

  • Web 服务通过 「Web」 目录下的 Dockerfile 来进行构建,这里也设置了 Python 环境设置,Django 应用默认8000端口。这个端口之后转发到主机环境的80端口上–例如,Docker Machine。Web 服务还在容器 Restore.env 文件中增加了环境变量。
  • Nginx 服务用于反向代理,作用于 Django 或静态文件目录。
  • Postgres 服务是从 Docker Hub 的官方 PostgreSQL镜像 安装,安装 Postgres 后运行在默认的服务器的5432端口。
  • Redis 使用官方 Redis镜像 安装,默认 Redis 服务是运行在6379端口。
  • 最后,注意有一个单独的容器来存储数据库数据,即为 Data。这有助于确保即使 Postgres 容器完全摧毁数据仍然存在。

现在,运行容器,构建镜像,然后开始服务:

$ docker-compose build   $ docker-compose up -d

这时可以有时间喝一杯咖啡或走走路,因为你第一次运行它将需要一段时间,随后就可以从 Docker 缓存中建立运行更快的了。

一旦服务运行,我们就需要创建数据库迁移:

$ docker-compose run web /usr/local/bin/python manage.py migrate

获得 Docker Machine 的相关 IP, – docker-machine ip –,然后在您的浏览器中输入IP:

如何使用 Docker 组件开发 Django 项目?

出现上图后刷新,您应该能看到页面更新。从本质上讲,我们使用 Redis INCR 来递增每个处理请求,查看 web/docker_django/apps/todo/views.py 代码以获得更多信息。

同样,这创造了五项服务,都在不同的容器中运行:

$ docker-compose ps   Name    Command    State           Ports  ----------------------------------------------------------------------------------------------  dockerizingdjango_data_1       /docker-entrypoint.sh true       Up      5432/tcp  dockerizingdjango_nginx_1      /usr/sbin/nginx       Up      0.0.0.0:80->80/tcp  dockerizingdjango_postgres_1   /docker-entrypoint.sh postgres   Up      0.0.0.0:5432->5432/tcp  dockerizingdjango_redis_1      /entrypoint.sh redis-server      Up      0.0.0.0:6379->6379/tcp  dockerizingdjango_web_1        /usr/local/bin/gunicorn do ...   Up      8000/tcp  

要查看哪些环境变量可用于 Web 服务,运行:

$ docker-compose run web env

要查看日志,运行:

$ docker-compose logs

您也可以进入 Postgres Shell - - 因为我们已经通过 docker-compose.yml 文件设置在数据库中通过添加用户/角色,端口转发到主机环境中:

$ psql -h 192.168.99.100 -p 5432 -U postgres --password

准备部署?先停止运行 docker-compose stop ,然后让我们的应用程序在云中运行!

部署

与我们在本地运行应用程序一样,我们现在可以 push 到与 Docker Machine 环境完全相同的云托管服务提供商。现在让我们部署到 Digital Ocean 中。

您注册 Digital Ocean 之后,产生个人访问令牌 「Personal Access Token」,然后运行以下命令:

$ docker-machine create \   -d digitalocean \   --digitalocean-access-token=ADD_YOUR_TOKEN_HERE \  Production 

这将需要几分钟时间来提供 droplet , 并设置一个新的 Docker Machine 产品环境:

INFO[0000] Creating SSH key...   INFO[0001] Creating Digital Ocean droplet...   INFO[0133] "production" has been created and is now the active machine.   INFO[0133] To point your Docker client at it, run this in your shell: eval "$(docker-machine env production)"

现在我们有两台机器运行,一是在本地,一个在 Digital Ocean:

$ docker-machine ls  NAME         ACTIVE   DRIVER         STATE     URL  dev          *        virtualbox     Running   tcp://192.168.99.100:2376  production            digitalocean   Running   tcp://104.131.107.8:2376

设置 production 为激活机器并加载 Docker 环境到 shell:

$ docker-machine active production   $ eval "$(docker-machine env production)"

最后,让我们在云上再次构建 Django 的应用程序。这时候我们就需要使用一个稍微不同的 Docker Compose 文件,不需要安装在容器里。为什么呢?因为容器本身非常适合本地开发,这样我们可以更新「Web」目录的本地代码,并且更改代码立刻对容器产生影响。在生产中,很明显没有这个必要。

$ docker-compose build   $ docker-compose up -d -f production.yml   $ docker-compose run web /usr/local/bin/python manage.py migrate

获取与 Digital Ocean 帐户相关联的 IP 地址,并在浏览器中查看它。如果一切顺利,你应该可以看到你的应用程序在运行。

原文地址: Django Development With Docker Compose and Machine

本文系 OneAPM 工程师编译整理。想阅读更多技术文章,请访问 OneAPM 官方博客