Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marshallford/terraform-provider-pfsense
Used to configure pfSense firewall/router devices with Terraform.
https://github.com/marshallford/terraform-provider-pfsense
pfsense terraform terraform-provider
Last synced: about 22 hours ago
JSON representation
Used to configure pfSense firewall/router devices with Terraform.
- Host: GitHub
- URL: https://github.com/marshallford/terraform-provider-pfsense
- Owner: marshallford
- License: mit
- Created: 2023-08-21T03:15:49.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-10T01:20:56.000Z (7 months ago)
- Last Synced: 2025-01-19T16:16:21.272Z (8 days ago)
- Topics: pfsense, terraform, terraform-provider
- Language: Go
- Homepage: https://registry.terraform.io/providers/marshallford/pfsense
- Size: 106 KB
- Stars: 21
- Watchers: 3
- Forks: 3
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Terraform Provider pfSense
[](https://registry.terraform.io/providers/marshallford/pfsense/latest/docs)
Used to configure [pfSense](https://www.pfsense.org/) firewall/router systems with Terraform. Validated with pfSense CE, compatibility with pfSense Plus is not guaranteed.
> [!WARNING]
> All versions released prior to `v1.0.0` are to be considered [breaking changes](https://semver.org/#how-do-i-know-when-to-release-100).
## Support Matrix
| Release | pfSense | Terraform |
| :------: | :----------------: | :------------: |
| < v1.0.0 | >= 2.6.0, <= 2.7.2 | >= 1.6, <= 1.8 |
## Development Requirements
- [Terraform](https://developer.hashicorp.com/terraform/downloads)
- [Go](https://golang.org/doc/install)
## Building The Provider
1. Clone the repository
2. Enter the repository directory
3. Build the provider using the Go `install` command:
```shell
go install
```
## Adding Dependencies
This provider uses [Go modules](https://github.com/golang/go/wiki/Modules).
Please see the Go documentation for the most up to date information about using Go modules.
To add a new dependency `github.com/author/dependency` to your Terraform provider:
```shell
go get github.com/author/dependency
go mod tidy
```
Then commit the changes to `go.mod` and `go.sum`.
## 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](#development-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 docs`.
In order to run the full suite of Acceptance tests, run `make test/acc`.
*Note:* Acceptance tests create real resources, and often cost money to run.
```shell
make test/acc
```