Terraform provider for Coder.
We recommend using nix to manage your development environment. If you have nix installed, you can run nix develop to enter a shell with all the necessary dependencies.
Alternatively, you can install the dependencies manually.
Follow the instructions outlined in the Terraform documentation to setup your local Terraform to use your local version rather than the registry version.
- Create a file named
.terraformrcin your$HOMEdirectory - Add the following content:
provider_installation { # Override the coder/coder provider to use your local version dev_overrides { "coder/coder" = "/path/to/terraform-provider-coder" } # For all other providers, install them directly from their origin provider # registries as normal. If you omit this, Terraform will _only_ use # the dev_overrides block, and so no other providers will be available. direct {} }
- (optional, but recommended) Validate your configuration:
- Create a new
main.tffile and include:
terraform { required_providers { coder = { source = "coder/coder" } } }
- Run
terraform initand observe a warning likeWarning: Provider development overrides are in effect
- Create a new
- Run
go build -o terraform-provider-coderto build the provider binary, which Terraform will try locate and execute - All local Terraform runs will now use your local provider!
- NOTE: we vendor in this provider into
github.com/coder/coder, so if you're testing with a local clone then you should also rungo mod edit -replace github.com/coder/terraform-provider-coder=/path/to/terraform-provider-coderin your clone.