terrable

README

Terrable

Terrable ~ Terraform ~ Ansible

This project is a terraform provider for on-host configuration management powered by Terraform.

Rationale

Terraform already provides a configuration language and state management. This project is an experiment in on-host configuration.

Ansible is slow for our use case, even when running locally or using an alternative strategy plugin. This project is not intended as a replacement to Ansible, or as a mechanism to converge remote hosts, rather an experiment with our specific use cases.

Requirements

• Terraform 0.13.x
• Go 1.15

Usage

## A "local" system provider to manage local resources
provider "terrable" {}

resource "terrable_user" "tomcat" {
    name   = "tomcat_user"
    groups = ["myapp"]
}

Developing

Dependencies for building from source

If you need to build from source, you should have a working Go environment setup. If not check out the Go getting started guide.

This project uses Go Modules for dependency management. To fetch all dependencies run make mod inside this repository.

Build

make build

The binary will then be available at build/$(GOOS)_$(GOARCH)/$(PLUGIN_NAME)_v$(VERSION)

Install

make install

This will place the binary under $(HOME)/.terraform.d/plugins/$(HOSTNAME)/$(USER)/$(NAME)/$(VERSION)/$(GOOS)_$(GOARCH). After installing you will need to run terraform init in any project using the plugin.

License

MIT