手动设置指南

建议使用 安装指南 ,而不是遵循这些说明。 如果对详细信息感兴趣或尝试跳过一些步骤,可以找到有关如何在本文中手动配置存储库的信息。

创建配置文件

存储库从存储库中的 .env.{ENVIROMENT} 文件中获取配置值。 为此,首先需要将 .env.template 文件.env.dev.env.test.env.prod复制到同一目录中并填充值。 创建清单时会使用这些文件中的值。 对于本地开发,通常只需 .env.dev 文件。

确定 WorkloadName 并将其填写到 .env.dev 文件中。

前端注册Microsoft Entra应用程序

可以使用 CreateDevAADApp.ps1 创建新的 Microsoft Entra 应用,也可以执行以下步骤。

  1. 在 Microsoft Entra IDmin 门户中导航到应用注册。
  2. 创建新的多租户应用程序。

应用注册的屏幕截图。

  1. 将以下 SPA redirectURIs 添加到应用程序清单:

在安装过程中选择 {WORKLOAD_NAME}。 查看存储库中的项目结构。

正在查找您的 {TENANT_ID}? 执行以下步骤:

  1. 打开Microsoft Fabric,然后选择右上角的个人资料图片。
  2. 从下拉菜单中选择“ 关于 ”。
  3. 在“关于”对话框中,可以找到租户 ID 和租户区域。

创建应用后,打开“Workload/.env.dev”文件,并将工作负荷名称插入“WORKLOAD_NAME”,并在“FRONTEND_APPID”配置属性中插入前端应用程序客户端 ID。

DevGateway

存储库需要更多需要下载的软件。 为此,需要下载 DevGateway 并将其解压缩到 tools 目录中。

若要启动 DevGateway,需要在 workload-dev-mode.json 目录中提供一个名为 build/DevGateway/ 的配置文件。 此文件告知 DevGateway 如何定位和管理您的工作负荷。

示例配置:

{
    "WorkspaceGuid": "your-workspace-guid-here",
    "ManifestPackageFilePath": "path/to/Your/Repo/build/Manifest/[WorkloadName].[Version].nupkg",
    "WorkloadEndpointURL": "http://127.0.0.1:5000/workload"
}

字段说明:

  • WorkspaceGuid:工作负载可用的 Fabric 工作区的 GUID。
  • ManifestPackageFilePath:已编译的工作负荷清单包的路径(.nupkg 文件)。
  • WorkloadEndpointURL:托管工作负荷后端的 URL(通常是本地开发服务器)。