An Akamai GTM Terraform provider
Go HCL Makefile
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin/terraform-provider-akamai
vendor
.gitignore
.travis.yml
CONTRIBUTING.md
LICENSE
Makefile
NOTICE
README.md
config.go
example.tf
provider.go
provider_test.go
resource_gtm_data_center.go
resource_gtm_data_center_test.go
resource_gtm_domain.go
resource_gtm_domain_test.go
resource_gtm_property.go
resource_gtm_property_test.go
util.go

README.md

Build Status

terraform-provider-akamai

An Akamai provider for HashiCorp Terraform.

Installation

  1. Download the desired release version for your operating system
  2. Untar the download contents
  3. Install the terraform-provider-akamai anywhere on your system
  4. Add terraform-provider-akamai to your ~/.terraformrc file:
providers {
  "akamai" = "path/to/your/terraform-provider-akamai"
}

Install from source

If you'd prefer to install from source:

  1. Add terraform-provider-akamai to your ~/.terraformrc file:
providers {
  "akamai" = "$GOPATH/bin/terraform-provider-akamai"
}
  1. Install terraform-provider-akamai:
git clone git@github.com:Comcast/terraform-provider-akamai.git
cd terraform-provider-akamai
make

Environment

Note that terraform-provider-akamai assumes the following Akamai credentials stored as environment variables:

export AKAMAI_EDGEGRID_HOST=https://some-host.luna.akamaiapis.net
export AKAMAI_EDGEGRID_ACCESS_TOKEN=some-access-token
export AKAMAI_EDGEGRID_CLIENT_TOKEN=some-client-token
export AKAMAI_EDGEGRID_CLIENT_SECRET=some-client-secret

Usage

See example.tf as a usage reference.

WARNING!

When using terraform-provider-akamai against an existing Akamai GTM domain with existing Akamai GTM properties, Terraform will destroy all existing Akamai GTM properties associated with the resource "akamai_gtm_domain" cited in your .tf file. If undesired, this destructive action can be avoided by omitting usage of the resource "akamai_gtm_domain" in your .tf file.

Acceptance Tests

Acceptance tests require Akamai credentials authorized to perform CRUD actions against the golangtest.akadns.net GTM domain.

Establish the required AKAMAI_EDGEGRID_* environment variables and execute the tests:

make test

Releasing new versons

terraform-provider-akamai releases are automatically published to GitHub via TravisCI each time a new git tag is pushed to GitHub.

To publish a new terraform-provider-akamai release from your git repository's HEAD...

  1. establish a GITHUB_TOKEN env variable: export GITHUB_TOKEN=YOUR_ACCESS_TOKEN
  2. edit Makefile's VERSION variable to the appropriate semantic version
  3. execute make release