tthelper

A helper library for Gruntwork's Terratest, specifically for Terraform unit-tests on Azure.

Installation

go get github.com/darkraiden/tthelper

Usage

Here is an example of how to use the library in a test:

package main

import (
    "testing"

    "github.com/darkraiden/tthelper"
    "github.com/gruntwork-io/terratest/modules/terraform"
)

func TestTerraform(t *testing.T) {
    tt := tthelper.New(t)
    terraformOptions := tt.TerraformOptions("./fixture", nil, ..."./variables.tfvars")

    defer terraform.Destroy(t, terraformOptions)
    terraform.InitAndApply(t, terraformOptions)
}

Environment Variables

The library requires two environment variables to be set:

• TEST_AZURE_SUBSCRIPTION_ID
• TEST_AZURE_TENANT_ID

API Reference

func New

func New(t *testing.T) *Terratest

New creates a new instance of Terratest by checking if the required environment variables, TEST_AZURE_SUBSCRIPTION_ID and TEST_AZURE_TENANT_ID, are set. If either of these are missing, the function will call t.Fatal with an error message. Otherwise, it will return a new instance of Terratest with the values of the environment variables set as the SubscriptionID and TenantID fields.

func (tt *Terratest) TerraformOptions

func (tt *Terratest) TerraformOptions(fixtureFolder string, vars map[string]interface{}, varFiles ...string) *terraform.Options

TerraformOptions returns a pointer to a Terraform Options struct configured with the specified fixture folder, variables, and variable files. If the input fixtureFolder is an empty string, it defaults to "./fixture". If the input vars map is nil, it initializes an empty map. The values for the keys "subscription_id" and "tenant_id" are added to the vars map based on the values stored in the Terratest struct.

Author

Davide Di Mauro

License

MIT