terratalk 0.2.2

A Terraform commentator.

terratalk

Terratalk is a simple tool to add an opinionated terraform plan output into your pull-request as a comment. This allows you to have a quick feedback on infrastructure changes without having to leave the context of your pull-request view.

Setup

Prerequisite

This tool relies on either Bitbucket Branch Source or GitHub Branch Source to be installed as a plugin on your Jenkins. Alternatively you can set the environment variable CHANGE_URL to the URL of the pull-request which will allow terratalk to construct the proper API request to your SCM.

Installation

On the build agent, install terratalk:

$ sudo -H pip install terratalk

If you are using GitHub you will additionally need to install the following:

$ sudo -H pip install PyGithub

Running

Execute in the same directory, optionally with the same TF_DATA_DIR as you would normally run terraform. If you use tfenv that will work as well.

$ terraform plan -out WORKSPACE.plan
$ terratalk comment -w WORKSPACE

Supported environment variables

Bitbucket

• STASH_USER
• STASH_PASS

GitHub

• GITHUB_TOKEN

Results

License

MIT