Merge pull request #1 from kumarvna/develop

final configuration for v1.0

Author: kumarvna

.gitignore

@@ -4,6 +4,7 @@
 # .tfstate files
 *.tfstate
 *.tfstate.*
+*.terraform.lock.hcl*
 
 # Crash log files
 crash.log

README.md

@@ -0,0 +1,80 @@
+# Azure Cache for Redis Terraform module
+
+Azure Cache for Redis provides an in-memory data store based on the Redis software. This terraform module helps to quickly create the open-source (OSS Redis) Azure Cache for Redis.
+
+## Module Usage
+
+### Azure Cache for Redis with Cluster
+
+```hcl
+module "redis" {
+  source  = "kumarvna/redis/azurerm"
+  version = "1.0.0"
+
+  # By default, this module will create a resource group
+  # proivde a name to use an existing resource group and set the argument 
+  # to `create_resource_group = false` if you want to existing resoruce group. 
+  # If you use existing resrouce group location will be the same as existing RG.
+  create_resource_group = false
+  resource_group_name   = "rg-shared-westeurope-01"
+  location              = "westeurope"
+
+  # Configuration to provision a Standard Redis Cache
+  # Specify `shard_count` to create on the Redis Cluster
+  # Add patch_schedle to this object to enable redis patching schedule
+  redis_server_settings = {
+    demoredischache-shared = {
+      sku_name    = "Premium"
+      capacity    = 2
+      shard_count = 3
+    }
+  }
+
+  # MEMORY MANAGEMENT
+  # Azure Cache for Redis instances are configured with the following default Redis configuration values:
+  redis_configuration = {
+    maxmemory_reserved = 2
+    maxmemory_delta    = 2
+    maxmemory_policy   = "allkeys-lru"
+  }
+
+  #Azure Cache for Redis firewall filter rules are used to provide specific source IP access. 
+  # Azure Redis Cache access is determined based on start and end IP address range specified. 
+  # As a rule, only specific IP addresses should be granted access, and all others denied.
+  # "name" (ex. azure_to_azure or desktop_ip) may only contain alphanumeric characters and underscores
+  firewall_rules = {
+    access_to_azure = {
+      start_ip = "1.2.3.4"
+      end_ip   = "1.2.3.4"
+    },
+    desktop_ip = {
+      start_ip = "49.204.228.223"
+      end_ip   = "49.204.228.223"
+    }
+  }
+
+  # (Optional) To enable Azure Monitoring for Azure Cache for Redis
+  # (Optional) Specify `storage_account_name` to save monitoring logs to storage. 
+  log_analytics_workspace_name = "loganalytics-we-sharedtest2"
+
+  # Tags for Azure Resources
+  tags = {
+    Terraform   = "true"
+    Environment = "dev"
+    Owner       = "test-user"
+  }
+}
+```
+
+## Terraform Usage
+
+To run this example you need to execute following Terraform commands
+
+```hcl
+terraform init
+terraform plan
+terraform apply
+
+```
+
+Run `terraform destroy` when you don't need these resources.

examples/Azure_Cache_for_Redis_with_Cluster/README.md

@@ -0,0 +1,57 @@
+module "redis" {
+  source  = "kumarvna/redis/azurerm"
+  version = "1.0.0"
+
+  # By default, this module will create a resource group
+  # proivde a name to use an existing resource group and set the argument 
+  # to `create_resource_group = false` if you want to existing resoruce group. 
+  # If you use existing resrouce group location will be the same as existing RG.
+  create_resource_group = false
+  resource_group_name   = "rg-shared-westeurope-01"
+  location              = "westeurope"
+
+  # Configuration to provision a Standard Redis Cache
+  # Specify `shard_count` to create on the Redis Cluster
+  # Add patch_schedle to this object to enable redis patching schedule
+  redis_server_settings = {
+    demoredischache-shared = {
+      sku_name    = "Premium"
+      capacity    = 2
+      shard_count = 3
+    }
+  }
+
+  # MEMORY MANAGEMENT
+  # Azure Cache for Redis instances are configured with the following default Redis configuration values:
+  redis_configuration = {
+    maxmemory_reserved = 2
+    maxmemory_delta    = 2
+    maxmemory_policy   = "allkeys-lru"
+  }
+
+  # Azure Cache for Redis firewall filter rules are used to provide specific source IP access. 
+  # Azure Redis Cache access is determined based on start and end IP address range specified. 
+  # As a rule, only specific IP addresses should be granted access, and all others denied.
+  # "name" (ex. azure_to_azure or desktop_ip) may only contain alphanumeric characters and underscores
+  firewall_rules = {
+    access_to_azure = {
+      start_ip = "1.2.3.4"
+      end_ip   = "1.2.3.4"
+    },
+    desktop_ip = {
+      start_ip = "49.204.228.223"
+      end_ip   = "49.204.228.223"
+    }
+  }
+
+  # (Optional) To enable Azure Monitoring for Azure Cache for Redis
+  # (Optional) Specify `storage_account_name` to save monitoring logs to storage. 
+  log_analytics_workspace_name = "loganalytics-we-sharedtest2"
+
+  # Tags for Azure Resources
+  tags = {
+    Terraform   = "true"
+    Environment = "dev"
+    Owner       = "test-user"
+  }
+}

examples/Azure_Cache_for_Redis_with_Cluster/main.tf

@@ -0,0 +1,49 @@
+output "redis_cache_instance_id" {
+  description = "The Route ID of Redis Cache Instance"
+  value       = module.redis.redis_cache_instance_id
+}
+
+output "redis_cache_hostname" {
+  description = "The Hostname of the Redis Instance"
+  value       = module.redis.redis_cache_hostname
+}
+
+output "redis_cache_ssl_port" {
+  description = "The SSL Port of the Redis Instance"
+  value       = module.redis.redis_cache_ssl_port
+}
+
+output "redis_cache_port" {
+  description = "The non-SSL Port of the Redis Instance"
+  value       = module.redis.redis_cache_port
+  sensitive   = true
+}
+
+output "redis_cache_primary_access_key" {
+  description = "The Primary Access Key for the Redis Instance"
+  value       = module.redis.redis_cache_primary_access_key
+  sensitive   = true
+}
+
+output "redis_cache_secondary_access_key" {
+  description = "The Secondary Access Key for the Redis Instance"
+  value       = module.redis.redis_cache_secondary_access_key
+  sensitive   = true
+}
+
+output "redis_cache_primary_connection_string" {
+  description = "The primary connection string of the Redis Instance."
+  value       = module.redis.redis_cache_primary_connection_string
+  sensitive   = true
+}
+
+output "redis_cache_secondary_connection_string" {
+  description = "The secondary connection string of the Redis Instance."
+  value       = module.redis.redis_cache_secondary_connection_string
+  sensitive   = true
+}
+
+output "redis_configuration_maxclients" {
+  description = "Returns the max number of connected clients at the same time."
+  value       = module.redis.redis_configuration_maxclients
+}

examples/Azure_Cache_for_Redis_with_Cluster/output.tf

@@ -0,0 +1,4 @@
+variable "subnet_id" {
+  description = "The ID of the Subnet within which the Redis Cache should be deployed. Only available when using the Premium SKU and this subnet s "
+  default     = null
+}

examples/Azure_Cache_for_Redis_with_Cluster/variables.tf

@@ -0,0 +1,85 @@
+# Azure Cache for Redis Terraform module
+
+Azure Cache for Redis provides an in-memory data store based on the Redis software. This terraform module helps to quickly create the open-source (OSS Redis) Azure Cache for Redis.
+
+## Module Usage
+
+### Azure Cache for Redis with data persistence enabled
+
+```hcl
+module "redis" {
+  source  = "kumarvna/redis/azurerm"
+  version = "1.0.0"
+
+  # By default, this module will create a resource group
+  # proivde a name to use an existing resource group and set the argument 
+  # to `create_resource_group = false` if you want to existing resoruce group. 
+  # If you use existing resrouce group location will be the same as existing RG.
+  create_resource_group = false
+  resource_group_name   = "rg-shared-westeurope-01"
+  location              = "westeurope"
+
+  # Configuration to provision a Standard Redis Cache
+  # Specify `shard_count` to create on the Redis Cluster
+  # Add patch_schedle to this object to enable redis patching schedule
+  redis_server_settings = {
+    demoredischache-shared = {
+      sku_name = "Premium"
+      capacity = 2
+    }
+  }
+
+  # MEMORY MANAGEMENT
+  # Azure Cache for Redis instances are configured with the following default Redis configuration values:
+  redis_configuration = {
+    maxmemory_reserved = 2
+    maxmemory_delta    = 2
+    maxmemory_policy   = "allkeys-lru"
+  }
+
+  # SNAPSHOTTING - Redis data backup
+  # Data persistence doesn't work if `shard_count` is specified. i.e. Cluster enabled.
+  enable_data_persistence                    = true
+  data_persistence_backup_frequency          = 60
+  data_persistence_backup_max_snapshot_count = 1
+
+  #Azure Cache for Redis firewall filter rules are used to provide specific source IP access. 
+  # Azure Redis Cache access is determined based on start and end IP address range specified. 
+  # As a rule, only specific IP addresses should be granted access, and all others denied.
+  # "name" (ex. azure_to_azure or desktop_ip) may only contain alphanumeric characters and underscores
+  firewall_rules = {
+    access_to_azure = {
+      start_ip = "1.2.3.4"
+      end_ip   = "1.2.3.4"
+    },
+    desktop_ip = {
+      start_ip = "49.204.228.223"
+      end_ip   = "49.204.228.223"
+    }
+  }
+
+  # (Optional) To enable Azure Monitoring for Azure Cache for Redis
+  # (Optional) Specify `storage_account_name` to save monitoring logs to storage. 
+  log_analytics_workspace_name = "loganalytics-we-sharedtest2"
+
+  # Tags for Azure Resources
+  tags = {
+    Terraform   = "true"
+    Environment = "dev"
+    Owner       = "test-user"
+  }
+}
+```
+
+## Terraform Usage
+
+To run this example you need to execute following Terraform commands
+
+```hcl
+terraform init
+terraform plan
+terraform apply
+
+```
+
+Run `terraform destroy` when you don't need these resources.

examples/Azure_Cache_for_Redis_with_Data_Persistence_Enabled/README.md

@@ -0,0 +1,62 @@
+module "redis" {
+  source  = "kumarvna/redis/azurerm"
+  version = "1.0.0"
+
+  # By default, this module will create a resource group
+  # proivde a name to use an existing resource group and set the argument 
+  # to `create_resource_group = false` if you want to existing resoruce group. 
+  # If you use existing resrouce group location will be the same as existing RG.
+  create_resource_group = false
+  resource_group_name   = "rg-shared-westeurope-01"
+  location              = "westeurope"
+
+  # Configuration to provision a Standard Redis Cache
+  # Specify `shard_count` to create on the Redis Cluster
+  # Add patch_schedle to this object to enable redis patching schedule
+  redis_server_settings = {
+    demoredischache-shared = {
+      sku_name = "Premium"
+      capacity = 2
+    }
+  }
+
+  # MEMORY MANAGEMENT
+  # Azure Cache for Redis instances are configured with the following default Redis configuration values:
+  redis_configuration = {
+    maxmemory_reserved = 2
+    maxmemory_delta    = 2
+    maxmemory_policy   = "allkeys-lru"
+  }
+
+  # SNAPSHOTTING - Redis data backup
+  # Data persistence doesn't work if `shard_count` is specified. i.e. Cluster enabled.
+  enable_data_persistence                    = true
+  data_persistence_backup_frequency          = 60
+  data_persistence_backup_max_snapshot_count = 1
+
+  #Azure Cache for Redis firewall filter rules are used to provide specific source IP access. 
+  # Azure Redis Cache access is determined based on start and end IP address range specified. 
+  # As a rule, only specific IP addresses should be granted access, and all others denied.
+  # "name" (ex. azure_to_azure or desktop_ip) may only contain alphanumeric characters and underscores
+  firewall_rules = {
+    access_to_azure = {
+      start_ip = "1.2.3.4"
+      end_ip   = "1.2.3.4"
+    },
+    desktop_ip = {
+      start_ip = "49.204.228.223"
+      end_ip   = "49.204.228.223"
+    }
+  }
+
+  # (Optional) To enable Azure Monitoring for Azure Cache for Redis
+  # (Optional) Specify `storage_account_name` to save monitoring logs to storage. 
+  log_analytics_workspace_name = "loganalytics-we-sharedtest2"
+
+  # Tags for Azure Resources
+  tags = {
+    Terraform   = "true"
+    Environment = "dev"
+    Owner       = "test-user"
+  }
+}