Rabel 安装指南

Question

在配置完 Rabel 的安装环境之后，就可以实际的安装了。

第一部分：安装 Rabel

1.1) 使用 git 下载 Rabel 源代码

备注：如果之前你已经下载了 Rabel 源代码，可以跳过此步。

执行以下命令：

git clone git://github.com/daqing/rabel.git

在成功下载之后，执行：

cd ./rabel

进入 Rabel 源代码目录。

1.2) 安装所需Gem

[ PostgreSQL ]

如果打算使用 PostgreSQL，请找到 Gemfile 中以下两行：

# gem 'pg'
gem 'mysql2'

然后修改为：

gem 'pg'
# gem 'mysql2'

[ MySQL]

如果使用 MySQL，无需任何修改。

然后执行以下命令：

./deploy/install_bundle.sh

这可能需要4 ~ 5分钟时间，耐心等待

1.3) 配置数据库

[ PostgreSQL ]

执行以下命令：

cp config/database.yml.pg config/database.yml

然后用编辑器(vim)打开 config/database.yml，会看到如下内容:

default: &default
  adapter: postgresql
  encoding: unicode
  pool: 5
  username: postgres
  password:
  host: localhost
  port: 5432

其中 username 和 password 就是连接 PostgreSQL 数据库使用的用户名和密码，分别填入相应信息即可。

[ MySQL]

执行以下命令:

cp config/database.yml.mysql config/database.yml

然后用编辑器(vim)打开 config/database.yml，会看到如下内容:

default: &default
  adapter: mysql2
  encoding: utf8
  reconnect: false
  pool: 5
  username: root
  password:
  socket: /tmp/mysql.sock

其中 username 和 password 就是连接 MySQL 数据库使用的用户名和密码，分别填入相应信息即可。 另外，需要把配置中的 socket，修改为命令 mysql_config --socket 所对应的输出。

例如，在我的系统上，mysql_config --socket 的输出为:

/var/run/mysqld/mysqld.sock

那么这里的 socket: /tmp/mysql.sock 就应该修改成:

socket: /var/run/mysqld/mysqld.sock

1.4) 通过环境变量配置 Rabel

执行以下命令:

cp config/application.yml.example config/application.yml

所生成的配置文件如下：config/application.yml

# required
RABEL_HOST_NAME: 'example.com'
RABEL_SYSTEM_EMAIL: 'hello@example.com'
SECRET_TOKEN: ''
SESSION_KEY: '_example_session'

# memcache
RABEL_MEMCACHED_SERVER: '127.0.0.1:11011'
RABEL_MEMCACHED_USERNAME: ''
RABEL_MEMCACHED_PASSWORD: ''
RABEL_MEMCACHED_NAMESPACE: 'example'

# upyun
RABEL_UPYUN_SWITCH: 'off'
RABEL_UPYUN_OP_NAME: 'example'
RABEL_UPYUN_OP_PASSWORD: 'example'
RABEL_UPYUN_BUCKET: 'example'
RABEL_UPYUN_BUCKET_DOMAIN: 'example.b0.upaiyun.com'

需要做以下修改：

1. 修改域名

请把上面的 example.com 替换成自己要绑定的域名。

2. 设置 SECRET_TOKEN

生成一个 Secret Token:

rake secret

把以上命令的输出，作为 SECRET_TOKEN 的值。

3. 支持上传图片

如果打算让用户上传图片，并且存储到又拍云，请做以下修改：

1. 把 RABEL_UPYUN_SWITCH 修改为 on
2. 设置又拍云的相关信息，各个配置的含义如下：

RABEL_UPYUN_OP_NAME: 操作员名称
RABEL_UPYUN_OP_PASSWORD: 操作员密码
RABEL_UPYUN_BUCKET: 空间名称
RABEL_UPYUN_BUCKET_DOMAIN: 空间域名

如果不打算支持图片上传，请跳过此步。

1.5) 加载数据库结构

执行以下命令:

./deploy/setup_database_once.sh

1.6) 预编译 assets

执行以下命令:

./deploy/precompile_assets.sh

第二部分：使用 Nginx + Unicorn 部署 Rabel

2.1) 启动 Unicorn

执行以下命令:

./deploy/start_unicorn_manually.sh

2.2) 创建 Nginx 配置文件

执行以下命令:

sudo cp ./deploy/nginx-example.conf /etc/nginx/conf.d/rabel.conf

对 /etc/nginx/conf.d/rabel.conf做以下修改：

1. 把 RABEL_HOME 替换为 Rabel 源代码所在的目录。
2. 把 HOST_NAME 替换为将要绑定的域名。

2.3) 启动 Nginx:

sudo nginx

第三部分：安装成功 !

到这里，Rabel 就搭建成功。如果网站样式没有显示，应该是目录权限的问题，执行一下命令即可:

chmod a+x $HOME

网站第一个注册用户，拥有最大权限，所以赶紧注册成为第一个用户吧。