部署Node.js的应用

原创：作者 mashihua

最近Node.js很火，让很多的前端看到了可以直接从前端写到后端的希望。但是每次部署一个Node.js的应用却让前端苦恼不已。每次登陆服务器，用自己不熟悉的方式从版本控制仓库中拖下源代码，kill掉应用的进程，重起一个应用的守护进程。如果能够自动化的部署一个Node.js应用，而不需要去接触这些前端不太熟悉的Unix系统命令和管理。对于大家来说就是提升了生产力。Capistrano是一个强大的自动化部署工具，所以我们选用他来做自动化部署。并且我已经把做好了的一个部署脚本<a href=“https://github.com/mashihua/Nodebot”>Nodebot</a>提交到github上去，供大家参考。 首先我们需要一个环境，分为两个环境：部署客户端环境和服务器环境。 <h3>部署客户端系统需求：</h3> 你可以用任何系统了，系统只要具备下面的4个软件就可。 <ol> <li>安装ruby。去<a href=“http://www.ruby-lang.org/en/downloads/”>http://www.ruby-lang.org/en/downloads/</a>下载适合你系统的ruby版本。</li> <li>安装rubygem。去<a href=“http://rubyforge.org/projects/rubygems/”>http://rubyforge.org/projects/rubygems/</a>下载最新版的RubyGems，解压后运行以下命令安装。 sudo ruby setup.rb</li> <li>安装Capistrano和Capistrano-etx。运行以下的命令安装。sudo gem install capistrano capistrano-ext</li> </ol> 这样你就拥有了在机器部署node.js应用的软件。然后你需要能够不使用密码直接登陆到服务器上。运行下面的命令： <pre># Create a local ssh key ssh-keygen #Copy key to server cat ~/.ssh/id_rsa.pub | ssh user@domain.com “cat >> .ssh/authorized_keys” </pre> 这样你就可以不需要密码直接登陆到服务器。 <h3>服务器端系统需求：</h3> 当然要Unix一类的系统了，Nodebot需要具备upstart的系统（一个基于事件的守护进程管理系统）。虽然Node.js能跑在window上，但是那只适合开发环境，不适合生产环境。还要有下面的软件，你也可以下载Nodebot并在部署客户端运行命令cap nodebot:setup 来自动化安装。 <ol> <li>安装scm软件。比如git，svn或hg，取决于你的node.js应用源代码管理软件。</li> <li>安装Node.js。没什么好说的，地球人都知道这是什么。</li> <li>安装npm。Node.js的一个包管理软件</li> <li>安装node-jake。一个javascript的代码构建工具，有点像make和rake。用来安装应用的依赖。</li> <li>具备upstart的系统，比如Ubantu。来做应用的守护进程。参看 <a href=“http://upstart.ubuntu.com/”>http://upstart.ubuntu.com/</a></li> </ol> 部署的登陆用户需要sudo权限，并且不需要提示输入密码。参考命令： <pre>#Add a sudoer sudo useradd -m foo #edit sudoer privilege sudo visudo </pre> 出现编辑器时，插入下面一行，foo就是你新建的用户： <pre>foo ALL=(ALL) NOPASSWD: ALL</pre> 然后在deploy.rb文件（下面会提到）里配置foo为部署用户。 <h3>部署客户端脚本</h3> 环境有了，那就要开工了。我们希望在服务器上的Node.js应用运行几个不同的环境：测试环境，开发环境，产品环境等。运行cap .命令会在当前的目录下产生一个文件和一个目录。在目录里有个deploy.rb，这是我们需要修改的文件。由于我们需要多个环境，所以我们引入了Capistrano-etx。 <pre>set :stages, %w[staging production] set :default_stage, ‘staging’ require ‘capistrano/ext/multistage’ </pre> 我们设定了两个环境：staging和production，默认是staging环境。我们再在config目录下建一个deploy目录，里面放的两个.rb文件对应不同的环境配置.最后部署环境的目录下是这样的一个结构： <pre>. ├── Capfile └── config ├── deploy │ ├── production.rb │ └── staging.rb ├── deploy.rb └── node.rb</pre> deploy.rb文件看起来像这样。你需要设定host, repository,user和admin_user ： <pre>## # Capistrano tasks for Ubantu. # # Author: Shihua Ma http://f2eskills.com/ set :stages, %w[staging production] set :default_stage, ‘staging’ require ‘capistrano/ext/multistage’ #application name set :application, “example” #start server script set :node_file, “app.js” #deploy host set :host, “hostname” #user name,must be a sudoer without prompting for password set :user, “username” set :admin_runner, user set :repository, “git@git @git hub.com:mashihua/Nodebot.git” set :scm, :git set :deploy_via, :remote_cache role :app, host set :use_sudo, true namespace :deploy do 
 desc “Start node server”
 task :start, :roles => :app, :except => { :no_release => true } do
 run “sudo start #{application}#{node_env}"
 end
 
 desc “Stop node server”
 task :stop, :roles => :app, :except => { :no_release => true } do
 run "sudo stop #{application}#{node_env}”
 end
 
 desc “Restart node server”
 task :restart, :roles => :app, :except => { :no_release => true } do
 run “sudo restart #{application}#{node_env} || sudo start #{application}#{node_env}”
 end
 
 desc “Check required packages and install if packages are not installed”
 task :check_packages, roles => :app do
 run “cd #{release_path} && jake depends”
 end
 
 task :create_deploy_to_with_sudo, :roles => :app do
 run “sudo mkdir -p #{deploy_to}”
 run “sudo chown #{admin_runner}:#{admin_runner} #{deploy_to}”
 end
 
 desc “Update submodules”
 task :update_submodules, :roles => :app do
 run “cd #{release_path}; git submodule init && git submodule update”
 end
 
 task :write_upstart_script, :roles => :app do
 upstart_script = <> #{shared_path}/log/#{node_env}.log 2>&1"
 end script
 respawn
 UPSTART
 
 put upstart_script, “/tmp/#{application}_upstart.conf”
 run “sudo mv /tmp/#{application}upstart.conf /etc/init/#{application}#{node_env}.conf”
 end
 
 end
 
 before ‘deploy:setup’, ‘deploy:create_deploy_to_with_sudo’
 after ‘deploy:setup’, ‘deploy:write_upstart_script’
 after “deploy:finalize_update”, “deploy:update_submodules”, “deploy:check_packages”
 </pre>
 staging.rb环境文件看起来像这样。设定了应用的环境，git的branch，应用的监听端口和部署目录：
 <pre>set :node_env, “staging”
 #git repos branch
 set :branch, “master”
 #listing port
 set :application_port, “1603”
 #deploy path
 set :deploy_to, “/srv/www/apps/#{application}/#{node_env}”
 </pre>
 production.rb环境文件看起来像这样：
 <pre>set :node_env, “production”
 #git repos branch
 set :branch, “production”
 #listing port
 set :application_port, “1604”
 #deploy path
 set :deploy_to, “/srv/www/apps/#{application}/#{node_env}”
 </pre>
 
 <h3>主要命令：</h3>
 <ul>
 <li>cap -T 查看所有的task</li>
 <li>cap deploy:setup 设置staging环境，比如创建部署的目录等。staging是默认环境，命令等同于cap staging deploy:setup。调用production环境的命令cap production deploy:setup，第一个参数是环境名，第二个参数是任务名。</li>
 <li>cap nodebot:setup 安装系统一些软件和配置守护进程。上面已经介绍过。</li>
 <li>cap production deploy 部署 production环境的Node.js应用。包括从仓库取最新的代码，链接最新的代码到一个目录。重起应用的Server。</li>
 <li>cap deploy:stop, cap deploy:start和cap deploy:restart 停止，启动和重起staging环境的Server。</li>
 </ul>
 <h3>简单的Node.js应用：</h3>
 我们用一个简单的Node.js应用来说明实际的效果，应用的目录结构就像这样：
 <pre>.
 ├── Jakefile.js
 ├── app.js
 ├── config
 │ └── requirements.json
 └── log</pre>
 
 log 应用日志的输出目录
 
 app.js 就是应用的启动脚本
 <pre>var express = require(‘express’);
 
 var app = express.createServer();
 
 app.get(’/’, function(req, res){
 //the log will out put to log/{node_env}.log
 console.log(“Method:” + req.method);
 //send text to agent
 res.send(‘Hello World. NODE_ENV=’ + process.env.NODE_ENV);
 });
 
 
 //listening on application_port where set by capistrano
 app.listen(process.argv[2] || 3000);
 </pre>
 Jakefile.js jake构建工具调用的脚本，在本例子中用来安装express
 <pre>var fs = require(‘fs’);
 
 desc(‘Check and install required packages’);
 task(‘depends’, [], function (arg) {
 var npm = require(‘npm’);
 npm.load({}, function (err) {
 if (err) return commandFailed(err);
 npm.on(“log”, function (message) { if(arg) console.log(message) })
 var requirements = JSON.parse(fs.readFileSync(‘config/requirements.json’));
 npm.commands.install(requirements, function (err, data) {
 if (err) return commandFailed(err);
 });
 });
 }, true);
 </pre>
 config/requirements.json 应用依赖的定义
 <pre>[ “express@2.4.7”]</pre>
 
 实际部署的效果： <a href=“http://xiaoya.me:1603/”>staging环境</a>， <a href=“http://xiaoya.me:1604/”>production环境</a>
 <h2>结论：</h2>
 使用<a href=“https://github.com/mashihua/Nodebot”>Nodebot</a>你可以轻松的部署你的Node.js应用。把你的焦点放到实际的需求中，而不用关心部署环境的建立和部署应用的麻烦，只许在部署客户端轻松的输入简单的命令。

巴特西

部署Node.js的应用

最新文章

热门文章