Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nxt-engineering/terraform-provider-publicip
A Terraform provider to get your current public IPv6 and/or IPv4.
https://github.com/nxt-engineering/terraform-provider-publicip
go hacktoberfest terraform terraform-provider
Last synced: about 1 month ago
JSON representation
A Terraform provider to get your current public IPv6 and/or IPv4.
- Host: GitHub
- URL: https://github.com/nxt-engineering/terraform-provider-publicip
- Owner: nxt-engineering
- License: mit
- Created: 2022-01-25T09:31:09.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-03-21T14:32:49.000Z (almost 2 years ago)
- Last Synced: 2024-06-21T13:03:23.811Z (6 months ago)
- Topics: go, hacktoberfest, terraform, terraform-provider
- Language: Go
- Homepage: https://registry.terraform.io/providers/nxt-engineering/publicip
- Size: 132 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Public IP Terraform Provider
This Terraform provider connects to [ifconfig.co](https://ifconfig.co) to fetch information about the public IP in use.
It was mainly built to allow creating or adjusting firewall rules in cloud setups on the fly,
so that other providers that connect directly to the resources can operate.
For example and at least until version 3,
the `azurerm` provider needed to connect to the Azure Storage account directly to manage blob containers.
Likewise, a `postgresql` provider needs to directly connect to the database to do its job.
## Usage
```terraform
terraform {
required_providers {
publicip = {
source = "nxt-engineering/publicip"
version = "~> 0.0.3"
}
}
}
provider "publicip" {}
data "publicip_address" "main" {}
output "ip" {
value = data.publicip_address.main.ip
}
output "all" {
value = data.publicip_address.main
}
```
## Development
### Requirements
- [Terraform](https://www.terraform.io/downloads.html) >= 1.0
- [Go](https://golang.org/doc/install) >= 1.17
### Building The Provider
1. Clone the repository
1. Enter the repository directory
1. Build the provider using the Go `install` command:
```shell
go install
```
### Testrun
Add this to your `~/.terraformrc`:
```hcl
provider_installation {
dev_overrides {
# Edit the path … … here: |________|
"registry.terraform.io/nxt-engineering/publicip" = "HOME/SRC/terraform-provider-publicip"
}
direct {}
}
```
Set up a dummy project like this:
```terraform
terraform {
required_providers {
publicip = {
source = "nxt-engineering/publicip"
}
}
}
provider "publicip" {}
data "publicip_address" "default" {}
data "publicip_address" "default_v4" {
source_ip = "0.0.0.0"
}
data "publicip_address" "default_v6" {
source_ip = "::"
}
output "out" {
value = {
default = data.publicip_address.default,
default_v4 = data.publicip_address.default_v4,
default_v6 = data.publicip_address.default_v6,
}
}
```
Build the provider:
```bash
go build -o terraform-provider-publicip
```
Run the provider like this:
```bash
TF_LOG_PROVIDER=DEBUG terraform apply -auto-approve
```