Create and Deploy Changes in AutoRABIT
Last updated
Last updated
The deployment process allows you to quickly and safely transfer new developments from your sandbox instance to a production instance. In this article, we'll go over how to perform the deployment operation in the ARM application.
Log in to your ARM account.
Click on the Deployment
module.
Click on New Deployment
.
On the New Deployment
page, choose the basic parameters of your deployment, including the source org from which you'll be retrieving output and the destination org from which you'll be deploying the retrieved components.
Give your deployment a name.
Choose the deployment method from the Deployment From
dropdown to carry out the deployment. There are approx. 10-14 different deployment ways to carry out your deployment in the ARM application.
Important Note: Only the new release labels for which the package has been successfully prepared will be visible in the Release Label dropdown if you choose Deployment From: Release Label. Release labels created before the 22.3 release will not be visible under this dropdown yet. Please go to the Release Label Summary screen and click Create Artifact to prepare the package. Then, the release label will be available to use for deployment.
Choose the Metadata Type(s)
. This allows you to deploy the entire Salesforce Org, Full Profiles, or Permission Sets.
Full Profiles
fetches all the profiles available in the selected source.
Full Permission Sets
fetches all the permission sets from your selected source.
Select your Source Org/
Version Control
.
Select your Destination Org
.
Choose the Deployment Type:
Selective Deployment
is a deployment in which only the metadata types you’ve selected are deployed from the source org to the destination org.
Full Deployment
transfers all metadata types in the source org to the destination org. However, a few metadata types, such as dynamic package XML files, can’t be retrieved in this process. In this case, the irretrievable data types will generate warnings during deployment, but ARM will continue the deployment and transfer the retrievable metadata types.
The Metadata Filter
section allows you to specify filters limiting the metadata included in your deployment. You can enter filter parameters here or leave these fields blank if they do not apply.
This section lets you control how the profile settings and permissions are passed on from the source org during the deployment. Remember that in API version 40.0 and later, when the user deploys retrieved permission set output from one org to another, the metadata in the deployment replaces the target org metadata. In API version 39.0 and earlier, the deployment contents are merged with the current org data.
Deploy Profile Access Settings for selected components only:
Select this check box to refactor the profile settings based on the selected components. Refactored profiles are deployed along with the selected components.
Once you're done with the initial setup for your deployment, click on Retrieve Metadata
. You'll be redirected to the metadata selection screen, which allows you to select the metadata components for deployment. You can also use the search filter to find particular metadata types quickly.
The selected components will be listed under the Selected Items
tab.
Note: Salesforce does not display inactive custom metadata components so they will not be displayed in the deployment list of metadata components. If inactive metadata components are required for the deployment, please refer to the following steps:
Activate Inactive Components: If certain components are required for deployment but are currently inactive, consider activating them in the latest Salesforce account if the option is still available, before initiating the deployment process. This can ensure that all necessary components are included in the deployment.
Consult Salesforce Documentation: For more specific guidance and troubleshooting, refer to the Salesforce documentation on metadata deployment. The documentation provides detailed information on deployment settings, component visibility, and best practices for deploying metadata. However, it is important to note that the specific behavior of inactive custom metadata not being visible may be consistent with Salesforce's intended design, even though it is not explicitly mentioned in the documentation. Please note that the specific steps and solutions may vary depending on your Salesforce setup and configuration. It is recommended to consult your Salesforce administrator or support team for assistance tailored to your specific scenario.
You’ll see the list of metadata components in your target org but not in your source under the Destructive Items
tab. Check the box next to a component you want to delete, and it will be deleted when you deploy. For a detailed explanation of destructive changes, refer to the article: Destructive Changes.
Once you’ve chosen the metadata members to include in the deployment, select one of the two options at the bottom of the page:
Deploy:
This option will immediately deploy to the destination org.
Compare Metadata & Deploy (recommended):
This option allows you to compare the metadata members between the two sources before you proceed with the deployment.
On this screen, you will be presented with a list of metadata types and their respective member lists.
Deployment via Salesforce Org Further expanding the member's list will allow you to view the members' dependent components, and selecting them means deploying the dependent components to the destination org.
The Diff
tab will indicate if there are any differences between the members from the source and the target org.
Clicking on the difference icon in the right column will display a new page with details of the differences between the orgs. You will have the option to download the log from this page. If the difference report contains more than 10,000 lines, it is best practice to download the report first and view its changes.
When you have determined which metadata members to include in the deployment, click the checkbox next to each member to select it, and then click the Deploy
button. It will take you to the Deployment Settings
page.
On the Deployment Settings
page, you will be presented with a list of filters to use in the deployment:
Filters | Description |
---|---|
Ignore warnings | When this filter is checked, metadata types that trigger warnings during the retrieval process will not cause the deployment to fail, and ARM will deploy all other metadata types as possible. |
Validate only | Checking this option will validate and save the deployment label without actually executing the deployment. The label can then be used later for a Quick Deploy if the target org is a production environment against which the validation was done |
Take backup | This option creates a backup of the original state of the metadata to which you can revert if the deployment fails or has other functional issues. This option will not be visible for "deployment via Vlocity components". |
Ignore missing visibility settings (profiles) | With this option, differences in visibility settings between the source and destination orgs will not cause the deployment to fail. ARM will compare the source and destination orgs and keep only the common settings between both orgs. Standard fields are not supported for this option. |
Remove Login IP Ranges | This option will remove IP ranges from your profile while deploying |
Remove System and User Permissions | Remove the user's permission from your profile while deploying. |
Do not include 'Destructive members' | Select this checkbox if you have configured certain metadata types to skip while deploying. You can configure such metadata types under the |
Ignore installed components | When selected, ARM will scan for the components that are deployed, and if there are any managed package components located in the target org, these components will be excluded from the metadata.zip files while the remaining components are deployed. |
Fetch Wavexmd components | Upon selection, this checkbox will allow you to select the respective wavexmd files belonging to the wave dashboard metadata type and deploy them via selective deployment to another Salesforce Org. This checkbox will be hidden if the WaveDashboard metadata type or its corresponding members are not picked. Note: This feature is currently applicable only for the following deployment methods:
|
Apex Test Level:
Next, choose the Apex unit test level to validate your deployment. To know more about Apex tests, please refer to the article: Apex Unit Tests.
Static Code Analysis (SCA)
: Choose the SCA tool to detect bugs, code smells, and security vulnerabilities before the deployment begins.
SCA Supported Metadata Types:
For ApexPMD, Checkmarx, SonarQube: Apex Classes, Apex Triggers, Apex Pages, AuraDefinitionBundle, LightningComponentBundle.
For Codescan: ApexClasses, ApexPages, ApexTriggers, AuraDefinitionBundle, CustomObjects, Flow, LightningComponentBundle, PermissionSets, Profiles, Settings, SharingRules, Workflows.
You can stop the deployment if the SCA doesn't meet the criteria set globally. Go to My Account >
Validation Criteria- Static Code Analysis
to set the global configuration for your SCA tool.
Also, you can select the recipients for the alert under the SCA Mail Notifications
field. Multiple recipients can be added here.
Search and Substitute
If you have created the search and substitute rules to define custom find and substitute rules that ARM applies whenever you commit and deploy files from one Sandbox to another Sandbox, one Sandbox to Version Control, or vice-versa, such rule can be found here.
Fetch the Test Cases:
Before running the deployment, you may like to run the functional test cases to test the code's functionality being deployed to the Destination Environment. Therefore, select how you would like to fetch the test cases.
Deployment Notes:
In the Deployment Notes box, specify the reason for the deployment and what has changed across your Salesforce Org.
The next screen is the Deployment Summary
page, where you can view the components one final time before deployment.
Click on Validate Deployment.
You will be redirected to the Deployment Summary screen, showing the deployment progress.
If there are no differences, the right column will display theicon for each member.
If there are any differences, the right column will display theicon.
From the Apply Search and Substitute Rules
list, select the rule that will be associated with the current deployment process. Use the/button to add/remove the rule and using the/button, move the rules list up and down. Based on the selection, the top rule will be deployed initially, and the process will continue for the remaining rules.