通过

快速入门：运行工作负载示例

  • 项目

本快速入门指南介绍如何使用示例工作负载创建和运行 Microsoft Fabric 工作负载。

先决条件

开始之前，确保已在系统上安装以下各项：

分步指南

启用自定义工作负载

如下所示配置管理门户：

  1. 使用管理员帐户登录 Fabric。

  2. 从“设置”中，转到“管理员门户”。

    屏幕截图显示如何进入 Fabric 管理员门户。

  3. 在“其他工作负载”部分中，启用“容量管理员和参与者可以添加与删除其他工作负载”租户设置。 可以为整个组织或特定组启用它。

设置示例项目

  1. 克隆存储库：克隆此处找到的存储库：示例项目目录

  2. 安装依赖项：导航到克隆存储库中的 Frontend 目录并执行以下命令：

    npm install

  3. 启动本地服务器：通过运行以下命令使用 webpack 启动本地 Node.js 服务器：

    npm start

    服务器通常在端口 60006 上运行。 通过访问 127.0.0.1:60006/manifests 并检查前端文件夹中的 .env.dev 配置文件，来确认服务器是否正常运行。

  4. 启用前端开发人员模式：在管理门户的租户设置中，在“其他工作负载”部分下，激活“容量管理员可以开发其他工作负载。”租户设置。 此设置允许连接到本地服务器，并持久保存在浏览器会话中。

运行示例工作负载

本地服务器运行并启用“开发人员模式”后，新的示例工作负载将显示在菜单中。

  1. 访问示例工作负载：要开始“创建”体验，请导航到示例工作负载主页。

准备开发环境

  1. 打开解决方案：在 Visual Studio 2022 中打开解决方案，并确保与 net7 兼容。

  2. 应用注册：按照身份验证指南设置 Microsoft Entry ID 身份验证，以便在体系结构中进行安全交互。

  3. 配置工作负载设置：使用特定配置详细信息更新 src/Config/workload-dev-mode.json 和 src/appsettings.json：

    • 将 workload-dev-mode.json 从 src/Config 复制到 C:\ 并更新以下字段，以匹配配置：

    注意

    你可以将它复制到任何其他路径，并在项目中设置命令行参数 "-DevMode:LocalConfigFilePath"，以指定路径。

    • WorkspaceGuid：你的工作区 ID。 在 Fabric 中选择工作区（例如 https://app.fabric.microsoft.com/groups/{WorkspaceID}/）时，在浏览器 URL 中找到它。

    • ManifestPackageFilePath：清单包的位置。 生成解决方案时，它将在 src\bin\Debug 中保存清单包。 有关清单包的更多详细信息，请参阅后续步骤。

    • WorkloadEndpointURL：工作负载终结点 URL。

    • 在 src/appsettings.json 文件中，更新以下字段以匹配配置：

      • PublisherTenantId：工作负载发布者租户的 ID。
      • ClientId：工作负载 Microsoft Entra 应用程序的客户端 ID (AppID)。
      • ClientSecret：工作负载 Microsoft Entra 应用程序的密钥。
      • 受众：可以在应用注册中找到传入的 Microsoft Entra 令牌的受众，该注册是在“公开 API”部分下创建的。 这也称为应用程序 ID URI。

  4. 配置 WorkloadManifest.xml 文件：使用以下 Microsoft Entra 应用程序详细信息配置 WorkloadManifest.xml 文件：

    • AppID
    • ResourceID
    • RedirectURI

  5. 生成清单包：生成解决方案以创建清单包文件，其中包括验证和打包必要的 XML 和 JSON 文件。

    • 在 Packages\manifest\files 中的 workloadManifest.xml 上触发 Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe（可以在 \workloadManifestValidator 目录中找到验证过程的代码）。 如果验证失败，则会生成一个指定失败验证的错误文件。
    • 如果存在错误文件，则生成失败并显示“WorkloadManifest 验证错误”。 你可以在 VS Studio 中双击该错误，随后将显示错误文件。
    • 验证成功后，将 WorkloadManifest.xml 和 FrontendManifest.json 文件打包到 ManifestPackage.1.0.0.nupkg 中。 生成的包可以在 src\bin\Debug 中找到。

    将 ManifestPackage.1.0.0.nupkg 文件复制到 workload-dev-mode.json 配置文件中定义的路径。

  6. 运行 DevGateway：执行“Microsoft.Fabric.Workload.DevGateway.exe”，并使用对 workload-dev-mode.json 的 字段中指定的工作区具有工作区管理员权限的用户登录WorkspaceGuid。

  7. 启动项目：将“样板”项目设置为 Visual Studio 中的启动项目，并运行该项目。

附加步骤

  • 根据需要更新工作负载配置文件。
  • 构建解决方案以确保所有依赖项都正确链接。
  • 运行前端和 devgateway 以建立与 Fabric 后端的通信。
  • 创建项并运行作业，以测试工作负载的完整功能。

相关内容