Humanitec Documentation
WebsiteStatusLogin inGet started
Search…
Introduction
Welcome
How does Humanitec integrate?
What happens if you hit "Deploy"?
Getting Started
Technical Requirements
Create Sample App
Connect own Infrastructure
Work with Sample App
Migrate own App
Guides
Tutorials
Connect CI Setup
Orchestrate Infrastructure
Manage Users & Permissions
Using Humanitec
Work with Apps
Work with Environments
Create & Delete Environments
Clone between Environments
Override values & secrets
Deploy to Environments
Working with Drafts
Understand Deployment Sets
Understand Deployment History
Roll back Deployments
Diff Deployments
Debug Deployments
Automate Deployments
Work with Workloads
Integrations
Resource Types
Resource Drivers
Create own Resource Driver
Reference
Concepts
User Interface (UI)
Command Line Interface (CLI)
Workload Profiles
Platform API
Troubleshooting
Support Channels
Powered By GitBook
Working with Drafts
Understand how Drafts help your prepare changes for deployment

What is a Draft?

A Draft in Humanitec is a set of proposed changes to an App. You can use a Draft to collect together all of the changes you want to make before you make a new deployment of your App into an Environment.
When a draft is deployed, the changes in the draft are applied to what is currently deployed to the Environment. This means that your draft will usually remain valid even if another developer has made a deployment to the environment between you creating your draft and deploying it. As long as the changes in the first draft don't conflict with the second (for example the first draft removes an item which needs to be updated by the second draft,) the second deployment will succeed and apply the changes you had in your draft. This is similar to how patches can be applied to a code base. Multiple patches can be applied as long as they do not conflict with each other.
You can think of a Draft as a place you can make edits. A draft is effectively a list of your edits.

Creating a new Draft

The Humanitec UI ensures that there is always a Draft available for you to start working with. This Draft will have the name Untitled Draft. This means you only need to create a new Draft if you wish to work on an additional set of edits that you wish to deploy independently.
To create a new Draft, you will need to have the Administrator role within your Organization or hold the Owner/Developer role on the App. Learn more about RBAC in Humanitec here.
UI
CLI
API
  1. 1.
    Start in the App Details Screen.
  2. 2.
    Make sure you have selected the Environment you want to add the draft to from the Environment Tabs.
  3. 3.
    Click the … button on the current Draft.
  4. 4.
    Select "Create new draft" from the menu that appears.
Steps to create a new Draft in the UI
Our CLI is currently in closed beta. Please contact us if you want to learn more.
Drafts as a concept only exist in the UI and CLI. They are actually just Deployment Deltas which are assigned to a particular environment.
To create a Draft via the API, create a new Delta and set the Environment.
In the UI you can only see your currently active draft at one time. You can switch between Drafts to view your other Drafts.

Rename a Draft

If you are working on more than one Draft at a time or you are collaborating on a Draft it can be useful to give a Draft a name. This will help you or your colleague locate the draft in future.
To rename a Draft, you will need to have the Administrator role within your Organization or hold the Owner/Developer role on the App. Learn more about RBAC in Humanitec here.
UI
CLI
API
  1. 1.
    Start in the App Details Screen.
  2. 2.
    Click the … button on the current Draft.
  3. 3.
    Select "Rename draft" from the menu that appears.
Steps to rename a Draft in the UI
Our CLI is currently in closed beta. Please contact us if you want to learn more.
Drafts as a concept only exist in the UI and CLI. They are actually just Deployment Deltas which are assigned to a particular environment.
To rename a draft via the API, you can update the Name.

Switch between Drafts

To switch between drafts, you will need to have the Administrator role within your Organization or hold the Owner/Developer role on the App. Learn more about RBAC in Humanitec here.
UI
CLI
API
The Humanitec UI only allows you to work on one Draft at a time. You can change the active Draft you are working on by switching Drafts.
  1. 1.
    Start in the App Details Screen.
  2. 2.
    Click the … button on the current Draft.
  3. 3.
    Select "Switch drafts" from the menu that appears.
  4. 4.
    Select the Draft to switch to from the list that appears.
Steps to switch between drafts
Our CLI is currently in closed beta. Please contact us if you want to learn more.
There is no concept of an "Active Draft" in the API.

Discard a Draft

If you no longer plan to deploy the edits you made in a Draft, you can discard the draft. This will remove the draft from the list of drafts you can switch to.
To discard a Draft, you will need to have the Administrator role within your Organization or hold the Owner/Developer role on the App. Learn more about RBAC in Humanitec here.
UI
CLI
API
  1. 1.
    Start in the App Details Screen.
  2. 2.
    Click the … button on the current Draft.
  3. 3.
    Select "Discard draft" from the menu that appears.
Steps to discard a Draft in the UI
Our CLI is currently in closed beta. Please contact us if you want to learn more.
Discarding a Draft is the equivalent of marking a Delta as archived.
You cannot discard the last remaining Draft in an Environment. To discard the last draft:
​create a new draft, switch to old draft and then discard it.
Previous
Deploy to Environments
Next
Understand Deployment Sets
Last modified 10d ago
Copy link
Contents
What is a Draft?
Creating a new Draft
Rename a Draft
Switch between Drafts
Discard a Draft