Terraform Provider for AWS Redshift

A Terraform provider for managing AWS Redshift objects: users, groups, schemas, databases, grants, default privileges, and datashares.

Published on the Terraform Registry and the OpenTofu Registry.

Requirements

• Terraform >= 1.8 or OpenTofu >= 1.6
• Go >= 1.26 (to build the provider from source)

Usage

terraform {
  required_providers {
    redshift = {
      source  = "gr8-toolkit/redshift"
      version = "~> 1.0"
    }
  }
}

provider "redshift" {
  host     = "my-cluster.us-east-1.redshift.amazonaws.com"
  port     = 5439
  username = "admin"
  password = var.redshift_password
  database = "dev"
}

See the registry documentation for the full list of resources and data sources.

Building from Source

git clone git@github.com:gr8-toolkit/terraform-provider-redshift.git
cd terraform-provider-redshift
make build

make build runs gofmt, then go install, placing the binary in $GOPATH/bin.

Documentation

Docs are generated from schema Description fields and the examples/ directory using tfplugindocs. Files under docs/ are auto-generated — do not edit them manually.

Regenerate after changing the schema or examples:

make doc

Releasing

Releases are fully automated via GitHub Actions and GoReleaser.

1. Update the changelog:

   RELEASE_VERSION=v1.x.y \
   CHANGELOG_GITHUB_TOKEN=<token> \
   make changelog

2. Push the changelog commit:

   git push origin master

3. Tag and push — this triggers the release workflow automatically:

   RELEASE_VERSION=v1.x.y make release

The Release workflow builds cross-platform binaries, signs the checksums with GPG, and publishes the GitHub release.

Contributing

See CONTRIBUTING.md.