capium 0.0.1 → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README.md +70 -0
- data/lib/capium.rb +4 -1
- metadata +7 -6
data/README.md
ADDED
@@ -0,0 +1,70 @@
|
|
1
|
+
# Lithium Capistrano Deploy
|
2
|
+
|
3
|
+
If you want to get the most out of Capistrano and you do not want to have to deal with the *railsisms* that ship by default, this is the gem for you.
|
4
|
+
|
5
|
+
## Assumptions
|
6
|
+
|
7
|
+
+ A Lithium app
|
8
|
+
+ Must have SSH access to the server you are deploying to.
|
9
|
+
+ You either have the same password to all target machines, or you have public keys in place to allow passwordless access to them.
|
10
|
+
|
11
|
+
## Installation
|
12
|
+
|
13
|
+
### Through RubyGems.org ###
|
14
|
+
|
15
|
+
sudo gem install capium
|
16
|
+
|
17
|
+
### Through GitHub ###
|
18
|
+
|
19
|
+
git clone git://github.com/mehlah/capium.git
|
20
|
+
cd capium
|
21
|
+
gem build capium.gemspec
|
22
|
+
sudo gem install capium-{version}.gem
|
23
|
+
|
24
|
+
## Usage
|
25
|
+
|
26
|
+
Open your application's `Capfile` and make it begins like this:
|
27
|
+
|
28
|
+
require 'rubygems'
|
29
|
+
require 'capium'
|
30
|
+
load 'config/deploy'
|
31
|
+
|
32
|
+
Taking care to remove the original `require 'deploy'` as this is where all the standard tasks are defined.
|
33
|
+
And make sure you start capium on the last line of that same file:
|
34
|
+
|
35
|
+
capium
|
36
|
+
|
37
|
+
You should then be able to proceed as you would usually, you may want to familiarise yourself with the truncated list of tasks, you can get a full list with:
|
38
|
+
|
39
|
+
$ cap -T
|
40
|
+
|
41
|
+
## What's in the box?
|
42
|
+
|
43
|
+
If you want to try before you buy, here's the list of tasks included with this version of the deploy recipe:
|
44
|
+
|
45
|
+
cap deploy # Deploys your project.
|
46
|
+
cap deploy:check # Test deployment dependencies.
|
47
|
+
cap deploy:cleanup # Clean up old releases.
|
48
|
+
cap deploy:cold # Deploys and starts a `cold' application.
|
49
|
+
cap deploy:pending # Displays the commits since your last deploy.
|
50
|
+
cap deploy:pending:diff # Displays the `diff' since your last deploy.
|
51
|
+
cap deploy:rollback # Rolls back to a previous version and restarts.
|
52
|
+
cap deploy:rollback:code # Rolls back to the previously deployed version.
|
53
|
+
cap deploy:setup # Prepares one or more servers for deployment.
|
54
|
+
cap deploy:symlink # Updates the symlink to the most recently deployed ...
|
55
|
+
cap deploy:update # Copies your project and updates the symlink.
|
56
|
+
cap deploy:update_code # Copies your project to the remote servers.
|
57
|
+
cap deploy:upload # Copy files to the currently deployed version.
|
58
|
+
cap lithium:setup # Prepares server for deployment of a Lith...
|
59
|
+
cap lithium:update # Force Lithium installation to checkout a...
|
60
|
+
cap lithium:clear_cache # Blow up all the cache files Lithium uses...
|
61
|
+
cap lithium:configure_library_path # Sets the path to the class libraries use...
|
62
|
+
cap invoke # Invoke a single command on the remote servers.
|
63
|
+
cap shell # Begin an interactive Capistrano session.
|
64
|
+
|
65
|
+
|
66
|
+
## Bugs & Feedback
|
67
|
+
|
68
|
+
Via my Github profile please:
|
69
|
+
|
70
|
+
http://github.com/mehlah
|
data/lib/capium.rb
CHANGED
@@ -27,6 +27,8 @@ Capistrano::Configuration.instance(:must_exist).load do
|
|
27
27
|
|
28
28
|
_cset(:deploy_to) { "/u/apps/#{application}" }
|
29
29
|
_cset(:revision) { source.head }
|
30
|
+
|
31
|
+
# Lithium variables
|
30
32
|
_cset(:lithium_repo) { "git://github.com/UnionOfRAD/lithium.git"}
|
31
33
|
_cset(:lithium_branch) { "master" }
|
32
34
|
|
@@ -154,6 +156,7 @@ Capistrano::Configuration.instance(:must_exist).load do
|
|
154
156
|
after("deploy:setup", "lithium:setup")
|
155
157
|
after("deploy:symlink", "lithium:configure_library_path", "lithium:clear_cache")
|
156
158
|
end
|
159
|
+
|
157
160
|
# =========================================================================
|
158
161
|
# These are the tasks that are available to help with deploying web apps,
|
159
162
|
# and specifically, Rails applications. You can have cap give you a summary
|
@@ -465,7 +468,7 @@ Capistrano::Configuration.instance(:must_exist).load do
|
|
465
468
|
This directory contain a copy of the Lithium core.
|
466
469
|
DESC
|
467
470
|
task :configure_library_path do
|
468
|
-
run "sed -i \"s
|
471
|
+
run "sed -i \"s=^define('LITHIUM_LIBRARY_PATH.*$=define('LITHIUM_LIBRARY_PATH', '#{shared_path}/libraries');=\" #{release_path}/config/bootstrap/libraries.php"
|
469
472
|
end
|
470
473
|
|
471
474
|
desc <<-DESC
|
metadata
CHANGED
@@ -1,13 +1,13 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: capium
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
hash:
|
4
|
+
hash: 27
|
5
5
|
prerelease:
|
6
6
|
segments:
|
7
7
|
- 0
|
8
8
|
- 0
|
9
|
-
-
|
10
|
-
version: 0.0.
|
9
|
+
- 2
|
10
|
+
version: 0.0.2
|
11
11
|
platform: ruby
|
12
12
|
authors:
|
13
13
|
- Mehdi Lahmam B.
|
@@ -15,10 +15,10 @@ autorequire:
|
|
15
15
|
bindir: bin
|
16
16
|
cert_chain: []
|
17
17
|
|
18
|
-
date: 2011-08-
|
18
|
+
date: 2011-08-14 00:00:00 Z
|
19
19
|
dependencies: []
|
20
20
|
|
21
|
-
description:
|
21
|
+
description: Lithium app deployment using Capistrano made easy
|
22
22
|
email: mehdi@lahmam.com
|
23
23
|
executables: []
|
24
24
|
|
@@ -28,6 +28,7 @@ extra_rdoc_files: []
|
|
28
28
|
|
29
29
|
files:
|
30
30
|
- lib/capium.rb
|
31
|
+
- README.md
|
31
32
|
homepage: http://rubygems.org/gems/capium
|
32
33
|
licenses: []
|
33
34
|
|
@@ -60,6 +61,6 @@ rubyforge_project:
|
|
60
61
|
rubygems_version: 1.8.8
|
61
62
|
signing_key:
|
62
63
|
specification_version: 3
|
63
|
-
summary:
|
64
|
+
summary: Capistrano deploy recipes for Lithium
|
64
65
|
test_files: []
|
65
66
|
|