Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/davidji99/terraform-provider-asana

Terraform Asana Provider
https://github.com/davidji99/terraform-provider-asana

asana asana-api asana-go terraform-provider-asana

Last synced: 26 days ago
JSON representation

Terraform Asana Provider

Awesome Lists containing this project

README

        

Terraform Provider Asana
=========================

This resource is used to configure resources supported by the [Asana API](https://developers.asana.com/docs).

Requirements
------------

- [Terraform](https://www.terraform.io/downloads.html) `v0.12.x`+
- [Go](https://golang.org/doc/install) 1.14 (to build the provider plugin)

Usage
-----

```hcl
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](http://www.golang.org) 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.

```shell script
$ 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:

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

Set the asana provider without a version constraint:

```hcl
provider "asana" {}
```

Then, initialize Terraform:

```shell script
terraform init
```

### Testing

Please see the [TESTING](TESTING.md) guide for detailed instructions on running tests.

### Updating or adding dependencies

This project uses [Go Modules](https://github.com/golang/go/wiki/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.