terraform-provider-coderd

README

terraform-provider-coderd

terraform-provider-coderd enables managing a Coder deployment using Terraform IaC.

The provider currently supports resources and data sources for:

• Users
• Templates + Template Versions
• Groups
• Workspace Proxies
• Organizations (Data Source only)

Requirements

• Terraform >= 1.0
• Go >= 1.21
• Coder >= 2.10.1

Usage

See the examples and the documentation.

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (see Requirements above).

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

To generate or update documentation, run make gen.

Terraform Acceptance Tests

Acceptance tests are run against a live Coder deployment in a local Docker container. To run the full suite of Acceptance tests, run make testacc.

[!NOTE] Our CI workflow runs an acceptance test matrix against multiple Terraform versions.