README.md

ALZLib Terraform Provider

This provider is built on the Terraform Plugin Framework.

The ALZLib provider uses the ALZLib library to provide ALZ archetype data resources to Terraform.

The data sources resources that it produces are complex objects, with nested maps. This output is designed to be used with a Terraform module that will process this data to deploy resources.

Requirements

• Terraform >= 1.x
• Go >= 1.18

Building The Provider

1. Clone the repository
2. Enter the repository directory
3. Build the provider using the Go install command:

go install

Using the provider

provider "alzlib" {
  source = "matt-FFFFFF/alzlib"
  version = "0.1.0"
  directory = "./path/to/alzlib/directory"
}

data "alzlib_archetypes" "prod" {}

output "archetypes" {
  value = data.alzlib_archetypes.prod.archetypes
}

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (see Requirements above).

To compile the provider, run go install. This will build the provider and put the provider binary in the $GOPATH/bin directory.

To generate or update documentation, run go generate.

In order to run the full suite of Acceptance tests, run make testacc.

make testacc