SFDX Deploy Tool
SFDX Deploy Tool helps you to deploy metadata from one salesforce org to another using SFDX CLI commands.
Getting Started
Download this repository as a zip file and extract it. You can also clone this repository using the below command.
git clone https://github.com/rahulmalhotra/SFDX-Deploy-Tool.git
Prerequisites
SFDX CLI must be downloaded and installed on your system before using this tool.
Installing
Once you've extracted this tool. You'll see a config.txt file with the information as shown below
sourceOrg=CR1
destinationOrg=PB1
package.xmlLocationToDeploy=metadata\package.xml
folderLocationForFetchedZip=metadata
waitTimeInMinutes=10
testLevel=RunSpecifiedTests
runTests=TemperatureConverterTest,LeadProcessorTest
folderLocationToUndeploy=metadata\destructive
Follow the below steps to configure config.txt,
-
Replace CR1 by the alias of your source org in sfdx cli ( If you haven't connected your source org using sfdx cli in past, you can delete CR1 and leave this space empty )
-
Replace PB1 by the alias of your destination org in sfdx cli ( If you haven't connected your destination org using sfdx cli in past, you can delete PB1 and leave this space empty )
-
As you can see, the package.xmlLocationToDeploy is given the value metadata\package.xml i.e. the package.xml inside the metadata folder will be used to fetch and deploy data. Either you can update the package.xml inside the metadata folder with your own metadata or you can specify the path to your own package.xml in the config file.
-
You can also see that the folderLocationForFetchedZip is given the value metadata. This means that when you'll fetch the metadata from source org it'll create a zip file inside the metadata folder and this zip file will be used later to deploy the metadata to destination org. If you want to use a different folder, you can specify the full path to that folder in config file.
-
Now we have the waitTimeInMinutes which is specified as 10 minutes you can update it according to your choice.
-
SFDX CLI provides you 4 test levels namely:- NoTestRun, RunSpecifiedTests, RunLocalTests and RunAllTestsInOrg. I have given my testLevel parameter the value of RunSpecifiedTests which will use the runTests parameter to get the test classes name which will be executed while deployment. You can also change it to NoTestRun or anything else from the available test levels but make sure that for the runTests parameter, you're specifying the testclass names separated by ",". The runTests parameter will be used only when the testLevel is set to RunSpecifiedTests.
-
The folderLocationToUndeploy should consists of the location of a folder which contains an empty package.xml file and a destructiveChanges.xml file. This will be used when you need to un-deploy or remove metadata from the org. The metadata specified in destructiveChanges.xml will be removed from destination org.
SFDX Deploy Tool is now ready for use.
Usage for Windows
You just need to make sure that the file sfdxdeploytool.bat and config.txt are in the same folder. After configuring, double click on sfdxdeploytool.bat and you're good to go. In case you need a demo, I have written a blog post for the same that can be viewed here.
Usage for macOS
You just need to make sure that the file sfdxdeploytool.command and config.txt are in the same folder. After configuring, double click on sfdxdeploytool.command and you're good to go. In case you need a demo, I have written a blog post for the same that can be viewed here. This blog post mainly specifies the execution using windows operating system. However, the tool will work exactly the same in case of macOS as well.
In case you face any permission issue while executing sfdxdeploytool.command file, run the below command in terminal after navigating to SFDX-Deploy-Tool folder:
chmod 755 sfdxdeploytool.command
This will make the file executable in your system so that you can use it easily.
Tools and Softwares used
- SFDX CLI - Salesforce CLI.
Todo
- User should be able to fetch, validate, deploy and un-deploy metadata.
- Support for mac.
Contributing
Please read CONTRIBUTING.md for details on code of conduct and the process for submitting pull requests.
Authors
- Rahul Malhotra - @rahulcoder
License
This project is licensed under the BSD 3-Clause License - see the LICENSE.md file for details.