Démarrage rapide : Créer une application App Service à l’aide d’un modèle Terraform

Commencez à utiliser Azure App Service en déployant une application dans le cloud via Terraform. Lorsque vous utilisez un niveau App Service gratuit, il n’y a aucun frais pour suivre ce guide de démarrage rapide.

Terraform vous permet de définir et de créer des déploiements d’infrastructure complets dans Azure. Vous créez des modèles Terraform dans un format lisible par l’homme qui créent et configurent des ressources Azure de manière cohérente et reproductible. Cet article vous montre comment créer une application à l’aide de Terraform.

Conditions préalables

• Un abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

• Une configuration Terraform. Utilisez l’une des options suivantes :

  • Configurer Terraform dans Azure Cloud Shell avec Bash
  • Configurer Terraform dans Azure Cloud Shell avec PowerShell
  • Configurer Terraform dans Windows avec Bash
  • Configurer Terraform dans Windows avec PowerShell

• Extension Azure Terraform Visual Studio Code. Avec cette extension, vous pouvez utiliser Terraform à partir de l’éditeur pour créer, tester et exécuter des configurations Terraform. L’extension prend également en charge la visualisation de graphe de ressources. Pour savoir comment installer l’extension, consultez Installer l’extension Azure Terraform Visual Studio Code.

Vérifier le modèle

Choisissez le modèle Linux ou Windows suivant pour créer un plan App Service et une application App Service. Linux crée un exemple d’application Node.js Hello World à partir du référentiel Exemples Azure . Le modèle de conteneur Windows crée un exemple d’application ASP.NET à partir de 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
}

Le modèle définit les quatre ressources Azure suivantes. Pour plus d’informations sur l’utilisation et les informations d’utilisation, consultez le registreTerraform du fournisseur Azure.

• Microsoft.Resources/resourcegroups : créez un groupe de ressources s’il n’en existe pas déjà.
  • azurerm_resource_group
• Microsoft.Web/serverfarms : créez un plan App Service.
  • azurerm_service_plan
• Microsoft.Web/sites : Créez une application App Service Linux.
  • azurerm_linux_web_app
• Microsoft.Web/sites/sourcecontrols : créez une configuration de déploiement Git externe.
  • azurerm_app_service_source_control

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

Pour plus d’informations sur la construction de modèles Terraform, consultez la documentation Terraform.

Implémenter le code Terraform

Terraform fournit de nombreuses fonctionnalités que vous pouvez utiliser pour gérer, générer, déployer et mettre à jour l’infrastructure. Les étapes suivantes vous montrent comment déployer et détruire vos ressources. La documentation Terraform et Terraform sur Azure fournissent plus de détails. Nous vous recommandons de consulter la documentation précédente si Terraform fait partie de votre stratégie d’infrastructure Azure.

1. Créez un répertoire dans lequel tester et exécuter l’exemple de code Terraform. Définissez-le comme répertoire actif.

   mkdir appservice_tf_quickstart
   cd appservice_tf_quickstart
   

2. Créez un fichier nommé main.tf et insérez le code de l’étape précédente.

   code main.tf
   

3. Initialisez Terraform.

   terraform init
   

4. Créez le plan Terraform.

   terraform plan
   

5. Provisionnez les ressources définies dans le main.tf fichier de configuration. Confirmez l’action en entrant oui à l’invite.

   terraform apply
   

Valider le déploiement

1. Dans le menu principal du portail Azure, sélectionnez Groupes de ressources et accédez au groupe de ressources que vous avez créé à l’aide du modèle précédent. Le nom est myResourceGroup- suivi d’une chaîne d’entiers aléatoires.

2. Vous pouvez voir le service App Service et un plan App Service créés par Terraform.

3. Sélectionnez App Service et accédez à l’URL pour vérifier que votre site a été créé correctement. Vous pouvez également accéder à http://<app_name>.azurewebsites.net, où le nom de l’application est webapp- suivi de cette même chaîne d’entiers aléatoires à partir du groupe de ressources.

Nettoyer les ressources

Quand vous n’en avez plus besoin, supprimez le groupe de ressources ou revenez à votre terminal et exécutez terraform destroy pour supprimer toutes les ressources associées à ce guide de démarrage rapide.

Remarque

Pour plus d’exemples Azure App Service Terraform, consultez les exemples Terraform pour Azure App Service. Vous trouverez encore plus d’exemples Terraform sur tous les services Azure sur GitHub.

Contenu connexe

• Documentation Terraform sur Azure
• Exemples Terraform pour Azure App Service