terraform-provider-googlecli

README

terraform-provider-googlecli

This provider exposes resources that are available through google provided CLIs. These clis are wrapped for one of two reasons:

1. there is no go operational API to hit
2. expediency

The contents of this provider will change over time as google services stablize and become available in the upstream google provider.

Current Version

Terraform are not easy to work with in terms of plugins. Currently their plugin API is version 4. This plugin has jumped from 2 to 4. There are breaking changes in between terraform version, up and down. This plugin can only be run with these specifics in mind:

• terraform version 0.8.8
• gcloud version 146.0.0
• go version 1.8

CI Deployment

With dep as the package manager we can create vendor on deploy instead of carrying it around with us in the repo. CircleCI caching will alleviate some of the download time. Dep allows us to slim the repo considerably by removing the vendor and creating it on deploy.

Dep is in alpha but works currently, it will be the official dependency manager for go, so integrating with that early.

To use:

• check out
• run tests
  • add several variables to your environment:
    • TF_ACC (set to anything)
    • GOOGLE_CREDENTIALS, set to the contents of a secrets file downloaded from google
    • GOOGLE_PROJECT, set to the project for the above credentials
    • GOOGLE_REGION, set to us-central1
  • execute tests using makefile
    • make tests TESTARGS=<args to pass to 'go test'>
    • ex to only run dataflow tests "make test TESTARGS='--run=Dataflow'"
• install binary to $GOBIN to make it usable system wide (assumes GOBIN is in your PATH)
  • make install
• edit terraform.rc (see terraform docs here: https://terraform.io/docs/plugins/basics.html) to have the following block: providers { googlecli = "terraform-provider-googlecli" }
• build and copy file to terraform install
  • locate terraform install
  • go build -o TERRAFORM_INSTALL_LOCATION