Class: Chef::Provider::Deploy

Inherits:
Chef::Provider show all
Includes:
Mixin::Command, Mixin::FromFile
Defined in:
lib/chef/provider/deploy.rb,
lib/chef/provider/deploy/revision.rb,
lib/chef/provider/deploy/timestamped.rb

Direct Known Subclasses

Revision, Timestamped

Defined Under Namespace

Classes: Revision, Timestamped

Instance Attribute Summary collapse

Attributes inherited from Chef::Provider

#current_resource, #new_resource, #node

Instance Method Summary collapse

Methods included from Mixin::Command

handle_command_failures, not_if, only_if, output_of_command, popen4, run_command, run_command_with_systems_locale

Methods included from Mixin::FromFile

#class_from_file, #from_file

Methods inherited from Chef::Provider

#action_nothing, build_from_file

Methods included from Mixin::ConvertToClassName

#convert_to_class_name, #convert_to_snake_case, #filename_to_qualified_string

Methods included from Mixin::RecipeDefinitionDSLCore

#method_missing

Methods included from Mixin::Language

#data_bag, #data_bag_item, #platform?, #search, #value_for_platform

Constructor Details

#initialize(node, new_resource, collection = nil, definitions = nil, cookbook_loader = nil) ⇒ Deploy

Returns a new instance of Deploy.



33
34
35
36
37
38
39
40
41
42
43
44
45
46
# File 'lib/chef/provider/deploy.rb', line 33

def initialize(node, new_resource, collection=nil, definitions=nil, cookbook_loader=nil)
  super(node, new_resource, collection, definitions, cookbook_loader)
  
  # NOTE: workaround for CHEF-577
  @definitions ||= Hash.new
  @collection = Chef::ResourceCollection.new
  
  @scm_provider = @new_resource.scm_provider.new(@node, @new_resource)
  
  # @configuration is not used by Deploy, it is only for backwards compat with
  # chef-deploy or capistrano hooks that might use it to get environment information
  @configuration = @new_resource.to_hash
  @configuration[:environment] = @configuration[:environment] && @configuration[:environment]["RAILS_ENV"]
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Chef::Mixin::RecipeDefinitionDSLCore

Instance Attribute Details

#release_pathObject (readonly)

Returns the value of attribute release_path.



31
32
33
# File 'lib/chef/provider/deploy.rb', line 31

def release_path
  @release_path
end

#scm_providerObject (readonly)

Returns the value of attribute scm_provider.



31
32
33
# File 'lib/chef/provider/deploy.rb', line 31

def scm_provider
  @scm_provider
end

Instance Method Details

#action_deployObject



62
63
64
65
66
67
68
69
70
71
72
73
74
# File 'lib/chef/provider/deploy.rb', line 62

def action_deploy
  if all_releases.include?(release_path)
    if all_releases[-1] == release_path
      Chef::Log.debug("Already deployed app at #{release_path}, and it is the latest revision.  Use action :force_deploy to re-deploy this revision.")
    else
      Chef::Log.info("Already deployed app at #{release_path}.  Rolling back to it - use action :force_deploy to re-checkout this revision.")
      action_rollback
    end
  else
    deploy
    @new_resource.updated = true
  end
end

#action_force_deployObject



76
77
78
79
80
81
82
83
# File 'lib/chef/provider/deploy.rb', line 76

def action_force_deploy
  if all_releases.include?(release_path)
    Chef::Log.info("Already deployed app at #{release_path}, forcing.")
    FileUtils.rm_rf(release_path)
  end
  deploy
  @new_resource.updated = true
end

#action_rollbackObject



85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
# File 'lib/chef/provider/deploy.rb', line 85

def action_rollback
  if release_path
    rp_index = all_releases.index(release_path)
    raise RuntimeError, "There is no release to rollback to!" unless rp_index
    rp_index += 1
    releases_to_nuke = all_releases[rp_index..-1]
  else
    @release_path = all_releases[-2] 
    raise RuntimeError, "There is no release to rollback to!" unless @release_path
    releases_to_nuke = [ all_releases.last ]
  end

  Chef::Log.info "rolling back to previous release: #{release_path}"
  symlink
  Chef::Log.info "restarting with previous release"
  restart
  releases_to_nuke.each do |i|
    Chef::Log.info "Removing release: #{i}"
    FileUtils.rm_rf i 
    release_deleted(i)
  end
  @new_resource.updated = true
end

#all_releasesObject



189
190
191
# File 'lib/chef/provider/deploy.rb', line 189

def all_releases
  Dir.glob(@new_resource.deploy_to + "/releases/*").sort
end

#callback(what, callback_code = nil) ⇒ Object



126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
# File 'lib/chef/provider/deploy.rb', line 126

def callback(what, callback_code=nil)
  @collection = Chef::ResourceCollection.new
  case callback_code
  when Proc
    Chef::Log.info "Running callback #{what} code block"
    recipe_eval(&callback_code)
  when String
    callback_file = "#{release_path}/#{callback_code}"
    unless ::File.exist?(callback_file)
      raise RuntimeError, "Can't find your callback file #{callback_file}"
    end
    run_callback_from_file(callback_file)
  when nil
    run_callback_from_file("#{release_path}/deploy/#{what}.rb")
  else
    raise RuntimeError, "You gave me a callback I don't know what to do with: #{callback_code.inspect}"
  end
end

#cleanup!Object



181
182
183
184
185
186
187
# File 'lib/chef/provider/deploy.rb', line 181

def cleanup!
  all_releases[0..-6].each do |old_release|
    Chef::Log.info "Removing old release #{old_release}"
    FileUtils.rm_rf(old_release)
    release_deleted(old_release)
  end
end

#copy_cached_repoObject



211
212
213
214
215
216
# File 'lib/chef/provider/deploy.rb', line 211

def copy_cached_repo
  Chef::Log.info "copying the cached checkout to #{release_path}"
  FileUtils.mkdir_p(@new_resource.deploy_to + "/releases")
  FileUtils.cp_r("#{@new_resource.destination}.", release_path, :preserve => true)
  release_created(release_path)
end


252
253
# File 'lib/chef/provider/deploy.rb', line 252

def create_dirs_before_symlink
end

#deployObject



109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
# File 'lib/chef/provider/deploy.rb', line 109

def deploy
  Chef::Log.info "deploying branch: #{@new_resource.branch}"
  enforce_ownership
  update_cached_repo
  copy_cached_repo
  install_gems
  enforce_ownership
  callback(:before_migrate, @new_resource.before_migrate)
  migrate
  callback(:before_symlink, @new_resource.before_symlink)
  symlink
  callback(:before_restart, @new_resource.before_restart)
  restart
  callback(:after_restart, @new_resource.after_restart)
  cleanup!
end

#enforce_ownershipObject



218
219
220
221
# File 'lib/chef/provider/deploy.rb', line 218

def enforce_ownership
  Chef::Log.info "ensuring proper ownership"
  FileUtils.chown_R(@new_resource.user, @new_resource.group, @new_resource.deploy_to)
end


223
224
225
226
227
228
# File 'lib/chef/provider/deploy.rb', line 223

def link_current_release_to_production
  Chef::Log.info "Linking release #{release_path} into production at #{@new_resource.current_path}"
  FileUtils.rm_f(@new_resource.current_path)
  FileUtils.ln_sf(release_path, @new_resource.current_path)
  enforce_ownership
end


238
239
240
241
242
243
244
245
246
247
248
249
250
# File 'lib/chef/provider/deploy.rb', line 238

def link_tempfiles_to_current_release
  dirs_info = @new_resource.create_dirs_before_symlink.join(",")
  Chef::Log.info("creating directories before symlink: #{dirs_info}")
  @new_resource.create_dirs_before_symlink.each { |dir| FileUtils.mkdir_p(release_path + "/#{dir}") }
  
  links_info = @new_resource.symlinks.map { |src, dst| "#{src} => #{dst}" }.join(", ")
  Chef::Log.info("Linking shared paths into current release: #{links_info}")
  @new_resource.symlinks.each do |src, dest|
    FileUtils.ln_sf(@new_resource.shared_path + "/#{src}",  release_path + "/#{dest}")
  end
  run_symlinks_before_migrate
  enforce_ownership
end

#load_current_resourceObject



48
49
50
# File 'lib/chef/provider/deploy.rb', line 48

def load_current_resource
  @release_path = @new_resource.deploy_to + "/releases/#{release_slug}"
end

#migrateObject



145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
# File 'lib/chef/provider/deploy.rb', line 145

def migrate
  run_symlinks_before_migrate
  
  if @new_resource.migrate
    enforce_ownership
    
    environment = @new_resource.environment
    env_info = environment && environment.map do |key_and_val| 
      "#{key_and_val.first}='#{key_and_val.last}'"
    end.join(" ")
    
    Chef::Log.info  "Migrating: running #{@new_resource.migration_command} as #{@new_resource.user} " +
                    "with environment #{env_info}"
    run_command(run_options(:command => @new_resource.migration_command, :cwd=>release_path))
  end
end

#purge_tempfiles_from_current_releaseObject



255
256
257
258
259
# File 'lib/chef/provider/deploy.rb', line 255

def purge_tempfiles_from_current_release
  log_info = @new_resource.purge_before_symlink.join(", ")
  Chef::Log.info("Purging directories in checkout #{log_info}")
  @new_resource.purge_before_symlink.each { |dir| FileUtils.rm_rf(release_path + "/#{dir}") }
end

#restartObject



169
170
171
172
173
174
175
176
177
178
179
# File 'lib/chef/provider/deploy.rb', line 169

def restart
  if restart_cmd = @new_resource.restart_command
    if restart_cmd.kind_of?(Proc)
      Chef::Log.info("Restarting app with embedded recipe")
      recipe_eval(&restart_cmd)
    else
      Chef::Log.info("Restarting app with #{@new_resource.restart_command} in #{@new_resource.current_path}")
      run_command(run_options(:command => @new_resource.restart_command, :cwd => @new_resource.current_path))
    end
  end
end

#run(command, &block) ⇒ Object



56
57
58
59
60
# File 'lib/chef/provider/deploy.rb', line 56

def run(command, &block)
  exec = execute(command, &block)
  exec.user(@new_resource.user)
  exec
end

#run_scm_syncObject



201
202
203
204
# File 'lib/chef/provider/deploy.rb', line 201

def run_scm_sync
  Chef::Log.info "updating the cached checkout"
  @scm_provider.action_sync
end


230
231
232
233
234
235
236
# File 'lib/chef/provider/deploy.rb', line 230

def run_symlinks_before_migrate
  links_info = @new_resource.symlink_before_migrate.map { |src, dst| "#{src} => #{dst}" }.join(", ")
  Chef::Log.info "Making pre-migration symlinks: #{links_info}"
  @new_resource.symlink_before_migrate.each do |src, dest|
    FileUtils.ln_sf(@new_resource.shared_path + "/#{src}", release_path + "/#{dest}")
  end
end

#sudo(command, &block) ⇒ Object



52
53
54
# File 'lib/chef/provider/deploy.rb', line 52

def sudo(command,&block)
  execute(command, &block)
end

#svn_force_exportObject



206
207
208
209
# File 'lib/chef/provider/deploy.rb', line 206

def svn_force_export
  Chef::Log.info "exporting source repository to #{@new_resource.destination}"
  @scm_provider.action_force_export
end


162
163
164
165
166
167
# File 'lib/chef/provider/deploy.rb', line 162

def symlink
  Chef::Log.info "Symlinking"
  purge_tempfiles_from_current_release
  link_tempfiles_to_current_release
  link_current_release_to_production
end

#update_cached_repoObject



193
194
195
196
197
198
199
# File 'lib/chef/provider/deploy.rb', line 193

def update_cached_repo
  if @new_resource.svn_force_export
    svn_force_export
  else
    run_scm_sync
  end
end