在本地配置并运行 Azure DevOps 演示生成器

Azure DevOps Services

重要

Azure DevOps 演示生成器已停用

Microsoft已停止对 Azure DevOps 演示生成器的进一步开发和投资。 虽然此工具提供了用于使用示例数据创建预配置的 Azure DevOps 项目的重要功能,但我们将资源集中在其他平台功能上,以便更好地满足不断变化的客户需求。

建议的替代方法:

可以在本地计算机上以控制台应用程序或可执行文件的形式运行 Azure DevOps 演示生成器项目。 此方法可让你更好地控制工具的执行,并允许你针对特定方案自定义其行为。

先决条件

在开始之前,请确保计算机上安装了这些组件:

在本地设置演示生成器

按照以下步骤在本地计算机上配置并运行演示生成器:

  1. Azure DevOps 演示生成器存储库 克隆到本地计算机:

    git clone https://github.com/microsoft/AzDevOpsDemoGenerator.git
    cd AzDevOpsDemoGenerator
    
  2. 在 Visual Studio 或首选 IDE 中打开 ADOGenerator.sln 解决方案文件。

  3. 在 Visual Studio 中,设置启动项目:

    1. 右键单击解决方案资源管理器中的 ADOGenerator 项目。
    2. 选择“ 设置为启动项目”。
  4. 生成解决方案以还原所有依赖项,并确保项目成功编译:

    1. 在 Visual Studio 中: 右键单击解决方案资源管理器中的解决方案,然后选择“ 生成解决方案”。
    2. 在命令行中:
    dotnet build
    
  5. 使用以下方法之一将项目作为控制台应用程序运行:

    1. 在 Visual Studio 中:F5 或选择 “开始 ”按钮。
    2. 在命令行中:
    dotnet run --project src/ADOGenerator/ADOGenerator.csproj
    

创建可执行文件

创建可在没有 .NET SDK 的计算机上分发或运行的独立可执行文件:

发布项目

在 Visual Studio 中:

  1. 右键单击解决方案资源管理器中的 ADOGenerator 项目。
  2. 选择发布
  3. 按照提示配置发布设置(目标文件夹、配置、运行时)。

在命令行中:

dotnet publish src/ADOGenerator/ADOGenerator.csproj -c Release -r win-x64 --self-contained

运行可执行文件

转到已发布的目录并运行可执行文件:

cd src/ADOGenerator/bin/Release/net8.0/win-x64/publish
./ADOGenerator.exe

配置注意事项

在本地运行 Azure DevOps 演示生成器时,请记住以下因素:

  • 配置文件:确保输出目录中存在所需的配置文件(例如 appsettings.json)。
  • 依赖项:验证生成输出中是否包括所有必要的依赖项。
  • 权限:应用程序需要适当的权限才能访问 Azure DevOps 服务。
  • 网络访问:确保计算机可以通过 HTTPS 连接到 Azure DevOps Services。

Troubleshooting

如果在设置或运行演示生成器时遇到问题:

  1. 检查控制台输出:查看控制台中是否存在特定问题的错误消息。
  2. 验证依赖项:确保正确还原所有必需的包和依赖项。
  3. 验证配置:检查配置文件是否包含正确的设置和值。
  4. 查看连接:验证与 Azure DevOps Services 的网络连接。
  5. 检查 .NET 版本:确认使用的是正确的 .NET SDK 版本。

备用方法

由于Microsoft不再积极开发演示生成器,因此请考虑项目自动化的以下替代方法:

  • 用于脚本化项目设置和管理的 Azure DevOps CLI
  • 自定义项目预配解决方案中的 REST API 自动化
  • 使用 Azure DevOps REST API 的 PowerShell 脚本
  • 用于基础结构和项目设置的 Azure 资源管理器模板