练习 - 设置环境

  • 4 分钟

重要

需要自己的 Azure 订阅才能完成本练习，并且可能会产生费用。 如果还没有 Azure 订阅，请在开始前创建一个免费帐户。

在你开始处理玩具公司的网站管道之前，需要配置环境。 在本部分中，确保已设置好 Azure 和 Azure DevOps 环境，以完成本模块的其余操作。

为了达成这些目标，你需要：

  • 设置一个 Azure DevOps 项目供本模块使用。
  • 将项目的存储库克隆到计算机。
  • 在 Azure 中创建资源组。
  • 在 Azure Pipelines 中创建服务连接。

获取 Azure DevOps 项目

在本部分中，你将确保已设置 Azure DevOps 组织以完成本模块的其余部分。 你可运行在 Azure DevOps 中创建项目的模板来进行设置。

本学习路径中的模块是循序渐进的。 每个模块都有一个关联的 Azure DevOps 项目。

提示

即使你在学习路径中完成了上一个模块，请按照这些说明创建新项目并确保为其指定一个新名称。

运行模板

运行一个模板来设置 Azure DevOps 组织。

  1. 在 Visual Studio 或其他 IDE 中获取并运行 ADOGenerator 项目。

  2. 当系统询问是要创建新模板还是使用演示生成器时，请输入 1 ，然后选择 Enter。

  3. 当系统提示 输入上述模板列表中的模板编号时，以使用 Azure Pipelines 测试 Bicep 代码为目的，输入 41，然后按下 Enter 键。

  4. 选择身份验证方法。 可以 设置和使用个人访问令牌（PAT） 或使用设备登录。

    注释

    如果设置了 PAT，请务必授权必要的 范围。 对于本模块，可以使用 “完全访问权限”，但在实际情况下，应仅授予必要的范围。

  5. 输入 Azure DevOps 组织名称，然后选择 Enter。

  6. 如果出现提示，请输入 Azure DevOps PAT，然后选择 Enter。

  7. 输入项目名称（如 玩具网站测试），然后选择 Enter。

  8. 创建项目后，在浏览器中（at https://dev.azure.com/<your-organization-name>/）转到 Azure DevOps 组织并选择该项目。

  9. 在 Azure DevOps 中，在默认池 中创建自承载代理 。

为存储库创建分支

如果尚未创建，请创建 mslearn-test-bicep-code-using-github-actions 存储库的分支。

  1. 在 GitHub 上，转到 mslearn-test-bicep-code-using-github-actions 存储库。

  2. 选择屏幕右上角的 Fork。

  3. 选择 GitHub 帐户作为“所有者”，然后选择“创建分支”。

克隆存储库

  1. 在 Azure DevOps 中，选择“存储库”“文件”。>

    Azure DevOps 的屏幕截图，显示 Repos 菜单，其中 Files 被突出显示。

  2. 选择“克隆”。

    显示存储库的 Azure DevOps 的屏幕截图。突出显示了“克隆”按钮。

  3. 如果使用的是 macOS，则需要提供特定密码才能克隆 Git 存储库。 选择“ 生成 Git 凭据 ”，并将显示的用户名和密码复制到安全位置。

  4. 选择“在 VS Code 中克隆”。 如果系统提示你允许打开 Visual Studio Code，请选择“打开”。

    显示存储库设置的 Azure DevOps 的屏幕截图。突出显示了 Visual Studio Code 中克隆的按钮。

  5. 如果对话框提示你允许扩展打开存储库 URI，请选择“ 打开”。

  6. 创建要用于存储库的文件夹，然后单击“ 选择为存储库目标”。

  7. 这是你第一次使用此存储库，因此系统会提示你登录。

    • 如果使用的是 Windows，请输入你在本练习前面用于登录 Azure DevOps 的相同凭据。

    • 如果使用的是 macOS，请输入你前一刻生成的 Git 用户名和密码。

  8. Visual Studio Code 会提示你打开存储库。 选择“打开” 。

    Visual Studio Code 提示符打开克隆的存储库的屏幕截图。突出显示了“打开”按钮。

登录 Azure

若要使用 Azure 中的资源组，请从 Visual Studio Code 终端登录到 Azure 帐户。 请确保已安装 Azure CLI 工具。

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

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

    Visual Studio Code 终端窗口的屏幕截图。突出显示 bash 选项。

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

    Visual Studio Code 终端窗口的屏幕截图。将显示终端 shell 下拉列表，并选择了 Git Bash。

  4. 在终端 shell 列表中，选择“bash”，然后选择加号以打开使用 bash shell 的新终端。

    Visual Studio Code 终端窗口的屏幕截图。bash 终端和加号突出显示。

使用 Azure CLI 登录到 Azure

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

    az login

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

若要使用 Azure 中的资源组，请从 Visual Studio Code 终端登录到 Azure 帐户。 确保已安装 Azure PowerShell。

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

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

    Visual Studio Code 终端窗口的屏幕截图。突出显示了 pwsh 选项。

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

    Visual Studio Code 终端窗口的屏幕截图。在终端 shell 下拉列表中选择 PowerShell。

  4. 在终端 shell 列表中，选择“powershell”或“pwsh”，然后选择加号以打开使用 powershell 或 pwsh shell 的新终端。

    Visual Studio Code 终端窗口的截屏。PowerShell 终端和加号按钮已被选中。

使用 Azure PowerShell 登录到 Azure

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

    Connect-AzAccount

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

在 Azure 中创建资源组

若要创建资源组，请在 Visual Studio Code 终端中运行此 Azure CLI 命令：

az group create --name ToyWebsiteTest --___location westus3

若要创建资源组，请在 Visual Studio Code 终端中运行以下 Azure PowerShell 命令：

New-AzResourceGroup -Name ToyWebsiteTest -Location westus3

在 Azure Pipelines 中创建服务连接

接下来，在 Azure Pipelines 中创建服务连接。 该连接将在 Azure 中自动创建一个服务主体。 它还会向服务主体授予资源组的“参与者”角色，从而使管道可部署到该资源组。

  1. 在之前创建的项目中，选择 “项目设置”。

    Azure DevOps 的屏幕截图。突出显示项目设置的菜单项。

  2. 选择“服务连接”“创建服务连接”。

    Azure DevOps 的屏幕截图，其中显示了创建服务连接的步骤。

  3. 选择“Azure 资源管理器”“下一步”。

    Azure DevOps 的屏幕截图。已选择 Azure 资源管理器服务连接类型。

  4. 选择“应用注册”（自动）。

  5. 在“订阅”下拉列表中，选择自己的 Azure 订阅。

    弹出窗口可能会提示你登录到 Azure。 如果是，请输入凭据并登录。

  6. 在“资源组”下拉列表中，选择“ToyWebsiteTest”。

  7. 在 服务连接名称中，输入 ToyWebsiteTest。 请确保选中“为所有管道授予访问权限”复选框。

    显示创建服务连接的步骤的屏幕截图。

    提示

    为简单起见，你向每个管道提供对服务连接的访问权限。 创建使用生产资源的实际服务连接时，请考虑仅将访问权限提供给需要这些连接的管道。

  8. 选择“保存”。