Ends in:
2 DAYS
21 HRS
10 MIN
12 SEC
Ends in:
2 D
21 H
10 M
12 S

There are multiple versions of this document. Pick the options that suit you best.

UI
Database
Tiered

Provisioning an Azure Web App using Terraform

In this tutorial, we'll walk through the steps to provision an Azure Web App using Terraform. Terraform is an open-source infrastructure as a code tool that allows you to define and manage your infrastructure in a declarative way.

Prerequisites

Before you begin, you'll need the following:

Creating a Service Principal for Terraform in Azure

When working with Terraform on Azure, you'll need a "Service Principal" for authentication. A "Service Principal" is an identity created to be used with applications, hosted services, and automated tools to access Azure resources.

To create a service principal, run the following command in the Azure CLI:

  1. Login to Azure CLI

    Before you begin, make sure you are logged into your Azure account with the Azure CLI:

    az login
    
  2. Set your Subscription:

    If you have multiple Azure subscriptions, specify the one you intend to use:

    az account set --subscription="YOUR_SUBSCRIPTION_ID"
    
  3. Create the Service Principal:

    The following command will create a service principal. Replace YOUR_APP_NAME with a suitable name for your application:

    az ad sp create-for-rbac --name "YOUR_APP_NAME" --role contributor --scopes /subscriptions/YOUR_SUBSCRIPTION_ID
    

    Replace YOUR_SUBSCRIPTION_ID with your subscription id.

    The output of this command will provide the appId, displayName, name, password, and tenant. It's crucial to note these values, especially appId (Client ID) and password (Client Secret), as you'll need them for Terraform authentication.

  4. Specify the service principal credentials in environment variables

    bash:

    export ARM_SUBSCRIPTION_ID="<azure_subscription_id>"
    export ARM_TENANT_ID="<azure_subscription_tenant_id>"
    export ARM_CLIENT_ID="<service_principal_appid>"
    export ARM_CLIENT_SECRET="<service_principal_password>"
    

    To execute the ~/.bashrc script, run source ~/.bashrc (or its abbreviated equivalent . ~/.bashrc). You can also exit and reopen Cloud Shell for the script to run automatically. Run the following bash command to verify the Azure environment variables:

    . ~/.bashrc
    

    powershell:

    $env:ARM_SUBSCRIPTION_ID="<azure_subscription_id>"
    $env:ARM_TENANT_ID="<azure_subscription_tenant_id>"
    $env:ARM_CLIENT_ID="<service_principal_appid>"
    $env:ARM_CLIENT_SECRET="<service_principal_password>"
    

    Run the following PowerShell command to verify the Azure environment variables:

    gci env:ARM_*
    

    Replace the values with your own.

Creating a Terraform Configuration

  1. Create a new directory for your Terraform configuration files.

  2. Create a new file named main.tf in the directory and add the following code:

    # Configure the Azure provider
    terraform {
      required_providers {
        azurerm = {
          source  = "hashicorp/azurerm"
          version = "~> 3.0.0"
        }
      }
      required_version = ">= 0.14.9"
    }
    provider "azurerm" {
      features {}
    }
    
    # Create the resource group
    resource "azurerm_resource_group" "rg" {
      name     = "demo-abp-web-app"
      location = "westeurope"
    }
    
    # Create the Linux App Service Plan
    resource "azurerm_service_plan" "appserviceplan" {
      name                = "demo-abp-web-app-plan"
      location            = azurerm_resource_group.rg.location
      resource_group_name = azurerm_resource_group.rg.name
      os_type             = "Linux"
      sku_name            = "B3"
    }
    
    # Create the web app, pass in the App Service Plan ID
    resource "azurerm_linux_web_app" "webapp" {
      name                  = "demo-abp-web-app"
      location              = azurerm_resource_group.rg.location
      resource_group_name   = azurerm_resource_group.rg.name
      service_plan_id       = azurerm_service_plan.appserviceplan.id
      https_only            = true
      site_config {
        application_stack {
          dotnet_version = "6.0"
        }
        minimum_tls_version  = "1.2"
      }
    }
    
    output "webappurl" {
    
      value = "${azurerm_linux_web_app.webapp.name}.azurewebsites.net"
    }
    
  3. Run terraform init to initialize the directory.

  4. Run terraform plan to see the execution plan.

  5. Run terraform apply to apply the changes. Write yes when prompted to confirm the deployment.

  6. Wait for the deployment to complete.

  7. Navigate to the web app URL to see the deployed application.

You can also see the web app URL in the output of the terraform apply command.

You have to change the dotnet version of the runtime stack according to your application. For example, if you are using .NET 7, you should change dotnet_version = "6.0" to dotnet_version = "7.0".

Azure Web App

Destroying the Terraform Configuration

  1. Run terraform destroy to destroy the created resources.

  2. Type yes when prompted to confirm the destruction.

Contributors


Last updated: October 23, 2024 Edit this page on GitHub

Was this page helpful?

Please make a selection.

To help us improve, please share your reason for the negative feedback in the field below.

Please enter a note.

Thank you for your valuable feedback!

Please note that although we cannot respond to feedback, our team will use your comments to improve the experience.

In this document
Community Talks

What’s New with .NET 9 & ABP 9?

21 Nov, 17:00
Online
Watch the Event
Mastering ABP Framework Book
Mastering ABP Framework

This book will help you gain a complete understanding of the framework and modern web application development techniques.

Learn More