Class: Origen::Application::Deployer

Inherits:
Object
  • Object
show all
Defined in:
lib/origen/application/deployer.rb

Overview

This class manages deploying an application’s website.

The web pages are compiled in the local application workspace and deploy consists of copying them to the remote location.

Two directories are maintained in the remote location, one containing the live website and another where the new site is copied to during a deploy. A symlink is used to indicate which one of the two directories is currently being served.

Upon a successful copy the symlink is switched over, thereby providing zero-downtime deploys and guaranteeing that the old site will stay up if an error is encountered during a deploy.

An alternative method of deploying is also supported by pushing to a Git repository.

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#directory=(value) ⇒ Object (writeonly)

Sets the attribute directory

Parameters:

  • value —

    the value to set the attribute directory to.



21
22
23
 
# File 'lib/origen/application/deployer.rb', line 21

def directory=(value)
  @directory = value
end

#test=(value) ⇒ Object (writeonly)

Sets the attribute test

Parameters:

  • value —

    the value to set the attribute test to.



21
22
23
 
# File 'lib/origen/application/deployer.rb', line 21

def test=(value)
  @test = value
end

Instance Method Details



214
215
216
217
 
# File 'lib/origen/application/deployer.rb', line 214

def create_symlink(from, to)
  `rm -f #{to}` if File.exist?(to)
  `ln -s #{from} #{to}` if File.exist?(from)
end

#create_web_server_dir ⇒ Object 



223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
 
# File 'lib/origen/application/deployer.rb', line 223

def create_web_server_dir
  if File.exist?("#{Origen.root}/templates/web")
    dir = web_server_dir
    FileUtils.rm_rf dir if File.exist?(dir)
    FileUtils.mkdir_p dir
    # Copy the web infrastructure
    FileUtils.cp_r Dir.glob("#{Origen.top}/templates/nanoc/*").sort, dir
    # Compile the dynamic stuff
    Origen.app.runner.launch action: :compile,
                             files:  "#{Origen.top}/templates/nanoc_dynamic",
                             output: dir
    unless Origen.root == Origen.top
      # Copy any application overrides if they exist
      if File.exist?("#{Origen.root}/templates/nanoc")
        FileUtils.cp_r Dir.glob("#{Origen.root}/templates/nanoc/*").sort, dir, remove_destination: true
      end
    end
    # Remove the .SYNCs
    system "find #{dir} -name \".SYNC\" | xargs rm -fr"
    @nanoc_dir = dir
  end
end

#deploy_archive(id) ⇒ Object 



203
204
205
206
207
208
209
210
211
212
 
# File 'lib/origen/application/deployer.rb', line 203

def deploy_archive(id)
  dir = live_remote_directory
  if dir
    id.gsub!('.', '_')
    archive_dir = "#{Origen.config.web_directory}/#{id}"
    FileUtils.rm_rf(archive_dir) if File.exist?(archive_dir)
    FileUtils.mkdir_p archive_dir
    FileUtils.cp_r "#{Origen.root}/web/output/.", archive_dir
  end
end

#deploy_file(file) ⇒ Object 



159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
 
# File 'lib/origen/application/deployer.rb', line 159

def deploy_file(file)
  if deploy_to_git?
    fail 'File based deploy has is not support for Git yet :-('
  else
    remote_dir = live_remote_directory
    if remote_dir
      file = Origen.file_handler.clean_path_to(file)
      sub_dir = Origen.file_handler.sub_dir_of(file, "#{Origen.root}/templates/web") .to_s
      page = file.basename.to_s.sub(/\..*/, '')
      # Special case for the main index page
      if page == 'index' && sub_dir == '.'
        FileUtils.cp "#{Origen.root}/web/output/index.html", remote_dir
      else
        FileUtils.mkdir_p("#{remote_dir}/#{sub_dir}/#{page}")
        FileUtils.cp "#{Origen.root}/web/output/#{sub_dir}/#{page}/index.html", "#{remote_dir}/#{sub_dir}/#{page}"
      end
    end
  end
end

#deploy_site ⇒ Object

Deploy a whole web site.

This copies the entire contents of web/output in the application directory to the remote server.



127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
 
# File 'lib/origen/application/deployer.rb', line 127

def deploy_site
  Origen.app.listeners_for(:before_deploy_site).each(&:before_deploy_site)
  if deploy_to_git?
    dir = git_repo.local.to_s
    dir += "/#{git_sub_dir}" if git_sub_dir
    # Delete everything so that we don't preserve old files
    git_repo.delete_all(git_sub_dir)
    FileUtils.mkdir_p(dir) unless File.exist?(dir)
    `chmod a+w -R #{Origen.root}/web/output`      # Ensure world writable, required?
    FileUtils.cp_r "#{Origen.root}/web/output/.", dir
    git_repo.checkin git_sub_dir, unmanaged: true, comment: @commit_message
  else
    # Empty the contents of the remote dir
    if File.exist?(offline_remote_directory)
      FileUtils.remove_dir(offline_remote_directory, true)
      require_remote_directories
    end
    # Copy the new contents across
    `chmod g+w -R #{Origen.root}/web/output`      # Ensure group writable
    FileUtils.cp_r "#{Origen.root}/web/output/.", offline_remote_directory
    `chmod g+w -R #{offline_remote_directory}`  # Double ensure group writable
    # Make live
    create_symlink offline_remote_directory, latest_symlink
    index = "#{Origen.config.web_directory}/index.html"
    # This symlink allows the site homepage to be accessed from the web root
    # directory rather than root directory/latest
    unless File.exist?(index)
      create_symlink "#{latest_symlink}/index.html", index
    end
  end
end

#deploy_to_git? ⇒ Boolean

Returns:

  • (Boolean) 


84
85
86
 
# File 'lib/origen/application/deployer.rb', line 84

def deploy_to_git?
  !!(Origen.config.web_directory =~ /\.git\/?#{git_sub_dir}$/)
end

#generate_api ⇒ Object 



179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
 
# File 'lib/origen/application/deployer.rb', line 179

def generate_api
  dir = "#{Origen.root}/web/output/api"
  FileUtils.rm_rf(dir) if File.exist?(dir)
  # system("cd #{Origen.root} && rdoc --op api --tab-width 4 --main api_doc/README.txt --title 'Origen (#{Origen.version})' api_doc lib/origen")
  if Origen.root == Origen.top
    title = "#{Origen.config.name} #{Origen.version}"
  else
    title = "#{Origen.config.name} #{Origen.app.version}"
  end
  system("yard doc --output-dir #{Origen.root}/web/output/api --title '#{title}'")
  # Yard doesn't have an option to ignore github-style READMEs, so force it here to
  # always present the API index on the API homepage for consistency
  index = "#{Origen.root}/web/output/api/index.html"
  _index = "#{Origen.root}/web/output/api/_index.html"
  FileUtils.rm_f(index) if File.exist?(index)
  # This removes a prominent link that we are left with to a README file that doesn't work
  require 'nokogiri'
  doc = Nokogiri::HTML(File.read(_index))
  doc.xpath('//h2[contains(text(), "File Listing")]').remove
  doc.css('#files').remove
  File.open(_index, 'w') { |f| f.write(doc.to_html) }
  FileUtils.cp(_index, index)
end

#git_repo ⇒ Object

Returns a RevisionControl::Git object that points to a local copy of the website repo which is will build and checkout as required



62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
 
# File 'lib/origen/application/deployer.rb', line 62

def git_repo
  @git_repo ||= begin
    local = Pathname.new("#{Origen.app.workspace_manager.imports_directory}/git/#{Origen.config.web_directory.gsub('/', '-').symbolize}")
    if git_sub_dir
      remote = Origen.config.web_directory.sub("\/#{git_sub_dir}", '')
    else
      remote = Origen.config.web_directory
    end
    git = RevisionControl::Git.new(local: local, remote: remote)
    if git.initialized?
      git.checkout(force: true)
    else
      git.build(force: true)
    end
    git
  end
end

#git_sub_dir ⇒ Object 



54
55
56
57
58
 
# File 'lib/origen/application/deployer.rb', line 54

def git_sub_dir
  if Origen.config.web_directory =~ /\.git\/(.*)$/
    Regexp.last_match(1)
  end
end

#latest_symlink ⇒ Object 



97
98
99
 
# File 'lib/origen/application/deployer.rb', line 97

def latest_symlink
  "#{Origen.config.web_directory}/latest"
end

#live_remote_directory ⇒ Object 



113
114
115
116
117
118
119
120
121
 
# File 'lib/origen/application/deployer.rb', line 113

def live_remote_directory
  if File.exist?(latest_symlink)
    if File.readlink(latest_symlink) =~ /remote1/
      "#{Origen.config.web_directory}/remote1"
    elsif File.readlink(latest_symlink) =~ /remote2/
      "#{Origen.config.web_directory}/remote2"
    end
  end
end

#offline_remote_directory ⇒ Object 



101
102
103
104
105
106
107
108
109
110
111
 
# File 'lib/origen/application/deployer.rb', line 101

def offline_remote_directory
  if File.exist?(latest_symlink)
    if File.readlink(latest_symlink) =~ /remote1/
      "#{Origen.config.web_directory}/remote2"
    else
      "#{Origen.config.web_directory}/remote1"
    end
  else
    "#{Origen.config.web_directory}/remote1"
  end
end

#prepare!(options = {}) ⇒ Object

Prepare for deploying, this will raise an error if the current user is found to have insufficient permissions to deploy to the target directory



25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/origen/application/deployer.rb', line 25

def prepare!(options = {})
  if deploy_to_git?
    require 'highline/import'
    @commit_message = options[:message] || ask('Enter a deployment commit message:  ') do |q|
      q.validate = /\w/
      q.responses[:not_valid] = "Can't be blank"
    end
    Origen.log.info "Fetching the website's Git respository..."
    git_repo
    begin
      fail unless git_repo.can_checkin?
    rescue
      puts "Sorry, but you don't have permission to write to #{Origen.config.web_directory}!"
      exit 1
    end
  else
    begin
      require_remote_directories
      test_file = "#{Origen.config.web_directory}/_test_file.txt"
      FileUtils.rm_f(test_file) if File.exist?(test_file)
      FileUtils.touch(test_file)
      FileUtils.rm_f(test_file)
    rescue
      puts "Sorry, but you don't have permission to write to #{Origen.config.web_directory}!"
      exit 1
    end
  end
end

#require_remote_directories ⇒ Object 



88
89
90
91
92
93
94
95
 
# File 'lib/origen/application/deployer.rb', line 88

def require_remote_directories
  %w(remote1 remote2).each do |dir|
    dir = "#{Origen.config.web_directory}/#{dir}"
    unless File.exist?(dir)
      FileUtils.mkdir_p dir
    end
  end
end

#test_run? ⇒ Boolean

Returns:

  • (Boolean) 


80
81
82
 
# File 'lib/origen/application/deployer.rb', line 80

def test_run?
  @test
end

#web_server_dir ⇒ Object 



219
220
221
 
# File 'lib/origen/application/deployer.rb', line 219

def web_server_dir
  "#{Origen.root}/web"
end