https://github.com/epilot-dev/terraform-provider-epilot-role
terraform provider for epilot roles and permissions
https://github.com/epilot-dev/terraform-provider-epilot-role
Last synced: 10 months ago
JSON representation
terraform provider for epilot roles and permissions
- Host: GitHub
- URL: https://github.com/epilot-dev/terraform-provider-epilot-role
- Owner: epilot-dev
- Created: 2025-06-11T11:03:51.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-20T00:38:25.000Z (11 months ago)
- Last Synced: 2025-07-20T02:55:59.566Z (11 months ago)
- Language: Go
- Size: 174 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# epilot-dashboard
Terraform Provider for the *epilot-dashboard* API.
## Summary
Permissions API: Flexible Role-based Access Control for epilot
## Table of Contents
* [epilot-dashboard](#epilot-dashboard)
* [Installation](#installation)
* [Available Resources and Data Sources](#available-resources-and-data-sources)
* [Testing the provider locally](#testing-the-provider-locally)
* [Development](#development)
* [Contributions](#contributions)
## Installation
To install this provider, copy and paste this code into your Terraform configuration. Then, run `terraform init`.
```hcl
terraform {
required_providers {
epilot-role = {
source = "epilot-dev/epilot-role"
version = "0.20.8"
}
}
}
provider "epilot-role" {
# Configuration options
}
```
## Available Resources and Data Sources
### Resources
* [epilot-role_role](docs/resources/role.md)
### Data Sources
* [epilot-role_role](docs/data-sources/role.md)
## Testing the provider locally
#### Local Provider
Should you want to validate a change locally, the `--debug` flag allows you to execute the provider against a terraform instance locally.
This also allows for debuggers (e.g. delve) to be attached to the provider.
```sh
go run main.go --debug
# Copy the TF_REATTACH_PROVIDERS env var
# In a new terminal
cd examples/your-example
TF_REATTACH_PROVIDERS=... terraform init
TF_REATTACH_PROVIDERS=... terraform apply
```
#### Compiled Provider
Terraform allows you to use local provider builds by setting a `dev_overrides` block in a configuration file called `.terraformrc`. This block overrides all other configured installation methods.
1. Execute `go build` to construct a binary called `terraform-provider-epilot-role`
2. Ensure that the `.terraformrc` file is configured with a `dev_overrides` section such that your local copy of terraform can see the provider binary
Terraform searches for the `.terraformrc` file in your home directory and applies any configuration settings you set.
```
provider_installation {
dev_overrides {
"registry.terraform.io/epilot-dev/epilot-role" = ""
}
# 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 {}
}
```
# Development
## Contributions
While we value open-source contributions to this terraform provider, this library is generated programmatically. Any manual changes added to internal files will be overwritten on the next generation.
We look forward to hearing your feedback. Feel free to open a PR or an issue with a proof of concept and we'll do our best to include it in a future release.
### SDK Created by [Speakeasy](https://www.speakeasy.com/?utm_source=epilot-dashboard&utm_campaign=terraform)