README.md

Akamai Provider for Terraform

Maintainers

This provider plugin is maintained by the Akamai Developer team at Akamai.

Requirements

• Terraform 0.11.x
• Go 1.9.x

Provider Configuration

The configuration for this provider requires the location of an .edgerc credentials file, and a section name for each service to be used:

provider "akamai" {
  edgerc = "~/.edgerc"
  papi_section = "papi"
  fastdns_section = "dns"
}

Resources

The Akamai provider adds three resources, akamai_cp_code, akamai_fastdns_zone and akamai_property.

akamai_cp_code

This resource is used to configure Akamai Content Provider Codes.

resource "akamai_cp_code" "example" {
  contract_id = "ctr_XXX"
  group_id    = "grp_XXX"
  name        = "example-XXX"
  product_id  = "prd_XXX"
}

A more complete example configuration can be found here.

akamai_fastdns_zone

This resource is used to configure DNS records hosted by Akamai's FastDNS.

resource "akamai_fastdns_zone" "test_zone" {
  hostname = "example.com"

  a {
    name = "www"
    ttl = 600
    active = true
    target = "5.6.7.8"
  }

  cname {
    name = "blog"
    ttl = 600
    active = true
    target = "example.com."
  }
}

An more complete example configuration can be found here.

akamai_property

This resource represents a property (web site) configuration hosted on the Akamai platform.

resource "akamai_property" "dshafik_sandbox" {
	name = "dshafik.sandbox.akamaideveloper.com"
	account_id = "act_####"
	product_id = "prd_SPM"
	cp_code = "######"
	contact = ["[email protected]"]
	hostname = ["dshafik.sandbox.akamaideveloper.com"]

	rules {
		rule {
			name = "l10n"
			comment = "Localize the default timezone"

			criteria {
				name = "path"

				option {
					key = "matchOperator"
					value = "MATCHES_ONE_OF"
				}

				option {
					key = "matchCaseSensitive"
					value = "true"
				}

				option {
					key = "values"
					values = ["/"]
				}
			}

			behavior {
				name = "rewriteUrl"

				option {
					key = "behavior"
					value = "REWRITE"
				}

				option {
					key = "targetUrl"
					value = "/America/Los_Angeles"
				}
			}
		}
	}
}

A more complete example configuration can be found here

Building The Provider

Clone source to $GOPATH.

$ mkdir -p $GOPATH/src/github.com/akamai
$ cd $GOPATH/src/github.com/akamai
$ git clone [email protected]:akamai/terraform-provider-akamai

Change to source directory, install vendor dependencies, and build provider.

$ cd $GOPATH/src/github.com/akamai/terraform-provider-akamai
$ make dep-install
$ make build

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.9+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.

To compile the provider, run make build. This will build the provider and put the provider binary in the $GOPATH/bin directory.

$ make build
...
$ $GOPATH/bin/terraform-provider-akamai
...

In order to test the provider, you can simply run make test.

$ make test

In order to run the full suite of Acceptance tests, run make testacc.

Note: Acceptance tests create real resources, and often cost money to run.

$ make testacc