ChangeSet

A ChangeSet in ConfigHub is analogous to a change/pull/merge request in version control systems. It identifies a range of revisions across units. Each ChangeSet has a start tag and an end tag, and is associated with any revisions produced while attached to the corresponding units.

A change set acts as a kind of lock while attached to the units. Changes not identified as part of the change set will be rejected. A ChangeSet can be open on units in several Spaces, and records each Space it was opened in, in InScopeSpaceIDs. Taking the first unit out of it closes the whole ChangeSet.

Operations on revisions, such as restore, approve, and apply, can target the last revision of each unit in the change set, or prior to the first revision.

An open ChangeSet is reviewed before it is closed. ReviewRequests records whose review it is waiting for, and the reviews themselves are the Attestations recorded of its revisions. UserID is who created it.

A ChangeSet can be governed by a ChangeWorkflow, named by ChangeWorkflowID when it is created and copied into ChangeWorkflow. The workflow has no Stages, and its Final prerequisites gate closing the ChangeSet, in every Space it was opened in. A close forced past them with a reason is recorded in CloseOverride.

For more information about how to use change sets, see making changes. A ChangeSet locks the units it is open on; a ChangeOrder is what follows a change across Spaces as it is promoted, and a ChangeOrder ending at a ChangeSet's end tag is how what the ChangeSet changed is promoted and released.