Class: Ec2UltraDNSUpdater::UltraDNS

Inherits:
Object
  • Object
show all
Includes:
Preconditions
Defined in:
lib/ec2_ultradns_updater/ultradns.rb

Defined Under Namespace

Modules: TYPE

Constant Summary collapse

ULTRADNS_WSDL_URL =
"http://ultra-api.ultradns.com:8008/UltraDNS_WS/v01?wsdl"
DEFAULT_TTL =
60

Instance Method Summary collapse

Methods included from Preconditions

#precondition, #str_not_empty

Constructor Details

#initialize(opts = {}) ⇒ UltraDNS

Returns a new instance of UltraDNS.



29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 29

def initialize(opts = {})
  @logger = opts[:logger] || Logger.new(STDOUT)
  
  Savon.configure do |config|
    config.logger = @logger
    config.raise_errors = false
  end
  # also configure HTTPI
  HTTPI.logger = @logger

  @username = opts[:username]
  @password = opts[:password]
  @zone = fix_zone_name(opts[:zone] || '')
  
  precondition.str_not_empty(@username)
  precondition.str_not_empty(@password)
  precondition.str_not_empty(@zone)
end

Instance Method Details

#clientObject



198
199
200
201
202
203
204
205
206
207
208
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 198

def client
  soap_username = @username
  soap_password = @password
  
  @client ||= Savon::Client.new do
    wsdl.document = ULTRADNS_WSDL_URL
    wsse.credentials soap_username, soap_password
  end

  @client
end

#create_or_update_a(node_label, to_ip) ⇒ Object



61
62
63
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 61

def create_or_update_a(node_label, to_ip)
  create_or_update_info1(TYPE::A, node_label, to_ip)
end

#create_or_update_cname(cname, to_hostname) ⇒ Object



53
54
55
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 53

def create_or_update_cname(cname, to_hostname)
  create_or_update_info1(TYPE::CNAME, cname, fix_zone_name(to_hostname))
end

#create_or_update_info1(type, label, to_value) ⇒ Object



109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
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
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 109

def create_or_update_info1(type, label, to_value)
  precondition.str_not_empty(label)
  precondition.str_not_empty(to_value)
  
  zone = @zone
  fixed_label = fix_zone_name(label)
  
  guid = get_guid_by_label_and_type(label, type) || ''

  change_method = :create_resource_record
  record_opts = {'Type' => type, 'DName' => fixed_label, 'TTL' => DEFAULT_TTL}

  if guid != ''
    @logger.info "Updating Record Mapping: #{fixed_label} => #{to_value}"
    change_method = :update_resource_record # update it
    record_opts['Guid'] = guid;
  else
    # make sure there isn't another record at this label of a different type
    delete_record_by_label_not_matching_type(label, type)
    @logger.info "Creating Record Mapping: #{fixed_label} => #{to_value}"
    record_opts['ZoneName'] = zone;
  end

  begin
    resp = client.request(change_method) {
      ns = ''
      soap.namespaces.each do |k, v|
        ns = k.gsub(/xmlns:/,'') if v =~ /schema\.ultraservice\.neustar\.com/
      end
      soap.body do |xml|
        xml.transactionID()
        xml.resourceRecord(record_opts) {
          xml.tag!("#{ns}:InfoValues", {"Info1Value" => to_value})
        }
      end
    }
  
    log_error(resp)
    resp.success?
  rescue
    false
  end
end

#delete_record_by_guid(guid) ⇒ Object



72
73
74
75
76
77
78
79
80
81
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 72

def delete_record_by_guid(guid)
  resp = client.request(:delete_resource_record) {
    soap.body do |xml|
      xml.transactionID()
      xml.guid(guid)
    end
  }
  log_error(resp)
  resp.success?
end

#delete_record_by_label(label) ⇒ Object



88
89
90
91
92
93
94
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 88

def delete_record_by_label(label)
  recs = get_records_by_label(label)
  unless recs.nil?
    guid = (recs[:resource_record][:@guid] rescue '') || ''
    delete_record_by_guid(guid) unless guid == ''
  end
end

#delete_record_by_label_not_matching_type(label, type) ⇒ Object



96
97
98
99
100
101
102
103
104
105
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 96

def delete_record_by_label_not_matching_type(label, type)
  recs = get_records_by_label(label)
  unless recs.nil?
    guid = (recs[:resource_record][:@guid] rescue '') || ''
    rec_type = (recs[:resource_record][:@type] rescue '') || ''
    if guid != '' && rec_type != type
      delete_record_by_guid(guid)
    end
  end
end

#fix_zone_name(name) ⇒ Object

..Must end with a '.'



215
216
217
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 215

def fix_zone_name(name)
  (name != nil && name.strip != '' && name[-1] != '.') ? "#{name}." : name
end

#get_a_guid(node_label) ⇒ Object



57
58
59
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 57

def get_a_guid(node_label)
  get_guid_by_label_and_type(node_label, TYPE::A)
end

#get_cname_guid(cname) ⇒ Object



49
50
51
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 49

def get_cname_guid(cname)
  get_guid_by_label_and_type(cname, TYPE::CNAME)
end

#get_guid_by_label_and_type(label, type) ⇒ Object



153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 153

def get_guid_by_label_and_type(label, type)
  zone = @zone
  fixed_label = fix_zone_name(label)

  guids_resp = client.request(:get_resource_record_guid_list) {
    soap.body do |xml|
      xml.resourceRecord({
        "ZoneName" => zone, 'Type' => type, 'DName' => fixed_label
      }) 
    end
  }

  log_error(guids_resp)
  
  begin
    guid = guids_resp[:get_resource_record_guid_list_response][:resource_record_guid_list][:guid]
    @logger.debug("guid found: #{guid}")
  rescue
    @logger.debug("guid not found")
  end
  guid
end

#get_record_by_label_and_type(label, type) ⇒ Object



177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 177

def get_record_by_label_and_type(label, type)
  zone = @zone
  fixed_label = fix_zone_name(label)
  
  begin
    records_resp = client.request('getResourceRecordsOfDNameByType'.snakecase.to_sym) {
      soap.body do |xml|
        xml.zoneName(zone)
        xml.rrType(type)
        xml.hostName(fixed_label)
      end
    }
    log_error(records_resp)  
  
    records_resp.to_hash[:get_resource_records_of_d_name_by_type_response][:resource_record_list]
  rescue
    @logger.debug("Resource Record list is empty")
  end
end

#get_records_by_label(label) ⇒ Object



84
85
86
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 84

def get_records_by_label(label)
  get_record_by_label_and_type(label, TYPE::ALL)
end

#log_error(response) ⇒ Object



210
211
212
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 210

def log_error(response)
  @logger.error {response.to_xml} unless response.success?
end

#network_status?Boolean

Returns:

  • (Boolean)


65
66
67
68
69
70
# File 'lib/ec2_ultradns_updater/ultradns.rb', line 65

def network_status?    
  resp = client.request(:get_neustar_network_status) 
  @logger.debug(resp)
  log_error(resp)
  resp.success?
end