https://github.com/epilot-dev/terraform-provider-epilot-product
https://github.com/epilot-dev/terraform-provider-epilot-product
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/epilot-dev/terraform-provider-epilot-product
- Owner: epilot-dev
- Created: 2023-11-10T09:16:38.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-13T15:10:43.000Z (over 1 year ago)
- Last Synced: 2024-09-14T23:29:34.573Z (over 1 year ago)
- Language: Go
- Size: 533 KB
- Stars: 1
- Watchers: 6
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# epilot-product
## SDK Installation
To install this provider, copy and paste this code into your Terraform configuration. Then, run `terraform init`.
```hcl
terraform {
required_providers {
epilot-product = {
source = "epilot-dev/epilot-product"
version = "0.2.0"
}
}
}
provider "epilot-product" {
# Configuration options
}
```
## SDK Example Usage
### 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
## Table of Contents
* [epilot-product](#epilot-product)
* [SDK Installation](#sdk-installation)
* [SDK Example Usage](#sdk-example-usage)
* [Installation](#installation)
* [Testing the provider locally](#testing-the-provider-locally)
* [Available Resources and Data Sources](#available-resources-and-data-sources)
## Installation
To install this provider, copy and paste this code into your Terraform configuration. Then, run `terraform init`.
```hcl
terraform {
required_providers {
epilot-product = {
source = "epilot-dev/epilot-product"
version = "0.13.2"
}
}
}
provider "epilot-product" {
# 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-product`
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-product" = ""
}
# 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-product_coupon](docs/resources/coupon.md)
* [epilot-product_price](docs/resources/price.md)
* [epilot-product_product](docs/resources/product.md)
* [epilot-product_tax](docs/resources/tax.md)
### Data Sources
* [epilot-product_coupon](docs/data-sources/coupon.md)
* [epilot-product_price](docs/data-sources/price.md)
* [epilot-product_product](docs/data-sources/product.md)
* [epilot-product_tax](docs/data-sources/tax.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/github.com/epilot-dev/terraform-provider-epilot-product/scaffolding" = ""
}
# 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`.
### 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)