abcdd9ac29
* Adds docker_network data source * Adds documentation for the docker_network data source * Adding basic network data source test |
||
|---|---|---|
| .github | ||
| docker | ||
| examples/ssh-protocol | ||
| scripts | ||
| vendor | ||
| website | ||
| .gitignore | ||
| .go-version | ||
| .travis.yml | ||
| CHANGELOG.md | ||
| GNUmakefile | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| main.go | ||
| README.md | ||
Terraform Provider
- Website: https://www.terraform.io
- Mailing list: Google Groups
Requirements
Building The Provider
Clone repository to: $GOPATH/src/github.com/terraform-providers/terraform-provider-docker
$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers
$ git clone git@github.com:terraform-providers/terraform-provider-docker
Enter the provider directory and build the provider
$ cd $GOPATH/src/github.com/terraform-providers/terraform-provider-docker
$ make build
Using the provider
Fill in for each provider
Developing the Provider
If you wish to work on the provider, you'll first need Go installed on your machine (version 1.11+ 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 build
...
$ $GOPATH/bin/terraform-provider-docker
...
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 a local registry which will be deleted afterwards.
$ make testacc
In order to extend the provider and test it with terraform, build the provider as mentioned above with
$ make build
Remove an explicit version of the provider you develop, because terraform will fetch
the locally built one in $GOPATH/bin
provider "docker" {
# version = "~> 0.1.2"
...
}
Don't forget to run terraform init each time you rebuild the provider. Check here for a more detailed explanation.
You can check the latest released version of a provider at https://releases.hashicorp.com/terraform-provider-docker/.
Developing on Windows
You can build and test on Widows without make. Run go install to
build and Scripts\runAccTests.bat to run the test suite.
Continuous integration for Windows is not available at the moment due to lack of a CI provider that is free for open source projects and supports running Linux containers in Docker for Windows. For example, AppVeyor is free for open source projects and provides Docker on its Windows builds, but only offers Linux containers on Windows as a paid upgrade.