Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This article describes how to upload and manage a workload in Microsoft Fabric. The Workloads page in the Admin Portal has two tabs:
- Manage my tenant - Browse and add published workloads to your tenant.
- Publish - Upload and manage your own workload packages.
Workloads enhance the usability of your service within a familiar workspace, eliminating the need to leave the Fabric environment. Fabric workloads increase user engagement and improve your application's discoverability in the Fabric marketplace. The Fabric workspace includes various components, known as Fabric items, which handle storage, analysis, and presentation of your data.
Prerequisites
To deploy a workload, you must have the following prerequisites:
- A Fabric account with admin permissions.
- The NuGet package workload solution that you want to deploy. For information about creating a workload solution, see Create a new Item.
Note
When DevGateway is connected to the Fabric backend, the developer workload takes precedence over the workload that's activated in the tenant. If you try to create an item in a workspace that's registered in the DevGateway configuration,, the Fabric backend calls your local workload instead of the activated workload.
Manage my tenant
The Manage my tenant tab lists all workloads that have been published and are available for your tenant. From this tab, admins can:
- Browse available workloads - View all workloads published to the Workload Hub, including their publisher and status.
- Add workloads - Select a workload to view its details, including an overview, documentation links, and licensing information. Select Add Workload to add it to your tenant directly from the Admin Portal.
- Consent on behalf of the organization - If you have sufficient Microsoft Entra permissions, select Consent to grant organization-wide consent for the workload's required permissions. This eliminates the need for individual users to consent when they first use the workload.
Upload a workload
Use the Publish tab to upload your own workload packages. To upload a workload to Microsoft Fabric:
Sign in to Fabric with an admin account.
In Settings, go to Admin portal.
On Workloads, select Upload workload.
Go to the NuGet package you want to upload and select Open.
Important
Each uploaded NuGet package must have a unique version number. If you try to upload a package with a version that already exists, you get a This package has already been uploaded error. To resolve this issue, increment the minor version in your NuGet package (for example, change
1.0.0to1.1.0) and upload it again.
Select the workload.
Select the uploaded version.
Select Add.
The version number is now listed, and Status is Active in tenant.
Manage a workload
After a workload is added, you can update, delete, or deactivate the workload.
Update a workload
To change to a different active version of a workload:
In the Admin portal, on the Workloads pane, select a workload to activate.
On the Add tab, select Edit.
Select the version you want to activate and select Add.
Select Add again to confirm the change.
The new version number is now listed, and Status is Active in tenant.
Delete a workload
To delete a workload:
In the Admin portal, on the Workloads pane, select the workload to delete.
On the Uploads tab, next to the version you want to delete, select the Delete icon.
You can't delete the active version of a workload. To delete an active version of a workload, first deactivate the workload.
Deactivate a workload
To deactivate a workload:
In the Admin portal, on the Workloads pane, select the workload to deactivate.
On the Add tab, select Deactivate.
