initial module commit (#1)

* initial module commit

* Auto Format

* skip_final_snapshot by default

* Auto Format

* IAM roles list respected, removed trailing dots for variables descriptions

* Auto Format

Co-authored-by: cloudpossebot <11232728+cloudpossebot@users.noreply.github.com>

Author: maximmi

.gitignore

@@ -6,6 +6,7 @@
 *.tfstate.*
 .terraform
 .terraform.tfstate.lock.info
+**/.terraform.lock.hcl
 
 **/.idea
 **/*.iml

README.md

@@ -1,10 +1,17 @@
+enabled = true
+
 region = "us-east-2"
 
-namespace = "eg"
+availability_zones = ["us-east-2a", "us-east-2b"]
 
-environment = "ue2"
+namespace = "eg"
 
 stage = "test"
 
-name = "example"
+name = "redshift-cluster"
+
+port = 5439
+
+admin_user = "admin"
 
+admin_password = "Admin_Password_1"

docs/terraform.md

@@ -1,7 +1,62 @@
-module "example" {
+provider "aws" {
+  region = var.region
+}
+
+module "vpc" {
+  source  = "cloudposse/vpc/aws"
+  version = "0.21.1"
+
+  cidr_block = "172.19.0.0/16"
+
+  context = module.this.context
+}
+
+module "subnet" {
+  source  = "cloudposse/dynamic-subnets/aws"
+  version = "0.38.1"
+
+  availability_zones   = var.availability_zones
+  vpc_id               = module.vpc.vpc_id
+  igw_id               = module.vpc.igw_id
+  cidr_block           = module.vpc.vpc_cidr_block
+  nat_gateway_enabled  = false
+  nat_instance_enabled = false
+
+  context = module.this.context
+}
+
+module "security_group" {
+  source  = "cloudposse/security-group/aws"
+  version = "0.1.4"
+
+  vpc_id = module.vpc.vpc_id
+  rules = [
+    {
+      type        = "ingress"
+      from_port   = var.port
+      to_port     = var.port
+      protocol    = "all"
+      cidr_blocks = ["0.0.0.0/0"]
+    },
+    {
+      type        = "egress"
+      from_port   = 0
+      to_port     = 0
+      protocol    = "all"
+      cidr_blocks = ["0.0.0.0/0"]
+    }
+  ]
+  context = module.this.context
+}
+
+module "redshift_cluster" {
   source = "../.."
 
-  example = var.example
+  subnet_ids          = module.subnet.private_subnet_ids
+  vpc_security_groups = [module.vpc.vpc_default_security_group_id, module.security_group.id]
+
+  admin_user     = var.admin_user
+  admin_password = var.admin_password
 
   context = module.this.context
 }

examples/complete/fixtures.us-east-2.tfvars

@@ -1,14 +1,104 @@
 output "id" {
-  description = "ID of the created example"
-  value       = module.example.id
+  description = "The Redshift Cluster ID"
+  value       = module.redshift_cluster.id
 }
 
-output "example" {
-  description = "Output \"example\" from example module"
-  value       = module.example.example
+output "arn" {
+  description = "Amazon Resource Name (ARN) of cluster"
+  value       = module.redshift_cluster.arn
 }
 
-output "random" {
-  description = "Output \"random\" from example module"
-  value       = module.example.random
+output "cluster_identifier" {
+  description = "The Cluster Identifier"
+  value       = module.redshift_cluster.cluster_identifier
+}
+
+output "cluster_revision_number" {
+  description = "The specific revision number of the database in the cluster"
+  value       = module.redshift_cluster.cluster_revision_number
+}
+
+output "cluster_subnet_group_name" {
+  description = "The name of a cluster subnet group to be associated with this cluster"
+  value       = module.redshift_cluster.cluster_subnet_group_name
+}
+
+output "cluster_parameter_group_name" {
+  description = "The name of the parameter group to be associated with this cluster"
+  value       = module.redshift_cluster.cluster_parameter_group_name
+}
+
+output "port" {
+  description = "The Port the cluster responds on"
+  value       = module.redshift_cluster.port
+}
+
+output "dns_name" {
+  description = "The DNS name of the cluster"
+  value       = module.redshift_cluster.dns_name
+}
+
+output "vpc_security_group_ids" {
+  description = "The VPC security group Ids associated with the cluster"
+  value       = module.redshift_cluster.vpc_security_group_ids
+}
+
+output "cluster_security_groups" {
+  description = "The security groups associated with the cluster"
+  value       = module.redshift_cluster.cluster_security_groups
+}
+
+output "endpoint" {
+  description = "The connection endpoint"
+  value       = module.redshift_cluster.endpoint
+}
+
+output "database_name" {
+  description = "The name of the default database in the Cluster"
+  value       = module.redshift_cluster.database_name
+}
+
+output "node_type" {
+  description = "The type of nodes in the cluster"
+  value       = module.redshift_cluster.node_type
+}
+
+output "cluster_type" {
+  description = "The cluster type"
+  value       = module.redshift_cluster.cluster_type
+}
+
+output "redshift_subnet_group_arn" {
+  description = "Amazon Resource Name (ARN) of the Redshift Subnet group name"
+  value       = module.redshift_cluster.redshift_subnet_group_arn
+}
+
+output "redshift_subnet_group_id" {
+  description = "The Redshift Subnet group name ID"
+  value       = module.redshift_cluster.redshift_subnet_group_id
+}
+
+output "redshift_parameter_group_arn" {
+  description = "Amazon Resource Name (ARN) of the Redshift parameter group"
+  value       = module.redshift_cluster.redshift_parameter_group_arn
+}
+
+output "redshift_parameter_group_id" {
+  description = "The Redshift parameter group name"
+  value       = module.redshift_cluster.redshift_parameter_group_id
+}
+
+output "vpc_cidr" {
+  value       = module.vpc.vpc_cidr_block
+  description = "VPC CIDR"
+}
+
+output "public_subnet_cidrs" {
+  value       = module.subnet.public_subnet_cidrs
+  description = "Public subnet CIDR blocks"
+}
+
+output "private_subnet_cidrs" {
+  value       = module.subnet.private_subnet_cidrs
+  description = "Private subnet CIDR blocks"
 }

examples/complete/main.tf

@@ -1,4 +1,25 @@
-variable "example" {
+variable "region" {
   type        = string
-  description = "The value which will be passed to the example module"
+  description = "AWS region"
+}
+
+variable "port" {
+  type        = number
+  default     = 5439
+  description = "The port number on which the cluster accepts incoming connections"
+}
+
+variable "availability_zones" {
+  type = list(string)
+}
+
+variable "admin_user" {
+  type        = string
+  default     = "admin"
+  description = "(Required unless a snapshot_identifier is provided) Username for the master DB user"
+}
+
+variable "admin_password" {
+  type        = string
+  description = "(Required unless a snapshot_identifier is provided) Password for the master DB user"
 }

examples/complete/outputs.tf

@@ -2,9 +2,13 @@ terraform {
   required_version = ">= 0.12.26"
 
   required_providers {
-    local = {
-      source  = "hashicorp/local"
-      version = ">= 1.2"
+    aws = {
+      source  = "hashicorp/aws"
+      version = ">= 2.0"
+    }
+    null = {
+      source  = "hashicorp/null"
+      version = ">= 2.0"
     }
   }
 }

examples/complete/variables.tf

@@ -1,13 +1,65 @@
-resource "random_integer" "example" {
-  count = module.this.enabled ? 1 : 0
+resource "aws_redshift_cluster" "default" {
+  count              = module.this.enabled ? 1 : 0
+  cluster_identifier = var.cluster_identifier == "" ? module.this.id : var.cluster_identifier
+  database_name      = var.database_name
+  master_username    = var.admin_user
+  master_password    = var.admin_password
+  node_type          = var.node_type
+  cluster_type       = var.cluster_type
 
-  min = 1
-  max = 50000
-  keepers = {
-    example = var.example
+  vpc_security_group_ids       = var.vpc_security_groups
+  cluster_subnet_group_name    = join("", aws_redshift_subnet_group.default.*.id)
+  availability_zone            = var.availability_zone
+  preferred_maintenance_window = var.preferred_maintenance_window
+
+  cluster_parameter_group_name        = join("", aws_redshift_parameter_group.default.*.id)
+  automated_snapshot_retention_period = var.automated_snapshot_retention_period
+  port                                = var.port
+  cluster_version                     = var.engine_version
+  number_of_nodes                     = var.nodes
+  publicly_accessible                 = var.publicly_accessible
+  encrypted                           = var.encrypted
+  enhanced_vpc_routing                = var.enhanced_vpc_routing
+  kms_key_id                          = var.kms_key_arn
+  elastic_ip                          = var.elastic_ip
+  skip_final_snapshot                 = var.skip_final_snapshot
+  final_snapshot_identifier           = var.final_snapshot_identifier
+  snapshot_identifier                 = var.snapshot_identifier
+  snapshot_cluster_identifier         = var.snapshot_cluster_identifier
+  owner_account                       = var.owner_account
+  iam_roles                           = var.iam_roles
+
+  depends_on = [
+    aws_redshift_subnet_group.default,
+    aws_redshift_parameter_group.default
+  ]
+
+  logging {
+    enable        = var.logging
+    bucket_name   = var.logging_bucket_name
+    s3_key_prefix = var.logging_s3_key_prefix
   }
+
+  tags = module.this.tags
 }
 
-locals {
-  example = format("%v %v", var.example, join("", random_integer.example[*].result))
+resource "aws_redshift_subnet_group" "default" {
+  count       = module.this.enabled ? 1 : 0
+  name        = module.this.id
+  subnet_ids  = var.subnet_ids
+  description = "Allowed subnets for Redshift Subnet group"
+  tags        = module.this.tags
+}
+
+resource "aws_redshift_parameter_group" "default" {
+  name   = module.this.id
+  family = "redshift-1.0"
+
+  dynamic "parameter" {
+    for_each = var.cluster_parameters
+    content {
+      name  = parameter.value.name
+      value = parameter.value.value
+    }
+  }
 }