https://github.com/epilot-dev/terraform-provider-epilot-entitymapping
Terraform provider for creating an entity mapping configuration for an epilot journey
https://github.com/epilot-dev/terraform-provider-epilot-entitymapping
Last synced: about 1 year ago
JSON representation
Terraform provider for creating an entity mapping configuration for an epilot journey
- Host: GitHub
- URL: https://github.com/epilot-dev/terraform-provider-epilot-entitymapping
- Owner: epilot-dev
- Created: 2024-03-05T15:04:19.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-21T16:47:47.000Z (over 1 year ago)
- Last Synced: 2024-11-21T17:40:01.976Z (over 1 year ago)
- Language: Go
- Size: 350 KB
- Stars: 1
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# epilot-entitymapping
To install this provider, copy and paste this code into your Terraform configuration. Then, run `terraform init`.
```hcl
terraform {
required_providers {
epilot-entitymapping = {
source = "epilot-dev/epilot-entitymapping"
version = "0.2.7"
}
}
}
provider "epilot-entitymapping" {
# Configuration options
}
```
### Testing the provider locally
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.
### Example
```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
```
## Summary
Entity Mapping API: API Backend for mapping source entity into target entities
## Table of Contents
* [Installation](#installation)
* [Available Resources and Data Sources](#available-resources-and-data-sources)
* [Testing the provider locally](#testing-the-provider-locally)
## Installation
To install this provider, copy and paste this code into your Terraform configuration. Then, run `terraform init`.
```hcl
terraform {
required_providers {
epilot-entitymapping = {
source = "epilot-dev/epilot-entitymapping"
version = "0.9.1"
}
}
}
provider "epilot-entitymapping" {
# Configuration options
}
```
## 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-entitymapping`
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-entitymapping" = ""
}
# 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 {}
}
```
## Available Resources and Data Sources
### Resources
* [epilot-entitymapping_entity_mapping](docs/resources/entity_mapping.md)
### Data Sources
* [epilot-entitymapping_entity_mapping](docs/data-sources/entity_mapping.md)
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.
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-entitymapping" = ""
}
# 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 {}
}
```
Your `` may vary depending on how your Go environment variables are configured. Execute `go env GOBIN` to set it, then set the `` to the value returned. If nothing is returned, set it to the default location, `$HOME/go/bin`.
Note: To use the dev_overrides, please ensure you run `go build` in this folder. You must have a binary available for terraform to find.
### Contributions
While we value open-source contributions to this SDK, this library is generated programmatically.
Feel free to open a PR or a Github issue as a proof of concept and we'll do our best to include it in a future release!
### SDK Created by [Speakeasy](https://docs.speakeasyapi.dev/docs/using-speakeasy/client-sdks)