Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/barneyparker/terraform-provider-gd
GoDaddy provider for Terraform
https://github.com/barneyparker/terraform-provider-gd
godaddy godaddy-api godaddy-dns godaddy-dns-records terraform terraform-provider
Last synced: 26 days ago
JSON representation
GoDaddy provider for Terraform
- Host: GitHub
- URL: https://github.com/barneyparker/terraform-provider-gd
- Owner: barneyparker
- Created: 2018-04-02T18:54:26.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-04-08T15:17:09.000Z (over 6 years ago)
- Last Synced: 2024-09-30T12:41:41.776Z (about 1 month ago)
- Topics: godaddy, godaddy-api, godaddy-dns, godaddy-dns-records, terraform, terraform-provider
- Language: Go
- Size: 4.88 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Terraform-Provider-GD
A simple Terraform provider for GoDaddy
Although another provider already exists, I had some trouble making it work. Unfortunately I have no experience of Go, so altering it seemed quite hard!
Instead, I wrote my own from scratch!
It's not good (code-wise) and I am sure there are a million ways to do things a lot better with this, but it does work
## Installation:
### From source
To use, create a symbolic link to `~/.terraform/plugins/terraform-provider-gd`
then add the following to your ~/.terraformrc file (create if necessary)
```
gd = "$HOME/.terraform/plugins/terraform-provider-gd"
```
### Install from GitHub
```
bash <(curl -s https://raw.githubusercontent.com/barneyparker/terraform-provider-gd/master/install.sh)
```
## GoDaddy API
More information about the GoDaddy API & creation of API keys can be found at:
[GoDaddy API](https://developer.godaddy.com/)
## Declaring the Provider
In terraform, declare the provider:
```
provider "gd" {
key = ""
secret = ""
}
```
Alternatively, to keep keys out of your code, declare the provider:
```
provider "gd" {}
```
And set environment variables:
```
export GODADDY_API_KEY=
export GODADDY_API_SECRET=
```
## Creating a DNS Resource
To create a resource, create a `gd_record`:
```
resource "gd_record" "test_record" {
domain = "example.com"
type = "A"
name = "terraform"
data = "8.8.8.8"
priority = 0
ttl = 600
}
```
which will create an `A` record for `terraform.example.com` pointing to `8.8.8.8`
Available record types are:
* `A`
* `AAAA`
* `CNAME`
* `MX`
* `NS`
* `TXT`
`SRV` don't work right now, and `SOA` aren't allowed by the GoDaddy API...
## State of the Project
I have no idea what I am doing! The structure of the provider doesn't match the official providers - although I did initially start by following the Terraform guides...
The project was written in an afternoon, and while I have tried to keep the code relatively clean I was mainly focusing on getting it working rather than a perfect implementation.
There are no tests. I found even getting logs out of Terraform to see what was going on was painful, but it really could do with some tests...
The GoDaddy API can be useless and return incorrect results occasionally. From what I could tell, it's their API at fault. Not a great situation, but hey....
## Collaboration
If you can improve any of the code I would welcome any pull requests. Please do your best to explain the changes - as I mentioned above my Go experience is non-existent so I will be easily confused.