terraform-godaddy

Terraform plugin for managing domain records

Terraform v0.7.x

https://github.com/n3integration/terraform-godaddy/releases/tag/v1.0.0

Terraform v0.8.x

https://github.com/n3integration/terraform-godaddy/releases/tag/v1.2.3

Terraform v0.9.x

https://github.com/n3integration/terraform-godaddy/releases/tag/v1.3.0

Installation

bash <(curl -s https://raw.githubusercontent.com/n3integration/terraform-godaddy/master/install.sh)

API Key

In order to leverage the GoDaddy APIs, an API key is required. The key pair can be optionally stored in environment variables.

export GD_KEY=abc
export GD_SECRET=123

Provider

If key and secret aren't provided under the godaddy provider, they are expected to be exposed as environment variables: GD_KEY and GD_SECRET.

provider "godaddy" {
  key = "abc"
  secret = "123"
}

Domain Record Resource

A godaddy_domain_record resource requires a domain. If the domain is not registered under the account that owns the key, an optional customer number can be specified. Additionally, one or more record instances are required. For each record, the name, type, and data attributes are required. Address and NameServer records can be defined using shorthand-notation as addresses = [""] or nameservers = [""], respectively unless you need to override the default time-to-live (3600). The available record types include:

• A
• AAAA
• CNAME
• NS
• SOA
• TXT

resource "godaddy_domain_record" "gd-fancy-domain" {
  domain   = "fancy-domain.com"
  customer = "1234"                         // required if provider key does not belong to customer

  record {
    name = "www"
    type = "CNAME"
    data = "fancy.github.io"
    ttl = 3600
  }

  addresses   = ["192.168.1.2", "192.168.1.3"]
  nameservers = ["ns7.domains.com", "ns6.domains.com"]
}

License

Copyright 2017 [email protected]

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.