Merge pull request #1 from kumarvna/develop

Initial version PR

Author: kumarvna

.gitignore

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

README.md

@@ -0,0 +1,16 @@
+data "azurerm_application_insights" "main" {
+  count               = var.application_insights_enabled && var.application_insights_id != null ? 1 : 0
+  name                = split("/", var.application_insights_id)[8]
+  resource_group_name = split("/", var.application_insights_id)[4]
+}
+
+resource "azurerm_application_insights" "main" {
+  count               = var.application_insights_enabled && var.application_insights_id == null ? 1 : 0
+  name                = lower(format("appi-%s", var.app_insights_name))
+  location            = local.location
+  resource_group_name = local.resource_group_name
+  application_type    = var.application_insights_type
+  retention_in_days   = var.retention_in_days
+  disable_ip_masking  = var.disable_ip_masking
+  tags                = merge({ "ResourceName" = "${var.app_insights_name}" }, var.tags, )
+}

appinsights.tf

@@ -0,0 +1,103 @@
+# Azure App Service (Web Apps) Terraform Module
+
+Terraform module to create Azure App Service with optional site_config, backup, connection_string, auth_settings and Storage for mount points.
+
+## Module Usage
+
+```hcl
+module "web-app" {
+  source  = "kumarvna/web-app/azurerm"
+  version = "1.0.0"
+
+  # By default, this module will not create a resource group. Location will be same as existing RG.
+  # proivde a name to use an existing resource group, specify the existing resource group name, 
+  # set the argument to `create_resource_group = true` to create new resrouce group.
+  resource_group_name = "rg-shared-westeurope-01"
+
+  # App service plan setttings and supported arguments. Default name used by module
+  # To specify custom name use `app_service_plan_name` with a valid name.  
+  # for Service Plans, see https://azure.microsoft.com/en-us/pricing/details/app-service/windows/  
+  # App Service Plan for `Free` or `Shared` Tiers `use_32_bit_worker_process` must be set to `true`.
+  service_plan = {
+    kind = "Windows"
+    size = "P1v2"
+    tier = "PremiumV2"
+  }
+
+  # App Service settings and supported arguments
+  # Backup, connection_string, auth_settings, Storage for mounts are optional configuration
+  app_service_name       = "mypocproject"
+  enable_client_affinity = true
+
+  # A `site_config` block to setup the application environment. 
+  # Available built-in stacks (windows_fx_version) for web apps `az webapp list-runtimes`
+  # Runtime stacks for Linux (linux_fx_version) based web apps `az webapp list-runtimes --linux`
+  site_config = {
+    always_on                 = true
+    dotnet_framework_version  = "v2.0"
+    ftps_state                = "FtpsOnly"
+    managed_pipeline_mode     = "Integrated"
+    use_32_bit_worker_process = true
+    windows_fx_version        = "DOTNETCORE|2.1"
+  }
+
+  # (Optional) A key-value pair of Application Settings
+  app_settings = {
+    APPINSIGHTS_PROFILERFEATURE_VERSION             = "1.0.0"
+    APPINSIGHTS_SNAPSHOTFEATURE_VERSION             = "1.0.0"
+    DiagnosticServices_EXTENSION_VERSION            = "~3"
+    InstrumentationEngine_EXTENSION_VERSION         = "disabled"
+    SnapshotDebugger_EXTENSION_VERSION              = "disabled"
+    XDT_MicrosoftApplicationInsights_BaseExtensions = "disabled"
+    XDT_MicrosoftApplicationInsights_Java           = "1"
+    XDT_MicrosoftApplicationInsights_Mode           = "recommended"
+    XDT_MicrosoftApplicationInsights_NodeJS         = "1"
+    XDT_MicrosoftApplicationInsights_PreemptSdk     = "disabled"
+  }
+
+  # The Backup feature in Azure App Service easily create app backups manually or on a schedule.
+  # You can configure the backups to be retained up to an indefinite amount of time.
+  # Azure storage account and container in the same subscription as the app that you want to back up. 
+  # This module creates a Storage Container to keep the all backup items. 
+  # Backup items - App configuration , File content, Database connected to your app
+  enable_backup        = true
+  storage_account_name = "stdiagfortesting"
+  backup_settings = {
+    enabled                  = true
+    name                     = "DefaultBackup"
+    frequency_interval       = 1
+    frequency_unit           = "Day"
+    retention_period_in_days = 90
+  }
+
+  # By default App Insight resource is created by this module. 
+  # Specify valid resource Id to `application_insights_id` to use existing App Insight
+  # Specifies the type of Application by setting up `application_insights_type` with valid string
+  # Specifies the retention period in days using `retention_in_days`. Default 90.
+  # By default the real client ip is masked in the logs, to enable set `disable_ip_masking` to `true` 
+  app_insights_name = "otkpocshared"
+
+  # Adding TAG's to your Azure resources 
+  tags = {
+    ProjectName  = "demo-internal"
+    Env          = "dev"
+    Owner        = "user@example.com"
+    BusinessUnit = "CORP"
+    ServiceClass = "Gold"
+  }
+}
+```
+
+## 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/complete/README.md

@@ -0,0 +1,81 @@
+module "web-app" {
+  source  = "kumarvna/web-app/azurerm"
+  version = "1.0.0"
+
+  # By default, this module will not create a resource group. Location will be same as existing RG.
+  # proivde a name to use an existing resource group, specify the existing resource group name, 
+  # set the argument to `create_resource_group = true` to create new resrouce group.
+  resource_group_name = "rg-shared-westeurope-01"
+
+  # App service plan setttings and supported arguments. Default name used by module
+  # To specify custom name use `app_service_plan_name` with a valid name.  
+  # for Service Plans, see https://azure.microsoft.com/en-us/pricing/details/app-service/windows/  
+  # App Service Plan for `Free` or `Shared` Tiers `use_32_bit_worker_process` must be set to `true`.
+  service_plan = {
+    kind = "Windows"
+    size = "P1v2"
+    tier = "PremiumV2"
+  }
+
+  # App Service settings and supported arguments
+  # Backup, connection_string, auth_settings, Storage for mounts are optional configuration
+  app_service_name       = "mypocproject"
+  enable_client_affinity = true
+
+  # A `site_config` block to setup the application environment. 
+  # Available built-in stacks (windows_fx_version) for web apps `az webapp list-runtimes`
+  # Runtime stacks for Linux (linux_fx_version) based web apps `az webapp list-runtimes --linux`
+  site_config = {
+    always_on                 = true
+    dotnet_framework_version  = "v2.0"
+    ftps_state                = "FtpsOnly"
+    managed_pipeline_mode     = "Integrated"
+    use_32_bit_worker_process = true
+    windows_fx_version        = "DOTNETCORE|2.1"
+  }
+
+  # (Optional) A key-value pair of Application Settings
+  app_settings = {
+    APPINSIGHTS_PROFILERFEATURE_VERSION             = "1.0.0"
+    APPINSIGHTS_SNAPSHOTFEATURE_VERSION             = "1.0.0"
+    DiagnosticServices_EXTENSION_VERSION            = "~3"
+    InstrumentationEngine_EXTENSION_VERSION         = "disabled"
+    SnapshotDebugger_EXTENSION_VERSION              = "disabled"
+    XDT_MicrosoftApplicationInsights_BaseExtensions = "disabled"
+    XDT_MicrosoftApplicationInsights_Java           = "1"
+    XDT_MicrosoftApplicationInsights_Mode           = "recommended"
+    XDT_MicrosoftApplicationInsights_NodeJS         = "1"
+    XDT_MicrosoftApplicationInsights_PreemptSdk     = "disabled"
+  }
+
+  # The Backup feature in Azure App Service easily create app backups manually or on a schedule.
+  # You can configure the backups to be retained up to an indefinite amount of time.
+  # Azure storage account and container in the same subscription as the app that you want to back up. 
+  # This module creates a Storage Container to keep the all backup items. 
+  # Backup items - App configuration , File content, Database connected to your app
+  enable_backup        = true
+  storage_account_name = "stdiagfortesting"
+  backup_settings = {
+    enabled                  = true
+    name                     = "DefaultBackup"
+    frequency_interval       = 1
+    frequency_unit           = "Day"
+    retention_period_in_days = 90
+  }
+
+  # By default App Insight resource is created by this module. 
+  # Specify valid resource Id to `application_insights_id` to use existing App Insight
+  # Specifies the type of Application by setting up `application_insights_type` with valid string
+  # Specifies the retention period in days using `retention_in_days`. Default 90.
+  # By default the real client ip is masked in the logs, to enable set `disable_ip_masking` to `true` 
+  app_insights_name = "otkpocshared"
+
+  # Adding TAG's to your Azure resources 
+  tags = {
+    ProjectName  = "demo-internal"
+    Env          = "dev"
+    Owner        = "user@example.com"
+    BusinessUnit = "CORP"
+    ServiceClass = "Gold"
+  }
+}

examples/complete/main.tf

@@ -0,0 +1,72 @@
+output "app_service_plan_id" {
+  description = "The resource ID of the App Service Plan component"
+  value       = module.web-app.app_service_plan_id
+}
+
+output "maximum_number_of_workers" {
+  description = " The maximum number of workers supported with the App Service Plan's sku"
+  value       = module.web-app.maximum_number_of_workers
+}
+
+output "app_service_id" {
+  description = "The resource ID of the App Service component"
+  value       = module.web-app.app_service_id
+}
+
+output "default_site_hostname" {
+  description = "The Default Hostname associated with the App Service"
+  value       = module.web-app.default_site_hostname
+}
+
+output "outbound_ip_addresses" {
+  description = "A comma separated list of outbound IP addresses"
+  value       = module.web-app.outbound_ip_addresses
+}
+
+output "outbound_ip_address_list" {
+  description = "A list of outbound IP addresses"
+  value       = module.web-app.outbound_ip_address_list
+}
+
+output "possible_outbound_ip_addresses" {
+  description = "A comma separated list of outbound IP addresses - not all of which are necessarily in use. Superset of `outbound_ip_addresses`."
+  value       = module.web-app.possible_outbound_ip_addresses
+}
+
+output "possible_outbound_ip_address_list" {
+  description = "A list of outbound IP addresses - not all of which are necessarily in use. Superset of outbound_ip_address_list."
+  value       = module.web-app.possible_outbound_ip_address_list
+}
+
+output "identity" {
+  description = "An identity block, which contains the Managed Service Identity information for this App Service."
+  value       = module.web-app.identity
+}
+
+output "application_insights_id" {
+  description = "The ID of the Application Insights component"
+  value       = module.web-app.application_insights_id
+}
+
+output "application_insights_app_id" {
+  description = "The App ID associated with this Application Insights component"
+  value       = module.web-app.application_insights_app_id
+}
+
+output "application_insights_instrumentation_key" {
+  description = "The Instrumentation Key for this Application Insights component"
+  value       = module.web-app.application_insights_instrumentation_key
+  sensitive   = true
+}
+
+output "application_insights_connection_string" {
+  description = "The Connection String for this Application Insights component"
+  value       = module.web-app.application_insights_connection_string
+  sensitive   = true
+}
+
+output "sas_url_query_string" {
+  value     = module.web-app.sas_url_query_string
+  sensitive = true
+}
+