Update compose

pull/128/head
Baohua Yang 2016-11-25 22:24:48 +08:00
parent 5291db9ad4
commit 5cd720a388
4 changed files with 37 additions and 36 deletions

View File

@ -77,9 +77,9 @@
* [使用](compose/usage.md) * [使用](compose/usage.md)
* [命令说明](compose/commands.md) * [命令说明](compose/commands.md)
* [YAML 模板文件](compose/yaml_file.md) * [YAML 模板文件](compose/yaml_file.md)
* [实战 Django](fig/django.md) * [实战 Django](compose/django.md)
* [实战 Rails](fig/rails.md) * [实战 Rails](compose/rails.md)
* [实战 wordpress](fig/wordpress.md) * [实战 wordpress](compose/wordpress.md)
* [Docker Machine 项目](machine/README.md) * [Docker Machine 项目](machine/README.md)
* [简介](machine/intro.md) * [简介](machine/intro.md)
* [安装](machine/install.md) * [安装](machine/install.md)

View File

@ -1,6 +1,6 @@
##使用 Django 入门 Fig ## 使用 Django
我们现在将使用 Fig 配置并运行一个 Django/PostgreSQL 应用。在此之前,先确保 Fig 已经 [安装](install.md)。 我们现在将使用 Compose 配置并运行一个 Django/PostgreSQL 应用。在此之前,先确保 Compose 已经 [安装](install.md)。
在一切工作开始前,需要先设置好三个必要的文件。 在一切工作开始前,需要先设置好三个必要的文件。
第一步,因为应用将要运行在一个满足所有环境依赖的 Docker 容器里面,那么我们可以通过编辑 `Dockerfile` 文件来指定 Docker 容器要安装内容。内容如下: 第一步,因为应用将要运行在一个满足所有环境依赖的 Docker 容器里面,那么我们可以通过编辑 `Dockerfile` 文件来指定 Docker 容器要安装内容。内容如下:
@ -24,7 +24,7 @@ psycopg2
``` ```
就是这么简单。 就是这么简单。
第三步,`fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成(一个 web 服务和一个数据库)、使用的 Docker 镜像、镜像之间的连接、挂载到容器的卷,以及服务开放的端口。 第三步,`docker-compose.yml` 文件将把所有的东西关联起来。它描述了应用的构成(一个 web 服务和一个数据库)、使用的 Docker 镜像、镜像之间的连接、挂载到容器的卷,以及服务开放的端口。
``` ```
db: db:
@ -39,22 +39,22 @@ web:
links: links:
- db - db
``` ```
查看 [`fig.yml` 章节](yml_ref.md) 了解更多详细的工作机制。 查看 [`docker-compose.yml` 章节](yml_ref.md) 了解更多详细的工作机制。
现在我们就可以使用 `fig run` 命令启动一个 Django 应用了。 现在我们就可以使用 `docker-compose run` 命令启动一个 Django 应用了。
``` ```
$ fig run web django-admin.py startproject figexample . $ docker-compose run web django-admin.py startproject docker-composeexample .
``` ```
Fig 会先使用 `Dockerfile` 为 web 服务创建一个镜像,接着使用这个镜像在容器里运行 `django-admin.py startproject figexample . ` 指令。 Compose 会先使用 `Dockerfile` 为 web 服务创建一个镜像,接着使用这个镜像在容器里运行 `django-admin.py startproject docker-composeexample . ` 指令。
这将在当前目录生成一个 Django 应用。 这将在当前目录生成一个 Django 应用。
``` ```
$ ls $ ls
Dockerfile fig.yml figexample manage.py requirements.txt Dockerfile docker-compose.yml docker-composeexample manage.py requirements.txt
``` ```
首先,我们要为应用设置好数据库的连接信息。用以下内容替换 `figexample/settings.py` 文件中 `DATABASES = ...` 定义的节点内容。 首先,我们要为应用设置好数据库的连接信息。用以下内容替换 `docker-composeexample/settings.py` 文件中 `DATABASES = ...` 定义的节点内容。
``` ```
DATABASES = { DATABASES = {
@ -68,7 +68,7 @@ DATABASES = {
} }
``` ```
这些信息是在 [postgres](https://registry.hub.docker.com/_/postgres/) Docker 镜像固定设置好的。 这些信息是在 [postgres](https://registry.hub.docker.com/_/postgres/) Docker 镜像固定设置好的。
然后,运行 `fig up` 然后,运行 `docker-compose up`
``` ```
Recreating myapp_db_1... Recreating myapp_db_1...
@ -82,14 +82,14 @@ myapp_web_1 | Validating models...
myapp_web_1 | myapp_web_1 |
myapp_web_1 | 0 errors found myapp_web_1 | 0 errors found
myapp_web_1 | January 27, 2014 - 12:12:40 myapp_web_1 | January 27, 2014 - 12:12:40
myapp_web_1 | Django version 1.6.1, using settings 'figexample.settings' myapp_web_1 | Django version 1.6.1, using settings 'docker-composeexample.settings'
myapp_web_1 | Starting development server at http://0.0.0.0:8000/ myapp_web_1 | Starting development server at http://0.0.0.0:8000/
myapp_web_1 | Quit the server with CONTROL-C. myapp_web_1 | Quit the server with CONTROL-C.
``` ```
这个 web 应用已经开始在你的 docker 守护进程里监听着 5000 端口了(如果你有使用 boot2docker ,执行 `boot2docker ip` ,就会看到它的地址)。 这个 web 应用已经开始在你的 docker 守护进程里监听着 5000 端口了(如果你有使用 boot2docker ,执行 `boot2docker ip` ,就会看到它的地址)。
你还可以在 Docker 上运行其它的管理命令,例如对于同步数据库结构这种事,在运行完 `fig up` 后,在另外一个终端运行以下命令即可: 你还可以在 Docker 上运行其它的管理命令,例如对于同步数据库结构这种事,在运行完 `docker-compose up` 后,在另外一个终端运行以下命令即可:
``` ```
$ fig run web python manage.py syncdb $ docker-compose run web python manage.py syncdb
``` ```

View File

@ -1,6 +1,6 @@
##使用 Rail 入门 Fig ## 使用 Rail
我们现在将使用 Fig 配置并运行一个 Rails/PostgreSQL 应用。在开始之前,先确保 Fig 已经 [安装](install.md)。 我们现在将使用 Compose 配置并运行一个 Rails/PostgreSQL 应用。在开始之前,先确保 Compose 已经 [安装](install.md)。
在一切工作开始前,需要先设置好三个必要的文件。 在一切工作开始前,需要先设置好三个必要的文件。
@ -22,7 +22,7 @@ ADD . /myapp
source 'https://rubygems.org' source 'https://rubygems.org'
gem 'rails', '4.0.2' gem 'rails', '4.0.2'
``` ```
最后,`fig.yml` 文件才是最神奇的地方。 `fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成(一个 web 服务和一个数据库)、每个镜像的来源(数据库运行在使用预定义的 PostgreSQL 镜像web 应用侧将从本地目录创建)、镜像之间的连接,以及服务开放的端口。 最后,`docker-compose.yml` 文件才是最神奇的地方。 `docker-compose.yml` 文件将把所有的东西关联起来。它描述了应用的构成(一个 web 服务和一个数据库)、每个镜像的来源(数据库运行在使用预定义的 PostgreSQL 镜像web 应用侧将从本地目录创建)、镜像之间的连接,以及服务开放的端口。
``` ```
db: db:
@ -39,19 +39,19 @@ web:
links: links:
- db - db
``` ```
所有文件就绪后,我们就可以通过使用 `fig run` 命令生成应用的骨架了。 所有文件就绪后,我们就可以通过使用 `docker-compose run` 命令生成应用的骨架了。
``` ```
$ fig run web rails new . --force --database=postgresql --skip-bundle $ docker-compose run web rails new . --force --database=postgresql --skip-bundle
``` ```
Fig 会先使用 `Dockerfile` 为 web 服务创建一个镜像,接着使用这个镜像在容器里运行 `rails new ` 和它之后的命令。一旦这个命令运行完后,应该就可以看一个崭新的应用已经生成了。 Compose 会先使用 `Dockerfile` 为 web 服务创建一个镜像,接着使用这个镜像在容器里运行 `rails new ` 和它之后的命令。一旦这个命令运行完后,应该就可以看一个崭新的应用已经生成了。
``` ```
$ ls $ ls
Dockerfile app fig.yml tmp Dockerfile app docker-compose.yml tmp
Gemfile bin lib vendor Gemfile bin lib vendor
Gemfile.lock config log Gemfile.lock condocker-compose log
README.rdoc config.ru public README.rdoc condocker-compose.ru public
Rakefile db test Rakefile db test
``` ```
在新的 `Gemfile` 文件去掉加载 `therubyracer` 的行的注释,这样我们便可以使用 Javascript 运行环境: 在新的 `Gemfile` 文件去掉加载 `therubyracer` 的行的注释,这样我们便可以使用 Javascript 运行环境:
@ -62,7 +62,7 @@ gem 'therubyracer', platforms: :ruby
现在我们已经有一个新的 `Gemfile` 文件,需要再重新创建镜像。(这个会步骤会改变 Dockerfile 文件本身,仅仅需要重建一次)。 现在我们已经有一个新的 `Gemfile` 文件,需要再重新创建镜像。(这个会步骤会改变 Dockerfile 文件本身,仅仅需要重建一次)。
``` ```
$ fig build $ docker-compose build
``` ```
应用现在就可以启动了但配置还未完成。Rails 默认读取的数据库目标是 `localhost` ,我们需要手动指定容器的 `db` 。同样的,还需要把用户名修改成和 postgres 镜像预定的一致。 应用现在就可以启动了但配置还未完成。Rails 默认读取的数据库目标是 `localhost` ,我们需要手动指定容器的 `db` 。同样的,还需要把用户名修改成和 postgres 镜像预定的一致。
打开最新生成的 `database.yml` 文件。用以下内容替换: 打开最新生成的 `database.yml` 文件。用以下内容替换:
@ -84,7 +84,7 @@ test:
现在就可以启动应用了。 现在就可以启动应用了。
``` ```
$ fig up $ docker-compose up
``` ```
如果一切正常,你应该可以看到 PostgreSQL 的输出,几秒后可以看到这样的重复信息: 如果一切正常,你应该可以看到 PostgreSQL 的输出,几秒后可以看到这样的重复信息:
@ -96,8 +96,8 @@ myapp_web_1 | [2014-01-17 17:16:29] INFO WEBrick::HTTPServer#start: pid=1 port=
最后, 我们需要做的是创建数据库,打开另一个终端,运行: 最后, 我们需要做的是创建数据库,打开另一个终端,运行:
``` ```
$ fig run web rake db:create $ docker-compose run web rake db:create
``` ```
这个 web 应用已经开始在你的 docker 守护进程里面监听着 3000 端口了(如果你有使用 boot2docker ,执行 `boot2docker ip` ,就会看到它的地址)。 这个 web 应用已经开始在你的 docker 守护进程里面监听着 3000 端口了(如果你有使用 boot2docker ,执行 `boot2docker ip` ,就会看到它的地址)。
![](../_images/fig-rails-screenshot.png) ![](../_images/docker-compose-rails-screenshot.png)

View File

@ -1,6 +1,7 @@
##使用 Wordpress 入门 Fig ## 使用 Wordpress
Fig 让 Wordpress 运行在一个独立的环境中很简易。 Compose 让 Wordpress 运行在一个独立的环境中很简易。
[安装](install.md) Fig ,然后下载 Wordpress 到当前目录:
[安装](install.md) Compose ,然后下载 Wordpress 到当前目录:
``` ```
wordpress.org/latest.tar.gz | tar -xvzf - wordpress.org/latest.tar.gz | tar -xvzf -
@ -14,7 +15,7 @@ ADD . /code
以上内容告诉 Docker 创建一个包含 PHP 和 Wordpress 的镜像。更多关于如何编写 Dockerfile 文件的信息可以查看 [镜像创建](../image/create.md#利用 Dockerfile 来创建镜像) 和 [Dockerfile 使用](../dockerfile/README.md)。 以上内容告诉 Docker 创建一个包含 PHP 和 Wordpress 的镜像。更多关于如何编写 Dockerfile 文件的信息可以查看 [镜像创建](../image/create.md#利用 Dockerfile 来创建镜像) 和 [Dockerfile 使用](../dockerfile/README.md)。
下一步,`fig.yml` 文件将开启一个 web 服务和一个独立的 MySQL 实例: 下一步,`docker-compose.yml` 文件将开启一个 web 服务和一个独立的 MySQL 实例:
``` ```
web: web:
@ -32,7 +33,7 @@ db:
MYSQL_DATABASE: wordpress MYSQL_DATABASE: wordpress
``` ```
要让这个应用跑起来还需要两个文件。 要让这个应用跑起来还需要两个文件。
第一个,`wp-config.php` ,它是一个标准的 Wordpress 配置文件,有一点需要修改的是把数据库的配置指向 `db` 容器。 第一个,`wp-condocker-compose.php` ,它是一个标准的 Wordpress 配置文件,有一点需要修改的是把数据库的配置指向 `db` 容器。
``` ```
<?php <?php
@ -82,5 +83,5 @@ if(file_exists($root.$path))
}else include_once 'index.php'; }else include_once 'index.php';
``` ```
这些配置文件就绪后,在你的 Wordpress 目录里面执行 `fig up` 指令Fig 就会拉取镜像再创建我们所需要的镜像,然后启动 web 和数据库容器。 接着访问 docker 守护进程监听的 8000 端口就能看你的 Wordpress 网站了。(如果你有使用 boot2docker ,执行 `boot2docker ip` ,就会看到它的地址)。 这些配置文件就绪后,在你的 Wordpress 目录里面执行 `docker-compose up` 指令Compose 就会拉取镜像再创建我们所需要的镜像,然后启动 web 和数据库容器。 接着访问 docker 守护进程监听的 8000 端口就能看你的 Wordpress 网站了。(如果你有使用 boot2docker ,执行 `boot2docker ip` ,就会看到它的地址)。