How do I target a specific commit SHA with capistrano deploy

Question

I am wondering how I can target a specific commit SHA in Git for deployment, using Capistrano? It should be something like

cap deploy --version=<sha targeted>

Can't seem to find the answer to this after a lot of searching.

score 63 · Accepted Answer · edited Dec 08 '15 at 16:04

63

For Capistrano 2.9 until 3.0:

cap -S revision=80655da8d80aaaf92ce5357e7828dc09adb00993 deploy

For older versions of Capistrano, you can deploy a particular git commit/tree/branch/tag by doing this:

cap -s branch=80655da8d80aaaf92ce5357e7828dc09adb00993 deploy

In some cases there may be a need of specifying the Environment as an argument as well. production is just an example.

cap production -S revision=80655da8d80aaaf92ce5357e7828dc09adb00993 deploy

edited Dec 08 '15 at 16:04

Don Giulio

2,946
3
43
82

answered May 27 '09 at 21:34

molf

73,644
13
135
118

is that the SHA for a specific commit? – Scott Miller May 27 '09 at 21:45
1

The branch will be passed to git with "git checkout ", so a commit id should work just as fine as a tree id, branch name, etc. – molf May 27 '09 at 22:12
this answer doesn't work for me, see @eahanson 's answer below. – Siwei Aug 08 '13 at 01:47
The original answer was pretty old, updated to reflect changes in Capistrano. – molf Aug 08 '13 at 08:08
5

For Capistrano 3, please see this question: http://stackoverflow.com/questions/21036175/how-to-deploy-a-specific-revision-with-capistrano-3 – KIR Jan 24 '14 at 10:01
1

`set :branch, 'SHA'` works uniformly in Capistrano 2 & 3 – Ev Dolzhenko Feb 28 '14 at 11:35

score 17 · Answer 2 · answered Aug 17 '12 at 17:05

17

molf's answer didn't work for me (using capistrano 2.11.2). I had to use "revision" instead of branch, like this:

cap -S revision=80655da8d80aaaf92ce5357e7828dc09adb00993 deploy

answered Aug 17 '12 at 17:05

eahanson

369
3
4

Working 100% fine in 2.14.2 – RidingTheRails Sep 10 '13 at 08:34
3

Well, 2.11.2 is above 2.9, and you use the syntax mentioned for above 2.9. Am I missing something ? – kik Feb 26 '14 at 14:10
@kik molf changed the answer after my comment – eahanson Mar 29 '20 at 15:40

score 14 · Answer 3 · edited May 06 '16 at 14:36

14

Capistrano 3

In your deploy.rb or stage-specific file like config/deploy/production.rb

set :branch, ENV.fetch('REVISION', 'master')

This allows you to point to a specific git revision. It accepts a SHA but also anything that resolves to a real revision (e.g. git tag, annotated tag, or branch).

Use it on the command line by setting the REVISION environment variable, e.g.

bundle exec cap production deploy REVISION=80655da8d80aaaf92ce5357e7828dc09adb00993

bundle exec cap staging deploy REVISION=my-topic-branch

edited May 06 '16 at 14:36

Dennis

56,821
26
143
139

answered Jun 10 '15 at 09:24

Alexander Popov

23,073
19
91
130

Is there a way to pass the branch as a command line argument? – marcovtwout Dec 23 '15 at 08:57
I don't know a way to do that. – Alexander Popov Dec 23 '15 at 09:14
1

@marcovtwout yes that's possible, see the updated the answer. – Dennis May 06 '16 at 14:37

score 1 · Answer 4 · answered May 13 '16 at 22:57

1

ask :branch, 'master'

Prompts for input but defaults to 'master' if you press return.

answered May 13 '16 at 22:57

How do I target a specific commit SHA with capistrano deploy

4 Answers4

Linked