Salesforce Quick Deploy

Quick Deployment for Salesforce can be used to deploy a successfully validated and tested component package against the same Salesforce Org. A distinct ID is generated as part of the execution that can be utilized during the quick deployment.

Workflow

Salesforce account and deploy key are required to run the Quick Deploy workflow. The workflow comprises creating a Quick Deploy task under Tasks section. Previously, you had to start an SFDX/ANT pipeline in Opsera to retrieve the deploy key. When the account and deploy key are entered after the task has been created, the task is prepared to be executed.

In this section:

• Fetch Deploy Key

• Create and Run Salesforce Quick Deploy

• Troubleshooting Failed Quick Deployments

Fetch Deploy Key

1. Login to Opsera and navigate to Products > Pipeline.

2. Create and trigger trigger a SFDX/ANT pipeline with a unit test case to generate the Salesforce Deploy Key.

3. Once the pipeline is triggered, navigate to Pipeline Logs and click Report under the Log Type column.

4. Under Summary tab, click Overview.

5. Copy the displayed Request ID.
   

   

   
   The fetched deploy key is required to run the Salesforce Quick Deploy task.

Create and Run Salesforce Quick Deploy Task

1. Navigate to Tasks menu and click Create New Task.

2. In the Create New Task popup, enter the following details:

• Name: Enter a name for the task

• Type: Select the type as Salesforce Quick Deploy from the dropdown.

• Salesforce Account: Select the Org.

• Salesforce Deploy Key: Enter the fetched deploy key.
  

  

3. Click Create.

4. In Opsera Task Confirmation popup, click Validate Deploy Key to view the list of components & Unit test details.

5. Click Run Task.

Once the task is successfully executed, you can view the deployment log under Activity Logs.

Troubleshooting Failed Quick Deployments

Here are a few common failure messages that you would encounter and the reasons for the failures to help you troubleshoot.

1. ERROR running force:source:deploy: INVALID_ID_FIELD: There have been deploys in the org since the source validate happened

   This occurs when the the provided Validation deployment Job ID is no more applicable for Quick Deploy. This can be due to the following reasons :

   1. A recent regular deployment / quick deployment execution has happened post the Validation.

   2. The provided deployment job ID was created as part of validation that happened 10 days prior.

2. ERROR running force:source:deploy: INVALID_ID_FIELD: Source validate did not run tests in the org
   This error occurs when the provided Validation deployment Job ID was executed with NoTestRun chosen or without any Unit test levels. Therefore it becomes ineligible for Quick Deployment.

3. ERROR running force:source:deploy: INVALID_ID_FIELD: Source validate does not meet the cutoff criteria for testless deploy
   This error occurs when the provided validation deployment Job ID does not meet any of the below criteria:
   (i) ID is unsuccessful or in-progress.
   (ii) ID is not having test execution available.
   (iii) ID doesn’t meet the test coverage criteria (75%).

4. ERROR running force:source:deploy: INVALID_ID_FIELD: Source is not a check-only deploy
   This error occurs when the provided Validation deployment Job ID is not a job ID created as part of Validation but rather as part of Deployment and therefore is not applicable for Quick Deployment.

5. ERROR running force:source:deploy: UNKNOWN_EXCEPTION: invalid parameter value
   The error occurs when the provided Validation deployment Job ID is not a valid Salesforce deployment ID and therefore not applicable for Quick Deployment.

6. ERROR running force:source:deploy: UNKNOWN_EXCEPTION: unexpected metadata
   This suggests that the provided Validation deployment Job ID is not a valid Salesforce deployment ID and therefore not eligible for Quick Deployment. This can also occur if the Job ID was created as part of Apex Test Run (Unit Test) Step.