title	Use an Azure Resource Manager template to deploy a Linux web app to Azure
description	Use an Azure Resource Manager template to deploy a Linux web app to Azure
ms.topic	quickstart
ms.author	jukullam
author	JuliaKM
ms.date	12/09/2025
monikerRange	=azure-devops
ms.custom	subject-armqs, devx-track-arm-template, arm2024, linux-related-content

Quickstart: Use an ARM template to deploy a Linux web app to Azure

[!INCLUDE version-eq-azure-devops]

Get started with Azure Resource Manager templates (ARM templates) by deploying a Linux web app with MySQL. ARM templates give you a way to save your configuration in code. Using an ARM template is an example of infrastructure as code and a good DevOps practice.

An ARM template is a JavaScript Object Notation (JSON) file that defines the infrastructure and configuration for your project. The template uses declarative syntax. In declarative syntax, you describe your intended deployment without writing the sequence of programming commands to create the deployment.

You can use either JSON or Bicep syntax to deploy Azure resources. Learn more about the difference between JSON and Bicep for templates.

Prerequisites

Before you begin, you need:

An Azure account with an active subscription. Create an account for free.
An active Azure DevOps organization. Sign up for Azure Pipelines.
(For Bicep deployments) An existing resource group. Create a resource group with Azure portal, Azure CLI, or Azure PowerShell.

Get the code

Fork this repository on GitHub:

https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.web/webapp-linux-managed-mysql

Review the template

JSON

The template used in this quickstart is from Azure Quickstart Templates.

The template defines several resources:

Bicep

The Bicep template used in this quickstart deploys the same resources as the JSON template. Bicep provides a more readable syntax for defining Azure resources.

Create your pipeline and deploy your template

JSON

Sign in to your Azure DevOps organization and navigate to your project. Create a project if you do not already have one.
Go to Pipelines, and then select Create Pipeline.
Select GitHub as the location of your source code.

[!NOTE] You may be redirected to GitHub to sign in. If so, enter your GitHub credentials.
When the list of repositories appears, select yourname/azure-quickstart-templates/.

[!NOTE] You may be redirected to GitHub to install the Azure Pipelines app. If so, select Approve and install.
When the Configure tab appears, select Starter pipeline.

Replace the content of your pipeline with this code:

trigger:
  - none

pool:
  vmImage: 'ubuntu-latest'

Create pipeline variables for siteName, administratorLogin, and administratorLoginPassword. The password variable should be marked as secret.
- Select Variables on the pipeline page.
- Use the + button to add variables.
- For administratorLoginPassword, select Keep this value secret.

Add the Copy Files task to the YAML file:

trigger:
  - none

pool:
  vmImage: 'ubuntu-latest'

steps:
  - task: CopyFiles@2
    inputs:
      SourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'
      Contents: '**'
      TargetFolder: '$(Build.ArtifactStagingDirectory)'

Add and configure the Azure Resource Group Deployment task:

trigger:
  - none

pool:
  vmImage: 'ubuntu-latest'

steps:
  - task: CopyFiles@2
    inputs:
      SourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'
      Contents: '**'
      TargetFolder: '$(Build.ArtifactStagingDirectory)'

  - task: AzureResourceManagerTemplateDeployment@3
    inputs:
      deploymentScope: 'Resource Group'
      azureResourceManagerConnection: '<your-resource-manager-connection>'
      subscriptionId: '<your-subscription-id>'
      action: 'Create Or Update Resource Group'
      resourceGroupName: 'ARMPipelinesLAMP-rg'
      location: '<your-closest-location>'
      templateLocation: 'Linked artifact'
      csmFile: '$(Build.ArtifactStagingDirectory)/azuredeploy.json'
      csmParametersFile: '$(Build.ArtifactStagingDirectory)/azuredeploy.parameters.json'
      overrideParameters: '-siteName $(siteName) -administratorLogin $(administratorLogin) -administratorLoginPassword $(administratorLoginPassword)'
      deploymentMode: 'Incremental'

Click Save and run to deploy your template. The pipeline job will be launched and after a few minutes, depending on your agent, the job status should indicate Success.

Bicep

Sign in to your Azure DevOps organization and navigate to your project. Create a project if you do not already have one.
Go to Pipelines, and then select Create Pipeline.
Select GitHub as the location of your source code.

[!NOTE] You may be redirected to GitHub to sign in. If so, enter your GitHub credentials.
When the list of repositories appears, select yourname/azure-quickstart-templates/.

[!NOTE] You may be redirected to GitHub to install the Azure Pipelines app. If so, select Approve and install.
When the Configure tab appears, select Starter pipeline.

Replace the content of your pipeline with this code:

trigger:
  - none

pool:
  vmImage: 'ubuntu-latest'

Create pipeline variables for siteName, administratorLogin, and administratorLoginPassword. The password variable should be marked as secret.
- Select Variables on the pipeline page.
- Use the + button to add variables.
- For administratorLoginPassword, select Keep this value secret.

At the top of your YAML file, map values for location and resourceGroupName. Your location should be the location of the resource group. Your resource group needs to already exist.

variables:
  vmImageName: 'ubuntu-latest'
  resourceGroupName: '<resource-group-name>'
  location: '<your-closest-location>'
  templateFile: './main.bicep'
  sourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'

If you do not already have an Azure Resource Manager service connection, create a service connection. Learn more about connecting to Azure.

Add the Azure CLI task to deploy with Bicep:

variables:
  vmImageName: 'ubuntu-latest'
  resourceGroupName: '<resource-group-name>'
  location: '<your-closest-location>'
  templateFile: './main.bicep'
  sourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'

trigger:
  - none

pool:
  vmImage: $(vmImageName)

steps:
  - task: AzureCLI@2
    inputs:
      azureSubscription: '<service-connection-name>'
      scriptType: bash
      scriptLocation: inlineScript
      inlineScript: |
        az deployment group create --resource-group $(resourceGroupName) --template-file $(sourceFolder)$(templateFile) \
        --parameters administratorLogin=$(administratorLogin) administratorLoginPassword=$(administratorLoginPassword)

Review deployed resources

JSON

Verify that the resources deployed. Go to the ARMPipelinesLAMP-rg resource group in the Azure portal and verify that you see App Service, App Service Plan, and Azure Database for MySQL server resources.

:::image type="content" source="media/azure-resources-portal.png" alt-text="ARM template resources in the Azure portal":::

You can also verify the resources using Azure CLI.
```
az resource list --resource-group ARMPipelinesLAMP-rg --output table
```
Go to your new site. If you set siteName to armpipelinetestsite, the site is located at https://armpipelinetestsite.azurewebsites.net/.

Bicep

Verify that the resources deployed. Go to your resource group in the Azure portal and verify that you see App Service, App Service Plan, and Azure Database for MySQL server resources.

:::image type="content" source="media/azure-resources-portal.png" alt-text="ARM template resources in the Azure portal":::

You can also verify the resources using Azure CLI.
```
az resource list --resource-group <resource-group-name> --output table
```
Go to your new site. If you set siteName to armpipelinetestsite, the site is located at https://armpipelinetestsite.azurewebsites.net/.

Clean up resources

JSON

You can also use an ARM template to delete resources. Change the action value in your Azure Resource Group Deployment task to DeleteRG. You can also remove the inputs for templateLocation, csmFile, csmParametersFile, overrideParameters, and deploymentMode.

trigger:
  - none

pool:
  vmImage: 'ubuntu-latest'

steps:
  - task: CopyFiles@2
    inputs:
      SourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'
      Contents: '**'
      TargetFolder: '$(Build.ArtifactStagingDirectory)'

  - task: AzureResourceManagerTemplateDeployment@3
    inputs:
      deploymentScope: 'Resource Group'
      azureResourceManagerConnection: '<your-resource-manager-connection>'
      subscriptionId: '<your-subscription-id>'
      action: 'DeleteRG'
      resourceGroupName: 'ARMPipelinesLAMP-rg'
      location: '<your-closest-location>'

Bicep

If you no longer need your deployed resources, delete your resource group.

az group delete -n <resource-group-name>

Next steps

[!div class="nextstepaction"] Create your first ARM template

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Quickstart: Use an ARM template to deploy a Linux web app to Azure

Prerequisites

Get the code

Review the template

JSON

Bicep

Create your pipeline and deploy your template

JSON

Bicep

Review deployed resources

JSON

Bicep

Clean up resources

JSON

Bicep

Next steps

FilesExpand file tree

deploy-arm-template.md

Latest commit

History

deploy-arm-template.md

File metadata and controls

Quickstart: Use an ARM template to deploy a Linux web app to Azure

Prerequisites

Get the code

Review the template

Create your pipeline and deploy your template

Review deployed resources

Clean up resources

Next steps