共用方式為


Extensibility Toolkit 中的工作負載資訊清單

工作負載資訊清單(WorkloadManifest.xml)用於配置工作負載的層級設定。 它會告訴 Fabric 您的工作負載是誰,以及如何連線到您的前端,以便主機可以安全地啟動它。 它補充了產品和項目定義,但不會取代:

  • 產品中繼資料 (用於探索和發佈) 位於 Product.json中。
  • 項目類型及其行為存在於項目資訊清單和 JSON 檔案中。

工作負載資訊清單所定義的內容

  • 工作負載身分識別: WorkloadName ([組織]。WorkloadId]) 和 Version (語意版本)
  • 託管模式: HostingType (使用 FERemote
  • 前端 Microsoft Entra 應用程式: AADFEApp>AppId
  • 前端端點:ServiceEndpoint條目包括Name(例如,Frontend)、Url(開發環境中的 localhost;生產環境的域必須是你已驗證的 Entra 網域的子域)、以及IsEndpointResolutionService。 請參閱 一般發佈要求 以了解網域限制。
  • 選擇性沙箱放寬: EnableSandboxRelaxation 僅當需要特殊 iFrame 功能時 (例如,起始檔案下載)

最佳做法

  • 在應用程式和資訊清單中保持版本一致
  • 宣告所需的最低權限 (最低權限原則)
  • 驗證資訊清單作為 CI 的一部分

結構

清單中的關鍵元素及其含義:

  • 具有結構描述版本的根元素 (例如 SchemaVersion="2.0.0")。
  • Workload 節點,其屬性包括:
    • WorkloadName — 格式 [Organization].[WorkloadId] 中的唯一識別碼 (例如 Org.MyWorkload)。 如果您不打算發佈至其他租用戶,您可以使用Org.[WorkloadId]。 若要跨租用戶發佈,請在 Fabric 中註冊完整的工作負載名稱(WorkloadName)。
    • HostingType — 表示工作負載託管;使用 FERemote
  • Version node — 工作負載套件的語意版本。
  • RemoteServiceConfiguration > CloudServiceConfiguration 包含:
    • Cloud (例如, Public)。
    • AADFEApp > AppId — 包含前端 Microsoft Entra 應用程式識別碼。
    • EnableSandboxRelaxation — 如果您需要特殊的 iFrame 功能 (例如,啟動檔案下載),請將其設定為 truefalse為了安全起見,預設保留。
    • Endpoints > ServiceEndpoint 條目包含:
      • Name (例如, Frontend)。
      • Url — 前端託管的地方。 用於 https://localhost:port 開發。 在生產環境中,網域必須是你已驗證的 Entra 網域的子網域。 完整網域限制請參見 一般發佈要求
      • IsEndpointResolutionService

建置輸出和預留位置

在 Starter-Kit 中,根據環境檔案中的組態建立資訊清單時,都會填充每個佔位符。 已完成的最終資訊清單會在 build/Manifest 目錄中建立。 使用預留位置並從環境中填入它們,可讓您建置不同的環境,而無需變更檔案或指令碼。 建置輸出由以下人員使用:

  • DevGateway:將您的本機開發執行個體註冊到 Fabric,這樣您的應用程式就可以在開發期間載入 Fabric 門戶網站。
  • DevServer:將資訊提供給 Fabric
  • 系統管理入口網站:針對測試和生產環境,請在發佈過程中透過 Fabric 系統管理入口網站上傳資訊清單套件。 請參閱 發佈您的工作負載

瞭解詳情