Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gordonbondon/terraform-provider-maxminddb
Terraform provider for MaxMind databases
https://github.com/gordonbondon/terraform-provider-maxminddb
geoip2 ip-address maxmind terraform terraform-provider
Last synced: 9 days ago
JSON representation
Terraform provider for MaxMind databases
- Host: GitHub
- URL: https://github.com/gordonbondon/terraform-provider-maxminddb
- Owner: gordonbondon
- License: mpl-2.0
- Created: 2021-01-20T12:28:22.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2023-01-09T08:01:00.000Z (almost 2 years ago)
- Last Synced: 2024-10-11T11:13:44.904Z (25 days ago)
- Topics: geoip2, ip-address, maxmind, terraform, terraform-provider
- Language: Go
- Homepage: https://registry.terraform.io/providers/gordonbondon/maxminddb/latest
- Size: 136 KB
- Stars: 2
- Watchers: 2
- Forks: 3
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# terraform-provider-maxminddb
Terraform provider that helps working with [MaxMind GeoIP2 Databases](https://www.maxmind.com/en/geoip2-databases)
## Using the Provider
For installation instructions and resource documentation check [provider page on terraform registry](https://registry.terraform.io/providers/gordonbondon/maxminddb/latest).
## 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) below).
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 `go generate`.
### Requirements
- [Terraform](https://www.terraform.io/downloads.html) >= 0.14.x
- [Go](https://golang.org/doc/install) >= 1.15
### Building The Provider
1. Clone the repository
1. Enter the repository directory
1. Build the provider using the Go `build` command:
```sh
$ go build .
```
To check locally build provider, update [`dev_overrides` cli config](https://www.terraform.io/docs/commands/cli-config.html#development-overrides-for-provider-developers):
```hcl
provider_installation {
dev_overrides {
"gordonbondon/maxminddb" = "/path/to/repo/terraform-provider-maxminddb"
}
direct {}
}
```
### 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:
```
go get github.com/author/dependency
go mod tidy
```
Then commit the changes to `go.mod` and `go.sum`.
## Developing the Provider
In order to run the full suite of Acceptance tests, run `make testacc`.
*Note:* Acceptance tests may create real resources, and often cost money to run.
```sh
$ make testacc
```
### Releasing the Provider
```shell
$ fingerprint=$(gpg --with-colons --list-key | awk -F: '$1 == "fpr" {print $10;}' | head -n 1)
$ export GPG_FINGERPRINT="${fingerprint}"
$ export GITHUB_TOKEN=xxx
$ git tag v0.x.x -s
$ goreleaser release --rm-dist
```