Class: EC2Launcher::Route53

Inherits:
Object
  • Object
show all
Defined in:
lib/ec2launcher/route53.rb

Instance Method Summary collapse

Constructor Details

#initialize(route53, hosted_zone_id, logger = nil) ⇒ Route53

Returns a new instance of Route53.

Parameters:

  • route53 (AWS::Route53) —

    Initialized Route53 object

  • hosted_zone_id (String) —

    Zone ID

  • (Log4r::Logger) 


25
26
27
28
29
30
 
# File 'lib/ec2launcher/route53.rb', line 25

def initialize(route53, hosted_zone_id, logger = nil)
  @log = logger

  @route53 = route53
  @hosted_zone_id = hosted_zone_id
end

Instance Method Details

#create_record(name, value, type = "A", ttl = 300) ⇒ Object

Creates a new DNS record in Route53. Deletes any existing record with the same name and record type.

Parameters:

  • name (String) —

    Name of the record

  • value (String) —

    Value for the DNS record

  • type (String) (defaults to: "A") —

    Type of DNS record: A, CNAME, etc. Defaults to ‘A’.

  • ttl (Integer) (defaults to: 300) —

    TTL in seconds. Defaults to 300.



39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/ec2launcher/route53.rb', line 39

def create_record(name, value, type = "A", ttl = 300)
  # Delete existing record because you can't update records
  delete_record_by_name(name, type, false)

  # Create new record
  begin
    @route53.client.change_resource_record_sets({
      :hosted_zone_id => @hosted_zone_id, 
      :change_batch => {
        :changes => [ 
          {
            :action => "CREATE", 
            :resource_record_set => { 
              :name => name, 
              :type => type,
              :ttl => ttl, 
              :resource_records => [ { :value => value } ]
            }
          }
        ]
      }
    })
  rescue StandardError => bang
    @log.error "Error creating A record from Route53: #{bang}"
  end
end

#delete_record(name, type, ttl, value, log_errors = true) ⇒ Object

Deletes a DNS record from Route53.

Parameters:

  • name (String) —

    Name of the record

  • type (String) —

    Type of DNS record: A, CNAME, etc.

  • ttl (Integer) —

    TTL in seconds

  • value (String) —

    Value for the DNS record

  • log_errors (Boolean) (defaults to: true) —

    Log errors or not. False quietly ignores errors.



93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
 
# File 'lib/ec2launcher/route53.rb', line 93

def delete_record(name, type, ttl, value, log_errors = true)
  delete_result = true
  begin
    @route53.client.change_resource_record_sets({
      :hosted_zone_id => @hosted_zone_id, 
      :change_batch => {
        :changes => [ 
          {
            :action => "DELETE", 
            :resource_record_set => { 
              :name => name, 
              :type => type,
              :ttl => ttl, 
              :resource_records => [ { :value => value } ]
            }
          }
        ]
      }
    })
  rescue StandardError => bang
    @log.error "Error deleting A record from Route53: #{bang}" if log_errors
    delete_result = false
  end
  delete_result
end

#delete_record_by_name(hostname, record_type = "A", log_errors = true) ⇒ Object

Deletes a record by hostname, if it exists.

Parameters:

  • hostname (String) —

    Name of the record

  • record_type (String) (defaults to: "A") —

    Type of DNS record: A, CNAME, etc.

  • log_errors (Boolean) (defaults to: true) —

    Log errors or not. False quietly ignores errors.



72
73
74
75
76
77
78
79
80
81
82
83
 
# File 'lib/ec2launcher/route53.rb', line 72

def delete_record_by_name(hostname, record_type = "A", log_errors = true)
  # Search for the record
  delete_result = true
  record = find_record(hostname, record_type)
  if record
    delete_record(record.name, record.type, record.ttl, record.value, log_errors)
  else
    delete_result = false
    @log.warn "Route53 '#{record_type}' record for '#{hostname}' not found!" if log_errors
  end
  delete_result
end

#find_record(name, type = 'A') ⇒ EC2Launcher::Route53Record

Searches for a record with the specified name and type.

required information about a Route53 entry or nil if not found.

Parameters:

  • name (String) —

    Name of the record

  • type (String) (defaults to: 'A') —

    Type of DNS record: A, CNAME, etc.

Returns:



126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
 
# File 'lib/ec2launcher/route53.rb', line 126

def find_record(name, type = 'A')
  # Find the record
  response = @route53.client.list_resource_record_sets({
    :hosted_zone_id => @hosted_zone_id,
    :start_record_name => name,
    :start_record_type => type,
    :max_items => 1
  })

  record = nil
  if response && response.data
    if response.data[:resource_record_sets] && response.data[:resource_record_sets].size > 0
      response_record = response.data[:resource_record_sets][0]
      if (response_record[:name] == name || response_record[:name] == "#{name}.") && response_record[:type] == type
        record = Route53Record.new(response_record[:name], response_record[:type], response_record[:ttl], response_record[:resource_records][0][:value])
      end
    end
  end

  record
end