terraform-provider-brightbox-old

README

Terraform Provider for Brightbox Cloud

Requirements

• Terraform 0.11.x
• Go 1.10 (to build the provider plugin)
• Dep v0.4.1 (to manage dependencies)

Usage

# For example, restrict brightbox version to 1.x.x
provider "brightbox" {
  version = "~> 1.0"
}

Building The Provider

Clone repository to: $GOPATH/src/github.com/brightbox/terraform-provider-brightbox

$ mkdir -p $GOPATH/src/github.com/brightbox; cd $GOPATH/src/github.com/brightbox
$ git clone git@github.com:brightbox/terraform-provider-brightbox

Enter the provider directory and build the provider

$ cd $GOPATH/src/github.com/brightbox/terraform-provider-brightbox
$ make build

Using the provider

This version supports managing:

• Cloud Servers
• Load Balancers
• Firewall Policies
• Cloud SQL Instances
• Cloud IPs
• Orbit Cloud Storage containers

Documentation

The announcement blog post gives a good overview:

https://www.brightbox.com/blog/2016/05/13/terraforming-brightbox-cloud/

And the getting started guide goes into more detail on how to use it

https://www.brightbox.com/docs/guides/terraform/getting-started/

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.10+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.

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

$ make bin
...
$ $GOPATH/bin/terraform-provider-brightbox
...

In order to test the provider, you can simply run make test.

$ make test

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

Note: Acceptance tests create real resources, and often cost money to run.

$ make testacc