mitchellh-sprinkle 0.1.5

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.
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