Release Labels
Overview
A Release Label is a combination of multiple commit labels. Creating a release label will allow you to combine a group of single revisions, allowing all the revisions to be deployed in one go. This article will discuss creating a new release label in the ARM application.
Before you begin:
Confirm you have the Manage Label permissions to create a new release label.
Commit revisions were made to the version control branch to combine them under a single release label. For more information, refer to the article: Commit Labels
Create a new Release Label
Log in to your ARM account.
Hover your mouse over the
Version Control
module and click on theChange Labels > Release Labels
or directly go to theChange Labels
tab and selectRelease Labels
from the dropdown.The Release Label screen is best viewed when the zoom setting is set to 80% on your Chrome/Firefox browser.Click on
Create Release Label.
On the next screen, give the release label creation process a
Label Name
and a shortDescription
.
Select the
Repository
and theBranch
containing the commit labels.Note:For the version control repository registered in the SFDX structure, you must choose an additional option, i.e., Package Directory. To know more about Package Directory, refer to the article: Salesforce DX Metadata FormatSelect the commit
Label Type
, i.e.,Salesforce
orVlocity
.Known LimitationsIf a branch-to-branch merge involves multiple commits that include data from Vlocity and Salesforce components, the ARM cannot classify those commits as Vlocity or Salesforce components.From the
No of Days
dropdown list, you can choose to retrieve the commit history for the previous 30, 60, 90, 120, 180, or 365 days, or ALL the commits at once. Please note that selecting ALL may result in a slight delay in fetching the entire commit history.InfoWith the ARM 22.3 release, you can create a release label and start the artifact preparation immediately by selecting theCreate package manifest for Deployment
checkbox for Salesforce labels. If you do not select this checkbox on this screen, you can still click theCreate Artifact
button on theRelease Label Summary
screen to create and run a package manually.
Click
Fetch Commit History
to retrieve all the revisions available on your selected repo and branch. If no records appear, then no revisions have been committed to the branch.Select two or more revisions from the left column to group them into a single release label. The
Selected Revisions
are displayed in a second column on the right side to make it easier to see. You can also unselect revisions from this section.
Important Note: If you choose just one revision while creating a new Release Label, a notification message asks you to select at least two revisions. You can choose the Single Revision option directly from the dropdown on the New Merge screen to perform a merge using only one revision. This helps in avoiding the creation of needless release labels.
Click
OK
. The newly created release label will be displayed on theRelease Labels Summary
screen.
It's always a good idea to break data into multiple pages when dealing with multiple-label records. You can browse 25, 50, 75, or 100 records on a single page or navigate to the previous or next page using the Previous
and Next
buttons.
Release Labels Summary
With the ARM 22.3 release, the Release Labels Summary
screen has been redesigned to enhance user experience and displays the following detailed information for each release label that is created:
At the top-left is where you can see the
Repository
drop-down. You can choose a different repository from the dropdown list.The release label name, the date and time it was last updated, and the version control branch.
The release label description.
The release label package status: Completed, Failed, Package Not Prepared, In-progress, or Aborted. Abort an ongoing package preparation using theicon, theicon indicates an aborted process, and theicon indicates the release label package creation is a success.
Click on theicon to view the latest version log.
Click on theicon to download the package.xml file in a .zip format.
Click on
View Dataset
to view the components in that release label package. You can view the components inJSON View
orTree View
.
Click
Create Artifact
to manually create a package that got failed or was not prepared. This option will not be clickable if the package creation has been completed or is in progress. This option will be available fororange
andred
release labels but not for green.
Important Note:
On the New Deployment page, for the Release Label dropdown, the new release labels for which the package has been successfully prepared will be shown. The dropdown menu will not show Release labels created before the ARM 22.3 release.
To manually prepare the package, use the Create Artifact button. The release label will then be available for deployment.
Last updated