/terraform-provider-newrelic

Terraform New Relic provider

Primary LanguageGoMozilla Public License 2.0MPL-2.0

Terraform Provider

Requirements

  • Terraform 0.10.x
  • Go 1.8 (to build the provider plugin)

Building The Provider

Clone repository to: $GOPATH/src/github.com/terraform-providers/terraform-provider-newrelic

$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers
$ git clone git@github.com:terraform-providers/terraform-provider-newrelic.git

Enter the provider directory and build the provider

$ cd $GOPATH/src/github.com/terraform-providers/terraform-provider-newrelic
$ make build

Using the provider

TODO: Fill in for each provider

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.8+ 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 bin
...
$ $GOPATH/bin/terraform-provider-newrelic
...

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

Updating Vendor Packages

This repository uses the govendor tool to manage dependencies found in the vendor folder. These dependencies are indexed in the vendor/vendor.json file.

To update a dependency:

  1. Ensure you have govendor installed: go get -u github.com/kardianos/govendor
  2. CD to the root of this repo (not into the vendor directory)
  3. Run govendor fetch PATH/FOR/PACKAGE where PATH/FOR/PACKAGE is the path property in vendor.json of the package you wish to update. Ex. go get github.com/paultyng/go-newrelic/api