排查 Bicep 安装问题
本文介绍如何解决 Bicep 安装中的潜在错误。
.NET 运行时错误
安装适用于 Visual Studio Code 的 Bicep 扩展时,可能会遇到以下错误消息:
Failed to install .NET runtime v5.0
Failed to download .NET 5.0.x ....... Error!
警告
这是最后的解决方案,可能会在更新版本时导致问题。
若要解决此问题,可以从 .NET 网站手动安装 .NET,然后使用以下设置配置 Visual Studio Code 以重用现有的 .NET 安装:
Windows
"dotnetAcquisitionExtension.existingDotnetPath": [
{
"extensionId": "ms-azuretools.vscode-bicep",
"path": "C:\\Program Files\\dotnet\\dotnet.exe"
}
]
macOS
如果需要的是 x64 安装,请使用:
"dotnetAcquisitionExtension.existingDotnetPath": [
{
"extensionId": "ms-azuretools.vscode-bicep",
"path": "/usr/local/share/dotnet/x64/dotnet"
}
]
对于其他 macOS 安装,请使用:
"dotnetAcquisitionExtension.existingDotnetPath": [
{
"extensionId": "ms-azuretools.vscode-bicep",
"path": "/usr/local/share/dotnet/dotnet"
}
]
请参阅用户和工作区设置,以了解如何配置 Visual Studio Code 设置。
已安装多个版本的 Bicep CLI
如果将 Bicep CLI 手动安装到多个位置,可能会出现意外行为,例如运行 upgrade 命令时 Bicep CLI 不更新。 或者,你可能会注意到,运行 az bicep version
会返回一个版本,但运行 bicep --version
会返回另一个版本。
若要解决此问题,可以更新所有位置,也可以选择一个位置来维护和删除其他位置。
首先,打开命令提示符(不是 PowerShell),然后运行 where bicep
。 此命令返回 Bicep 安装的位置。 如果使用由 Azure CLI 管理的 Bicep CLI 实例,则看不到此安装,因为它未添加到 PATH。 如果 where bicep
仅返回一个位置,则可能是你所看到的冲突版本介于手动安装与 Azure CLI 安装之间。
若要保留所有安装位置,请使用前面使用的相同方法为要维护的所有位置手动安装 Bicep CLI。 如果使用的是 Azure CLI,请运行 az bicep upgrade
以更新该版本。
若要仅保留一个安装位置,请执行以下步骤:
- 删除不想保留的安装的文件。
- 从 PATH 环境变量中删除这些位置。
如果既有手动安装,又有由 Azure CLI 管理的实例,你可以改为仅使用一个实例。
- 删除手动安装位置。
- 向 PATH 变量中添加由 Azure CLI 安装的 Bicep CLI 的位置。 对于Windows,由 Azure CLI 维护的位置为
%USERPROFILE%\.Azure\bin
。
将 Azure CLI 实例添加到 PATH 后,可以通过 az bicep
或 bicep
使用该版本。
后续步骤
有关使用 Visual Studio Code 和 Bicep 扩展的详细信息,请参阅快速入门:使用 Visual Studio Code 创建 Bicep 文件。