initial

Author: jritsema

LICENSE

@@ -0,0 +1,13 @@
+Copyright 2016 Turner
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

main.tf

@@ -0,0 +1,56 @@
+#
+# Security group resources
+#
+
+resource "aws_security_group" "redis" {
+  vpc_id = "${var.vpc_id}"
+
+  tags {
+    name = "${var.tag_name}"
+    description = "${var.tag_description}"
+    environment = "${var.tag_environment}"
+    creator = "${var.tag_creator}"
+    customer = "${var.tag_customer}"
+    owner = "${var.tag_owner}"
+    product = "${var.tag_product}"
+    costcenter = "${var.tag_costcenter}"
+  }
+}
+
+#
+# ElastiCache resources
+#
+
+resource "aws_elasticache_subnet_group" "default" {
+  name = "subnet-group-${var.tag_customer}-${var.tag_product}-${var.tag_environment}"
+  description = "Private subnets for the ElastiCache instances: ${var.tag_customer} ${var.tag_product} ${var.tag_environment}"
+  subnet_ids = ["${split(",", var.private_subnet_ids)}"]
+}
+
+resource "aws_elasticache_cluster" "redis" {
+  cluster_id = "${var.tag_customer}-${var.tag_product}-${var.tag_environment}"
+  engine = "redis"
+  engine_version = "${var.engine_version}"
+  maintenance_window = "${var.maintenance_window}"
+  node_type = "${var.instance_type}"
+  num_cache_nodes = "1"
+  parameter_group_name = "default.redis2.8"
+  port = "6379"
+  subnet_group_name = "${aws_elasticache_subnet_group.default.name}"
+  security_group_ids = ["${aws_security_group.redis.id}"]
+
+  tags {
+    name = "${var.tag_name}"
+    description = "${var.tag_description}"
+    environment = "${var.tag_environment}"
+    creator = "${var.tag_creator}"
+    customer = "${var.tag_customer}"
+    owner = "${var.tag_owner}"
+    product = "${var.tag_product}"
+    costcenter = "${var.tag_costcenter}"
+  }
+}
+
+#
+# todo: add CloudWatch resources
+#

outputs.tf

@@ -0,0 +1,15 @@
+output "cache_security_group_id" {
+  value = "${aws_security_group.redis.id}"
+}
+
+output "hostname" {
+  value = "${aws_elasticache_cluster.redis.cache_nodes.0.address}"
+}
+
+output "port" {
+  value = "${aws_elasticache_cluster.redis.cache_nodes.0.port}"
+}
+
+output "endpoint" {
+  value = "${join(":", aws_elasticache_cluster.redis.cache_nodes.0.address, aws_elasticache_cluster.redis.cache_nodes.0.port)}"
+}

readme.md

@@ -0,0 +1,51 @@
+# terraform-aws-elasticache-redis
+
+A Terraform module to create an Amazon Web Services (AWS) Redis ElastiCache cluster.
+
+### Usage
+
+```terraform
+module "elasticache_redis" {
+  source = "github.com/jritsema/terraform-aws-elasticache-redis"
+
+  vpc_id = "vpc-20f74844"
+  private_subnet_ids = "subnet-4a887f3c,subnet-76dae35d"
+
+  engine_version = "2.8.24"
+  instance_type = "cache.m3.medium"
+  maintenance_window = "sun:05:00-sun:06:00"
+
+  tag_name = "redis"
+  tag_description = "redis cluster for development"
+  tag_creator = "creator"
+  tag_product = "product"
+  tag_customer = "customer"
+  tag_owner = "owner"
+  tag_environment = "dev"
+  tag_costcenter = "TBD"
+}
+```
+
+### Variables
+
+- `vpc_id` - ID of VPC meant to house the cache
+- `private_subnet_ids` - Comma delimited list of private subnet IDs
+- `engine_version` - Cache engine version (default: `2.8.24`)
+- `instance_type` - Instance type for cache instance (default: `cache.m3.medium`)
+- `maintenance_window` - 60 minute time window to reserve for maintenance
+  (default: `sun:05:00-sun:06:00`)
+- `tag_name`
+- `tag_description`
+- `tag_creator`
+- `tag_product`
+- `tag_customer`
+- `tag_owner`
+- `tag_environment`
+- `tag_costcenter`
+
+### Outputs
+
+- `cache_security_group_id` - Security group ID of the cache cluster
+- `hostname` - Public DNS name of cache node
+- `port` - Port of cache instance
+- `endpoint` - Public DNS name and port separated by a `:`

variables.tf

@@ -0,0 +1,44 @@
+variable "vpc_id" {
+}
+
+variable "private_subnet_ids" {
+}
+
+variable "engine_version" {
+  default = "2.8.24"
+}
+
+variable "instance_type" {
+  default = "cache.m3.medium"
+}
+
+variable "maintenance_window" {
+  # SUN 01:00AM-02:00AM ET
+  default = "sun:05:00-sun:06:00"
+}
+
+# tags
+
+variable "tag_name" {
+}
+
+variable "tag_description" {
+}
+
+variable "tag_environment" {
+}
+
+variable "tag_creator" {
+}
+
+variable "tag_customer" {
+}
+
+variable "tag_owner" {
+}
+
+variable "tag_product" {
+}
+
+variable "tag_costcenter" {
+}