brpm_module_brpm 0.1.10

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    N2ZhNDlhYmE2YzVmNTUwZjM1MTI5NjJmNzg3NTVmNWVjY2MyYmZmMw==
+  data.tar.gz: !binary |-
+    MjFlZGFkYTY0MGRjOTJkZGY5ODZiZWQ3MzgwNTUwZDEzMTY5MjU2Zg==
+SHA512:
+  metadata.gz: !binary |-
+    NDJjYTk1N2RjMDM3ODFiNmFjZTBkMzUxOTlhYzVjNDBiNDNlZWYwMWQwNjk5
+    NjY4ZTcxYjE3NGE0MmUxNTEzYzQ5Y2Y0NDRmMDQ4ODE3ZjZiYjhmMjI0MGRi
+    Mzg3NTY4MGMwYjhjM2Y5ZWQ2YTc1NWM5YjIwNzU3MjhiM2ZmZGQ=
+  data.tar.gz: !binary |-
+    YmQyOWExMWU5OTM5OWU5ZTlkOWE3MGJjMWYyMmFjMWQ0Y2E1ZGE5NTY0OTg4
+    ZjA5NjkyYzg2ODhkYjA3YjQ5YTIwODg3NmVmMzU0YjRkMjlkYmMyZWY4ZWQ5
+    MWUxYTJkMTBhM2NlNjc4NjdhYWY2NjM0Mjc1NDNiZjc1ZmUxYWE=

data/.gitignore

@@ -0,0 +1,38 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+.DS_Store
+
+.idea
+

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3-p392

data/.travis.yml

@@ -0,0 +1,18 @@
+language: ruby
+
+before_install:
+  - gem update --system 2.1.9
+
+bundler_args: '' #remove the --deployment flag that causes the gems to be installed in .../1.9.1/...
+
+script:
+  - rspec tests --format documentation --color
+
+notifications:
+  email:
+    - niek.bartholomeus@gmail.com
+
+branches:
+  except:
+    - /^v[0-9.]*/
+

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 BMC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,7 @@
+# BRPM module for BRPM
+
+[![Build Status](https://travis-ci.org/BMC-RLM/brpm_module_brpm.svg?branch=master)](https://travis-ci.org/BMC-RLM/brpm_module_brpm)
+
+[![Gem Version](https://badge.fury.io/rb/brpm_module_brpm.png)](http://badge.fury.io/rb/brpm_module_brpm)
+
+This repository represents an external module for BRPM, to be used on top of the [BRPM content repository](https://github.com/BMC-RLM/brpm_content)

data/Rakefile

@@ -0,0 +1,24 @@
+# Copied from https://github.com/mitchellh/vagrant-aws/blob/master/Rakefile
+require 'rubygems'
+require 'bundler/setup'
+require 'rspec/core/rake_task'
+
+# Immediately sync all stdout so that tools like buildbot can
+# immediately load in the output.
+$stdout.sync = true
+$stderr.sync = true
+
+# Change to the directory of this file.
+Dir.chdir(File.expand_path("../", __FILE__))
+
+# This installs the tasks that help with gem creation and
+# publishing.
+Bundler::GemHelper.install_tasks
+
+# Install the `spec` task so that we can run tests.
+RSpec::Core::RakeTask.new do |task|
+  task.pattern = "tests/**/*_spec.rb"
+end
+
+# Default task is to run the unit tests
+task :default => "spec"

data/automations/create_release_from_excel.rb

@@ -0,0 +1,34 @@
+require 'simple_xlsx_reader'
+
+brpm_rest_client = BrpmRestClient.new
+params = BrpmAuto.params
+
+doc = SimpleXlsxReader.open(params["step_attachment_0"])
+BrpmAuto.log doc.sheets.first.rows.inspect
+
+plan = nil
+env_name = nil
+stage_name = nil
+sub_stage_name = nil
+app_name = nil
+request = nil
+
+doc.sheets.first.rows.each do |row|
+  if !row[0].nil?
+    BrpmAuto.log "Creating a new plan from template 'My Release Plan' for release #{row[0]} ..."
+    plan = brpm_rest_client.create_plan("My Release Plan", row[0], Time.now)
+  elsif !row[1].nil?
+    env_name = row[1].downcase
+    stage_name = row[1]
+  elsif !row[2].nil?
+    sub_stage_name = row[2]
+  elsif !row[3].nil?
+    app_name = row[3]
+  elsif !row[4].nil?
+    BrpmAuto.log "Creating a new request '#{row[4]}' for plan '#{plan["name"]}', stage '#{stage_name} - #{sub_stage_name}' and app '#{app_name}' ..."
+    request = brpm_rest_client.create_request_for_plan(plan["id"], "#{stage_name} - #{sub_stage_name}", row[4], 1, app_name, env_name, false)
+  elsif !row[5].nil?
+    BrpmAuto.log "Creating a new step '#{row[5]}' for request '#{request["name"]}' ..."
+    brpm_rest_client.create_step(request["id"], row[5], "User", 1)
+  end
+end

data/automations/create_release_from_excel.txt

@@ -0,0 +1,5 @@
+params["direct_execute"] = "true"
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_brpm", "create_release_from_excel", params)

data/automations/create_release_request.rb

@@ -0,0 +1,100 @@
+# TODO workaround bug fix where the request params are not transferred to the updated application's directory
+require 'fileutils'
+
+brpm_rest_client = BrpmRestClient.new
+
+BrpmAuto.log "Retrieving the application..."
+application = brpm_rest_client.get_app_by_name(BrpmAuto.params["application_name"])
+application_version = BrpmAuto.params["application_version"]
+
+release_request_template_name = BrpmAuto.params["release_request_template_name"] || "Release application"
+release_plan_template_name = BrpmAuto.params["release_plan_template_name"]
+release_plan_name = BrpmAuto.params["release_plan_name"]
+
+request_name = "Release #{application["name"]} #{application_version}"
+
+request_params = {}
+request_params["auto_created"] = true
+request_params["application_version"] = application_version
+request_params["component_versions"] = {}
+request_params["component_versions"]["EF - .NET web front end"] = BrpmAuto.params["ef_net_version"]
+request_params["component_versions"]["EF - Java calculation engine"] = BrpmAuto.params["ef_java_version"]
+
+if release_plan_template_name or release_plan_name
+  if release_plan_template_name
+    BrpmAuto.log "Creating a new plan from template '#{release_plan_template_name}' for #{application["name"]} v#{application_version} ..."
+    plan = brpm_rest_client.create_plan(release_plan_template_name, "Release #{BrpmAuto.params["application_name"]} v#{application_version}", Time.now)
+
+    BrpmAuto.log "Planning the plan ..."
+    brpm_rest_client.plan_plan(plan["id"])
+
+    BrpmAuto.log "Starting the plan ..."
+    brpm_rest_client.start_plan(plan["id"])
+  elsif release_plan_name
+    plan = brpm_rest_client.get_plan_by_name(release_plan_name)
+    raise "Release plan '#{release_plan_name}' doesn't exist." unless plan
+  end
+
+  BrpmAuto.log "Creating a new request '#{request_name}' from template '#{release_request_template_name}' for application '#{application["name"]}' and plan #{plan["name"]}..."
+  target_request = brpm_rest_client.create_request_for_plan_from_template(
+      plan["id"],
+      "Release",
+      release_request_template_name,
+      request_name,
+      "release",
+      false, # execute_now
+      request_params
+  )
+
+else
+  BrpmAuto.log "Creating a new request '#{request_name}' from template '#{release_request_template_name}' for application '#{application["name"]}'..."
+  target_request = brpm_rest_client.create_request(
+      release_request_template_name,
+      request_name,
+      "release",
+      false, # execute_now
+      request_params
+  )
+end
+
+unless target_request["apps"].first["id"] == application["id"]
+  BrpmAuto.log "The application from the template is different than the application we want to use so updating the request with the correct application..."
+  request = {}
+  request["id"] = target_request["id"]
+  request["app_ids"] = [application["id"]]
+  target_request = brpm_rest_client.update_request_from_hash(request)
+
+  # TODO workaround bug fix where the request params are not transferred to the updated application's directory
+  Dir.mkdir "#{BrpmAuto.params.automation_results_dir}/request/#{application["name"]}/#{1000 + target_request["id"].to_i}"
+  json = FileUtils.mv("#{BrpmAuto.params.automation_results_dir}/request/#{target_request["apps"].first["name"]}/#{1000 + target_request["id"].to_i}/request_data.json", "#{BrpmAuto.params.automation_results_dir}/request/#{application["name"]}/#{1000 + target_request["id"].to_i}/request_data.json")
+
+  BrpmAuto.log "Setting the owner of the manual steps to the groups that belong to application '#{application["name"]}'..."
+  target_request["steps"].select{ |step| step["manual"] }.each do |step|
+    BrpmAuto.log "Retrieving the details of step #{step["id"]} '#{step["name"]}'..."
+    step_details = brpm_rest_client.get_step_by_id(step["id"])
+
+    next if step_details["procedure"]
+
+    group_name = "#{step_details["owner"]["name"]} - #{application["name"]}"
+
+    BrpmAuto.log "Retrieving group #{group_name}..."
+    group = brpm_rest_client.get_group_by_name(group_name)
+    raise "Group '#{group_name}' doesn't exist" if group.nil?
+
+    step_to_update = {}
+    step_to_update["id"] = step["id"]
+    step_to_update["owner_id"] = group["id"]
+    step_to_update["owner_type"] = "Group"
+    brpm_rest_client.update_step_from_hash step_to_update
+  end
+end
+
+BrpmAuto.log "Planning the request ... "
+brpm_rest_client.plan_request(target_request["id"])
+
+BrpmAuto.log "Starting the request ... "
+brpm_rest_client.start_request(target_request["id"])
+
+BrpmAuto.params["result"] = {}
+BrpmAuto.params["result"]["request_id"] = target_request["id"]
+

data/automations/create_release_request.txt

@@ -0,0 +1,5 @@
+params["direct_execute"] = "true"
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_brpm", "create_release_request", params)

data/automations/create_request.rb

@@ -0,0 +1,73 @@
+brpm_rest_client = BrpmRestClient.new
+params = BrpmAuto.params
+request_params = BrpmAuto.request_params
+
+BrpmAuto.log "Retrieving the application..."
+application = brpm_rest_client.get_app_by_name(params["application"])
+application_version = request_params["application_version"] || ""
+
+BrpmAuto.log "Retrieving the environment..."
+target_environment = brpm_rest_client.get_environment_by_id(params["target_environment_id"])
+
+if request_params.has_key? "request_template_id"
+  request_template_id = request_params["request_template_id"]
+  request_template_name = nil
+else
+  request_template_id = nil
+  request_template_name = "Deploy #{application["name"]}"
+end
+
+BrpmAuto.log "Creating request 'Deploy #{application["name"]} #{application_version}' from template '#{request_template_id || request_template_name}' for application '#{application["name"]}' and environment '#{target_environment["name"]}'..."
+request = {}
+request["request_template_id"] = request_template_id
+request["template_name"] = request_template_name
+request["name"] = "Deploy #{application["name"]} #{application_version}"
+request["environment"] = target_environment["name"]
+request["execute_now"] = false
+request["app_ids"] = [ application["id"] ]
+
+if params.request_plan_id and ! params.request_plan_id.empty? and params["target_stage"] and ! params["target_stage"].empty?
+  plan_stage_id = brpm_rest_client.get_plan_stage_id(params.request_plan_id, params["target_stage"])
+  request["plan_member_attributes"] = { "plan_id" => params.request_plan_id, "plan_stage_id" => plan_stage_id }
+end
+
+target_request = brpm_rest_client.create_request_from_hash(request)
+
+unless target_request["apps"].first["id"] == application["id"]
+  BrpmAuto.log "The application from the template is different than the application we want to use so updating the request with the correct application..."
+  request = {}
+  request["id"] = target_request["id"]
+  request["app_ids"] = [application["id"]]
+  target_request = brpm_rest_client.update_request_from_hash(request)
+end
+
+if request_params.has_key?"component_versions"
+  BrpmAuto.log "Component versions found in the request params so setting the version number of the components... "
+  request_params["component_versions"].each do |component_name, component_version|
+    BrpmAuto.log "Setting the version of component '#{component_name}' to '#{component_version}'... "
+    brpm_rest_client.set_version_tag_of_steps_for_component(target_request, component_name, component_version)
+  end
+elsif ! application_version.empty?
+  BrpmAuto.log "Application version found so setting the version number of all components to #{application_version}... "
+  application["components"].each do |component|
+    brpm_rest_client.set_version_tag_of_steps_for_component(target_request, component["name"], application_version)
+  end
+end
+
+if params["execute_target_request"].downcase.include?("execute")
+  BrpmAuto.log "Planning the request ... "
+  brpm_rest_client.plan_request(target_request["id"])
+
+  BrpmAuto.log "Starting the request ... "
+  brpm_rest_client.start_request(target_request["id"])
+end
+
+if params["execute_target_request"].downcase.include?("monitor")
+  BrpmAuto.log "Waiting until the request has finished ..."
+  brpm_rest_client.monitor_request(target_request["id"])
+end
+
+BrpmAuto.log "Adding the created request' id to the request_params ..."
+request_params["target_request_id"] = target_request["id"]
+
+

data/automations/create_request.txt

@@ -0,0 +1,23 @@
+###
+# target_environment_id:
+#   name: Target environment
+#   required: yes
+#   position: A1:C1
+#   type: in-external-single-select
+#   external_resource: select_environment
+# target_stage:
+#   name: Target stage
+#   required: no
+#   position: A2:C2
+# execute_target_request:
+#   name: execute_target_request
+#   required: yes
+#   type: in-list-single
+#   list_pairs: 1,No|2,Execute|3,Execute and monitor
+#   position: A3:C3
+###
+params["direct_execute"] = "true"
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_brpm", "create_request", params)

data/automations/promote_request.rb

@@ -0,0 +1,197 @@
+def get_source_requests(params)
+  brpm_rest_client = BrpmRestClient.new
+
+  source_request_ids = brpm_rest_client.get_requests_by_plan_id_and_stage_name_and_app_name(params["request_plan_id"], params["source_stage"], params["application"])
+
+  raise "No requests found for application '#{params["application"]}' in stage '#{params["source_stage"]}' of this plan" if source_request_ids.count == 0
+
+  source_requests = source_request_ids.map { |source_request_id| brpm_rest_client.get_request_by_id(source_request_id) }
+                                      .sort_by { |request| request["created_at"] }
+
+  source_requests
+end
+
+def step_has_incremental_deployment(correction_source_step, source_steps_with_same_name)
+  brpm_rest_client = BrpmRestClient.new
+
+  incremental_deployment = false
+  if source_steps_with_same_name.count > 1
+    BrpmAuto.log "Already multiple steps with the same name, this means that it is a step that has a component with incremental deploy."
+    incremental_deployment = true
+  else
+    if !source_steps_with_same_name.first["component"].nil? and !correction_source_step["component"].nil?
+      if source_steps_with_same_name.first["component"]["id"] == correction_source_step["component"]["id"]
+        if !source_steps_with_same_name.first["version_tag"].nil? and !correction_source_step["version_tag"].nil?
+          BrpmAuto.log "Verifying if the associated component '#{correction_source_step["component"]["name"]}' uses incremental deployment ..."
+          component = brpm_rest_client.get_component_by_id(correction_source_step["component"]["id"])
+          incremental_deployment = (component.has_key?("properties") and component["properties"].any? { |property| property["name"] == "incremental_deployment" })
+
+          if incremental_deployment and source_steps_with_same_name.first["version_tag"]["name"] == correction_source_step["version_tag"]["name"]
+            raise "This component has incremental deployment and there already exists a step with the same component and version number."
+          end
+        end
+      end
+    end
+  end
+
+  incremental_deployment
+end
+
+def merge_source_request_steps(source_requests)
+  brpm_rest_client = BrpmRestClient.new
+
+  BrpmAuto.log "Getting the step details of the initial request ..."
+  source_steps = source_requests.first["steps"].map { |source_step_summary| brpm_rest_client.get_step_by_id(source_step_summary["id"]) }
+                                              .sort_by { |step| step["number"].to_f }
+
+  #TODO: use work tasks to find the first post-deploy step
+  post_deploy_step = source_steps.find { |step| step["name"] == "Post-deploy" }
+
+  BrpmAuto.log "Merging the correction requests with the original request ..."
+  source_requests[1..source_requests.count].each do |source_request|
+    BrpmAuto.log "Merging the steps from correction request #{source_request["id"]} - #{source_request["name"] || "<no name>"} (#{source_request["steps"].count} steps)"
+    source_request["steps"].sort_by { |step| step["number"].to_f }.each do |correction_source_step_summary|
+      correction_source_step = brpm_rest_client.get_step_by_id(correction_source_step_summary["id"])
+      BrpmAuto.log "Merging step '#{correction_source_step["name"]}' ..."
+
+      source_steps_with_same_name = source_steps.find_all { |source_step| source_step["name"] == correction_source_step["name"] }
+
+      if source_steps_with_same_name.count == 0
+        BrpmAuto.log "No steps yet with the same name, so adding this step to the list ..."
+        index = source_steps.index(post_deploy_step)
+        source_steps.insert(index, correction_source_step)
+        next
+      end
+
+      BrpmAuto.log "Verifying if the step has a component with incremental deployment ..."
+      incremental_deployment = step_has_incremental_deployment(correction_source_step, source_steps_with_same_name)
+
+      if incremental_deployment
+        BrpmAuto.log "This step has a component with incremental deployment so adding it to the list ..."
+        index = source_steps.index(source_steps_with_same_name.last)
+        source_steps.insert(index + 1, correction_source_step)
+      else
+        BrpmAuto.log "Replacing the original step with this one in the list ..."
+        index = source_steps.index(source_steps_with_same_name.first)
+        source_steps[index] = correction_source_step
+      end
+    end
+  end
+
+  source_steps
+end
+
+def create_target_request(initial_source_request, source_steps, params)
+  brpm_rest_client = BrpmRestClient.new
+
+  target_request = {}
+  target_request["name"] = params["request_name"].sub("Release", "Deploy")
+  target_request["description"] = initial_source_request["description"]
+  target_request["estimate"] = initial_source_request["estimate"]
+  target_request["owner_id"] = initial_source_request["owner"]["id"]
+  target_request["requestor_id"] = initial_source_request["requestor"]["id"]
+  target_request["deployment_coordinator_id"] = initial_source_request["deployment_coordinator"]["id"]
+  target_request["app_ids"] = initial_source_request["apps"][0]["id"]
+
+  plan_stage_id = brpm_rest_client.get_plan_stage_id(params["request_plan_id"], params["target_stage"])
+  target_request["plan_member_attributes"] = { "plan_id" => params["request_plan_id"], "plan_stage_id" => plan_stage_id }
+  target_request["environment"] = params["target_env"]
+  target_request["execute_now"] = (params["execute_target_request"] == 'Yes') #TODO: doesn't work - maybe try starting it explicitly after creation
+
+  BrpmAuto.log "Creating the target request ..."
+  target_request = brpm_rest_client.create_request_from_hash(target_request)
+
+  BrpmAuto.log "Creating the target steps ..."
+  procedure_mapping = {}
+  source_steps.each do |source_step|
+    BrpmAuto.log "Creating target step for step #{source_step["name"]} ..."
+
+    target_step = {}
+    if source_step["procedure"]
+      #TODO doesnt work yet
+      target_step["parent_id"] = procedure_mapping[source_step["parent_id"]]
+    end
+    target_step["request_id"] = target_request["id"]
+    target_step["name"] = source_step["name"]
+    target_step["description"] = source_step["description"]
+    target_step["owner_type"] = source_step["owner_type"]
+    target_step["owner_id"] = source_step["owner"]["id"] unless source_step["owner"].nil?
+    target_step["manual"] = source_step["manual"]
+    target_step["script_id"] = source_step["script"]["id"] unless source_step["script"].nil?
+    target_step["script_type"] = source_step["script_type"]
+    target_step["procedure"] = source_step["procedure"]
+
+    unless source_step["installed_component"].nil?
+      installed_components = brpm_rest_client.get_installed_components_by({ "app_name" => source_step["installed_component"]["app"]["name"],
+                                                           "component_name" => source_step["installed_component"]["component"]["name"],
+                                                           "environment_name" => params["target_env"] })
+
+      raise "No installed component found for app '#{source_step["installed_component"]["app"]["name"]}', component '#{source_step["installed_component"]["component"]["name"]}' and environment '#{source_step["installed_component"]["environment"]["name"]}'" if installed_components.count == 0
+
+      target_step["installed_component_id"] = installed_components[0]["id"]
+
+      unless source_step["version_tag"].nil?
+        version_tags = brpm_rest_client.get_version_tags_by({ "name" => source_step["version_tag"]["name"],
+                                             "app_name" => source_step["installed_component"]["app"]["name"],
+                                             "component_name" => source_step["installed_component"]["component"]["name"],
+                                             "environment_name" => params["target_env"] })
+
+        raise "No version tag found for app '#{source_step["installed_component"]["app"]["name"]}', component '#{source_step["installed_component"]["component"]["name"]}', environment '#{params["target_env"]}' and version '#{source_step["version_tag"]["name"]}'" if version_tags.count == 0
+
+        target_step["version_tag_id"] = version_tags[0]["id"]
+      end
+    end
+
+    target_step["component_id"] = source_step["component"]["id"] unless source_step["component"].nil?
+
+    target_step["own_version"] = source_step["own_version"]
+    target_step["component_version"] = source_step["component_version"]
+    target_step["custom_ticket_id"] = source_step["custom_ticket_id"]
+    target_step["release_content_item_id"] = source_step["release_content_item_id"]
+    target_step["on_plan"] = source_step["on_plan"]
+    target_step["should_execute"] = source_step["should_execute"]
+    target_step["execute_anytime"] = source_step["execute_anytime"]
+    target_step["start_by"] = source_step["start_by"]
+    target_step["location_detail"] = source_step["location_detail"]
+    target_step["estimate"] = source_step["estimate"]
+    target_step["different_level_from_previous"] = source_step["different_level_from_previous"]
+    target_step["phase_id"] = source_step["phase"]["id"] unless source_step["phase"].nil?
+    target_step["runtime_phase_id"] = source_step["runtime_phase"]["id"] unless source_step["runtime_phase"].nil?
+
+    target_step = brpm_rest_client.create_step_from_hash(target_step)
+
+    BrpmAuto.log "Created target step for step #{source_step["name"]} (#{target_step["position"]})."
+
+    procedure_mapping[source_step["id"]] = target_step["id"] if source_step["procedure"]
+  end
+
+  target_request
+end
+
+brpm_rest_client = BrpmRestClient.new
+params = BrpmAuto.params
+
+BrpmAuto.log "Getting the source requests ..."
+source_requests = brpm_rest_client.get_source_requests(params)
+
+if params["request_template"].nil? || params["request_template"].empty?
+  initial_source_request = source_requests.first
+  BrpmAuto.log "Found initial source request #{initial_source_request["id"]} - #{initial_source_request["name"] || "<no name>"}"
+
+  BrpmAuto.log "Merging the source request steps ..."
+  source_steps = merge_source_request_steps(source_requests)
+
+  BrpmAuto.log "Creating the target request ..."
+  target_request = create_target_request(initial_source_request, source_steps, params)
+else
+  target_request = brpm_rest_client.create_request_for_plan_from_template(params["request_plan_id"], params["target_stage"], params["request_template"], params["request_name"].sub("Release", "Deploy"), params["target_env"], (params["execute_target_request"] == 'Yes'))
+end
+
+BrpmAuto.log "Moving the source requests to the stage '#{params["source_stage"]} - Archived' ..."
+source_requests.each do |source_request|
+  brpm_rest_client.move_request_to_plan_and_stage(source_request["id"], params["request_plan_id"], "#{params["source_stage"]} - Archived")
+end
+
+BrpmAuto.log "Adding the promoted request' id to the request_params ..."
+BrpmAuto.request_params["promoted_request_id"] = target_request["id"]
+

data/automations/promote_request.txt

@@ -0,0 +1,24 @@
+###
+# request_template:
+#   name: request_template
+#   required: no
+# source_stage:
+#   name: source_stage
+#   required: yes
+# target_stage:
+#   name: target_stage
+#   required: yes
+# target_env:
+#   name: target_env
+#   required: yes
+# execute_target_request:
+#   name: execute_target_request
+#   required: yes
+#   type: in-list-single
+#   list_pairs: true,Yes|false,No
+###
+params["direct_execute"] = "true"
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_brpm", "promote_request", params)

data/automations/select_application_version.rb

@@ -0,0 +1,22 @@
+brpm_rest_client = BrpmRestClient.new
+
+if BrpmAuto.request_params["auto_created"]
+  BrpmAuto.log "The request was created in an automated way, not overriding the request params from the manual input step."
+  application_version = BrpmAuto.request_params["application_version"]
+else
+  BrpmAuto.log "Storing the input parameters ..."
+  BrpmAuto.request_params["application_version"] = BrpmAuto.params["application_version"]
+
+  application_version = BrpmAuto.params["application_version"]
+end
+
+BrpmAuto.log "Creating version tags for all components..."
+application = brpm_rest_client.get_app_by_name(BrpmAuto.params["application"])
+
+application["components"].each do |component|
+  application["environments"].each do |environment|
+    brpm_rest_client.create_version_tag(application["name"], component["name"], environment["name"], application_version)
+  end
+end
+
+

data/automations/select_application_version.txt

@@ -0,0 +1,17 @@
+###
+# application_id:
+#   name: Application
+#   position: A1:C1
+#   type: in-external-single-select
+#   external_resource: select_application
+#   required: yes
+# application_version:
+#   name: Version
+#   position: A2:B2
+#   required: yes
+###
+params["direct_execute"] = "true"
+
+require "#{ENV["BRPM_CONTENT_HOME"] || "#{ENV["BRPM_HOME"]}/modules"}/gems/brpm_content-#{ENV["BRPM_CONTENT_VERSION"] || "latest"}/modules/framework/brpm_script_executor.rb"
+
+BrpmScriptExecutor.execute_automation_script_from_gem("brpm_module_brpm", "select_application_version", params)