Awesome
terraform-provider-godaddy
Terraform plugin for managing domain records
<dl> <dt>Terraform v1.3.0</dt> <dd>https://github.com/n3integration/terraform-provider-godaddy/releases/tag/v1.9.0</dd> <dt>Terraform v0.14.x</dt> <dd>https://github.com/n3integration/terraform-provider-godaddy/releases/tag/v1.8.7</dd> <dt>Terraform v0.12.x</dt> <dd>https://github.com/n3integration/terraform-provider-godaddy/releases/tag/v1.7.3</dd> <dt>Terraform v0.11.x</dt> <dd>https://github.com/n3integration/terraform-provider-godaddy/releases/tag/v1.6.4</dd> <dt>Terraform v0.10.x</dt> <dd>https://github.com/n3integration/terraform-provider-godaddy/releases/tag/v1.5.0</dd> <dt>Terraform v0.9.x</dt> <dd>https://github.com/n3integration/terraform-provider-godaddy/releases/tag/v1.3.0</dd> <dt>Terraform v0.8.x</dt> <dd>https://github.com/n3integration/terraform-provider-godaddy/releases/tag/v1.2.3</dd> <dt>Terraform v0.7.x</dt> <dd>https://github.com/n3integration/terraform-provider-godaddy/releases/tag/v1.0.0</dd> </dl>Installation steps for Terraform Cloud
- Download the latest
linux_amd64
release from https://github.com/n3integration/terraform-provider-godaddy/releases - Unpack to
<project folder>/terraform.d/plugins/linux_amd64
. - Rename to match naming scheme:
terraform-provider-<NAME>_vX.Y.Z
https://www.terraform.io/docs/configuration/providers.html#third-party-plugins - Run
terraform init
to make sure the provider is initialized properly.
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 GODADDY_API_KEY=abc
export GODADDY_API_SECRET=123
Provider
If key
and secret
aren't provided under the godaddy
provider
, they are expected to be exposed as environment variables: GODADDY_API_KEY
and GODADDY_API_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. MX
records can optionally specify priority
or will default to 0
. 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
- CAA
- CNAME
- MX
- NS
- SOA
- SRV
- TXT
resource "godaddy_domain_record" "gd-fancy-domain" {
domain = "fancy-domain.com"
// required if provider key does not belong to customer
customer = "1234"
// specify zero or more record blocks
// a record block allows you to configure A, or NS records with a custom time-to-live value
// a record block also allow you to configure AAAA, CNAME, TXT, or MX records
record {
name = "www"
type = "CNAME"
data = "fancy.github.io"
ttl = 3600
}
record {
name = "@"
type = "MX"
data = "aspmx.l.google.com."
ttl = 600
priority = 1
}
record {
name = "@"
type = "SRV"
data = "host.example.com"
ttl = 3600
service = "_ldap"
protocol = "_tcp"
port = 389
}
// specify any A records associated with the domain
addresses = ["192.168.1.2", "192.168.1.3"]
// specify any custom nameservers for your domain
// note: godaddy now requires that the 'custom' nameservers are first supplied through the ui
nameservers = ["ns7.domains.com", "ns6.domains.com"]
}
Building for Linux
make linux
Additional Information
If your zone contains existing data, please ensure that your Terraform resource configuration includes all existing records, otherwise they will be removed.
This plugin also supports Terraform's import feature. This will at least allow you to determine the changes introduced
through terraform plan
and update the resource configuration accordingly to preserve existing data. The supplied resource id
to the terraform import
command should
be the name of the domain that you would like to import. Although this is currently a manual workaround, this plugin will be updated when Terraform includes support for
fully automated imports.
Import Example
terraform import godaddy_domain_record.gd-fancy-domain fancy-domain.com
License
Copyright 2023 n3integration@gmail.com
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.