上一篇

下一步

练习 - 在 Bicep 模板中定义资源

已完成

备注

首次激活沙盒并接受这些条款后，你的 Microsoft 帐户将与名为“Microsoft Learn 沙盒”的新 Azure 目录相关联。 还会将你添加到名为“Concierge 订阅”的特殊订阅中。

对于玩具发布网站，你决定首先通过创建一个基本的 Bicep 模板来创建概念证明。 在本练习中，你将创建一个存储帐户、Azure 应用服务计划和应用。 稍后，你将修改模板，使其更易于重复使用。

在此过程中，你将：

• 创建一个模板，用于定义包含硬编码值的单个存储帐户资源。
• 预配基础结构并验证结果。
• 将应用服务计划和应用添加到模板。
• 再次预配基础结构以查看新资源。

本练习使用适用于 Visual Studio Code 的 Bicep 扩展。 请务必在 Visual Studio Code 中安装此扩展。

创建包含存储帐户的 Bicep 模板

1. 打开 Visual Studio Code。

2. 新建一个名为 main.bicep 的文件。

3. 保存空文件，以便 Visual Studio Code 加载 Bicep 工具。

   你可以选择“文件”>“另存为”，也可以在 Windows 中选择Ctrl+S（在 macOS 上选择 ⌘+S）。 请务必记住保存文件的位置。 例如，你需要创建一个“模板”文件夹来存储文件。

4. 将以下 Bicep 代码添加到文件中。 你很快就会部署模板。 最好是你自行键入此代码，而不是复制和粘贴，这样就可以了解工具如何帮助你编写 Bicep 文件。

   resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
     name: 'toylaunchstorage'
     location: 'eastus'
     sku: {
       name: 'Standard_LRS'
     }
     kind: 'StorageV2'
     properties: {
       accessTier: 'Hot'
     }
   }
   

   提示

   Bicep 对换行符的位置非常严格，因此，请确保不要将换行符放在此处所列位置之外的其他位置。

   请注意，在你键入时，Visual Studio Code 会自动提供属性名称建议。 Visual Studio Code 的 Bicep 扩展可理解你要在模板中定义的资源，并列出属性和值供你使用。

5. 将存储帐户的名称从 toylaunchstorage 更新为可能是唯一的名称，因为每个存储帐户都需要一个全局唯一的名称。 确保名称的长度为 3 到 24 个字符，仅包含小写字母和数字。

   重要

   请勿跳过此步骤。 如果跳过，Bicep 文件将不会成功部署。

6. 保存对文件所做的更改。

将 Bicep 模板部署到 Azure

若要将此模板部署到 Azure，你需要从 Visual Studio Code 终端登录到 Azure 帐户。 请确保安装了 Azure CLI，并记得使用你用于激活沙盒的同一帐户登录。

1. 在“终端”菜单中，选择“新终端”。 终端窗口通常在屏幕的下半部分打开。

2. 如果终端窗口右侧显示的 shell 为“bash”，则将打开正确的 shell，你可以跳到下一部分。

   

3. 如果出现“bash”以外的 shell，请选择 shell 下拉箭头，然后选择“Azure Cloud Shell (Bash)”。

   

4. 在终端 shell 列表中，选择“bash”。

   

5. 在终端中，转到保存模板的目录。 例如，如果将模板保存到 templates 文件夹，则可以使用以下命令：

   cd templates
   

安装 Bicep

运行以下命令以确保具有最新版本的 Bicep：

az bicep install && az bicep upgrade

登录 Azure

1. 在 Visual Studio Code 终端中，运行以下命令登录到 Azure：

   az login
   

2. 在打开的浏览器中，登录到 Azure 帐户。

   Visual Studio Code 终端显示与此帐户关联的订阅列表。

3. 为在此会话中运行的所有 Azure CLI 命令设置默认订阅。

   az account set --subscription "Concierge Subscription"
   

   注意

   如果最近使用了多个沙盒，终端可能会显示多个 Concierge 订阅实例。 在这种情况下，请使用下面的两个步骤来设置一个默认订阅。 如果前面的命令成功，且仅列出一个 Concierge 订阅，则跳过下面的两个步骤。

4. 获取 Concierge 订阅 ID。

    az account list \
      --refresh \
      --query "[?contains(name, 'Concierge Subscription')].id" \
      --output table
   

5. 使用订阅 ID 设置默认订阅。 将 {your subscription ID} 替换为最新的 Concierge 订阅 ID。

   az account set --subscription {your subscription ID}
   

设置默认资源组

当你使用 Azure CLI 时，可以设置默认资源组，并忽略本练习中其他 Azure CLI 命令的参数。 将默认值设置为在沙盒环境中为你创建的资源组。

az configure --defaults group="<rgn>[sandbox resource group name]</rgn>"

将模板部署到 Azure

从 Visual Studio Code 的终端运行以下命令，以将 Bicep 模板部署到 Azure。 此命令可能需要一两分钟才能完成，然后你会看到成功的部署。 如果显示有关位置被硬编码的警告，你可以忽略它。 稍后将在模块中修复该位置。 可以继续操作，部署将成功。

az deployment group create --template-file main.bicep

你会在终端中看到 Running...。

若要将此模板部署到 Azure，需要从 Visual Studio Code 终端登录到 Azure 帐户。 请确保已安装 Azure PowerShell，并且登录的帐户与激活了沙盒的帐户相同。

1. 在“终端”菜单中，选择“新终端”。 终端窗口通常在屏幕的下半部分打开。

2. 如果终端窗口右侧显示的 shell 为“powershell”或“pwsh”，则会打开正确的 shell，你可以跳到下一部分。

   

3. 如果出现“powershell”或“pwsh”以外的 shell，请选择 shell 下拉箭头，然后选择“PowerShell”。

   

4. 在终端 shell 列表中，选择“powershell”或“pwsh”。

   

5. 在终端中，转到保存模板的目录。 例如，如果将模板保存到 templates 文件夹，则可以使用以下命令：

   Set-Location -Path templates
   

安装 Bicep CLI

若要从 Azure PowerShell 中使用 Bicep，请安装 Bicep CLI。

使用 Azure PowerShell 登录到 Azure

1. 在 Visual Studio Code 终端中，运行以下命令：

   Connect-AzAccount
   

   在打开的浏览器中，登录到 Azure 帐户。

2. 登录到 Azure 后，终端会显示与此帐户关联的订阅列表。

   如果已激活沙盒，则会显示名为“Concierge 订阅”的订阅。 请在本练习的其余部分使用此订阅。

3. 为在此会话中运行的所有 Azure PowerShell 命令设置默认订阅。

   $context = Get-AzSubscription -SubscriptionName 'Concierge Subscription'
   Set-AzContext $context
   

   注意

   如果最近使用了多个沙盒，终端可能会显示多个 Concierge 订阅实例。 在这种情况下，请使用下面的两个步骤来设置一个默认订阅。 如果前面的命令成功，且仅列出一个 Concierge 订阅，则跳过下面的两个步骤。

4. 获取订阅 ID。 运行以下命令将列出你的订阅及其 ID。 查看 Concierge Subscription，然后复制第二列中的 ID。 它类似于 cf49fbbc-217c-4eb6-9eb5-a6a6c68295a0。

   Get-AzSubscription
   

5. 将处于活动状态的订阅更改为“Concierge 订阅”。 请务必将 {Your subscription ID} 替换为复制的内容。

   $context = Get-AzSubscription -SubscriptionId {Your subscription ID}
   Set-AzContext $context
   

设置默认资源组

你可以设置默认资源组，并忽略本练习中其他 Azure PowerShell 命令的参数。 将此默认值设置为在沙盒环境中为你创建的资源组。

Set-AzDefault -ResourceGroupName <rgn>[sandbox resource group name]</rgn>

将模板部署到 Azure

在终端中使用以下 Azure PowerShell 命令将模板部署到 Azure。 此命令可能需要一两分钟才能完成，然后你会看到成功的部署。 如果显示有关位置被硬编码的警告，你可以忽略它。 稍后将在模块中修复该位置。 可以继续操作，部署将成功。

New-AzResourceGroupDeployment -TemplateFile main.bicep

验证部署

首次部署 Bicep 模板时，你可能需要使用 Azure 门户验证部署是否已成功完成，并检查结果。

1. 转到 Azure 门户并确保你位于沙盒订阅中：

   1. 选择页面右上角的头像。
   2. 选择“切换目录”。 在列表中，选择“Microsoft Learn 沙盒”目录。

2. 在左侧面板上，选择“资源组”。

3. 选择 沙盒资源组名称。

4. 在“概述”中，你会看到一个成功的部署。 可能需要展开 Essentials 区域才能查看部署。

   

5. 选择“1 个已成功”以查看部署的详细信息。

   

6. 选择名为“main”的部署，查看部署了哪些资源，然后选择“部署详细信息”以将其展开。 在本例中，有一个具有你指定的名称的存储帐户。

   

7. 使页面在浏览器中处于打开状态。 稍后会再次检查部署。

你也可以从命令行验证部署。 为此，请运行以下 Azure CLI 命令：

az deployment group list --output table

你也可以从命令行验证部署。 为此，请运行以下 Azure PowerShell 命令：

Get-AzResourceGroupDeployment -ResourceGroupName <rgn>[sandbox resource group name]</rgn> | Format-Table

向 Bicep 模板添加应用服务计划和应用

在上一个任务中，你了解了如何创建一个包含单个资源的模板并部署它。 现在，你已准备好部署更多资源，包括依赖项。 在此任务中，你将向 Bicep 模板添加应用服务计划和应用。

1. 在 Visual Studio Code 的 main.bicep 文件中，将以下代码添加到文件底部：

   resource appServicePlan 'Microsoft.Web/serverfarms@2023-12-01' = {
     name: 'toy-product-launch-plan-starter'
     location: 'eastus'
     sku: {
       name: 'F1'
     }
   }
   
   resource appServiceApp 'Microsoft.Web/sites@2023-12-01' = {
     name: 'toy-product-launch-1'
     location: 'eastus'
     properties: {
       serverFarmId: appServicePlan.id
       httpsOnly: true
     }
   }
   

2. 将应用服务应用的名称从 toy-product-launch-1 更新为可能唯一的名称。 请确保名称的长度为 2 到 60 个字符，包含大写和小写字母、数字和连字符，并且不以连字符开头或结尾。

3. 保存对文件所做的更改。

部署已更新的 Bicep 模板

在终端中运行以下 Azure CLI 命令。 你可以忽略有关硬编码位置的警告。 你将很快修复位置。

az deployment group create --template-file main.bicep

在终端中运行以下 Azure PowerShell 命令。 你可以忽略有关硬编码位置的警告消息。 你将很快修复位置。

New-AzResourceGroupDeployment -TemplateFile main.bicep

检查你的部署

1. 返回 Azure 门户，转到资源组。 你仍然会看到一个成功的部署，因为部署使用了与第一个部署相同的名称。

2. 选择“1 个成功”链接。

3. 选择名为“main”的部署，然后选择“部署详细信息”以展开已部署的资源列表。

   

4. 请注意，应用服务计划和应用已部署。

继续