Class: RecordStore::Provider

Inherits:
Object
  • Object
show all
Defined in:
lib/record_store/provider.rb

Direct Known Subclasses

DNSimple, DynECT, GoogleCloudDNS, NS1, OracleCloudDNS

Defined Under Namespace

Classes: DNSimple, DynECT, GoogleCloudDNS, NS1, OracleCloudDNS

Class Method Summary collapse

Class Method Details

.apply_changeset(changeset, stdout = $stdout) ⇒ Object

Applies changeset to provider



69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/record_store/provider.rb', line 69

def apply_changeset(changeset, stdout = $stdout)
  changeset.changes.each do |change|
    case change.type
    when :removal
      stdout.puts "Removing #{change.record}..."
      remove(change.record, changeset.zone)
    when :addition
      stdout.puts "Creating #{change.record}..."
      add(change.record, changeset.zone)
    when :update
      stdout.puts "Updating record with ID #{change.id} to #{change.record}..."
      update(change.id, change.record, changeset.zone)
    else
      raise ArgumentError, "Unknown change type #{change.type.inspect}"
    end
  end
end

.build_zone(zone_name:, config:) ⇒ Object 



55
56
57
58
59
60
61
 
# File 'lib/record_store/provider.rb', line 55

def build_zone(zone_name:, config:)
  zone = Zone.new(name: zone_name)
  zone.records = retrieve_current_records(zone: zone_name)
  zone.config = config

  zone
end

.freezable? ⇒ Boolean

Returns:

  • (Boolean) 


104
105
106
 
# File 'lib/record_store/provider.rb', line 104

def freezable?
  respond_to?(:freeze_zone)
end

.provider_for(object) ⇒ Object 



6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
 
# File 'lib/record_store/provider.rb', line 6

def provider_for(object)
  ns_server =
    case object
    when Record::NS
      object.nsdname.chomp('.')
    else
      begin
        master_nameserver_for(object)
      rescue Resolv::ResolvError
        $stderr.puts "Domain doesn't exist (#{object})"
        return
      end
    end

  case ns_server
  when /\.dnsimple\.com\z/
    'DNSimple'
  when /\.dynect\.net\z/
    'DynECT'
  when /\.googledomains\.com\z/
    'GoogleCloudDNS'
  when /\.nsone\.net\z/,
       /\.ns1global\.net\z/,
       /\.ns1global\.org\z/
    'NS1'
  when /\.oraclecloud\.net\z/
    'OracleCloudDNS'
  end
end

.record_types ⇒ Object 



36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/record_store/provider.rb', line 36

def record_types
  Set.new([
    'A',
    'AAAA',
    'ALIAS',
    'CAA',
    'CNAME',
    'MX',
    'NS',
    'SPF',
    'SRV',
    'TXT',
  ])
end

.retrieve_current_records(zone:, stdout: $stdout) ⇒ Object

returns an array of Record objects that match the records which exist in the provider

Raises:

  • (NotImplementedError) 


64
65
66
 
# File 'lib/record_store/provider.rb', line 64

def retrieve_current_records(zone:, stdout: $stdout)
  raise NotImplementedError
end

.secrets ⇒ Object 



92
93
94
95
96
97
98
 
# File 'lib/record_store/provider.rb', line 92

def secrets
  @secrets ||= if File.exist?(RecordStore.secrets_path)
    JSON.parse(File.read(RecordStore.secrets_path))
  else
    raise "You don't have a secrets.json file set up!"
  end
end

.supports_alias? ⇒ Boolean

Returns:

  • (Boolean) 


51
52
53
 
# File 'lib/record_store/provider.rb', line 51

def supports_alias?
  false
end

.thawable? ⇒ Boolean

Returns:

  • (Boolean) 


100
101
102
 
# File 'lib/record_store/provider.rb', line 100

def thawable?
  respond_to?(:thaw_zone)
end

.to_s ⇒ Object 



108
109
110
 
# File 'lib/record_store/provider.rb', line 108

def to_s
  name.demodulize
end

.zones ⇒ Object

Returns an array of the zones managed by provider as strings

Raises:

  • (NotImplementedError) 


88
89
90
 
# File 'lib/record_store/provider.rb', line 88

def zones
  raise NotImplementedError
end