Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Salesforce offers provides quick deploy where any pipeline with for every pipeline that has a validate step with and a unit test are eligible. As part of exaction a unique . A distinct ID is generated which as part of the execution that can be used and quick deploy can be performedutilized 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.

...

  • 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.

...

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

  2. Under Summary tab, click Overview.

  3. Copy the displayed Request ID.

    Image Added


    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 a name and choose “Salesforce Quick Deploy” as Typethe 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.

    Image Added

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.

Troubleshooting Failed Quick Deployments

Here are a few common failure messages that you’d 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.