Working with Drafts
Understand how Drafts help your prepare changes for deployment
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.
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.
- 2.Make sure you have selected the Environment you want to add the draft to from the Environment Tabs.
- 3.Click the
…button on the current Draft. - 4.Select "Create new draft" from the menu that appears.
.jpg?alt=media&token=3dc1b505-faa1-4085-aa5c-60188067364e)
Steps to create a new Draft in the UI
Drafts as a concept only exist in the UI and CLI. They are actually just Deployment Deltas which are assigned to a particular 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.
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.
- 2.Click the
…button on the current Draft. - 3.Select "Rename draft" from the menu that appears.
.jpg?alt=media&token=320c2ff7-21b4-4efa-be86-2e543376b279)
Steps to rename a Draft in the UI
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 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.
- 2.Click the
…button on the current Draft. - 3.Select "Switch drafts" from the menu that appears.
- 4.Select the Draft to switch to from the list that appears.
.jpeg?alt=media&token=f69e82c1-d4a7-48e3-a5a7-8c81ee382cf2)
Steps to switch between drafts
There is no concept of an "Active Draft" in the API.
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.
- 2.Click the
…button on the current Draft. - 3.Select "Discard draft" from the menu that appears.
.jpg?alt=media&token=82b0e43c-1c23-4667-abe3-b821658a3538)
Steps to discard a Draft in the UI
You cannot discard the last remaining Draft in an Environment. To discard the last draft:
Last modified 8mo ago