3.1 创建演示应用

第 2 章一样,我们要先创建一个新 Rails 项目,名为 sample_app,如代码清单 3.1 所示:[1]

代码清单 3.1:创建一个新应用
$ cd ~/workspace
$ rails _4.2.2_ new sample_app
$ cd sample_app/

(和 2.1 节一样,如果使用云端 IDE,可以在同一个工作空间中创建这个应用,没必要再新建一个工作空间。)

类似 2.1 节,接下来我们要用文本编辑器打开并编辑 Gemfile,写入应用所需的 gem。代码清单 3.2代码清单 1.5代码清单 2.1 一样,不过 test 组中的 gem 有所不同,稍后会做进一步设置(3.7 节)。注意,如果现在你想安装这个应用使用的所有 gem,要写入代码清单 11.66 中的内容。

代码清单 3.2:演示应用的 Gemfile
source 'https://rubygems.org'

gem 'rails',                '4.2.2'
gem 'sass-rails',           '5.0.2'
gem 'uglifier',             '2.5.3'
gem 'coffee-rails',         '4.1.0'
gem 'jquery-rails',         '4.0.3'
gem 'turbolinks',           '2.3.0'
gem 'jbuilder',             '2.2.3'
gem 'sdoc',                 '0.4.0', group: :doc

group :development, :test do
  gem 'sqlite3',     '1.3.9'
  gem 'byebug',      '3.4.0'
  gem 'web-console', '2.0.0.beta3'
  gem 'spring',      '1.1.3'
end

group :test do
  gem 'minitest-reporters', '1.0.5'
  gem 'mini_backtrace',     '0.1.3'
  gem 'guard-minitest',     '2.3.1'
end

group :production do
  gem 'pg',             '0.17.1'
  gem 'rails_12factor', '0.0.2'
end

和前两章一样,我们要执行 bundle install 命令安装并导入 Gemfile 中指定的 gem,而且指定 --without production 选项,[2]不安装生产环境使用的 gem:

$ bundle install --without production

运行这个命令后不会在开发环境中安装 PostgreSQL 所需的 pg gem,在生产环境和测试环境中我们使用 SQLite。Heroku 极力不建议在开发环境和生产环境中使用不同的数据库,但是对这个演示应用来说这两种数据库没什么差别,而且在本地安装配置 SQLite 比 PostgreSQL 容易得多。[3]如果你之前安装了某个 gem(例如 Rails 本身)的其他版本,和 Gemfile 中指定的版本号不同,最好再执行 bundle update 命令,更新 gem,确保安装的版本和指定的一致:

$ bundle update

最后,我们还要初始化 Git 仓库:

$ git init
$ git add -A
$ git commit -m "Initialize repository"

和第一个应用一样,我建议你更新一下 README 文件(在应用的根目录中),更好的描述这个应用。我们先把这个文件的格式从 RDoc 改为 Markdown:

$ git mv README.rdoc README.md

然后写入代码清单 3.3 中的内容。

代码清单 3.3:修改演示应用的 README 文件
# Ruby on Rails Tutorial: sample application

This is the sample application for the
[*Ruby on Rails Tutorial:
Learn Web Development with Rails*](http://www.railstutorial.org/)
by [Michael Hartl](http://www.michaelhartl.com/).

最后,提交这次改动:

$ git commit -am "Improve the README"

你可能还记得,在 1.4.4 节,我们使用 git commit -a -m "Message" 命令,指定了“全部变化”的旗标 -a 和提交信息旗标 -m。如上面这个命令所示,我们可以把两个旗标合在一起,变成 git commit -am "Message"

既然本书后续内容会一直使用这个演示应用,那么最好在 Bitbucket 中新建一个仓库,把这个应用推送上去:

$ git remote add origin [email protected]:<username>/sample_app.git
$ git push -u origin --all # 首次推送这个应用

为了避免以后遇到焦头烂额的问题,在这个早期阶段也可以把应用部署到 Heroku 中。参照第 1 章第 2 章,我建议使用代码清单 1.8代码清单 1.9 中的代码,创建一个显示“hello, world!”的首页。然后提交改动,再推送到 Heroku 中:

$ git commit -am "Add hello"
$ heroku create
$ git push heroku master

(和 1.5 节一样,你可能会看到一些警告消息,现在暂且不管,7.5 节会解决。)除了 Heroku 为应用分配的地址之外,看到的页面应该和图 1.18 一样。注意:有些读者反馈说,遇到了与 spring gem 有关的问题,你可以在命令行中执行 spring binstub 命令,看能不能解决。

在阅读本书的过程中,我建议你定期推送和部署,这样不仅能在远程仓库中备份,而且还能尽早发现在生产环境中可能出现的问题。如果遇到和 Heroku 有关的问题,可以查看生产环境中的日志,试着找出问题所在:

$ heroku logs

注意,如果你决定把真实的应用放到 Heroku 中,一定要按照 7.5 节介绍的方法配置 Unicorn。