Repository files navigation

Theterraform-provider-envbuilder is a Terraform provider that acts as a helper for setting upenvbuilder environments.

It is used to determine if a pre-built image of a dev container built from a given Git repository is present in a given Docker registry.If it is found that building a particular dev container would produce the same image that is already present in the remote registry, then that image can be used to start the container instead, skipping over the build phase.

Note: currently, this provider can only be run on Linux platforms. We areinvestigating support for other platforms.

Take a look at theenvbuilder_cached_image_resource.tf example for a detailed usage example.

For use withCoder, see theDev Containers documentation and check out the example templates:

• Docker
• Kubernetes
• AWS VM
• GCP VM

• Terraform >= 1.0
• Go >= 1.22

1. Clone the repository
2. Enter the repository directory
3. Build the provider using the Goinstall command:

go install

If you wish to work on the provider, you'll first needGo installed on your machine (seeRequirements above).

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

To generate or update documentation, rungo generate.

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

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

make testacc