The Azure Developer CLI (azd) provides two different workflows to initialize a template to use with your app, which include:
Both of these approaches are explored in the Create Azure Developer CLI templates overview doc.
In this article, you learn how to add support for the Azure Developer CLI (azd) to your app through the Select a template approach. Visit the Add azd support to your app using an existing template doc for more information on the alternative approach. You can also visit the Training - build and deploy azd templates for more information on building azd templates.
The Select a template workflow of the azd init command allows you to choose an existing azd template to use as a starting point. The contents of the selected template are added to the root directory of your project. Most templates provide the required set of azd files and folders, and many include a complete set infrastructure-as-code files to provision Azure resources for a chosen application stack.
In this example, you'll use the Starter - Bicep template, which includes the essential structure of an azd template and some useful boilerplate code to get started. Starter templates are a great choice when you want to scaffold out the correct template structure and starting resources, but still author your own infrastructure files.
To follow along with the steps ahead using an existing sample application, clone the following starter project to an empty directory on your computer:
git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart
In your command line tool of choice, navigate to the root directory of the cloned project.
Run the azd init command to initialize an azd template.
azd init
When prompted, choose the option to Select a template.
From the list of templates, select Starter - Bicep. You can type the template name or use your keyboard arrow keys to find it.
When prompted, enter a short environment name, such as testenv.
After you run azd init, the following assets are added to your current directory:
âââ .azdo [ Configures an Azure Pipeline ]
âââ .devcontainer [ For DevContainer ]
âââ .github [ Configures a GitHub workflow ]
âââ .vscode [ VS Code workspace configurations ]
âââ .azure [ Stores Azure configurations and environment variables ]
âââ infra [ Contains infrastructure as code files ]
â âââ main.bicep/main.tf [ Main infrastructure file ]
â âââ main.parameters.json/main.tfvars.json [ Parameters file ]
â âââ core/modules [ Contains reusable Bicep/Terraform modules ]
âââ azure.yaml [ Describes the app and type of Azure resources]
Your project now contains the core structure and assets of an azd template. However, to provision the Azure resources for your specific project, the Bicep files in the infra folder need to be updated. To host the sample application, you'll need to define the following resources using Bicep files:
Open the root project directory in your editor of choice, such as Visual Studio Code.
Open the main.bicep file in the infra folder using your editor. This file contains useful boilerplate code to setup essential variables, parameters, and naming conventions. Beneath the comment block around line 50 that reads Add resources to be provisioned below, add the following Bicep:
// Creates an app service instance to host the app
module web './core/host/appservice.bicep' = {
name: 'web'
scope: rg
params: {
name: '${abbrs.webSitesAppService}web-${resourceToken}'
location: location
tags: union(tags, { 'azd-service-name': 'web' })
appServicePlanId: appServicePlan.outputs.id
runtimeName: 'python'
runtimeVersion: '3.8'
scmDoBuildDuringDeployment: true
}
}
// Create an App Service Plan to group applications under the same payment plan and SKU
module appServicePlan './core/host/appserviceplan.bicep' = {
name: 'appserviceplan'
scope: rg
params: {
name: '${abbrs.webServerFarms}${resourceToken}'
location: location
tags: tags
sku: {
name: 'B1'
}
}
}
Note
${resourceToken} variable. This token is appended to the name of all Azure resources created by azd.azd uses tags to identify resources so you can modify the names based on your organization's naming convention.'azd-service-name': 'web' tag on the app service is the value azd uses to identify deployment host. The value must be the same as what is defined for the service in the azure.yaml file.To deploy the app, azd needs to know more about your app. The azure.yaml file is used to define the source code location, language, and the Azure hosting service for each service in your app. For full details, refer to the azure.yaml schema.
Open the azure.yaml at the root of the project.
Add the following lines to the bottom of the file:
name: msdocs-python-flask-webapp-quickstart
services:
web:
project: .
language: py
host: appservice
Save all of your changes and run the following command to provision and deploy the app resources on Azure:
azd up
When the command finishes, click the link in the command output to navigate to the deployed site.
Your project is now compatible with Azure Developer CLI and can be used as a template.
Note
azd also supports using Buildpack for containerizing your apps by default. If your azd template targets Azure Container Apps or Azure Kubernetes Service but does not include a Docker file, azd automatically generates an image using Buildpack.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4