Create & Delete Workloads
You need to add a Workload to a Draft in order to deploy it.
Adding a Workload will create a new Workload Resource along with its Pods in the Kubernetes cluster when it is deployed. After creating a new Workload you can add a Container image to it, see Working with Containers for further reference.
UI
CLI
API
- 1.
- 2.
- 3.Click the "+ Create new workload" button.
- 4.Choose a name for the workload. The name must be a valid Humanitec ID and cannot be changed later.
- 5.Every Workload is based on the
default-module
by default. The Workload Profile can be adjusted here if needed. - 6.Click the "Create Workload" button to create the Workload in your App.

Steps 1-3 of adding a Workload in the UI

Steps 4-5 of adding a Workload in the UI
Adding a Workload is the equivalent to adding a module to a Delta in the API. See Deployment Deltas in the API Documentation for more details.
Sometimes, multiple workloads in an App share very similar configuration. In this case it can be useful to duplicate a Workload.
Duplicating a Workload will create a copy of the configuration of that Workload. The Workloads will be independent from each other from that point forward.
UI
CLI
API
- Click the
…
button on the Workload to duplicate and select "Duplicate" from the menu that appears. - Choose an ID for the duplicated Workload. The ID must begin and end with lower-case alphanumeric characters ([a-z0-9]), but may also contain dashes (-), and cannot be changed later.
- Click the checkmark button to create the Workload in the App.
- If you wish to cancel this action, click the "Cancel" button.
.png?alt=media&token=c21677e1-98a9-4276-8074-852d2d311bc0)
How to duplicate a Workload in your App
Duplicating a Workload is the equivalent to adding a module to a Delta in the API. See Deployment Deltas in the API Documentation for more details.
UI
CLI
API
- Click the
…
button on the Workload you would like to remove. - Select "Remove" from the menu that appears. The Workload card will now be displayed as greyed out to indicate it will be removed on the next deployment.
- Click the "Restore" button if you want to revert the remove action in this Draft.

How to remove a Workload from your App
Removing a Workload is the equivalent to removing a module to a Delta in the API. See Deployment Deltas in the API Documentation for more details.
Last modified 20d ago