terraform-provider-asana

README

Terraform Provider Asana

This resource is used to configure resources supported by the Asana API.

Requirements

• Terraform v0.12.x+
• Go 1.14 (to build the provider plugin)

Usage

provider "asana" {
  version = "~> 0.1.0"
}

This provider is not compatible with terraform v0.11.x.

Development

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.14+ is required).

Build the Provider

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-asana
...

Using the Provider

To use the dev provider with local Terraform, copy the freshly built plugin into Terraform's local plugins directory:

cp $GOPATH/bin/terraform-provider-asana ~/.terraform.d/plugins/

Set the asana provider without a version constraint:

provider "asana" {}

Then, initialize Terraform:

terraform init

Testing

Please see the TESTING guide for detailed instructions on running tests.

Updating or adding dependencies

This project uses Go Modules for dependency management.

This example will fetch a module at the release tag and record it in your project's go.mod and go.sum files. It's a good idea to run go mod tidy afterward and then go mod vendor to copy the dependencies into a vendor/ directory.

If a module does not have release tags, then module@SHA can be used instead.