Create versions and branches in Git
Create tags and branches in a Git repository from ServiceNow Studio to version application releases and manage parallel development streams.
Parent Topic:Source control in ServiceNow Studio
Create a tag to link to a particular application version
Create a tag in the Git repository from ServiceNow Studio to mark a specific application version for future reference.
Before you begin
Link an app to source control in ServiceNow Studio
Role required: admin or sn_group_creator.app_creator
Procedure
Navigate to All > App Engine > ServiceNow Studio.
In the file navigator, select the application you want to open.
Select App details to open the app in the canvas.
Select Source control > Create tag.
Enter the Tag name.
Select Create tag.
The tag is created in the repository and linked to the current application version.
Select Close.
What to do next
Commit changes to the new branch.
Switch repository branches
Switch to a different repository branch in ServiceNow Studio to work on a separate version of the application.
Before you begin
A Git repository with one or more available branches must exist.
Role required: admin
Procedure
Navigate to All > App Engine > ServiceNow Studio.
In the file navigator, select the application you want to open.
Select App details to open the app in the canvas.
Select Source control > Switch branch.
Choose whether to stash or discard local changes before switching.
| Option | Description |
|---|---|
| Stash local changes | Saves local changes before switching to an alternate branch. You can later merge or discard the saved changes. |
| Discard local changes | Permanently deletes all local changes before switching to an alternate branch. Discarded changes cannot be recovered.Note: Use caution when discarding local changes. Because all application developers share repository credentials, there is no way to discard only one set of user changes. |
Select the branch to switch to.
Select Switch Branch.
Result
ServiceNow Studio updates the local application to match the branch version from the repository.
Create a repository branch
Create a branch in ServiceNow Studio to develop a new version of an existing app in isolation. The new branch is created in the remote repository and the application, including any uncommitted changes, switches to the new branch.
Before you begin
Role required: admin or sn_group_creator.app_creator
Procedure
Navigate to All > App Engine > ServiceNow Studio.
In the file navigator, select the application you want to open.
Select App details to open the app in the canvas.
Select Source control > Create branch.
Enter a Branch name.
To base the branch on an existing tag, select the Create from Tag drop-down list and select a tag.
Select Create Branch.
The new branch is created in the remote repository and the application switches to the new branch.
Select Close.
Set a default branch
Set a default branch in ServiceNow Studio to direct new changes to a branch other than main.
Before you begin
Link an app to source control in ServiceNow Studio
Role required: admin
Procedure
Follow the steps in Add a system property.
Add the glide.source_control.default_branch_name property and specify the default branch name of the Git source control repository.
All developer work is saved to the default branch unless a different branch is specified. If not set, the value defaults to
sn_instances/<instance_name>.
Result
The default branch is set. New changes in ServiceNow Studio are directed to the specified branch.