Create & Delete Workloads

Adding a Workload

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. 1.
    Start in the App Details Screen.
  2. 2.
    Ensure that the Draft is selected.
  3. 3.
    Click the "+ Create new workload" button.
  4. 4.
    Choose a name for the workload. The name must be a valid Humanitec ID and cannot be changed later.
  5. 5.
    Every Workload is based on the default-module by default. The Workload Profile can be adjusted here if needed.
  6. 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
Our CLI is currently in closed beta. Please contact us if you want to learn more.
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.

Duplicate a Workload

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
  • Start in the App Details Screen.
  • Ensure that the Draft is selected.
  • 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 be a valid Humanitec ID 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.
How to duplicate a Workload in your App
Our CLI is currently in closed beta. Please contact us if you want to learn more.
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.

Remove a Workload

UI
CLI
API
  • Start in the App Details Screen.
  • Ensure that the Draft is selected.
  • 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
Our CLI is currently in closed beta. Please contact us if you want to learn more.
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.