diff --git a/fig/django.md b/fig/django.md index 6b11803..a22610c 100644 --- a/fig/django.md +++ b/fig/django.md @@ -24,7 +24,7 @@ psycopg2 ``` 就是这么简单。 -第三步,`fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成(一个 web 服务和一个数据库)、使用的 Docker 镜像、镜像之间的关系、挂载到容器的卷,以及服务开放的端口。 +第三步,`fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成(一个 web 服务和一个数据库)、使用的 Docker 镜像、镜像之间的连接、挂载到容器的卷,以及服务开放的端口。 ``` db: @@ -41,12 +41,12 @@ web: ``` 查看 [`fig.yml` 章节](yml_ref.md) 了解更多详细的工作机制。 -我们现在就可以使用 `fig run` 命令启动一个 Django 应用了。 +现在我们就可以使用 `fig run` 命令启动一个 Django 应用了。 ``` $ fig run web django-admin.py startproject figexample . ``` -Fig 会先使用 `Dockerfile` 为 web 服务创建一个镜像。接着使用这个镜像在容器里运行 `django-admin.py startproject figexample . ` 指令。 +Fig 会先使用 `Dockerfile` 为 web 服务创建一个镜像,接着使用这个镜像在容器里运行 `django-admin.py startproject figexample . ` 指令。 这将在当前目录生成一个 Django 应用。 @@ -85,7 +85,6 @@ myapp_web_1 | January 27, 2014 - 12:12:40 myapp_web_1 | Django version 1.6.1, using settings 'figexample.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` ,就会看到它的地址)。 diff --git a/fig/rails.md b/fig/rails.md index 0793873..ea36f61 100644 --- a/fig/rails.md +++ b/fig/rails.md @@ -1,8 +1,10 @@ -##从 Fig 结合 Rail 开玩 +##使用 Rail 入门 Fig 我们现在将使用 Fig 配置并运行一个 Rails/PostgreSQL 应用。在开始之前,先确保 Fig 已经 [安装](install.md)。 -先设置好三个必要的文件。首先,我们的应用将要运行在一个安装好所有依赖环境的 Docker 容器里面。我们可以通过指定 `Dockerfile` 文件的内容从而决定 Docker 容器安装什么内容。内容如下: + +在一切工作开始前,需要先设置好三个必要的文件。 +首先,因为应用将要运行在一个满足所有环境依赖的 Docker 容器里面,那么我们可以通过编辑 `Dockerfile` 文件来指定 Docker 容器要安装内容。内容如下: ``` FROM ruby @@ -13,11 +15,89 @@ ADD Gemfile /myapp/Gemfile RUN bundle install ADD . /myapp ``` -这些内容指定了的应用使用一个 Ruby 镜像,并安装插件和其它依赖。关于 Dockerfile 的更多信息可以查看 [镜像创建](../image/create.md#利用 Dockerfile 来创建镜像) 和 [Dockerfile 使用](../dockerfile/README.md) -下一步,我们需要一个引导加载 Rails 的文件 `Gemfile` 。 它将通过 `rails new` 短暂的覆盖 。 +以上内容指定应用将使用安装了 Ruby、Bundler 以及其依赖件的镜像。更多关于如何编写 Dockerfile 文件的信息可以查看 [镜像创建](../image/create.md#利用 Dockerfile 来创建镜像) 和 [Dockerfile 使用](../dockerfile/README.md)。 +下一步,我们需要一个引导加载 Rails 的文件 `Gemfile` 。 等一会儿它将会被 `rails new` 命令覆盖重写。 ``` source 'https://rubygems.org' gem 'rails', '4.0.2' ``` -最后,`fig.yml` 文件才是最神奇的地方。 \ No newline at end of file +最后,`fig.yml` 文件才是最神奇的地方。 `fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成(一个 web 服务和一个数据库)、每个镜像的来源(数据库运行在使用预定义的 PostgreSQL 镜像,web 应用侧将从本地目录创建)、镜像之间的连接,以及服务开放的端口。 + +``` +db: + image: postgres + ports: + - "5432" +web: + build: . + command: bundle exec rackup -p 3000 + volumes: + - .:/myapp + ports: + - "3000:3000" + links: + - db +``` +所有文件就绪后,我们就可以通过使用 `fig run` 命令生成应用的骨架了。 + +``` +$ fig run web rails new . --force --database=postgresql --skip-bundle +``` +Fig 会先使用 `Dockerfile` 为 web 服务创建一个镜像,接着使用这个镜像在容器里运行 `rails new `和它之后的命令。一旦这个命令运行完后,应该就可以看一个崭新的应用已经生成了。 + +``` +$ ls +Dockerfile app fig.yml tmp +Gemfile bin lib vendor +Gemfile.lock config log +README.rdoc config.ru public +Rakefile db test +``` +在新的 `Gemfile` 文件去掉加载 `therubyracer` 的行的注释,这样我们便可以 Javascript 运行环境: + +``` +gem 'therubyracer', platforms: :ruby +``` +现在我们已经有一个新的 `Gemfile` 文件,需要重新创建镜像。(这个会步骤会改变 Dockerfile 文件本身,仅仅需要重建一次)。 + +``` +$ fig build +``` +应用现在就可以启动了,但是还不能这样中止。Rails 默认设置数据库信息是读取 `localhost` 的,我们需要手动指定容器的 `db` 。同样的,还需要把用户名修改成和 postgres 镜像一致。 +打开最新生成的 `database.yml` 文件。用以下内容替换: + +``` +development: &default + adapter: postgresql + encoding: unicode + database: postgres + pool: 5 + username: postgres + password: + host: db + +test: + <<: *default + database: myapp_test +``` +现在就可以启动应用了。 + +``` +$ fig up +``` +如果一切正常,你应该可以看到 PostgreSQL 的输出,几秒后可以看到这样的重复信息: + +``` +myapp_web_1 | [2014-01-17 17:16:29] INFO WEBrick 1.3.1 +myapp_web_1 | [2014-01-17 17:16:29] INFO ruby 2.0.0 (2013-11-22) [x86_64-linux-gnu] +myapp_web_1 | [2014-01-17 17:16:29] INFO WEBrick::HTTPServer#start: pid=1 port=3000 +``` +最后, 我们需要做的是创建数据库,打开另一个终端,运行: + +``` +$ fig run web rake db:create +``` +这个 web 应用已经开始在你的 docker 守护进程里面监听着 3000 端口了(如果你有使用 boot2docker ,执行 `boot2docker ip` ,就会看到它的地址)。 + +![](../_images/fig-rails-screenshot.png) \ No newline at end of file