使用 Capistrano 部署总结
使用 Capistrano 部署总结
2014年6月27日 admin发表评论阅读评论
简介
Capistrano 是一个 Ruby 程序,它提供高级的工具集来部署你的 Web应用到服务器上。Capistrano 允许你通过 SSH 从源代码控制仓库(SVN 或 Git)复制代码到服务器,并执行如重启 Web服务器、操作缓存、重命名文件、迁移数据库等部署前/后的功能。利用 Capistrano一次也可部署多台机器。 安装 Capistrano
为了安装 Capistrano,你的电脑需要已安装 Ruby 和 RubyGems。 # gem list Capistrano -a -r http://ruby.taobao.org/
*** REMOTE GEMS ***
capistrano (3.2.1, 3.2.0, 3.1.0, 3.0.1, 3.0.0, 2.15.5, 2.15.4, 2.15.3, 2.15.2, 2.15.1, 2.15.0, 2.14.2, 2.14.1, 2.13.5, 2.12.0, 2.11.2, 2.9.0, 2.8.0, 2.7.0, 2.6.0, 2.5.21, 2.5.20, 2.5.19, 2.5.18, 2.5.17, 2.5.16, 2.5.15, 2.5.14, 2.5.13, 2.5.12, 2.5.11, 2.5.10, 2.5.9, 2.5.8, 2.5.7, 2.5.6, 2.5.5, 2.5.4, 2.5.3, 2.5.2, 2.5.1, 2.5.0, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.0, 2.2.0, 2.1.0, 2.0.0, 1.4.2, 1.4.1, 1.4.0, 1.3.1, 1.3.0, 1.2.0, 1.1.0)
capistrano-af83 (0.4.7, 0.4.6, 0.4.5, 0.4.4, 0.4.3, 0.4.2, 0.4.1, 0.4.0, 0.3.8, 0.3.2, 0.3.1, 0.3.0, 0.2.4, 0.2.3, 0.2.2, 0.2.1, 0.2.0, 0.1.9, 0.1.8, 0.1.7, 0.1.6, 0.1.5, 0.1.4, 0.1.3, 0.1.2, 0.1.1, 0.1.0)
capistrano-akamai (0.0.1)
capistrano-alice (0.0.7, 0.0.6, 0.0.5, 0.0.4, 0.0.3, 0.0.2, 0.0.1)
capistrano-asgroup (0.0.1)
上面的命令列出了目前capistrano所有的版本及其相关的插件(插件还有很多,这里我没粘全),可以看到目前capistrano的最新版本为3.2.1 。不过由于webistrano环境所使用的是2.6.0 。本篇还是以2.6.0的版本进行安装和总结。 注:capistrano 3.X.X 版本和 capistrano 2.X.X之间已经发生了比较大的变化 。这有点类似于python3与python2的区别。 安装方法: $ gem install capistrano -v 2.6.0
//如果需要安装capistrano扩展,再增加下面的操作
$ gem install capistrano-ext
如果你遇到了问题或想要了解更多细节,可以参考官方的 Capistrano 入门指南,或找到使 Capistrano 工作的各种组件。 注:安装时,会自动安装依赖包,请确认 net-ssh 的版本号为2.7.0 ,不然执行任何deploy操作时会遇到类似如下的ssh认证报错 [deploy:update_code] exception while rolling back: Capistrano::ConnectionError, connection failed for: ... (Net::SSH::AuthenticationFailed: Authentication failed for user
具体可以参看github上的net-ssh项目的issues部分 。 创建项目
在终端中导航到你的应用根目录,并执行以下命令: $ sudo capify .
[add] writing './Capfile'
[add] making directory './config'
[add] writing './config/deploy.rb'
[done] capified!
$ tree
.
├── Capfile
└── config
└── deploy.rb
在capistrano 3.x.x的版本中,此处已经不能使用这样的方法创建项目,应该使用下面的操作: $ capify .
--------------------------------------------------------------------------------
Capistrano 3.x is incompatible with Capistrano 2.x.
This command has become `cap install` in Capistrano 3.x
For more information see http://www.capistranorb.com/
--------------------------------------------------------------------------------
$ sudo cap install
mkdir -p config/deploy
create config/deploy.rb
create config/deploy/staging.rb
create config/deploy/production.rb
mkdir -p lib/capistrano/tasks
Capified
$ tree
.
├── Capfile
├── config
│ ├── deploy
│ │ ├── production.rb
│ │ └── staging.rb
│ └── deploy.rb
└── lib
└── capistrano
└── tasks
也不难看出,两者的目录结构也已经发生了一些变化。个人尝试了下3.x.x版本,发现其功能和细节较2.x.x 做了很多优化。如果不使用古老的webistrano做web前端,建议使用新版本。由于webistrano 已经三年多没更新(作者也已宣布不再更新),所以不确定其与capistrano 3.x.x 的兼容性 。 创建的项目中一个特殊的 Capfile 文件,Capfile 将帮助 Capistrano 正确加载你的 deploy.rb模板,而deploy.rb文件定义了模块、namespace、task等,在部署过程中,只需要按主机组执行相应的task即可完成相应的操作。 编写 Capistrano模板
1、配置deploy.rb文件 以下deploy.rb
文件中一些详细的分析 require 'bundler/capistrano' #添加之后部署时会调用bundle install, 如果不需要就可以注释掉
require "capistrano/ext/multistage" #多stage部署所需
set :stages, %w(development production)
set :default_stage, "development"
set :application, "crm_app_end" #应用名称
set :repository, "https://test.361way.com/svn/trunk"
set :keep_releases, 5 #只保留5个备份
set :deploy_to, "/var/www/#{application}" #部署到远程机器的路径
set :user, "user1" #登录部署机器的用户名
set :password, "user1" #登录部署机器的密码, 如果不设部署时需要输入密码
default_run_options[:pty] = true #pty: 伪登录设备
#default_run_options[:shell] = false #Disable sh wrapping
set :use_sudo, true #执行的命令中含有sudo, 如果设为false, 用户所有操作都有权限
set :runner, "user2" #以user2用户启动服务
set :svn_username, "xxxx"
set :scm, :subversion #注意subversion前有冒号,不能少
# Or: `accurev`, `bzr`, `cvs`, `darcs`, `git`, `mercurial`, `perforce`, `subversion` or `none`
#set :deploy_via, :copy #如果SCM设为空, 也可通过直接copy本地repo部署
#set :domain, "crm.abc.com" #custom define
role :web, "192.168.0.13", "192.168.0.117" # Your HTTP server, Apache/etc
role :app, "192.168.0.13", "192.168.0.117" # This may be the same as your `Web` server
role :db, "192.168.0.13", :primary => true # This is where Rails migrations will run
#role :db, "your slave db-server here"
#
namespace :deploy do
desc "remove and destory this app"
task :destory, :roles => :app do
run "cd #{deploy_to}/../ && #{try_sudo} mv #{application} /tmp/#{application}_#{Time.now.strftime('%Y%d%m%H%M%S')}" #try_sudo 以sudo权限执行命令
end
after "deploy:update", "deploy:shared:setup" #after, before 表示在特定操作之后或之前执行其他任务
namespace :shared do
desc "setup shared folder symblink"
task :setup do
run "cd #{deploy_to}/current; rm -rf shared; ln -s #{shared_path} ."
end
end
after "deploy:setup", "deploy:setup_chown"
desc "change owner from root to user1"
task :setup_chown do
run "cd #{deploy_to}/../ && #{try_sudo} chown -R #{user}:#{user} #{application}"
end
task :start do
run "cd #{deploy_to}/current && ./crmd.sh start"
#try_sudo "cd #{deploy_to}/current && ./restart.sh"
end
task :stop do
run "cd #{deploy_to}/current && ./crmd.sh stop"
end
task :restart do
run "cd #{deploy_to}/current && ./crmd.sh restart"
end
end
上面关于环境部分这里特别说下,如果有多个stage要部署,则在config下创建deploy文件夹, 在该文件夹下有各stages文件, 文件名和 set :stages, %w(development production) 对应, 如development.rb production.rb,在各文件中设置相应变量即可, set :stages, ["staging", "production"]
set :default_stage, "staging"
production.rb 设置类似如下: set :deploy_to, "/var/www/#{application}"
# The hostnames to deploy to.
role :web, "devel.example.com"
# Specify one of the web servers to use for database backups or updates.
# This server should also be running Drupal.
role :db, "devel.example.com", :primary => true
# The username on the target system, if different from your local username
# ssh_options[:user] = 'alice'
# The path to drush
set :drush, "cd #{current_path} ; /usr/bin/php /data/lib/php/drush/drush.php"
同样development.rb: server "my_fancy_server.com", :app, :web, :db, :primary => true
set :deploy_to, "/var/www/fancy_shoes_development"
实际应用中,我们也可以配置在不同环境中使用同一主机中使用不同的目录,也可以配置不同的环境里包含着不同的主机。在多环境中,执行部署的命令需要指定环境: cap production deploy:...
在2.x.x 的多环境配置中使用cap发布也可以不指环境,这需要在配置中指定其中一个环境为默认环境 。在3.x.x中,默认创建的demo项目中,就已经创建好了deploy目录,并生成了production和staging两个环境文件,而且在执行时默认强制需要指定发布的环境,所以3.x.x的默认结构更清晰 。 2、验证配置的执行deploy 全部准备好后,先试试我们的 recipe,以便让 Capistrano
在服务器上创建初始的目录结构。从你的应用根目录执行下列命令: $ cap deploy:setup
当你执行该命令时,Capistrano 将 SSH 到你的服务器,进入你在 deploy_to 变量中所指定的目录,并创建特殊的 Capistrano 目录结构。如果遇到权限或 SSH
访问错误,你将获得错误消息。当命令执行时仔细看看 Capistrano 的输出。 在我们使用 Capistrano 做实际部署之前的最后一步是,确保 setup
命令在服务器上全都设置正确。使用以下命令进行简单验证: $ cap deploy:check
该命令将检查你的本机环境及服务器,并定位问题。如果你看到错误消息,修复后再运行此命令。一旦你执行 cap deploy:check 没有错误,则可继续处理。 部署过程中我们还会用到下面的语句(需要在deploy.rb里事先进行定义task): $cap deploy:setup #建立部署路径
$cap deploy:update #部署
$cap deploy:start #启动服务
$cap deploy:stop #停止服务
$cap deploy:restart #重启服务
$cap deploy:rollback #回滚
提示与技巧
使用远端缓存改进性能 Capistrano
的工作方式在每次部署时都将创建新的仓库克隆及导出。那必将很慢,通过添加一些扩展选项到
deploy.rb recipe 则可提速。添加下列内容到 deploy.rb 文件描述 scm 设置的位置: set :deploy_via, :remote_cache
此命令使 Capistrano 在服务器上只克隆/导出仓库一次,然后在每次部署时使用 svn
up 或 git pull 代替。如果你经常部署,你将发现提速明显。 添加定制的部署钩子(Hook) Capistrano 显然比通过 SSH
复制文件要高级。你可以配置事件或命令以便在文件复制完成后执行,如重启 Web
服务器、执行定制的脚本等。Capistrano 称这些为“任务”。例如,添加以下代码到
deploy.rb 文件: namespace :deploy do
task :restart, :roles => :web do
run "touch #{ current_path }/tmp/restart.txt"
end
task :restart_daemons, :roles => :app do
sudo "monit restart all -g daemons"
end
end
Capistrano 中的任务非常强大,我们在本指南中仅接触到表皮。你可以创建任务在部署
前、部署后或单独操作服务器。这可以是任何维护类型:重启进程、清理文件、发送
邮件通知、执行数据库迁移、运行脚本等等。 我们的示例包括两个定制任务。“restart”任务是内建于 Capistrano
中的,将在部署完成后自动执行。我们使用由 Passenger 驱动的现代 Rails 应用技术
touch tmp/restart.txt,你的 Web 服务器可能需要不同的命令。 我们的第二个示例任务是“restart_daemons”,Capistrano
不会默认执行此定制任务。为了让它运行,我们需要添加一个 hook: after "deploy", "deploy:restart_daemons"
此命令告诉 Capistrano 在我们的部署操作完成后执行任务。其他可用的 hook 是
before,将在文件复制之前执行任务。 关于 before 及 after hook,你可以阅读官方的 Capistrano 文档: Before Tasks
After Tasks
将 Git 分支与环境关联 因为我们有两个服务器环境(临时和生产),你可能想要绑定 Git
分支到这些环境。这样,你可以自动部署 staging 分支到临时环境,master
分支到生产环境。简单添加下列内容到 production.rb: set :branch, 'production'
并添加以下内容到 staging.rb set :branch, 'staging'
现在每次你执行 cap deploy 时,Capistrano 将从你的 staging 分支(因为 staging
是我们的默认环境)部署代码。如果你运行 cap production deploy,Capistrano
将从你的 master 分支部署代码。 参考文档: largetalk的csdn博客 capistrano部署drupal应用 dl528888 51cto博客 使用capistrano部署web应用 github wiki页
使用 Capistrano 部署总结的更多相关文章
- 使用GitLab CI + Capistrano部署CakePHP应用程序
使用GitLab CI + Capistrano部署CakePHP应用程序 摘要:本文描述了如使用GitLab CI + Capistrano部署CakePHP应用程序. 目录 1. 问题2. 解决方 ...
- Capistrano 部署rails 应用
1 安装 gem install capistrano // For mutiple stages gem install capistrano-ext 2 准备 capify . 这个命令会创建Ca ...
- 部署node程序并维持正常运行时间
12.2部署的基础知识 假定你创建了一个想要展示的Web程序,或者创建了一个商业应用,在把它放到生产环境中之前需要测试一下.你很可能会从一个简单的部署开始,然后再做些工作让它的正常运行时间和性能达到最 ...
- 使用_Capistrano_进行自动化部署(2)
之前的一篇文章是为了解决问题而写的,很多东西都没有介绍清楚,这一篇文章就是完整介绍一下 Capistrano,主要的参考来源是 Modern PHP 这本书. Capistrano 是用于自动部署应用 ...
- Twitter如何在数千台服务器上快速部署代码?
答案是:用BT,也就是你我应该都很熟悉的BitTorrent. 对于网站经营者.创业者来说,扩展性的问题是在网站流量成长过程中势必会面对的问题,如何建立一个具有扩展性的架构(scalable arch ...
- 关于 CAS 不能登录的问题
经过排查,是因为 Capistrano 部署中设置了 http_proxy.此时通过 cas.m.xxxx.com 域名去访问 CAS 服务时,就不通了,需要修改为 IP 来访问. 但是公司的 CAS ...
- Rails的静态资源管理(四)—— 生产环境的 Asset Pipeline
官方文档:http://guides.ruby-china.org/asset_pipeline.html http://guides.rubyonrails.org/asset_pipeline.h ...
- Capistrano初探--Ruby快速部署工具
1.Capistrano介绍 是什么?---一种部署工具.(部署就是在生产服务器上安装应用程序,或是更新最新版本:web服务器的启动重启与停止:使网站进入维护状态或将其恢复为常态) 在进行 Rails ...
- 使用 Capistrano 进行自动化部署
最近在折腾这个,弄了好多次都不成功,看了官方文档和很多博客,都没有说清楚,因此,我觉得有必要把它记录下来,以帮助更多像我这样被弄得烦躁的人. 首先是安装,其实 Ubuntu 上面安装 Capistra ...
随机推荐
- javascrit-function中this的指向问题
javascrit中this的指向 全局作用域或者普通函数中 this 指向全局对象 window. //直接打印 console.log(this) //window //function声明函数 ...
- linux系统查看当前正在运行的服务
--查看当前服务器所有服务 service --status-all -- 查看当前所有正在运行的服务 service --status-all | grep running --查看指定服务运行状态 ...
- 【AMAD】transitions -- 一个python实现的轻量级,面向对象的有限状态机
简介 个人评分 简介 Transitions1是使用python实现的有限状态机2. 而有限状态机是实现经典模式 -- 状态模式3的前提. 这个库的API相当优雅,简洁. 另外博客园有人发布博客4介绍 ...
- Django 数据库操作
Django 数据库操作 Django运算表达式与Q对象/F对象 1 模型查询 概述: 1 查询集:表示从数据库中获取的对象的集合 2 查询集可以有多个过滤器,通过 逻辑运算符连接 3 过滤器就是一个 ...
- 【Linux开发】linux设备驱动归纳总结(四):5.多处理器下的竞态和并发
linux设备驱动归纳总结(四):5.多处理器下的竞态和并发 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ...
- kafka服务器批量copy文件脚本
#!/bin/bashif [[ $# -lt 1 ]] ; then echo no params ; exit ; fiparams=$@for (( i=1 ; i <= 3 ; i = ...
- 解决ubuntu命令行中文乱码
解决方法: 1.安装zhcon 登入用户后,输入 1 sudo apt-get install zhcon 2.启动zhcon 输入 1 zhcon --utf8 PS:zhcon支持中文输入法,按 ...
- C++学习 之 继承方式(笔记)
1.继承方式的分类 继承方式有公有继承,私有继承,保护继承.不同之处在于指定派生类的基类时使用的关键字不同:公有继承使用关键字public,私有继承使用关键字private,保护继承使用关键字prot ...
- AppCan调试问题
来源:http://edu.appcan.cn/theVideoMain1.html?chapterId=248_1 第1步, 生成AppCan调试中心 第2步, 启动AppCan调试中心 第3步, ...
- Hive 教程(三)-DDL基础
DDL,Hive Data Definition Language,数据定义语言: 通俗理解就是数据库与库表相关的操作,本文总结一下基本方法 hive 数据仓库配置 hive 数据仓库默认位置在 hd ...