terraform-provider-luis

README

Terraform Provider

Maintainers

This is an unoffical provider plugin, regular improvements or support will be attempted but no guarantees!

Please let Microsoft know there is demand for a Luis Terraform Provider by voting for this idea on UserVoice https://cognitive.uservoice.com/forums/551524-language-understanding-luis/suggestions/39795295-terraform-provider-for-authoring

Requirements

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

Usage

# For example, restrict template version in 0.1.x
provider "luis" {
  version = "~> 0.1"
}

Building The Provider

Clone repository to: $GOPATH/src/github.com/crazedpeanut/terraform-provider-luis

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

Enter the provider directory and build the provider

$ cd $GOPATH/src/github.com/crazedpeanut/terraform-provider-luis
$ make build

Using the provider

resource "luis_application" "main" {
  name    = "main"
  culture = "en-us"
}

resource "luis_version" "main" {
  app_id     = luis_application.main.id
  version_id = "0.0.2"
  content    = [This can be either LuDown or JSON representation of the luis version]
  trained    = true
  published  = true
}

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 build
...
$ $GOPATH/bin/terraform-provider-luis
...

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