工作負載資訊清單(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。
-
-
Versionnode — 工作負載套件的語意版本。 -
RemoteServiceConfiguration>CloudServiceConfiguration包含:-
Cloud(例如,Public)。 -
AADFEApp>AppId— 包含前端 Microsoft Entra 應用程式識別碼。 -
EnableSandboxRelaxation— 如果您需要特殊的 iFrame 功能 (例如,啟動檔案下載),請將其設定為true。false為了安全起見,預設保留。 -
Endpoints>ServiceEndpoint條目包含:-
Name(例如,Frontend)。 -
Url— 前端託管的地方。 用於https://localhost:port開發。 在生產環境中,網域必須是你已驗證的 Entra 網域的子網域。 完整網域限制請參見 一般發佈要求 。 -
IsEndpointResolutionService。
-
-
建置輸出和預留位置
在 Starter-Kit 中,根據環境檔案中的組態建立資訊清單時,都會填充每個佔位符。 已完成的最終資訊清單會在 build/Manifest 目錄中建立。 使用預留位置並從環境中填入它們,可讓您建置不同的環境,而無需變更檔案或指令碼。 建置輸出由以下人員使用:
- DevGateway:將您的本機開發執行個體註冊到 Fabric,這樣您的應用程式就可以在開發期間載入 Fabric 門戶網站。
- DevServer:將資訊提供給 Fabric
- 系統管理入口網站:針對測試和生產環境,請在發佈過程中透過 Fabric 系統管理入口網站上傳資訊清單套件。 請參閱 發佈您的工作負載。