From 5cd720a388ddbd7ad63464f937cf2cfc60ae2a99 Mon Sep 17 00:00:00 2001 From: Baohua Yang Date: Fri, 25 Nov 2016 22:24:48 +0800 Subject: [PATCH] Update compose --- SUMMARY.md | 6 +++--- {fig => compose}/django.md | 28 ++++++++++++++-------------- {fig => compose}/rails.md | 26 +++++++++++++------------- {fig => compose}/wordpress.md | 13 +++++++------ 4 files changed, 37 insertions(+), 36 deletions(-) rename {fig => compose}/django.md (62%) rename {fig => compose}/rails.md (68%) rename {fig => compose}/wordpress.md (75%) diff --git a/SUMMARY.md b/SUMMARY.md index 959a4cc..cb5b9a4 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -77,9 +77,9 @@ * [使用](compose/usage.md) * [命令说明](compose/commands.md) * [YAML 模板文件](compose/yaml_file.md) - * [实战 Django](fig/django.md) - * [实战 Rails](fig/rails.md) - * [实战 wordpress](fig/wordpress.md) + * [实战 Django](compose/django.md) + * [实战 Rails](compose/rails.md) + * [实战 wordpress](compose/wordpress.md) * [Docker Machine 项目](machine/README.md) * [简介](machine/intro.md) * [安装](machine/install.md) diff --git a/fig/django.md b/compose/django.md similarity index 62% rename from fig/django.md rename to compose/django.md index 6d5309d..2fd0aa4 100644 --- a/fig/django.md +++ b/compose/django.md @@ -1,6 +1,6 @@ -##使用 Django 入门 Fig +## 使用 Django -我们现在将使用 Fig 配置并运行一个 Django/PostgreSQL 应用。在此之前，先确保 Fig 已经 [安装](install.md)。 +我们现在将使用 Compose 配置并运行一个 Django/PostgreSQL 应用。在此之前，先确保 Compose 已经 [安装](install.md)。 在一切工作开始前，需要先设置好三个必要的文件。 第一步，因为应用将要运行在一个满足所有环境依赖的 Docker 容器里面，那么我们可以通过编辑 `Dockerfile` 文件来指定 Docker 容器要安装内容。内容如下： @@ -24,7 +24,7 @@ psycopg2 ``` 就是这么简单。 -第三步，`fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成（一个 web 服务和一个数据库）、使用的 Docker 镜像、镜像之间的连接、挂载到容器的卷，以及服务开放的端口。 +第三步，`docker-compose.yml` 文件将把所有的东西关联起来。它描述了应用的构成（一个 web 服务和一个数据库）、使用的 Docker 镜像、镜像之间的连接、挂载到容器的卷，以及服务开放的端口。 ``` db: @@ -39,22 +39,22 @@ web: links: - 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 应用。 ``` $ 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 = { @@ -68,7 +68,7 @@ DATABASES = { } ``` 这些信息是在 [postgres](https://registry.hub.docker.com/_/postgres/) Docker 镜像固定设置好的。 -然后，运行 `fig up` ： +然后，运行 `docker-compose up` ： ``` Recreating myapp_db_1... @@ -82,14 +82,14 @@ myapp_web_1 | Validating models... myapp_web_1 | myapp_web_1 | 0 errors found 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 | Quit the server with CONTROL-C. ``` 这个 web 应用已经开始在你的 docker 守护进程里监听着 5000 端口了（如果你有使用 boot2docker ，执行 `boot2docker ip` ，就会看到它的地址）。 -你还可以在 Docker 上运行其它的管理命令，例如对于同步数据库结构这种事，在运行完 `fig up` 后，在另外一个终端运行以下命令即可： +你还可以在 Docker 上运行其它的管理命令，例如对于同步数据库结构这种事，在运行完 `docker-compose up` 后，在另外一个终端运行以下命令即可： ``` -$ fig run web python manage.py syncdb -``` \ No newline at end of file +$ docker-compose run web python manage.py syncdb +``` diff --git a/fig/rails.md b/compose/rails.md similarity index 68% rename from fig/rails.md rename to compose/rails.md index 720255c..7625a8d 100644 --- a/fig/rails.md +++ b/compose/rails.md @@ -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' gem 'rails', '4.0.2' ``` -最后，`fig.yml` 文件才是最神奇的地方。 `fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成（一个 web 服务和一个数据库）、每个镜像的来源（数据库运行在使用预定义的 PostgreSQL 镜像，web 应用侧将从本地目录创建）、镜像之间的连接，以及服务开放的端口。 +最后，`docker-compose.yml` 文件才是最神奇的地方。 `docker-compose.yml` 文件将把所有的东西关联起来。它描述了应用的构成（一个 web 服务和一个数据库）、每个镜像的来源（数据库运行在使用预定义的 PostgreSQL 镜像，web 应用侧将从本地目录创建）、镜像之间的连接，以及服务开放的端口。 ``` db: @@ -39,19 +39,19 @@ web: links: - 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 -Dockerfile app fig.yml tmp +Dockerfile app docker-compose.yml tmp Gemfile bin lib vendor -Gemfile.lock config log -README.rdoc config.ru public +Gemfile.lock condocker-compose log +README.rdoc condocker-compose.ru public Rakefile db test ``` 在新的 `Gemfile` 文件去掉加载 `therubyracer` 的行的注释，这样我们便可以使用 Javascript 运行环境： @@ -62,7 +62,7 @@ gem 'therubyracer', platforms: :ruby 现在我们已经有一个新的 `Gemfile` 文件，需要再重新创建镜像。（这个会步骤会改变 Dockerfile 文件本身，仅仅需要重建一次）。 ``` -$ fig build +$ docker-compose build ``` 应用现在就可以启动了，但配置还未完成。Rails 默认读取的数据库目标是 `localhost` ，我们需要手动指定容器的 `db` 。同样的，还需要把用户名修改成和 postgres 镜像预定的一致。 打开最新生成的 `database.yml` 文件。用以下内容替换： @@ -84,7 +84,7 @@ test: 现在就可以启动应用了。 ``` -$ fig up +$ docker-compose up ``` 如果一切正常，你应该可以看到 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` ，就会看到它的地址）。 -![](../_images/fig-rails-screenshot.png) \ No newline at end of file +![](../_images/docker-compose-rails-screenshot.png) diff --git a/fig/wordpress.md b/compose/wordpress.md similarity index 75% rename from fig/wordpress.md rename to compose/wordpress.md index 08add3c..e3d05f4 100644 --- a/fig/wordpress.md +++ b/compose/wordpress.md @@ -1,6 +1,7 @@ -##使用 Wordpress 入门 Fig -Fig 让 Wordpress 运行在一个独立的环境中很简易。 -[安装](install.md) Fig ，然后下载 Wordpress 到当前目录： +## 使用 Wordpress +Compose 让 Wordpress 运行在一个独立的环境中很简易。 + +[安装](install.md) Compose ，然后下载 Wordpress 到当前目录： ``` 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)。 -下一步，`fig.yml` 文件将开启一个 web 服务和一个独立的 MySQL 实例： +下一步，`docker-compose.yml` 文件将开启一个 web 服务和一个独立的 MySQL 实例： ``` web: @@ -32,7 +33,7 @@ db: MYSQL_DATABASE: wordpress ``` 要让这个应用跑起来还需要两个文件。 -第一个，`wp-config.php` ，它是一个标准的 Wordpress 配置文件，有一点需要修改的是把数据库的配置指向 `db` 容器。 +第一个，`wp-condocker-compose.php` ，它是一个标准的 Wordpress 配置文件，有一点需要修改的是把数据库的配置指向 `db` 容器。 ```