Inicio rápido: Creación de una aplicación de App Service mediante una plantilla de Terraform

Para empezar a trabajar con Azure App Service , implemente una aplicación en la nube a través de Terraform. Cuando se usa un nivel gratuito de App Service, no hay ningún cargo para completar este inicio rápido.

Terraform permite definir y crear implementaciones de infraestructura completas en Azure. Cree plantillas de Terraform en un formato legible que cree y configure recursos de Azure de forma coherente y reproducible. En este artículo se muestra cómo crear una aplicación mediante Terraform.

Prerrequisitos

• Una suscripción de Azure. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

• Una configuración de Terraform. Use una de las siguientes opciones:

  • Configuración de Terraform en Azure Cloud Shell con Bash
  • Configuración de Terraform en Azure Cloud Shell con PowerShell
  • Configuración de Terraform en Windows con Bash
  • Configuración de Terraform en Windows con PowerShell

• Extensión de Visual Studio Code de Azure Terraform. Con esta extensión, puede trabajar con Terraform desde el editor para crear, probar y ejecutar configuraciones de Terraform. La extensión también admite la visualización de gráficos de recursos. Para obtener información sobre cómo instalar la extensión, consulte Instalación de la extensión de Visual Studio Code de Azure Terraform.

Revisión de la plantilla

Elija la siguiente plantilla de Linux o Windows para crear un plan de App Service y una aplicación de App Service. Linux creará una aplicación de ejemplo Node.js Hello World desde el repositorio de ejemplos de Azure . La plantilla de contenedor de Windows creará una aplicación de ejemplo ASP.NET desde Microsoft Container Registry.

Linux

# Configure the Azure provider
terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 3.0.0"
    }
  }
  required_version = ">= 0.14.9"
}
provider "azurerm" {
  features {}
}

# Generate a random integer to create a globally unique name
resource "random_integer" "ri" {
  min = 10000
  max = 99999
}

# Create the resource group
resource "azurerm_resource_group" "rg" {
  name     = "myResourceGroup-${random_integer.ri.result}"
  location = "eastus"
}

# Create the Linux App Service Plan
resource "azurerm_service_plan" "appserviceplan" {
  name                = "webapp-asp-${random_integer.ri.result}"
  location            = azurerm_resource_group.rg.location
  resource_group_name = azurerm_resource_group.rg.name
  os_type             = "Linux"
  sku_name            = "B1"
}

# Create the web app, pass in the App Service Plan ID
resource "azurerm_linux_web_app" "webapp" {
  name                  = "webapp-${random_integer.ri.result}"
  location              = azurerm_resource_group.rg.location
  resource_group_name   = azurerm_resource_group.rg.name
  service_plan_id       = azurerm_service_plan.appserviceplan.id
  depends_on            = [azurerm_service_plan.appserviceplan]
  https_only            = true
  site_config { 
    minimum_tls_version = "1.2"
    application_stack {
      node_version = "16-lts"
    }
  }
}

#  Deploy code from a public GitHub repo
resource "azurerm_app_service_source_control" "sourcecontrol" {
  app_id             = azurerm_linux_web_app.webapp.id
  repo_url           = "https://github.com/Azure-Samples/nodejs-docs-hello-world"
  branch             = "main"
  use_manual_integration = true
  use_mercurial      = false
}

La plantilla define los cuatro recursos de Azure siguientes. Para más información y información de uso, consulte Azure Provider Terraform Registry.

• Microsoft.Resources/resourcegroups: cree un grupo de recursos si aún no existe uno.
  • azurerm_resource_group
• Microsoft.Web/serverfarms: cree un plan de App Service.
  • azurerm_service_plan
• Microsoft.Web/sites: cree una aplicación de App Service para Linux.
  • azurerm_linux_web_app
• Microsoft.Web/sites/sourcecontrols: cree una configuración de implementación de Git externa.
  • azurerm_app_service_source_control

Contenedor Windows

# Configure the Azure provider
terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~>3.0.0"
    }
  }
}

provider "azurerm" {
  features {}
}

# Generate a random integer to create a globally unique name
resource "random_integer" "ri" {
  min = 10000
  max = 99999
}

# Create the resource group
resource "azurerm_resource_group" "rg" {
  name     = "rg-${random_integer.ri.result}"
  location = "eastus"
}

# Create the Windows App Service Plan
resource "azurerm_service_plan" "windows_appserviceplan" {
  name                = "windows-asp-${random_integer.ri.result}"
  location            = azurerm_resource_group.rg.location
  resource_group_name = azurerm_resource_group.rg.name
  os_type             = "WindowsContainer"
  sku_name            = "P1v3"
}

# Create the Windows Web App with a container
resource "azurerm_windows_web_app" "windows_webapp" {
  name                  = "windows-webapp-${random_integer.ri.result}"
  location              = azurerm_resource_group.rg.location
  resource_group_name   = azurerm_resource_group.rg.name
  service_plan_id       = azurerm_service_plan.windows_appserviceplan.id

  site_config {
    always_on = true
    app_command_line = ""
    application_stack {
      docker_container_name = "mcr.microsoft.com/dotnet/framework/samples"
      docker_container_tag = "aspnetapp"
    }
  }

  app_settings = {
    DOCKER_REGISTRY_SERVER_USERNAME     = ""
    DOCKER_REGISTRY_SERVER_PASSWORD     = ""
    DOCKER_REGISTRY_SERVER_URL          = "https://mcr.microsoft.com"
    WEBSITES_ENABLE_APP_SERVICE_STORAGE = "false"
  }
}

Para obtener más información sobre cómo construir plantillas de Terraform, consulte la documentación de Terraform.

Implementación del código de Terraform

Terraform proporciona muchas características que puede usar para administrar, compilar, implementar y actualizar la infraestructura. Los pasos siguientes muestran cómo implementar y destruir los recursos. La documentación de Terraform y la documentación de Terraform en Azure proporcionan más detalles. Se recomienda revisar la documentación anterior si Terraform forma parte de la estrategia de infraestructura de Azure.

1. Cree un directorio en el que probar y ejecutar el código de Terraform de ejemplo. Conviértalo en el directorio actual.

   mkdir appservice_tf_quickstart
   cd appservice_tf_quickstart
   

2. Cree un archivo denominado main.tf e inserte el código del paso anterior.

   code main.tf
   

3. Inicialice Terraform.

   terraform init
   

4. Crear el plan Terraform.

   terraform plan
   

5. Aprovisione los recursos definidos en el archivo de main.tf configuración. Confirme la acción escribiendo sí en el aviso.

   terraform apply
   

Validación de la implementación

1. En el menú principal de Azure Portal, seleccione Grupos de recursos y vaya al grupo de recursos que creó mediante la plantilla anterior. El nombre es myResourceGroup-, seguido por una cadena de enteros aleatorios.

2. Puede ver App Service y un plan de App Service creado por Terraform.

3. Seleccione App Service y vaya a la dirección URL para comprobar que el sitio se creó correctamente. También puede ir a http://<app_name>.azurewebsites.net, donde el nombre de la aplicación es webapp- seguido de esa misma cadena de enteros aleatorios del grupo de recursos.

Limpieza de recursos

Cuando ya no sea necesario, elimine el grupo de recursos o vuelva al terminal y ejecute terraform destroy para eliminar todos los recursos asociados a este inicio rápido.

Nota:

Para obtener más ejemplos de Terraform de Azure App Service, consulte Ejemplos de Terraform para Azure App Service. Puede encontrar más ejemplos de Terraform en todos los servicios de Azure en GitHub.

Contenido relacionado

• Documentación de Terraform en Azure
• Ejemplos de Terraform para Azure App Service