Salesforce DX Developer Guide

How Salesforce Developer Experience Changes the Way You Work
Salesforce CLI Configuration and Tips
Project Setup
Authorization
Metadata Coverage
Scratch Orgs
Sandboxes
Development
Build and Release Your App
Build and Release Your App with Metadata API
Develop and Test Changes Locally
Build and Test the Release Artifact
Test the Release Artifact in a Staging Environment
Release Your App to Production
Cancel a Metadata Deployment
First-Generation Managed Packages
Second-Generation Managed Packages
Unlocked Packages
Continuous Integration
Troubleshoot Salesforce DX
Limitations for Salesforce DX
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Release Your App to Production

Now that all your tests have passed in the Full sandbox, you’re ready to deploy to production.
You have two options to deploy your metadata to production using Salesforce CLI. For information on all command options, view the command --help.
  • Deploy your metadata directly to your production org using the source:deploy command.
  • Convert your local DX project files to metadata format, then use the mdapi:deploy command.
  1. In your deployment run list, complete any pre-deployment tasks.
  2. Authorize your production org.
  3. If you plan to use the mdapi:deploy command, convert your files from source format to metadata format. 
    1sfdx force:source:convert
  4. Set up the quick deploy.
    Salesforce CLI Command Command-Line Example 
    1sfdx force:source:deploy
    		 
    1sfdx force:source:deploy --checkonly \
2--sourcepath force-app --targetusername production-org \
3--testlevel RunLocalTests
    		 
    1sfdx force:mdapi:deploy
    		 
    1sfdx force:mdapi:deploy --checkonly \
2--zipfile winter19.zip --targetusername production-org \
3--testlevel RunLocalTests

    This command returns a job ID that you reference in the quick deploy.

  5. After the tests are run, verify that all the Apex tests have passed. Be sure that the tests cover at least 75% of the code being deployed.
  6. Run the quick deploy:
    Salesforce CLI Command Command-Line Example 
    1sfdx force:source:deploy
    		 
    1sfdx force:source:deploy \
2--targetusername production-org \
3--validateddeployrequestid jobID
    		 
    1sfdx force:mdapi:deploy
    		 
    1sfdx force:mdapi:deploy \
2--targetusername production-org \
3--validateddeployrequestid jobID
  7. Open the production org, then perform any post-deployment tasks listed in the deployment run list.