From f4b012403147df1fe3b22ebec53cd5019211f888 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=8D=A2=E5=85=8B?= Date: Wed, 29 May 2013 00:00:43 +0800 Subject: [PATCH] =?UTF-8?q?discourse=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2013-05-25-discourse-install-guide.md | 132 +++++++++++------- 1 file changed, 81 insertions(+), 51 deletions(-) diff --git a/_posts/2013/2013-05-25-discourse-install-guide.md b/_posts/2013/2013-05-25-discourse-install-guide.md index 9cd833f..a79cb9f 100644 --- a/_posts/2013/2013-05-25-discourse-install-guide.md +++ b/_posts/2013/2013-05-25-discourse-install-guide.md @@ -11,30 +11,33 @@ tags: [Discourse](http://discourse.org/)是一个开源的论坛程序，由Stack Overflow的联合创始人之一Jeff Atwood在离开Stack Overflow后组队创建。他们的目标很宏伟，就是创建一个面向未来十年的论坛程序。具体的一些论坛的特性可以到其官网上查看，这里主要讨论一些其技术相关的东西。 -Discourse的源码托管在github,[https://github.com/discourse/discourse](https://github.com/discourse/discourse)，使用了以下一些相关技术： +Discourse的源码托管在github上,[https://github.com/discourse/discourse](https://github.com/discourse/discourse)，使用了以下一些相关技术： -- Ruby on Rails ，Discourse的后端其实是一个rails的app,拥有RESTful的api，api返回数据格式都是JSON格式。 -- Ember.js ，前端是一个Ember.js的app，和rails的api进行交互，他们使用这个Ember.js的原因可以参考这篇博文[http://eviltrout.com/2013/02/10/why-discourse-uses-emberjs.html](http://eviltrout.com/2013/02/10/why-discourse-uses-emberjs.html),博主在Discourse项目中主要担任前端开发工作，他的观点就是如果一个web应用是一个强交互应用的话，那么就可以使用Client MVC的js框架 +- Ruby on Rails ，Discourse的后端是一个rails的app,RESTful的api，返回JSON格式的数据 +- Ember.js ，Discourse的前端是一个Ember.js的app，和rails的api进行交互，他们使用这个Ember.js的原因可以参考这篇博文[http://eviltrout.com/2013/02/10/why-discourse-uses-emberjs.html](http://eviltrout.com/2013/02/10/why-discourse-uses-emberjs.html),此博主在Discourse项目中主要担任前端开发工作，他的观点就是如果一个web应用是一个强交互应用的话，那么使用Client MVC的js框架将利大于弊 - PostgreSQL ， 主要的数据都使用PostgreSQL进行存储，这个具有学院派风格的数据库经过多年的发展，稳定性，性能都非常不错，功能全面也是其一大特色。 - Redis ，使用Redis这个kv数据库用于任务队列等功能 -如果你想使用Discourse搭建一个论坛，那么一个虚拟主机（VPS）是必不可少的了。本文所使用的主机是在Digital Ocean上申请的，机房选择的是旧金山，国内的访问速度还可以，我是比较熟悉Debian系（比如Debian，Ubuntu...）的Linux发行版本，安装软件直接apt-get解决，非常的方便。所以就选了Debian 7.0 x32 Server，512MB Ram，20GB SSD Disk，不过官方建议的最低内存是1G。 -创建好一个系统之后，第一步要做的就是系统的优化，用户创建及一些安全性相关的设置。 - +如果你想使用Discourse搭建一个论坛，那么一个虚拟主机（VPS）是必不可少的了。本文所使用的主机是在Digital Ocean上申请的，机房选择的是旧金山，国内的访问速度还可以，我是比较熟悉Debian系（比如Debian，Ubuntu...）的Linux发行版本，安装软件直接apt-get解决，非常的方便。所以就选了Debian 7.0 x32 Server，512MB Ram，20GB SSD Disk，不过Discourse官方建议的最低内存是1G。 +
+应用的部署使用了一个ruby写的叫做[Capistrano](https://github.com/capistrano/capistrano)的工具，它是一个远程自动部署的工具，支持插件比如这次就使用了一个Capistrano的rbenv插件。 +Capistrano的使用中涉及到两方：一方是客户端，也就是发起运行Capistrano的一方，Capistrano的配置文件都在客户端；另一方是服务器端，也就是最终应用部署的目标容器。我们在客户端中配置好Capistrano以及发布的脚本，然后运行之，Capistrano便会根据脚本通过ssh连接到服务器上进行部署的各项工作，这些步骤无需我们直接操作，我们只需要看着命令行中输出的log便可。 + ###一.服务器端的各项准备工作 -应用的部署使用了一个ruby写的叫做[Capistrano](https://github.com/capistrano/capistrano)的工具，它是一个远程自动部署的工具，支持插件。只要在服务器上把基础环境准备好后，应用的配置和部署只需要在本地客户端上敲几个命令即可，特别是多服务器端的时候特别方便了。 -创建好虚拟主机后首先有几个操作需要先做一下的 + +创建好虚拟主机后服务器端的一些工作 + +####0.准备工作 更新系统： apt-get update apt-get upgrade apt-get install vim #默认的vi不太好用,你也可以选择别的编辑器比如nano - + 确认下hostname vi /etc/hosts #比如 127.0.0.1 localhost mydiscourse.org - -
+ ####1.创建交换区 有些虚拟机提供商可能默认就创建好交换区了，你可以通过free命令来查看，如果free的结果中看到类似如下这一行的时候，说明已经存在swap分区了 @@ -70,26 +73,33 @@ Digital Ocean默认是没有帮你创建好交换分区的，创建的方式如 要设置ssh验证方式，首先得在客户端也就是本机（desktop）上生成密钥对（如果你之前已经有了可以跳过此步） ssh-keygen - -这个时候会在~/.ssh 目录下生成了两个文件 id_rsa 和 id_rsa.pub，前者为私有，后者为公钥，你需要将公钥内容加到服务器端对应用户的 ~/.ssh/authorized_keys 文件中，如果authorized_keys不存在则你需要创建一下。 + +这个时候会在~/.ssh 目录下生成了两个文件 id_rsa 和 id_rsa.pub，前者为私有，后者为公钥，你需要将公钥内容加到服务器端对应用户的 `~/.ssh/authorized_keys` 文件中，如果authorized_keys不存在则你需要创建一下。 然后为了安全性 设置下相关目录的权限 - + chown -R apps:apps .ssh chmod 700 .ssh chmod 600 .ssh/authorized_keys -这个时候你可以从客户端直接ssh 过去而不用输入用户密码了，假设这个时候你以apps登录下，我们再把密码验证登录验证的方式关掉。 +这个时候你可以从客户端直接ssh连 过去而不用输入用户密码了，假设这个时候你以apps登录下，我们再把密码验证登录验证的方式关掉。 - sudo vi /etc/ssh/sshd_config #加上 PasswordAuthentication no 以及 PermitRootLogin no - sudo service ssh restart #重启 sshd服务 + #设置成 PasswordAuthentication no 以及 PermitRootLogin no + sudo vi /etc/ssh/sshd_config + + #重启 sshd服务 + sudo service ssh restart ####3.安装必要的软件 - + + + #编译ruby所需的基础库 sudo apt-get install build-essential openssl libreadline6 libreadline6-dev \ curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev \ sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev libgdbm-dev \ ncurses-dev automake libtool bison subversion pkg-config libffi-dev + #安装nginx sudo apt-get install nginx + #安装PostgreSQL redis sudo apt-get install postgresql-9.1 postgresql-contrib-9.1 redis-server \ libxml2-dev libxslt-dev libpq-dev make g++ @@ -100,62 +110,70 @@ Digital Ocean默认是没有帮你创建好交换分区的，创建的方式如 createdb -U apps discourse_production 由于Discourse有邮件发送的需求，如果你想使用系统本身来发邮件，那么你还得安装sendmail - - apt-get install sendmail -###二.客户端的准备工作 + + apt-get install sendmail
+###二.客户端的工作 + ####1.客户端安装基础软件 安装git，如果你是使用Linux那么直接使用相关的包管理软件进行安装，如果你使用的是Mac那么可以使用macprot或者brew这些第三方的包管理软件进行安装。当然如果你要使用源码编译的方式安装也是可以的。 安装ruby，你可以直接安装（包管理软件安装或者源码编译），也可以通过ruby版本管理的软件进行间接安装，比如rvm，rbenv。我这里选择了rbenv。 如果你是Linux你得确保编译所需的软件包都安装就绪 - + sudo apt-get install build-essential openssl libreadline6 libreadline6-dev \ curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev \ sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev libgdbm-dev \ ncurses-dev automake libtool bison subversion pkg-config libffi-dev - + 如果你是Mac，那么XCode以及XCode命令行工具你得安装就位。 安装rbenv以及通过rbenv安装ruby + #安装rbenv git clone git://github.com/sstephenson/rbenv.git ~/.rbenv echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile echo 'eval "$(rbenv init -)"' >> ~/.bash_profile exec $SHELL -l + + #安装rbenv的ruby-build插件，方便ruby版本的安装 git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build - rbenv install 2.0.0-p195; rbenv global 2.0.0-p195 - rbenv rehash + #安装rbenv的rehash插件，安装了新的gem后再也不用运行rbenv rehash了:) + git clone https://github.com/sstephenson/rbenv-gem-rehash.git ~/.rbenv/plugins/rbenv-gem-rehash + + #安装ruby-2.0.0-p195以及bundler + rbenv install 2.0.0-p195; + rbenv global 2.0.0-p195 gem install bundler - rbenv rehash ####2.git库的相关操作 如果你想自己做一些自定义的开发工作或者想为discourse这个开源项目贡献自己的代码，那么你去注册一个github的账号是必不可少的了。 -然后从 https://github.com/discourse/discourse fork一个git库出来，比如我fork出来的地址为 https://github.com/kejinlu/discourse +然后从 [https://github.com/discourse/discourse](https://github.com/discourse/discourse) fork一个git库出来，比如我fork出来的地址为 [https://github.com/kejinlu/discourse](https://github.com/kejinlu/discourse) + #克隆远程库到本地 git clone git@github.com:kejinlu/discourse.git cd discourse - git remote add upstream git@github.com:discourse/discourse.git #增加上游库,以便将上游的更新合并过来 + #增加上游库,以便将上游的更新合并过来 + git remote add upstream git@github.com:discourse/discourse.git ####3.准备Discourse生产环境所需的配置文件 - config/database.yml - config/redis.yml - environments/production.rb - initializers/secret_token.rb - config/thin.yml - config/nginx.conf -`config/database.yml`是数据库的配置文件，主要配置数据库的用户名密码，以及相关hostname - +- config/database.yml +数据库的配置文件，主要配置数据库的用户名密码，以及相关hostname + cp database.yml.production-sample config/database.yml - vi config/database.yml #然后对用户名密码以及对生产环境对应的host_names进行修改 + #然后对用户名密码以及对生产环境对应的host_names进行修改 + vi config/database.yml + +- config/redis.yml +配置文件可以直接使用样例 -`config/redis.yml` 配置文件可以直接使用样例 cp redis.yml.sample redis.yml #使用样例的配置即可，无需修改 - -`environments/production.rb` 主要涉及到邮件发送的配置，如果你不想使用操作系统中的sendmail进行发送邮件,你可以选择第三方的smtp服务， -比如我就是使用gmail的smtp进行发送的。 - + +- environments/production.rb +次配置文件主要需要修改就是邮件发送的配置，如果你不想使用操作系统中的sendmail进行发送邮件,你可以选择第三方的smtp服务， +比如我就是使用gmail的smtp进行发送的，相关配置如下： + config.action_mailer.delivery_method = :smtp config.action_mailer.perform_deliveries = true config.action_mailer.raise_delivery_errors = true @@ -171,18 +189,26 @@ Digital Ocean默认是没有帮你创建好交换分区的，创建的方式如 #config.action_mailer.delivery_method = :sendmail #config.action_mailer.sendmail_settings = {arguments: '-i'} -`initializers/secret_token.rb` 这个文件是rails要用的，默认就存在了，只不过用于开发环境的，你需要生成一个新的secret并对这个文件进行修改 +- initializers/secret_token.rb +这个文件是rails要用的，默认就存在了，只不过用于开发环境的，你需要生成一个新的secret并对这个文件进行修改 + bundle exec rake secret - + 将生成的字符串用到`initializers/secret_token.rb`文件中 最后这个文件除了注释掉的只剩下一行 + Discourse::Application.config.secret_token = "你生成的token贴到这里" -`config/thin.yml` 是用于thin的配置文件， +- config/thin.yml +是用于thin的配置文件， + cp config/thin.yml.sample config/thin.yml + 在config/thin.yml最后加上一行 + onebyone: true + 当然你也可以自己设置server的数量，一个server在运行的时候对应一个thin的进程，如果你的内存有线可以适当的减少server的数量，比如我设置成了2 --- @@ -202,8 +228,8 @@ Digital Ocean默认是没有帮你创建好交换分区的，创建的方式如 daemonize: true onebyone: true -`config/nginx.conf` - +- config/nginx.conf + cp config/nginx.conf.sample config/nginx.conf 这是nginx的配置文件，下面是我的配置，upstream里面内容和thin的配置对应,还要记得修改server_name以及location的root的位置 @@ -264,7 +290,7 @@ Digital Ocean默认是没有帮你创建好交换分区的，创建的方式如 } -由于上面的一些配置中涉及到一些敏感信息，你不不能将其放到public的库中，要不放到私有库中，要么将这些敏感文件加入git的ignore +由于上面的一些配置中涉及到一些敏感信息，你不不能将其放到public的库中，要不放到私有库中，要么将这些敏感文件加入git的ignore。如果将上述的文件加入ignore的话，那么在下面的deploy脚本中需要将本地的配置在部署的过程中拷贝到目标服务器中，作为生产环境的配置文件，如果你把正式的配置文件都放到了私有的库中，那么这些配置文件其实就没有必要从客户端再拷贝了，下文的deploy.rb脚本中就有从本地拷贝这些配置的过程。 ####4.配置Capistrano @@ -272,8 +298,10 @@ Digital Ocean默认是没有帮你创建好交换分区的，创建的方式如 gem 'capistrano', require: nil gem 'capistrano-rbenv', require: nil - -cp Capfile.sample Capfile + +增加Capfile + + cp Capfile.sample Capfile 创建config/deploy.rb @@ -397,6 +425,7 @@ cp Capfile.sample Capfile ####5.运行Capistrano +初次安装部署 bundle install cap deploy:setup @@ -404,7 +433,8 @@ cp Capfile.sample Capfile 升级部署 - + + git fetch upstream git merge upstream/master git push origin master