No description
  • Go 91.5%
  • Shell 3.3%
  • Makefile 2.9%
  • HTML 2.3%
Find a file
Tony Li c9213b96af
Merge pull request #100 from terraform-providers/data_source_stackdriver
resource/data_source: add support for stackdriver privatekey
2020-06-10 01:49:36 -07:00
.github Make CoC and support channels more visible 2017-11-01 23:05:11 +01:00
grafana add private key field 2020-06-10 02:03:23 -04:00
scripts Fix Changelog Links Script for grafana provider 2017-06-26 09:51:00 -05:00
vendor Update resource grafana_data_source (#90) 2020-06-01 20:45:27 -07:00
website add private key field 2020-06-10 02:03:23 -04:00
.gitignore Updating Makefile + Add gitignore 2017-06-06 16:27:32 -04:00
.go-version Fix build, use -mod=readonly (#98) 2020-06-09 18:43:55 -07:00
.travis.yml Fix build, use -mod=readonly (#98) 2020-06-09 18:43:55 -07:00
CHANGELOG.md prep for v1.6.0 2020-06-04 22:21:23 -07:00
GNUmakefile deps: use go modules for dep mgmt 2019-01-08 16:13:27 -05:00
go.mod Fix build, use -mod=readonly (#98) 2020-06-09 18:43:55 -07:00
go.sum bump nytm/go-grafana-api to v0.5.0 2020-06-03 10:56:07 -04:00
LICENSE initial commit 2017-06-05 20:54:06 +00:00
main.go Initial transfer of provider code 2017-06-06 12:00:14 -04:00
README.md provider: Require Go 1.11 in TravisCI and README 2019-01-07 17:04:51 -05:00

Terraform Provider

Requirements

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

Building The Provider

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

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

Enter the provider directory and build the provider

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

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.11+ 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-grafana
...

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. This should be performed before merging or opening pull requests.

$ GRAFANA_URL=http://localhost:3000 GRAFANA_AUTH=admin:admin make testacc

This requires a running Grafana server locally. This provider targets the latest version of Grafana, but older versions should be compatible where possible. In some cases, older versions of this provider will work with older versions of Grafana.

If you have Docker installed, you can run Grafana with the following command:

$ make test-serv

By default, this will use the latest version of Grafana based on their Docker repository. You can specify the version with the following:

$ GRAFANA_VERSION=3.1.1 make test-serv

This command will run attached and will stop the Grafana server when interrupted. Images will be cached locally by Docker so it is quicky to restart the server as necessary. The server will use the default port and credentials for the GRAFANA_AUTH and GRAFANA_URL environment variables.

Nightly acceptance tests are run against the latest tag of the Grafana maintained Docker image.