Guida introduttiva: Creare un'app del servizio app con un modello Terraform

Introduzione al servizio app di Azure distribuendo un'app nel cloud tramite Terraform. Quando si utilizza un piano di servizio App gratuito, non ci sono costi per completare questa guida introduttiva.

Terraform consente di definire e creare distribuzioni complete dell'infrastruttura in Azure. I modelli Terraform vengono compilati in un formato leggibile che crea e configura le risorse di Azure in modo coerente e riproducibile. Questo articolo illustra come creare un'app usando Terraform.

Prerequisiti

• Una sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

• Configurazione di Terraform. Usare una delle opzioni seguenti:

  • Configurare Terraform in Azure Cloud Shell con Bash
  • Configurare Terraform in Azure Cloud Shell con PowerShell
  • Configurare Terraform in Windows con Bash
  • Configurare Terraform in Windows con PowerShell

• Estensione Azure Terraform di Visual Studio Code. Con questa estensione è possibile usare Terraform dall'editor per creare, testare ed eseguire configurazioni terraform. L'estensione supporta anche la visualizzazione del grafico delle risorse. Per informazioni su come installare l'estensione, vedere Installare l'estensione Azure Terraform di Visual Studio Code.

Rivedere il modello

Scegli il seguente modello Linux o Windows per creare un piano di servizio per app e un'app di tale servizio. Linux creerà un'app di esempio Node.js Hello World dal repository Azure Samples . Il modello di contenitore di Windows creerà un'app di esempio ASP.NET dal Registro Contenitori Microsoft.

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
}

Il modello definisce le quattro risorse di Azure seguenti. Per altri dettagli e informazioni sull'utilizzo, vedere Registro Terraform del provider di Azure.

• Microsoft.Resources/resourcegroups: creare un gruppo di risorse se non ne esiste già uno.
  • azurerm_resource_group
• Microsoft.Web/serverfarms: creare un piano di servizio app.
  • azurerm_service_plan
• Microsoft.Web/sites: Crea un'applicazione del servizio Linux.
  • azurerm_linux_web_app
• Microsoft.Web/sites/sourcecontrols: creare una configurazione di distribuzione Git esterna.
  • azurerm_app_service_source_control

Contenitore 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"
  }
}

Per altre informazioni su come costruire modelli Terraform, vedere la documentazione di Terraform.

Implementare il codice Terraform

Terraform offre molte funzionalità che è possibile usare per gestire, compilare, distribuire e aggiornare l'infrastruttura. I passaggi seguenti illustrano come distribuire ed eliminare definitivamente le risorse. La documentazione di Terraform e Terraform in Azure fornisce altri dettagli. È consigliabile esaminare la documentazione precedente se Terraform fa parte della strategia dell'infrastruttura di Azure.

1. Creare una directory in cui testare ed eseguire il codice Terraform di esempio. Impostarlo come directory corrente.

   mkdir appservice_tf_quickstart
   cd appservice_tf_quickstart
   

2. Creare un file denominato main.tf e inserire il codice del passaggio precedente.

   code main.tf
   

3. Inizializzare Terraform.

   terraform init
   

4. Creare il piano Terraform.

   terraform plan
   

5. Effettuare il provisioning delle risorse definite nel main.tf file di configurazione. Confermare l'azione immettendo sì al prompt.

   terraform apply
   

Convalidare la distribuzione

1. Nel menu principale del portale di Azure selezionare Gruppi di risorse e passare al gruppo di risorse creato usando il modello precedente. Il nome è myResourceGroup- seguito da una stringa di numeri interi casuali.

2. È possibile visualizzare il servizio app e un piano di servizio app creato da Terraform.

3. Selezionare Servizio app e passare all'URL per verificare che il sito sia stato creato correttamente. È anche possibile passare a http://<app_name>.azurewebsites.net, dove il nome dell'app è webapp- seguito da quella stessa stringa di numeri interi casuali del gruppo di risorse.

Pulire le risorse

Quando non sono più necessari, eliminare il gruppo di risorse o tornare al terminale ed eseguire terraform destroy per eliminare tutte le risorse associate a questa guida introduttiva.

Annotazioni

Per altre informazioni su Terraform del servizio app di Azure, vedere Esempi di Terraform per il servizio app di Azure. Altri esempi di Terraform sono disponibili in tutti i servizi di Azure in GitHub.

Contenuti correlati

• Documentazione di Terraform in Azure
• Esempi di Terraform per il servizio app di Azure