backedup 5.0.0.beta.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/LICENSE +19 -0
- data/README.md +33 -0
- data/bin/backedup +5 -0
- data/bin/docker_test +24 -0
- data/lib/backup/archive.rb +169 -0
- data/lib/backup/binder.rb +18 -0
- data/lib/backup/cleaner.rb +112 -0
- data/lib/backup/cli.rb +370 -0
- data/lib/backup/cloud_io/base.rb +38 -0
- data/lib/backup/cloud_io/cloud_files.rb +296 -0
- data/lib/backup/cloud_io/gcs.rb +121 -0
- data/lib/backup/cloud_io/s3.rb +253 -0
- data/lib/backup/cloud_io/swift.rb +96 -0
- data/lib/backup/compressor/base.rb +32 -0
- data/lib/backup/compressor/bzip2.rb +35 -0
- data/lib/backup/compressor/custom.rb +49 -0
- data/lib/backup/compressor/gzip.rb +73 -0
- data/lib/backup/compressor/pbzip2.rb +45 -0
- data/lib/backup/config/dsl.rb +102 -0
- data/lib/backup/config/helpers.rb +137 -0
- data/lib/backup/config.rb +118 -0
- data/lib/backup/database/base.rb +86 -0
- data/lib/backup/database/mongodb.rb +186 -0
- data/lib/backup/database/mysql.rb +191 -0
- data/lib/backup/database/openldap.rb +93 -0
- data/lib/backup/database/postgresql.rb +164 -0
- data/lib/backup/database/redis.rb +176 -0
- data/lib/backup/database/riak.rb +79 -0
- data/lib/backup/database/sqlite.rb +55 -0
- data/lib/backup/encryptor/base.rb +27 -0
- data/lib/backup/encryptor/gpg.rb +737 -0
- data/lib/backup/encryptor/open_ssl.rb +74 -0
- data/lib/backup/errors.rb +53 -0
- data/lib/backup/logger/console.rb +48 -0
- data/lib/backup/logger/fog_adapter.rb +25 -0
- data/lib/backup/logger/logfile.rb +131 -0
- data/lib/backup/logger/syslog.rb +114 -0
- data/lib/backup/logger.rb +197 -0
- data/lib/backup/model.rb +472 -0
- data/lib/backup/notifier/base.rb +126 -0
- data/lib/backup/notifier/campfire.rb +61 -0
- data/lib/backup/notifier/command.rb +99 -0
- data/lib/backup/notifier/datadog.rb +104 -0
- data/lib/backup/notifier/flowdock.rb +99 -0
- data/lib/backup/notifier/hipchat.rb +116 -0
- data/lib/backup/notifier/http_post.rb +114 -0
- data/lib/backup/notifier/mail.rb +232 -0
- data/lib/backup/notifier/nagios.rb +65 -0
- data/lib/backup/notifier/pagerduty.rb +79 -0
- data/lib/backup/notifier/prowl.rb +68 -0
- data/lib/backup/notifier/pushover.rb +71 -0
- data/lib/backup/notifier/ses.rb +123 -0
- data/lib/backup/notifier/slack.rb +147 -0
- data/lib/backup/notifier/twitter.rb +55 -0
- data/lib/backup/notifier/zabbix.rb +60 -0
- data/lib/backup/package.rb +51 -0
- data/lib/backup/packager.rb +106 -0
- data/lib/backup/pipeline.rb +120 -0
- data/lib/backup/splitter.rb +73 -0
- data/lib/backup/storage/base.rb +66 -0
- data/lib/backup/storage/cloud_files.rb +156 -0
- data/lib/backup/storage/cycler.rb +70 -0
- data/lib/backup/storage/dropbox.rb +206 -0
- data/lib/backup/storage/ftp.rb +116 -0
- data/lib/backup/storage/gcs.rb +93 -0
- data/lib/backup/storage/local.rb +61 -0
- data/lib/backup/storage/qiniu.rb +65 -0
- data/lib/backup/storage/rsync.rb +246 -0
- data/lib/backup/storage/s3.rb +155 -0
- data/lib/backup/storage/scp.rb +65 -0
- data/lib/backup/storage/sftp.rb +80 -0
- data/lib/backup/storage/swift.rb +124 -0
- data/lib/backup/storage/webdav.rb +102 -0
- data/lib/backup/syncer/base.rb +67 -0
- data/lib/backup/syncer/cloud/base.rb +176 -0
- data/lib/backup/syncer/cloud/cloud_files.rb +81 -0
- data/lib/backup/syncer/cloud/local_file.rb +97 -0
- data/lib/backup/syncer/cloud/s3.rb +109 -0
- data/lib/backup/syncer/rsync/base.rb +50 -0
- data/lib/backup/syncer/rsync/local.rb +27 -0
- data/lib/backup/syncer/rsync/pull.rb +47 -0
- data/lib/backup/syncer/rsync/push.rb +201 -0
- data/lib/backup/template.rb +41 -0
- data/lib/backup/utilities.rb +234 -0
- data/lib/backup/version.rb +3 -0
- data/lib/backup.rb +145 -0
- data/templates/cli/archive +28 -0
- data/templates/cli/compressor/bzip2 +4 -0
- data/templates/cli/compressor/custom +7 -0
- data/templates/cli/compressor/gzip +4 -0
- data/templates/cli/config +123 -0
- data/templates/cli/databases/mongodb +15 -0
- data/templates/cli/databases/mysql +18 -0
- data/templates/cli/databases/openldap +24 -0
- data/templates/cli/databases/postgresql +16 -0
- data/templates/cli/databases/redis +16 -0
- data/templates/cli/databases/riak +17 -0
- data/templates/cli/databases/sqlite +11 -0
- data/templates/cli/encryptor/gpg +27 -0
- data/templates/cli/encryptor/openssl +9 -0
- data/templates/cli/model +26 -0
- data/templates/cli/notifier/zabbix +15 -0
- data/templates/cli/notifiers/campfire +12 -0
- data/templates/cli/notifiers/command +32 -0
- data/templates/cli/notifiers/datadog +57 -0
- data/templates/cli/notifiers/flowdock +16 -0
- data/templates/cli/notifiers/hipchat +16 -0
- data/templates/cli/notifiers/http_post +32 -0
- data/templates/cli/notifiers/mail +24 -0
- data/templates/cli/notifiers/nagios +13 -0
- data/templates/cli/notifiers/pagerduty +12 -0
- data/templates/cli/notifiers/prowl +11 -0
- data/templates/cli/notifiers/pushover +11 -0
- data/templates/cli/notifiers/ses +15 -0
- data/templates/cli/notifiers/slack +22 -0
- data/templates/cli/notifiers/twitter +13 -0
- data/templates/cli/splitter +7 -0
- data/templates/cli/storages/cloud_files +11 -0
- data/templates/cli/storages/dropbox +20 -0
- data/templates/cli/storages/ftp +13 -0
- data/templates/cli/storages/gcs +8 -0
- data/templates/cli/storages/local +8 -0
- data/templates/cli/storages/qiniu +12 -0
- data/templates/cli/storages/rsync +17 -0
- data/templates/cli/storages/s3 +16 -0
- data/templates/cli/storages/scp +15 -0
- data/templates/cli/storages/sftp +15 -0
- data/templates/cli/storages/swift +19 -0
- data/templates/cli/storages/webdav +13 -0
- data/templates/cli/syncers/cloud_files +22 -0
- data/templates/cli/syncers/rsync_local +20 -0
- data/templates/cli/syncers/rsync_pull +28 -0
- data/templates/cli/syncers/rsync_push +28 -0
- data/templates/cli/syncers/s3 +27 -0
- data/templates/general/links +3 -0
- data/templates/general/version.erb +2 -0
- data/templates/notifier/mail/failure.erb +16 -0
- data/templates/notifier/mail/success.erb +16 -0
- data/templates/notifier/mail/warning.erb +16 -0
- data/templates/storage/dropbox/authorization_url.erb +6 -0
- data/templates/storage/dropbox/authorized.erb +4 -0
- data/templates/storage/dropbox/cache_file_written.erb +10 -0
- metadata +1255 -0
@@ -0,0 +1,99 @@
|
|
1
|
+
module Backup
|
2
|
+
module Notifier
|
3
|
+
class Command < Base
|
4
|
+
##
|
5
|
+
# Command to execute.
|
6
|
+
#
|
7
|
+
# Make sure it is accessible from your $PATH, or provide
|
8
|
+
# the absolute path to the command.
|
9
|
+
attr_accessor :command
|
10
|
+
|
11
|
+
##
|
12
|
+
# Arguments to pass to the command.
|
13
|
+
#
|
14
|
+
# Must be an array of strings or callable objects.
|
15
|
+
#
|
16
|
+
# Callables will be invoked with #call(model, status),
|
17
|
+
# and the return value used as the argument.
|
18
|
+
#
|
19
|
+
# In strings you can use the following placeholders:
|
20
|
+
#
|
21
|
+
# %l - Model label
|
22
|
+
# %t - Model trigger
|
23
|
+
# %d - Backup duration (HH:MM:SS)
|
24
|
+
# %s - Status (success/failure/warning)
|
25
|
+
# %v - Status verb (succeeded/failed/succeeded with warnings)
|
26
|
+
#
|
27
|
+
# All placeholders can be used with uppercase letters to capitalize
|
28
|
+
# the value.
|
29
|
+
#
|
30
|
+
# Defaults to ["%L %v"]
|
31
|
+
attr_accessor :args
|
32
|
+
|
33
|
+
def initialize(model, &block)
|
34
|
+
super
|
35
|
+
instance_eval(&block) if block_given?
|
36
|
+
|
37
|
+
@args ||= ["%L %v"]
|
38
|
+
end
|
39
|
+
|
40
|
+
private
|
41
|
+
|
42
|
+
##
|
43
|
+
# Notify the user of the backup operation results.
|
44
|
+
#
|
45
|
+
# `status` indicates one of the following:
|
46
|
+
#
|
47
|
+
# `:success`
|
48
|
+
# : The backup completed successfully.
|
49
|
+
# : Notification will be sent if `on_success` is `true`.
|
50
|
+
#
|
51
|
+
# `:warning`
|
52
|
+
# : The backup completed successfully, but warnings were logged.
|
53
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
54
|
+
#
|
55
|
+
# `:failure`
|
56
|
+
# : The backup operation failed.
|
57
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
58
|
+
#
|
59
|
+
def notify!(status)
|
60
|
+
IO.popen([@command] + args.map { |arg| format_arg(arg, status) })
|
61
|
+
end
|
62
|
+
|
63
|
+
def format_arg(arg, status)
|
64
|
+
if arg.respond_to?(:call)
|
65
|
+
arg.call(model, status)
|
66
|
+
else
|
67
|
+
arg.gsub(/%(\w)/) do |match|
|
68
|
+
ph = match[1]
|
69
|
+
val = case ph.downcase
|
70
|
+
when "l"
|
71
|
+
model.label
|
72
|
+
when "t"
|
73
|
+
model.trigger.to_s
|
74
|
+
when "d"
|
75
|
+
model.duration
|
76
|
+
when "v"
|
77
|
+
status_verb(status)
|
78
|
+
when "s"
|
79
|
+
status.to_s
|
80
|
+
end
|
81
|
+
val.capitalize! if ph == ph.upcase
|
82
|
+
val
|
83
|
+
end
|
84
|
+
end
|
85
|
+
end
|
86
|
+
|
87
|
+
def status_verb(status)
|
88
|
+
case status
|
89
|
+
when :success
|
90
|
+
"succeeded"
|
91
|
+
when :failure
|
92
|
+
"failed"
|
93
|
+
when :warning
|
94
|
+
"succeeded with warnings"
|
95
|
+
end
|
96
|
+
end
|
97
|
+
end
|
98
|
+
end
|
99
|
+
end
|
@@ -0,0 +1,104 @@
|
|
1
|
+
require "dogapi"
|
2
|
+
|
3
|
+
module Backup
|
4
|
+
module Notifier
|
5
|
+
class DataDog < Base
|
6
|
+
##
|
7
|
+
# The DataDog API key
|
8
|
+
attr_accessor :api_key
|
9
|
+
|
10
|
+
##
|
11
|
+
# The title of the event
|
12
|
+
attr_accessor :title
|
13
|
+
|
14
|
+
attr_deprecate :text,
|
15
|
+
version: "4.2",
|
16
|
+
message: "Please use the `message` attribute. For more information "\
|
17
|
+
"see https://github.com/backup/backup/pull/698"
|
18
|
+
|
19
|
+
##
|
20
|
+
# The timestamp for the event
|
21
|
+
attr_accessor :date_happened
|
22
|
+
|
23
|
+
##
|
24
|
+
# The priority of the event (low/normal)
|
25
|
+
attr_accessor :priority
|
26
|
+
|
27
|
+
##
|
28
|
+
# The host that generated the event
|
29
|
+
attr_accessor :host
|
30
|
+
|
31
|
+
##
|
32
|
+
# The tags for this host (should be an array)
|
33
|
+
attr_accessor :tags
|
34
|
+
|
35
|
+
##
|
36
|
+
# The alert_type of the event (error/warning/info/success)
|
37
|
+
attr_accessor :alert_type
|
38
|
+
|
39
|
+
##
|
40
|
+
# The aggregation_key for the event
|
41
|
+
attr_accessor :aggregation_key
|
42
|
+
|
43
|
+
##
|
44
|
+
# The source_type for the event (nagios, hudson, jenkins, user, my apps, feed, chef, puppet, git, bitbucket, fabric, capistrano)
|
45
|
+
attr_accessor :source_type_name
|
46
|
+
|
47
|
+
def initialize(model, &block)
|
48
|
+
super
|
49
|
+
instance_eval(&block) if block_given?
|
50
|
+
@title ||= "Backup #{model.label}"
|
51
|
+
end
|
52
|
+
|
53
|
+
private
|
54
|
+
|
55
|
+
##
|
56
|
+
# Notify the user of the backup operation results.
|
57
|
+
#
|
58
|
+
# `status` indicates one of the following:
|
59
|
+
#
|
60
|
+
# `:success`
|
61
|
+
# : The backup completed successfully.
|
62
|
+
# : Notification will be sent if `on_success` is `true`.
|
63
|
+
#
|
64
|
+
# `:warning`
|
65
|
+
# : The backup completed successfully, but warnings were logged.
|
66
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
67
|
+
#
|
68
|
+
# `:failure`
|
69
|
+
# : The backup operation failed.
|
70
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
71
|
+
#
|
72
|
+
def notify!(status)
|
73
|
+
msg = message.call(model, status: status_data_for(status))
|
74
|
+
|
75
|
+
hash = { alert_type: default_alert_type(status) }
|
76
|
+
hash.store(:msg_title, @title)
|
77
|
+
hash.store(:date_happened, @date_happened) if @date_happened
|
78
|
+
hash.store(:priority, @priority) if @priority
|
79
|
+
hash.store(:host, @host) if @host
|
80
|
+
hash.store(:tags, @tags) if @tags
|
81
|
+
hash.store(:aggregation_key, @aggregation_key) if @aggregation_key
|
82
|
+
hash.store(:source_type_name, @source_type_name) if @source_type_name
|
83
|
+
hash.store(:alert_type, @alert_type) if @alert_type
|
84
|
+
send_event(msg, hash)
|
85
|
+
end
|
86
|
+
|
87
|
+
# Dogapi::Client will raise an error if unsuccessful.
|
88
|
+
def send_event(msg, hash)
|
89
|
+
client = Dogapi::Client.new(@api_key)
|
90
|
+
event = Dogapi::Event.new(msg, hash)
|
91
|
+
client.emit_event(event)
|
92
|
+
end
|
93
|
+
|
94
|
+
# set alert type
|
95
|
+
def default_alert_type(status)
|
96
|
+
case status
|
97
|
+
when :success then "success"
|
98
|
+
when :warning then "warning"
|
99
|
+
when :failure then "error"
|
100
|
+
end
|
101
|
+
end
|
102
|
+
end
|
103
|
+
end
|
104
|
+
end
|
@@ -0,0 +1,99 @@
|
|
1
|
+
require "flowdock"
|
2
|
+
|
3
|
+
module Backup
|
4
|
+
module Notifier
|
5
|
+
class FlowDock < Base
|
6
|
+
##
|
7
|
+
# The Flowdock API token
|
8
|
+
attr_accessor :token
|
9
|
+
|
10
|
+
##
|
11
|
+
# Who the notification should appear from
|
12
|
+
attr_accessor :from_name
|
13
|
+
|
14
|
+
# Which email the notification should appear from
|
15
|
+
attr_accessor :from_email
|
16
|
+
|
17
|
+
##
|
18
|
+
# source for message
|
19
|
+
attr_accessor :source
|
20
|
+
|
21
|
+
##
|
22
|
+
# Subject for message
|
23
|
+
attr_accessor :subject
|
24
|
+
|
25
|
+
##
|
26
|
+
# tag message in inbox
|
27
|
+
attr_accessor :tags
|
28
|
+
|
29
|
+
##
|
30
|
+
# link for message
|
31
|
+
attr_accessor :link
|
32
|
+
|
33
|
+
def initialize(model, &block)
|
34
|
+
super
|
35
|
+
instance_eval(&block) if block_given?
|
36
|
+
|
37
|
+
@subject ||= default_subject
|
38
|
+
@source ||= default_source
|
39
|
+
@tags ||= []
|
40
|
+
end
|
41
|
+
|
42
|
+
private
|
43
|
+
|
44
|
+
##
|
45
|
+
# Notify the user of the backup operation results.
|
46
|
+
#
|
47
|
+
# `status` indicates one of the following:
|
48
|
+
#
|
49
|
+
# `:success`
|
50
|
+
# : The backup completed successfully.
|
51
|
+
# : Notification will be sent if `on_success` is `true`.
|
52
|
+
#
|
53
|
+
# `:warning`
|
54
|
+
# : The backup completed successfully, but warnings were logged.
|
55
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
56
|
+
#
|
57
|
+
# `:failure`
|
58
|
+
# : The backup operation failed.
|
59
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
60
|
+
#
|
61
|
+
def notify!(status)
|
62
|
+
@tags += default_tags(status)
|
63
|
+
send_message(message.call(model, status: status_data_for(status)))
|
64
|
+
end
|
65
|
+
|
66
|
+
# Flowdock::Client will raise an error if unsuccessful.
|
67
|
+
def send_message(msg)
|
68
|
+
client = Flowdock::Flow.new(
|
69
|
+
api_token: token, source: source,
|
70
|
+
from: { name: from_name, address: from_email }
|
71
|
+
)
|
72
|
+
|
73
|
+
client.push_to_team_inbox(subject: subject,
|
74
|
+
content: msg,
|
75
|
+
tags: tags,
|
76
|
+
link: link)
|
77
|
+
end
|
78
|
+
|
79
|
+
# set related tags
|
80
|
+
def default_tags(status)
|
81
|
+
case status
|
82
|
+
when :success then ["#BackupSuccess"]
|
83
|
+
when :warning then ["#BackupWarning"]
|
84
|
+
when :failure then ["#BackupFailure"]
|
85
|
+
end
|
86
|
+
end
|
87
|
+
|
88
|
+
# set default source
|
89
|
+
def default_source
|
90
|
+
"Backup #{model.label}"
|
91
|
+
end
|
92
|
+
|
93
|
+
# set default subject
|
94
|
+
def default_subject
|
95
|
+
"Backup Notification"
|
96
|
+
end
|
97
|
+
end
|
98
|
+
end
|
99
|
+
end
|
@@ -0,0 +1,116 @@
|
|
1
|
+
require "hipchat"
|
2
|
+
|
3
|
+
module Backup
|
4
|
+
module Notifier
|
5
|
+
class Hipchat < Base
|
6
|
+
##
|
7
|
+
# The Hipchat API token
|
8
|
+
attr_accessor :token
|
9
|
+
|
10
|
+
##
|
11
|
+
# The Hipchat API version
|
12
|
+
# Either 'v1' or 'v2' (default is 'v1')
|
13
|
+
attr_accessor :api_version
|
14
|
+
|
15
|
+
##
|
16
|
+
# Who the notification should appear from
|
17
|
+
attr_accessor :from
|
18
|
+
|
19
|
+
##
|
20
|
+
# Custom server URL
|
21
|
+
attr_accessor :server_url
|
22
|
+
|
23
|
+
##
|
24
|
+
# The rooms that should be notified
|
25
|
+
attr_accessor :rooms_notified
|
26
|
+
|
27
|
+
##
|
28
|
+
# Notify users in the room
|
29
|
+
attr_accessor :notify_users
|
30
|
+
|
31
|
+
##
|
32
|
+
# The background color of a success message.
|
33
|
+
# One of :yellow, :red, :green, :purple, or :random. (default: yellow)
|
34
|
+
attr_accessor :success_color
|
35
|
+
|
36
|
+
##
|
37
|
+
# The background color of a warning message.
|
38
|
+
# One of :yellow, :red, :green, :purple, or :random. (default: yellow)
|
39
|
+
attr_accessor :warning_color
|
40
|
+
|
41
|
+
##
|
42
|
+
# The background color of an error message.
|
43
|
+
# One of :yellow, :red, :green, :purple, or :random. (default: yellow)
|
44
|
+
attr_accessor :failure_color
|
45
|
+
|
46
|
+
def initialize(model, &block)
|
47
|
+
super
|
48
|
+
instance_eval(&block) if block_given?
|
49
|
+
|
50
|
+
@notify_users ||= false
|
51
|
+
@rooms_notified ||= []
|
52
|
+
@success_color ||= "yellow"
|
53
|
+
@warning_color ||= "yellow"
|
54
|
+
@failure_color ||= "yellow"
|
55
|
+
@api_version ||= "v1"
|
56
|
+
end
|
57
|
+
|
58
|
+
private
|
59
|
+
|
60
|
+
##
|
61
|
+
# Notify the user of the backup operation results.
|
62
|
+
#
|
63
|
+
# `status` indicates one of the following:
|
64
|
+
#
|
65
|
+
# `:success`
|
66
|
+
# : The backup completed successfully.
|
67
|
+
# : Notification will be sent if `on_success` is `true`.
|
68
|
+
#
|
69
|
+
# `:warning`
|
70
|
+
# : The backup completed successfully, but warnings were logged.
|
71
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
72
|
+
#
|
73
|
+
# `:failure`
|
74
|
+
# : The backup operation failed.
|
75
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
76
|
+
#
|
77
|
+
def notify!(status)
|
78
|
+
status_data = status_data_for(status)
|
79
|
+
msg = message.call(model, status: status_data)
|
80
|
+
send_message(msg, status_data[:color])
|
81
|
+
end
|
82
|
+
|
83
|
+
def client_options
|
84
|
+
{ api_version: @api_version }.tap do |h|
|
85
|
+
h[:server_url] = server_url if server_url
|
86
|
+
end
|
87
|
+
end
|
88
|
+
|
89
|
+
# Hipchat::Client will raise an error if unsuccessful.
|
90
|
+
def send_message(msg, color)
|
91
|
+
client = HipChat::Client.new(token, client_options)
|
92
|
+
rooms_to_notify.each do |room|
|
93
|
+
client[room].send(from, msg, color: color, notify: notify_users)
|
94
|
+
end
|
95
|
+
end
|
96
|
+
|
97
|
+
def rooms_to_notify
|
98
|
+
Array(rooms_notified).map { |r| r.split(",").map(&:strip) }.flatten
|
99
|
+
end
|
100
|
+
|
101
|
+
def status_data_for(status)
|
102
|
+
data = super(status)
|
103
|
+
data[:color] = status_color_for(status)
|
104
|
+
data
|
105
|
+
end
|
106
|
+
|
107
|
+
def status_color_for(status)
|
108
|
+
{
|
109
|
+
success: success_color,
|
110
|
+
warning: warning_color,
|
111
|
+
failure: failure_color
|
112
|
+
}[status]
|
113
|
+
end
|
114
|
+
end
|
115
|
+
end
|
116
|
+
end
|
@@ -0,0 +1,114 @@
|
|
1
|
+
require "uri"
|
2
|
+
|
3
|
+
module Backup
|
4
|
+
module Notifier
|
5
|
+
class HttpPost < Base
|
6
|
+
##
|
7
|
+
# URI to post notification to.
|
8
|
+
#
|
9
|
+
# URI scheme may be `http` or `https`.
|
10
|
+
#
|
11
|
+
# If Basic Authentication is needed, supply the `user:password` in the URI.
|
12
|
+
# e.g. 'https://user:pass@www.example.com/path'
|
13
|
+
#
|
14
|
+
# Port may also be supplied.
|
15
|
+
# e.g. 'http://www.example.com:8080/path'
|
16
|
+
attr_accessor :uri
|
17
|
+
|
18
|
+
##
|
19
|
+
# Hash of additional HTTP headers to send.
|
20
|
+
#
|
21
|
+
# This notifier sets the following headers:
|
22
|
+
# { 'User-Agent' => "Backup/#{ Backup::VERSION }",
|
23
|
+
# 'Content-Type' => 'x-www-form-urlencoded' }
|
24
|
+
#
|
25
|
+
# 'Content-Type' may not be changed.
|
26
|
+
# 'User-Agent' may be overridden or omitted by setting it to +nil+.
|
27
|
+
# e.g. { 'Authorization' => 'my_auth_info', 'User-Agent' => nil }
|
28
|
+
attr_accessor :headers
|
29
|
+
|
30
|
+
##
|
31
|
+
# Hash of additional POST parameters to send.
|
32
|
+
#
|
33
|
+
# This notifier will set two parameters:
|
34
|
+
# { 'status' => 'success|warning|failure',
|
35
|
+
# 'message' => '[Backup::(Success|Warning|Failure)] label (trigger)' }
|
36
|
+
#
|
37
|
+
# 'status' may not be changed.
|
38
|
+
# 'message' may be overridden or omitted by setting a +nil+ value.
|
39
|
+
# e.g. { 'auth_token' => 'my_token', 'message' => nil }
|
40
|
+
attr_accessor :params
|
41
|
+
|
42
|
+
##
|
43
|
+
# Successful HTTP Status Code(s) that should be returned.
|
44
|
+
#
|
45
|
+
# This may be a single code or an Array of acceptable codes.
|
46
|
+
# e.g. [200, 201, 204]
|
47
|
+
#
|
48
|
+
# If any other response code is returned, the request will be retried
|
49
|
+
# using `max_retries` and `retry_waitsec`.
|
50
|
+
#
|
51
|
+
# Default: 200
|
52
|
+
attr_accessor :success_codes
|
53
|
+
|
54
|
+
##
|
55
|
+
# Verify the server's certificate when using SSL.
|
56
|
+
#
|
57
|
+
# This will default to +true+ for most systems.
|
58
|
+
# It may be forced by setting to +true+, or disabled by setting to +false+.
|
59
|
+
attr_accessor :ssl_verify_peer
|
60
|
+
|
61
|
+
##
|
62
|
+
# Path to a +cacert.pem+ file to use for +ssl_verify_peer+.
|
63
|
+
#
|
64
|
+
# This is provided (via Excon), but may be specified if needed.
|
65
|
+
attr_accessor :ssl_ca_file
|
66
|
+
|
67
|
+
def initialize(model, &block)
|
68
|
+
super
|
69
|
+
instance_eval(&block) if block_given?
|
70
|
+
|
71
|
+
@headers ||= {}
|
72
|
+
@params ||= {}
|
73
|
+
@success_codes ||= 200
|
74
|
+
end
|
75
|
+
|
76
|
+
private
|
77
|
+
|
78
|
+
##
|
79
|
+
# Notify the user of the backup operation results.
|
80
|
+
#
|
81
|
+
# `status` indicates one of the following:
|
82
|
+
#
|
83
|
+
# `:success`
|
84
|
+
# : The backup completed successfully.
|
85
|
+
# : Notification will be sent if `on_success` is `true`.
|
86
|
+
#
|
87
|
+
# `:warning`
|
88
|
+
# : The backup completed successfully, but warnings were logged.
|
89
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
90
|
+
#
|
91
|
+
# `:failure`
|
92
|
+
# : The backup operation failed.
|
93
|
+
# : Notification will be sent if `on_warning` or `on_success` is `true`.
|
94
|
+
#
|
95
|
+
def notify!(status)
|
96
|
+
msg = message.call(model, status: status_data_for(status))
|
97
|
+
|
98
|
+
opts = {
|
99
|
+
headers: { "User-Agent" => "Backup/#{VERSION}" }
|
100
|
+
.merge(headers).reject { |_, value| value.nil? }
|
101
|
+
.merge("Content-Type" => "application/x-www-form-urlencoded"),
|
102
|
+
body: URI.encode_www_form({ "message" => msg }
|
103
|
+
.merge(params).reject { |_, value| value.nil? }
|
104
|
+
.merge("status" => status.to_s)),
|
105
|
+
expects: success_codes # raise error if unsuccessful
|
106
|
+
}
|
107
|
+
opts[:ssl_verify_peer] = ssl_verify_peer unless ssl_verify_peer.nil?
|
108
|
+
opts[:ssl_ca_file] = ssl_ca_file if ssl_ca_file
|
109
|
+
|
110
|
+
Excon.post(uri, opts)
|
111
|
+
end
|
112
|
+
end
|
113
|
+
end
|
114
|
+
end
|