terraform-provider-neon
terraform-provider-neon copied to clipboard
Terraform provider to manage Neon SaaS resources
Terraform Provider Neon
⭐ The project needs your support! Please leave a star and become a GitHub sponsor! ⭐
💖 Thank you @neondatabase for sponsoring the project! 💖
Terraform provider to manage the Neon Postgres projects.
Using the provider
terraform {
required_providers {
neon = {
source = "kislerdm/neon"
}
}
}
provider "neon" {}
Authentication and Configuration
Configuration for the Neon Provider can be derived from several sources, which are applied in the following order:
- Parameters in the provider configuration
provider "neon" {
api_key = "<neon-api_key>"
}
- Environment variables:
- Api key specified as
NEON_API_KEY
Requirements
- Terraform >= 0.13.x
Building The Provider
- Clone the repository
- Enter the repository directory
- Build the provider using the Go
install
command:
make build
- Run to install the provider to be used locally:
make install
Local development
Requirements
- Go (find required version in go.mod)
- gnuMake / cMake
Commands for local development
Run to see the full list of commands:
make help
Run to compile the provider:
make build
It will yield the binary terraform-provider-neon_vdev
.
Run to install a :
To generate or update documentation, run go docu
.
In order to run the full suite of Unit tests, run make test
.
In order to run the full suite of Acceptance tests, run make testacc
.
Note: Acceptance tests create real resources, and often cost money to run.