Manage a workload in Fabric (preview)

This article describes how to upload and manage a workload to the Fabric service. 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 store. The Fabric workspace includes various components, known as Fabric items, which handle the storage, analysis, and presentation of your data.

Prerequisites

Before you can deploy a workload, you must have the following prerequisites:

Note

When a DevGateway is connected to Fabric backend, the developer workload takes precedence over the workload activated in the tenant. If you try to create an item in a workspace associated with the same capacity as the one registered in the DevGateway configuration, Fabric backend calls your local workload instead of the activated one.

Upload a workload

To upload a workload to the Fabric service, follow these steps:

  1. Log into Fabric with an Admin account.

    Screenshot of Microsoft Fabric sign in screen.

  2. From Settings, go to the Admin portal.

    Screenshot showing how to get to the Fabric Admin portal.

  3. From Workloads, select Upload workload.

    Screenshot showing how to upload a workload.

  4. Browse to the nugget package you want to upload, and select Open.

    Screenshot showing how to browse to the NuGet package.

  5. Select workload.

  6. Select uploaded version

    Screenshot showing how to select the workload.

  7. Select Add.

Notice that the version number is now listed and Status is Active in tenant.

Screenshot showing the active version of the workload.

Manage a workload

Once you have a workload uploaded, you can manage it by performing the following actions:

Update a workload

To change to a different active version of a workload, follow these steps:

  1. From Workloads in the Admin portal select the workload you want to deactivate.

  2. From the Add tab, select Edit.

    Screenshot showing how to update a workload.

  3. Select the version you want to activate and select Add.

    Screenshot showing how to select the version of the workload to activate.

  4. Select Add again to confirm the change.

    Screenshot showing how to confirm the change.

Notice that the new version number is now listed and Status is Active in tenant.

Delete a workload

To delete a workload, follow these steps:

  1. From Workloads in the Admin portal select the workload you want to delete.

  2. From the Uploads tab, select delete icon next to the version you want to delete.

    Screenshot showing how to delete a workload.

You can't delete the active version of a workload. To delete the active version, first deactivate it.

Deactivate a workload

To deactivate a workload, follow these steps:

  1. From Workloads in the Admin portal select the workload you want to deactivate.

  2. From the Add tab, select Deactivate.

    Screenshot showing how to deactivate a workload.