https://github.com/coder/terraform-provider-coderd
Manage a Coder deployment using Terraform
https://github.com/coder/terraform-provider-coderd
Last synced: 15 days ago
JSON representation
Manage a Coder deployment using Terraform
- Host: GitHub
- URL: https://github.com/coder/terraform-provider-coderd
- Owner: coder
- License: mpl-2.0
- Created: 2024-06-07T08:28:17.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-04-04T01:21:18.000Z (22 days ago)
- Last Synced: 2025-04-05T02:47:04.497Z (21 days ago)
- Language: Go
- Homepage: https://registry.terraform.io/providers/coder/coderd/latest/docs
- Size: 749 KB
- Stars: 18
- Watchers: 3
- Forks: 2
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# terraform-provider-coderd
`terraform-provider-coderd` enables managing a [Coder](https://github.com/coder/coder) deployment using [Terraform](https://github.com/hashicorp/terraform) IaC.
The provider currently supports resources and data sources for:
- Users
- Templates + Template Versions
- Groups
- Workspace Proxies
- Organizations (Data Source only)
## Requirements
- [Terraform](https://developer.hashicorp.com/terraform/downloads) >= 1.0
- [Go](https://golang.org/doc/install) >= 1.21
- [Coder](https://github.com/coder/coder) >= 2.10.1
## Usage
See the [`examples`](examples) and the [documentation](https://registry.terraform.io/providers/coder/coderd/latest/docs).
## Developing the Provider
If you wish to work on the provider, you'll first need [Go](http://www.golang.org) installed on your machine (see [Requirements](#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](./github/workflows/test.yml) runs an acceptance test matrix against multiple Terraform versions.