This document describes how to build and use the docker terraform provider.
This provider lets you fetch information about docker images from a docker registry without
requiring a local docker daemon
Example usage
terraform {
required_providers {
docker = "~> 1.0"
}
}
provider "docker" {
registry = "index.docker.io"
username = ""
password = ""
}
data "docker_registry_image" "debian" {
name = "library/debian"
tag = "latest"
}
How to build
To build an test the plugin locally first create a ~/.terraformrc
file
provider_installation {
dev_overrides {
"habakke/docker" = "/Users/habakke/.terraform.d/plugins"
}
direct {}
}
Then build and install the plugin locally using
make install
Running tests
To run the internal unit tests run test test
make target
make test
To run terraform acceptance tests, the TF_ACC
env variable must be set to true before making the
test
make target, or the testacc
make target can be used
make testacc
TODO