mitchellh-sprinkle 0.1.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (70) hide show
  1. data/CREDITS +16 -0
  2. data/History.txt +4 -0
  3. data/MIT-LICENSE +20 -0
  4. data/Manifest.txt +68 -0
  5. data/README.txt +224 -0
  6. data/Rakefile +4 -0
  7. data/bin/sprinkle +86 -0
  8. data/config/hoe.rb +70 -0
  9. data/config/requirements.rb +17 -0
  10. data/examples/merb/deploy.rb +5 -0
  11. data/examples/rails/README +15 -0
  12. data/examples/rails/deploy.rb +2 -0
  13. data/examples/rails/packages/database.rb +9 -0
  14. data/examples/rails/packages/essential.rb +6 -0
  15. data/examples/rails/packages/rails.rb +28 -0
  16. data/examples/rails/packages/search.rb +11 -0
  17. data/examples/rails/packages/server.rb +28 -0
  18. data/examples/rails/rails.rb +71 -0
  19. data/examples/sprinkle/sprinkle.rb +38 -0
  20. data/lib/sprinkle/actors/actors.rb +17 -0
  21. data/lib/sprinkle/actors/capistrano.rb +117 -0
  22. data/lib/sprinkle/actors/vlad.rb +65 -0
  23. data/lib/sprinkle/configurable.rb +27 -0
  24. data/lib/sprinkle/deployment.rb +73 -0
  25. data/lib/sprinkle/extensions/arbitrary_options.rb +10 -0
  26. data/lib/sprinkle/extensions/array.rb +5 -0
  27. data/lib/sprinkle/extensions/blank_slate.rb +5 -0
  28. data/lib/sprinkle/extensions/dsl_accessor.rb +15 -0
  29. data/lib/sprinkle/extensions/string.rb +10 -0
  30. data/lib/sprinkle/extensions/symbol.rb +7 -0
  31. data/lib/sprinkle/installers/apt.rb +51 -0
  32. data/lib/sprinkle/installers/gem.rb +61 -0
  33. data/lib/sprinkle/installers/installer.rb +120 -0
  34. data/lib/sprinkle/installers/rake.rb +30 -0
  35. data/lib/sprinkle/installers/rpm.rb +37 -0
  36. data/lib/sprinkle/installers/source.rb +179 -0
  37. data/lib/sprinkle/package.rb +127 -0
  38. data/lib/sprinkle/policy.rb +85 -0
  39. data/lib/sprinkle/script.rb +13 -0
  40. data/lib/sprinkle/verifiers/directory.rb +11 -0
  41. data/lib/sprinkle/verifiers/executable.rb +17 -0
  42. data/lib/sprinkle/verifiers/file.rb +11 -0
  43. data/lib/sprinkle/verifiers/symlink.rb +15 -0
  44. data/lib/sprinkle/verify.rb +55 -0
  45. data/lib/sprinkle/version.rb +9 -0
  46. data/lib/sprinkle.rb +32 -0
  47. data/script/destroy +14 -0
  48. data/script/generate +14 -0
  49. data/spec/spec.opts +1 -0
  50. data/spec/spec_helper.rb +17 -0
  51. data/spec/sprinkle/actors/capistrano_spec.rb +170 -0
  52. data/spec/sprinkle/configurable_spec.rb +46 -0
  53. data/spec/sprinkle/deployment_spec.rb +80 -0
  54. data/spec/sprinkle/extensions/array_spec.rb +19 -0
  55. data/spec/sprinkle/extensions/string_spec.rb +21 -0
  56. data/spec/sprinkle/installers/apt_spec.rb +74 -0
  57. data/spec/sprinkle/installers/gem_spec.rb +75 -0
  58. data/spec/sprinkle/installers/installer_spec.rb +151 -0
  59. data/spec/sprinkle/installers/rpm_spec.rb +50 -0
  60. data/spec/sprinkle/installers/source_spec.rb +331 -0
  61. data/spec/sprinkle/package_spec.rb +422 -0
  62. data/spec/sprinkle/policy_spec.rb +126 -0
  63. data/spec/sprinkle/script_spec.rb +51 -0
  64. data/spec/sprinkle/sprinkle_spec.rb +25 -0
  65. data/spec/sprinkle/verify_spec.rb +137 -0
  66. data/sprinkle.gemspec +43 -0
  67. data/tasks/deployment.rake +34 -0
  68. data/tasks/environment.rake +7 -0
  69. data/tasks/rspec.rake +21 -0
  70. metadata +160 -0
@@ -0,0 +1,151 @@
1
+ require File.dirname(__FILE__) + '/../../spec_helper'
2
+
3
+ describe Sprinkle::Installers::Installer do
4
+ include Sprinkle::Deployment
5
+
6
+ before do
7
+ @package = mock(Sprinkle::Package, :name => 'package')
8
+ @empty = Proc.new { }
9
+ @sequence = ['op1', 'op2']
10
+ @delivery = mock(Sprinkle::Deployment, :process => true)
11
+ @installer = create_installer
12
+ @installer.delivery = @delivery
13
+ @roles = []
14
+ @deployment = deployment do
15
+ delivery :capistrano
16
+ installer do; prefix '/usr/bin'; end
17
+ end
18
+ end
19
+
20
+ def create_installer(&block)
21
+ installer = Sprinkle::Installers::Installer.new @package, &block
22
+ installer.stub!(:puts).and_return
23
+
24
+ # this is actually an abstract class so we'll insert a few fake install sequences
25
+ class << installer
26
+ def install_sequence
27
+ ['op1', 'op2']
28
+ end
29
+ end
30
+
31
+ installer
32
+ end
33
+
34
+ describe 'when created' do
35
+
36
+ it 'should belong to a package' do
37
+ @installer.package.should == @package
38
+ end
39
+
40
+ describe 'with a block to customize installer defaults' do
41
+
42
+ it 'should accept an optional block to customize installers defaults' do
43
+ @installer = create_installer do; prefix '/usr/local'; end
44
+ @installer.prefix.should == '/usr/local'
45
+ end
46
+
47
+ it 'should override any deployment level defaults' do
48
+ @installer = create_installer do; prefix '/usr/local'; end
49
+ @installer.defaults(@deployment)
50
+ @installer.prefix.should == '/usr/local'
51
+ end
52
+ end
53
+ end
54
+
55
+ describe 'during configuration' do
56
+ # We just check to make sure it has the Sprinkle::Configurable method
57
+ it 'should be configurable' do
58
+ @installer.should respond_to(:defaults)
59
+ end
60
+ end
61
+
62
+ describe 'during installation' do
63
+
64
+ it 'should request the install sequence from the concrete class' do
65
+ @installer.should_receive(:install_sequence).and_return(@sequence)
66
+ end
67
+
68
+ describe 'when testing' do
69
+
70
+ before do
71
+ Sprinkle::OPTIONS[:testing] = true
72
+ @logger = mock(ActiveSupport::BufferedLogger, :debug => true, :debug? => true)
73
+ end
74
+
75
+ it 'should not invoke the delivery mechanism with the install sequence' do
76
+ @delivery.should_not_receive(:process)
77
+ end
78
+
79
+ it 'should print the install sequence to the console' do
80
+ @installer.should_receive(:logger).twice.and_return(@logger)
81
+ end
82
+
83
+ end
84
+
85
+ describe 'when in production' do
86
+ it 'should invoke the delivery mechanism to process the install sequence' do
87
+ @delivery.should_receive(:process).with(@package.name, @sequence, @roles)
88
+ end
89
+ end
90
+
91
+ describe "with a pre command" do
92
+
93
+ def create_installer_with_pre_command(cmd="")
94
+ installer = Sprinkle::Installers::Installer.new @package do
95
+ pre :install, cmd
96
+
97
+ def install_commands
98
+ ["installer"]
99
+ end
100
+ end
101
+
102
+ installer.stub!(:puts).and_return
103
+ installer.delivery = @delivery
104
+ installer
105
+ end
106
+ before do
107
+ @installer = create_installer_with_pre_command('run')
108
+ end
109
+ describe "string commands" do
110
+ it "should insert the pre command for the specific package in the installation process" do
111
+ @installer.send(:install_sequence).should == [ 'run', 'installer' ]
112
+ end
113
+ end
114
+ describe "blocks as commands" do
115
+ before(:each) do
116
+ @installer = Sprinkle::Installers::Installer.new @package do
117
+ pre :install do
118
+ %w(a b c)
119
+ end
120
+
121
+ def install_commands
122
+ ["installer"]
123
+ end
124
+ end
125
+
126
+ @installer.stub!(:puts).and_return
127
+ @installer.delivery = @delivery
128
+ end
129
+ it "should be able to store a block if it's the pre command" do
130
+ @installer.send(:install_sequence).should == [ "a", "b", "c", 'installer' ]
131
+ end
132
+ end
133
+ describe "blocks as commands" do
134
+ before(:each) do
135
+ @array = ["a", "b"]
136
+ @installer = create_installer_with_pre_command(@array)
137
+ end
138
+ it "should be able to store a block if it's the pre command" do
139
+ @installer.send(:install_sequence).should == [ @array, 'installer' ].flatten
140
+ end
141
+ end
142
+ end
143
+
144
+ after do
145
+ @installer.process(@roles)
146
+ Sprinkle::OPTIONS[:testing] = false
147
+ end
148
+
149
+ end
150
+
151
+ end
@@ -0,0 +1,50 @@
1
+ require File.dirname(__FILE__) + '/../../spec_helper'
2
+
3
+ describe Sprinkle::Installers::Rpm do
4
+
5
+ before do
6
+ @package = mock(Sprinkle::Package, :name => 'package')
7
+ end
8
+
9
+ def create_rpm(debs, &block)
10
+ Sprinkle::Installers::Rpm.new(@package, debs, &block)
11
+ end
12
+
13
+ describe 'when created' do
14
+
15
+ it 'should accept a single package to install' do
16
+ @installer = create_rpm 'ruby'
17
+ @installer.packages.should == [ 'ruby' ]
18
+ end
19
+
20
+ it 'should accept an array of packages to install' do
21
+ @installer = create_rpm %w( gcc gdb g++ )
22
+ @installer.packages.should == ['gcc', 'gdb', 'g++']
23
+ end
24
+
25
+ end
26
+
27
+ describe 'during installation' do
28
+
29
+ before do
30
+ @installer = create_rpm 'ruby' do
31
+ pre :install, 'op1'
32
+ post :install, 'op2'
33
+ end
34
+ @install_commands = @installer.send :install_commands
35
+ end
36
+
37
+ it 'should invoke the rpm installer for all specified packages' do
38
+ @install_commands.should =~ /rpm -Uvh ruby/
39
+ end
40
+
41
+ it 'should automatically insert pre/post commands for the specified package' do
42
+ @installer.send(:install_sequence).should == [ 'op1', 'rpm -Uvh ruby', 'op2' ]
43
+ end
44
+
45
+ it 'should specify a non interactive mode to the apt installer'
46
+ it 'should install a specific version if defined'
47
+
48
+ end
49
+
50
+ end
@@ -0,0 +1,331 @@
1
+ require File.dirname(__FILE__) + '/../../spec_helper'
2
+
3
+ describe Sprinkle::Installers::Source do
4
+ include Sprinkle::Deployment
5
+
6
+ before do
7
+ @source = 'ftp://ftp.ruby-lang.org/pub/ruby/1.8/ruby-1.8.6-p111.tar.gz'
8
+
9
+ @deployment = deployment do
10
+ delivery :capistrano
11
+ source do
12
+ prefix '/usr'
13
+ archives '/usr/archives'
14
+ builds '/usr/builds'
15
+ end
16
+ end
17
+
18
+ @installer = create_source @source do
19
+ prefix '/usr/local'
20
+ archives '/usr/local/archives'
21
+ builds '/usr/local/builds'
22
+
23
+ enable %w( headers ssl deflate so )
24
+ disable %w( cache proxy rewrite )
25
+
26
+ with %w( debug extras )
27
+ without %w( fancyisms )
28
+ end
29
+
30
+ @installer.defaults(@deployment)
31
+ end
32
+
33
+ def create_source(source, version = nil, &block)
34
+ @package = mock(Sprinkle::Package, :name => 'package', :version => version)
35
+ Sprinkle::Installers::Source.new(@package, source, &block)
36
+ end
37
+
38
+ describe 'when created' do
39
+
40
+ it 'should accept a source archive name to install' do
41
+ @installer.source.should == @source
42
+ end
43
+
44
+ end
45
+
46
+ describe 'before installation' do
47
+
48
+ before do
49
+ @settings = { :prefix => '/usr/local', :archives => '/usr/local/tmp', :builds => '/usr/local/stage' }
50
+ end
51
+
52
+ it 'should fail if no installation area has been specified' do
53
+ @settings.delete(:prefix)
54
+ end
55
+
56
+ it 'should fail if no build area has been specified' do
57
+ @settings.delete(:builds)
58
+ end
59
+
60
+ it 'should fail if no source download area has been specified' do
61
+ @settings.delete(:archives)
62
+ end
63
+
64
+ after do
65
+ @settings.each { |k, v| @installer.send k, v }
66
+ lambda { @installer.install_sequence }.should raise_error
67
+ end
68
+
69
+ end
70
+
71
+ describe 'customized configuration' do
72
+
73
+ it 'should support specification of "enable" options' do
74
+ @installer.enable.should == %w( headers ssl deflate so )
75
+ end
76
+
77
+ it 'should support specification of "disable" options' do
78
+ @installer.disable.should == %w( cache proxy rewrite )
79
+ end
80
+
81
+ it 'should support specification of "with" options' do
82
+ @installer.with.should == %w( debug extras )
83
+ end
84
+
85
+ it 'should support specification of "without" options' do
86
+ @installer.without.should == %w( fancyisms )
87
+ end
88
+
89
+ it 'should support customized build area' do
90
+ @installer.prefix.should == '/usr/local'
91
+ end
92
+
93
+ it 'should support customized source area' do
94
+ @installer.archives.should == '/usr/local/archives'
95
+ end
96
+
97
+ it 'should support customized install area' do
98
+ @installer.builds.should == '/usr/local/builds'
99
+ end
100
+
101
+ end
102
+
103
+ describe 'during gnu source archive style installation' do
104
+
105
+ it 'should prepare the build, installation and source archives area' do
106
+ @installer.should_receive(:prepare).and_return(
107
+ [
108
+ 'mkdir -p /usr/local',
109
+ 'mkdir -p /usr/local/builds',
110
+ 'mkdir -p /usr/local/archives'
111
+ ]
112
+ )
113
+
114
+ end
115
+
116
+ it 'should download the source archive' do
117
+ @installer.should_receive(:download).and_return(
118
+ [
119
+ "wget -cq --directory-prefix='/usr/local/archives' #{@source}"
120
+ ]
121
+ )
122
+ end
123
+
124
+ it 'should extract the source archive' do
125
+ @installer.should_receive(:extract).and_return(
126
+ [
127
+ "bash -c 'cd /usr/local/builds && tar xzf /usr/local/archives/ruby-1.8.6-p111.tar.gz"
128
+ ]
129
+ )
130
+ end
131
+
132
+ it 'should configure the source' do
133
+ enable = %w( headers ssl deflate so ).inject([]) { |m, value| m << "--enable-#{value}"; m }
134
+ disable = %w( cache proxy rewrite ).inject([]) { |m, value| m << "--disable-#{value}"; m }
135
+
136
+ with = %w( debug extras ).inject([]) { |m, value| m << "--with-#{value}"; m }
137
+ without = %w( fancyisms ).inject([]) { |m, value| m << "--without-#{value}"; m }
138
+
139
+ options = "#{enable.join(' ')} #{disable.join(' ')} #{with.join(' ')} #{without.join(' ')}"
140
+
141
+ @installer.should_receive(:build).and_return(
142
+ [
143
+ "bash -c 'cd /usr/local/builds && ./configure --prefix=/usr/local #{options} > #{@package.name}-configure.log 2>&1'"
144
+ ]
145
+ )
146
+ end
147
+
148
+ it 'should build the source' do
149
+ @installer.should_receive(:build).and_return(
150
+ [
151
+ "bash -c 'cd /usr/local/builds && make > #{@package.name}-build.log 2>&1'"
152
+ ]
153
+ )
154
+ end
155
+
156
+ it 'should install the source' do
157
+ @installer.should_receive(:install).and_return(
158
+ [
159
+ "bash -c 'cd /usr/local/builds && make install > #{@package.name}-install.log 2>&1'"
160
+ ]
161
+ )
162
+ end
163
+
164
+ describe 'during a customized install' do
165
+
166
+ before do
167
+ @installer = create_source @source do
168
+ custom_install 'ruby setup.rb'
169
+ end
170
+
171
+ @installer.defaults(@deployment)
172
+ end
173
+
174
+ it 'should store the custom install commands' do
175
+ @installer.options[:custom_install].should == 'ruby setup.rb'
176
+ end
177
+
178
+ it 'should identify as having a custom install command' do
179
+ @installer.should be_custom_install
180
+ end
181
+
182
+ it 'should not configure the source automatically' do
183
+ @installer.should_receive(:configure).and_return([])
184
+ end
185
+
186
+ it 'should not build the source automatically' do
187
+ @installer.should_receive(:build).and_return([])
188
+ end
189
+
190
+ it 'should install the source using a custom installation command' do
191
+ @installer.send(:custom_install_commands).first.should =~ /ruby setup.rb/
192
+ end
193
+
194
+ it 'should be run relative to the source build area' do
195
+ @installer.send(:custom_install_commands).first.should =~ %r{cd /usr/builds/ruby-1.8.6-p111}
196
+ end
197
+
198
+ describe 'with a customized directory' do
199
+
200
+ before do
201
+ @installer.options[:custom_dir] = 'test'
202
+ end
203
+
204
+ it 'should install the source from the custom dir path' do
205
+ @installer.send(:custom_install_commands).first.should =~ /test/
206
+ end
207
+
208
+ it 'should store the custom build dir path' do
209
+ @installer.options[:custom_dir].should == 'test'
210
+ end
211
+
212
+ end
213
+
214
+ end
215
+
216
+ after do
217
+ @installer.send :install_sequence
218
+ end
219
+
220
+ end
221
+
222
+ describe 'pre stage commands' do
223
+
224
+ before do
225
+ @commands = {
226
+ :prepare => %w( prepare1 prepare2 ),
227
+ :download => %w( down1 down2 ),
228
+ :extract => %w( ex1 ex2 ),
229
+ :configure => %w( conf1 conf2 ),
230
+ :build => %w( build1 build2 ),
231
+ :install => %w( install1 install2 )
232
+ }
233
+
234
+ @installer = create_source @source
235
+ @commands.each { |k, v| @installer.pre k, *v }
236
+ @installer.defaults(@deployment)
237
+ end
238
+
239
+ it 'should run all pre-prepare commands' do
240
+ @commands.each { |k, v| @installer.should_receive(:pre_commands).with(k).and_return(v) }
241
+ end
242
+
243
+ it 'should be run relative to the source build area' do
244
+ @commands.each { |stage, command| @installer.send(:pre_commands, stage).first.should =~ %r{cd /usr/builds/ruby-1.8.6-p111} }
245
+ end
246
+
247
+ after do
248
+ @installer.send :install_sequence
249
+ end
250
+
251
+ end
252
+
253
+ describe 'post stage commands' do
254
+
255
+ before do
256
+ @commands = {
257
+ :prepare => %w( prepare1 prepare2 ),
258
+ :download => %w( down1 down2 ),
259
+ :extract => %w( ex1 ex2 ),
260
+ :configure => %w( conf1 conf2 ),
261
+ :build => %w( build1 build2 ),
262
+ :install => %w( install1 install2 )
263
+ }
264
+
265
+ @installer = create_source @source
266
+ @commands.each { |k, v| @installer.post k, *v }
267
+ @installer.defaults(@deployment)
268
+ end
269
+
270
+ it 'should run all post-prepare commands' do
271
+ @commands.each { |k, v| @installer.should_receive(:post_commands).with(k).and_return(v) }
272
+ end
273
+
274
+ it 'should be run relative to the source build area' do
275
+ @commands.each { |stage, command| @installer.send(:post_commands, stage).first.should =~ %r{cd /usr/builds/ruby-1.8.6-p111} }
276
+ end
277
+
278
+ after do
279
+ @installer.send :install_sequence
280
+ end
281
+
282
+ end
283
+
284
+ describe 'install sequence' do
285
+
286
+ it 'should prepare, then download, then extract, then configure, then build, then install' do
287
+ %w( prepare download extract configure build install ).each do |stage|
288
+ @installer.should_receive(stage).ordered.and_return([])
289
+ end
290
+ end
291
+
292
+ after do
293
+ @installer.send :install_sequence
294
+ end
295
+
296
+ end
297
+
298
+ describe 'source extraction' do
299
+
300
+ it 'should support tgz archives' do
301
+ @installer.source = 'blah.tgz'
302
+ @extraction = 'tar xzf'
303
+ end
304
+
305
+ it 'should support tar.gz archives' do
306
+ @installer.source = 'blah.tgz'
307
+ @extraction = 'tar xzf'
308
+ end
309
+
310
+ it 'should support tar.bz2 archives' do
311
+ @installer.source = 'blah.tar.bz2'
312
+ @extraction = 'tar xjf'
313
+ end
314
+
315
+ it 'should support tb2 archives' do
316
+ @installer.source = 'blah.tb2'
317
+ @extraction = 'tar xjf'
318
+ end
319
+
320
+ it 'should support zip archives' do
321
+ @installer.source = 'blah.zip'
322
+ @extraction = 'unzip'
323
+ end
324
+
325
+ after do
326
+ @installer.send(:extract_command).should == @extraction
327
+ end
328
+
329
+ end
330
+
331
+ end