phpservermon/puphpet/puppet/modules/puppi/manifests/project/dir.pp

451 lines
13 KiB
Puppet

# = Define puppi::project::dir
#
# This is a shortcut define to build a puppi project for a deploy based
# on the syncronization of a directory.
# It uses different "core" defines (puppi::project, puppi:deploy (many),
# puppi::rollback (many)) to build a full featured template project for
# automatic deployments.
# If you need to customize it, either change the template defined here or
# build up your own custom ones.
#
# == Variables:
#
# [*source*]
# The full URL of the main file to retrieve.
# Format should be in URI standard (http:// file:// ssh:// rsync://).
#
# [*deploy_root*]
# The destination directory where the retrieved file(s) are deployed.
#
# [*init_source*]
# (Optional) - The full URL to be used to retrieve, for the first time,
# the project files. They are copied directly to the $deploy_root
# Format should be in URI standard (http:// file:// ssh:// svn://).
#
# [*user*]
# (Optional) - The user to be used for deploy operations.
#
# [*predeploy_customcommand*]
# (Optional) - Full path with arguments of an eventual custom command to
# execute before the deploy. The command is executed as $predeploy_user.
#
# [*predeploy_user*]
# (Optional) - The user to be used to execute the $predeploy_customcommand.
# By default is the same of $user.
#
# [*predeploy_priority*]
# (Optional) - The priority (execution sequence number) that defines when,
# during the deploy procedure, the $predeploy_customcommand is executed
# Default: 39 (immediately before the copy of files on the deploy root).
#
# [*postdeploy_customcommand*]
# (Optional) - Full path with arguments of an eventual custom command to
# execute after the deploy. The command is executed as $postdeploy_user.
#
# [*postdeploy_user*]
# (Optional) - The user to be used to execute the $postdeploy_customcommand.
# By default is the same of $user.
#
# [*postdeploy_priority*]
# (Optional) - The priority (execution sequence number) that defines when,
# during the deploy procedure, the $postdeploy_customcommand is executed
# Default: 41 (immediately after the copy of files on the deploy root).
#
# [*init_script*]
# (Optional - Obsolete) - The name (ex: tomcat) of the init script of your
# Application server. If you define it, the AS is stopped and then started
# during deploy. This option is deprecated, you can use $disable_services
# for the same functionality
#
# [*disable_services*]
# (Optional) - The names (space separated) of the services you might want to
# stop during deploy. By default is blank. Example: "apache puppet monit".
#
# [*firewall_src_ip*]
# (Optional) - The IP address of a loadbalancer you might want to block out
# during a deploy.
#
# [*firewall_dst_port*]
# (Optional) - The local port to block from the loadbalancer during deploy
# (Default all).
#
# [*firewall_delay*]
# (Optional) - A delay time in seconds to wait after the block of
# $firewall_src_ip. Should be at least as long as the loadbalancer check
# interval for the services stopped during deploy (Default: 1).
#
# [*report_email*]
# (Optional) - The (space separated) email(s) to notify of deploy/rollback
# operations. If none is specified, no email is sent.
#
# [*backup_rsync_options*]
# (Optional) - The extra options to pass to rsync for backup operations. Use
# it, for example, to exclude directories that you don't want to archive.
# IE: "--exclude .snapshot --exclude cache --exclude www/cache".
#
# [*backup_retention*]
# (Optional) - Number of backup archives to keep. (Default 5).
# Lower the default value if your backups are too large and may fill up the
# filesystem.
#
# [*run_checks*]
# (Optional) - If you want to run local puppi checks before and after the
# deploy procedure. Default: "true".
#
# [*skip_predeploy*]
# For large data to deploy predeploy copy in /tmp/puppi might full the
# filesystem. Set to "yes" to deploy directly to $deploy_root. Default: no
# (files are first predeployed in /tmp/puppi then copied to $deploy_root)
#
# [*auto_deploy*]
# (Optional) - If you want to automatically run this puppi deploy when
# Puppet runs. Default: 'false'
#
define puppi::project::dir (
$source,
$deploy_root,
$init_source = '',
$user = 'root',
$predeploy_customcommand = '',
$predeploy_user = '',
$predeploy_priority = '39',
$postdeploy_customcommand = '',
$postdeploy_user = '',
$postdeploy_priority = '41',
$init_script = '',
$disable_services = '',
$firewall_src_ip = '',
$firewall_dst_port = '0',
$firewall_delay = '1',
$report_email = '',
$backup_rsync_options = '--exclude .snapshot',
$backup_retention = '5',
$run_checks = true,
$skip_predeploy = false,
$auto_deploy = false,
$enable = true ) {
require puppi
require puppi::params
# Set default values
$predeploy_real_user = $predeploy_user ? {
'' => $user,
default => $predeploy_user,
}
$postdeploy_real_user = $postdeploy_user ? {
'' => $user,
default => $postdeploy_user,
}
$bool_run_checks = any2bool($run_checks)
$bool_skip_predeploy = any2bool($skip_predeploy)
$bool_auto_deploy = any2bool($auto_deploy)
### CREATE PROJECT
puppi::project { $name:
enable => $enable ,
}
### INIT SEQUENCE
if ($init_source != '') {
puppi::initialize { "${name}-Deploy_Files":
priority => '40' ,
command => 'get_file.sh' ,
arguments => "-s ${init_source} -d ${deploy_root}" ,
user => $user ,
project => $name ,
enable => $enable ,
}
}
### DEPLOY SEQUENCE
if ($bool_run_checks == true) {
puppi::deploy { "${name}-Run_PRE-Checks":
priority => '10' ,
command => 'check_project.sh' ,
arguments => $name ,
user => 'root' ,
project => $name ,
enable => $enable ,
}
}
if ($bool_skip_predeploy == false) {
puppi::deploy { "${name}-Sync_Files":
priority => '20' ,
command => 'get_file.sh' ,
arguments => "-s ${source} -t dir" ,
user => 'root' ,
project => $name ,
enable => $enable ,
}
}
if ($firewall_src_ip != '') {
puppi::deploy { "${name}-Load_Balancer_Block":
priority => '25' ,
command => 'firewall.sh' ,
arguments => "${firewall_src_ip} ${firewall_dst_port} on ${firewall_delay}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
puppi::deploy { "${name}-Backup_existing_Files":
priority => '30' ,
command => 'archive.sh' ,
arguments => "-b ${deploy_root} -o '${backup_rsync_options}' -n ${backup_retention}" ,
user => 'root' ,
project => $name ,
enable => $enable ,
}
if ($disable_services != '') {
puppi::deploy { "${name}-Disable_extra_services":
priority => '36' ,
command => 'service.sh' ,
arguments => "stop ${disable_services}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($init_script != '') {
puppi::deploy { "${name}-Service_stop":
priority => '38' ,
command => 'service.sh' ,
arguments => "stop ${init_script}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($predeploy_customcommand != '') {
puppi::deploy { "${name}-Run_Custom_PreDeploy_Script":
priority => $predeploy_priority ,
command => 'execute.sh' ,
arguments => $predeploy_customcommand ,
user => $predeploy_real_user ,
project => $name ,
enable => $enable ,
}
}
# Here is done the deploy on $deploy_root
if ($bool_skip_predeploy == false) {
puppi::deploy { "${name}-Deploy":
priority => '40' ,
command => 'deploy.sh' ,
arguments => $deploy_root ,
user => $user ,
project => $name ,
enable => $enable ,
}
}
if ($bool_skip_predeploy == true) {
puppi::deploy { "${name}-Deploy":
priority => '40' ,
command => 'get_file.sh' ,
arguments => "-s ${source} -d ${deploy_root}" ,
user => $user ,
project => $name ,
enable => $enable ,
}
}
# End deploy
if ($postdeploy_customcommand != '') {
puppi::deploy { "${name}-Run_Custom_PostDeploy_Script":
priority => $postdeploy_priority ,
command => 'execute.sh' ,
arguments => $postdeploy_customcommand ,
user => $postdeploy_real_user ,
project => $name ,
enable => $enable ,
}
}
if ($init_script != '') {
puppi::deploy { "${name}-Service_start":
priority => '42' ,
command => 'service.sh' ,
arguments => "start ${init_script}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($disable_services != '') {
puppi::deploy { "${name}-Enable_extra_services":
priority => '44' ,
command => 'service.sh' ,
arguments => "start ${disable_services}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($firewall_src_ip != '') {
puppi::deploy { "${name}-Load_Balancer_Unblock":
priority => '46' ,
command => 'firewall.sh' ,
arguments => "${firewall_src_ip} ${firewall_dst_port} off 0" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($bool_run_checks == true) {
puppi::deploy { "${name}-Run_POST-Checks":
priority => '80' ,
command => 'check_project.sh' ,
arguments => $name ,
user => 'root' ,
project => $name ,
enable => $enable ,
}
}
### ROLLBACK SEQUENCE
if ($firewall_src_ip != '') {
puppi::rollback { "${name}-Load_Balancer_Block":
priority => '25' ,
command => 'firewall.sh' ,
arguments => "${firewall_src_ip} ${firewall_dst_port} on ${firewall_delay}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($disable_services != '') {
puppi::rollback { "${name}-Disable_extra_services":
priority => '37' ,
command => 'service.sh' ,
arguments => "stop ${disable_services}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($init_script != '') {
puppi::rollback { "${name}-Service_stop":
priority => '38' ,
command => 'service.sh' ,
arguments => "stop ${init_script}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($predeploy_customcommand != '') {
puppi::rollback { "${name}-Run_Custom_PreDeploy_Script":
priority => $predeploy_priority ,
command => 'execute.sh' ,
arguments => $predeploy_customcommand ,
user => $predeploy_real_user ,
project => $name ,
enable => $enable ,
}
}
puppi::rollback { "${name}-Recover_Files_To_Deploy":
priority => '40' ,
command => 'archive.sh' ,
arguments => "-r ${deploy_root} -o '${backup_rsync_options}'" ,
user => $user ,
project => $name ,
enable => $enable ,
}
if ($postdeploy_customcommand != '') {
puppi::rollback { "${name}-Run_Custom_PostDeploy_Script":
priority => $postdeploy_priority ,
command => 'execute.sh' ,
arguments => $postdeploy_customcommand ,
user => $postdeploy_real_user ,
project => $name ,
enable => $enable ,
}
}
if ($init_script != '') {
puppi::rollback { "${name}-Service_start":
priority => '42' ,
command => 'service.sh' ,
arguments => "start ${init_script}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($disable_services != '') {
puppi::rollback { "${name}-Enable_extra_services":
priority => '44' ,
command => 'service.sh' ,
arguments => "start ${disable_services}" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($firewall_src_ip != '') {
puppi::rollback { "${name}-Load_Balancer_Unblock":
priority => '46' ,
command => 'firewall.sh' ,
arguments => "${firewall_src_ip} ${firewall_dst_port} off 0" ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
if ($bool_run_checks == true) {
puppi::rollback { "${name}-Run_POST-Checks":
priority => '80' ,
command => 'check_project.sh' ,
arguments => $name ,
user => 'root' ,
project => $name ,
enable => $enable ,
}
}
### REPORTING
if ($report_email != '') {
puppi::report { "${name}-Mail_Notification":
priority => '20' ,
command => 'report_mail.sh' ,
arguments => $report_email ,
user => 'root',
project => $name ,
enable => $enable ,
}
}
### AUTO DEPLOY DURING PUPPET RUN
if ($bool_auto_deploy == true) {
puppi::run { $name: }
}
}