{"id":671,"date":"2022-10-27T21:40:00","date_gmt":"2022-10-28T02:40:00","guid":{"rendered":"https:\/\/blog.felineflock.com\/?p=671"},"modified":"2024-01-03T22:18:46","modified_gmt":"2024-01-04T04:18:46","slug":"salesforce-backup-made-easy-daily-automation-with-github-actions","status":"publish","type":"post","link":"https:\/\/blog.felineflock.com\/index.php\/2022\/10\/27\/salesforce-backup-made-easy-daily-automation-with-github-actions\/","title":{"rendered":"Salesforce Backup Made Easy: Daily Automation with GitHub Actions"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

Steps to implement daily backups of a Salesforce org with GitHub Actions:<\/p>\n\n\n\n

1) Preparing the GitHub repository<\/strong><\/p>\n\n\n\n

Decide the project name and whether to use production (login) or sandbox (test).<\/p>\n\n\n\n

Create a repository in GitHub.<\/p>\n\n\n\n

2) In the GitHub repository root, create the file sfdx-project.json<\/strong> below, change the project name and URL and commit:<\/p>\n\n\n\n

(you can copy this file<\/a> and modify it)<\/p>\n\n\n\n

\n

{ <\/code><\/p>\n\n\n\n

  \"packageDirectories\": [     {<\/code><\/p>\n\n\n\n

       \"path\": \"force-app\",<\/code><\/p>\n\n\n\n

      \"default\": true<\/code><\/p>\n\n\n\n

     }  ],<\/code><\/p>\n\n\n\n

  \"name\": \"PROJECT_NAME_HERE\",<\/code><\/p>\n\n\n\n

  \"namespace\": \"\",<\/code><\/p>\n\n\n\n

  \"sfdcLoginUrl\": \"https:\/\/login_or_test_here.salesforce.com\/\",<\/code><\/p>\n\n\n\n

  \"sourceApiVersion\": \"55.0\" <\/code><\/p>\n\n\n\n

}<\/code><\/p>\n<\/blockquote>\n\n\n\n

<\/merlin-component><\/p>\n\n\n\n

3) In the GitHub repository root, create the file package.xml<\/strong> below and commit:<\/p>\n\n\n\n

(you can copy this file<\/a>)<\/p>\n\n\n\n

\n

<?xml version=”1.0″ encoding=”UTF-8″?> <Package xmlns=”http:\/\/soap.sforce.com\/2006\/04\/metadata”> <types> <members>*<\/members> <name>ApexClass<\/name> <\/types> <types> <members>*<\/members> <name>ApexComponent<\/name> <\/types> <types> <members>*<\/members> <name>ApexPage<\/name> <\/types> <types> <members>*<\/members> <name>ApexTrigger<\/name> <\/types> <types> <members>*<\/members> <name>AuraDefinitionBundle<\/name> <\/types> <types> <members>*<\/members> <name>CustomField<\/name> <\/types> <types> <members>*<\/members> <name>CustomLabels<\/name> <\/types> <types> <members>*<\/members> <name>CustomMetadata<\/name> <\/types> <types> <members>*<\/members> <name>CustomObject<\/name> <\/types> <types> <members>*<\/members> <name>FieldSet<\/name> <\/types> <types> <members>*<\/members> <name>FlexiPage<\/name> <\/types> <types> <members>*<\/members> <name>Flow<\/name> <\/types> <types> <members>*<\/members> <name>FlowCategory<\/name> <\/types> <types> <members>*<\/members> <name>FlowDefinition<\/name> <\/types> <types> <members>*<\/members> <name>LightningComponentBundle<\/name> <\/types> <types> <members>*<\/members> <name>LightningMessageChannel<\/name> <\/types> <types> <members>*<\/members> <name>NamedCredential<\/name> <\/types> <types> <members>*<\/members> <name>PermissionSet<\/name> <\/types> <types> <members>*<\/members> <name>RemoteSiteSetting<\/name> <\/types> <types> <members>*<\/members> <name>StaticResource<\/name> <\/types> <types> <members>*<\/members> <name>ValidationRule<\/name> <\/types> <types> <members>*<\/members> <name>Workflow<\/name> <\/types> <types> <members>*<\/members> <name>WorkflowFieldUpdate<\/name> <\/types> <types> <members>*<\/members> <name>WorkflowRule<\/name> <\/types> <types> <members>*<\/members> <name>WorkflowTask<\/name> <\/types> <version>54.0<\/version> <\/Package><\/p>\n<\/blockquote>\n\n\n\n

<\/merlin-component><\/merlin-component><\/code><\/p>\n\n\n\n

4) Getting authentication URL from the org<\/strong><\/p>\n\n\n\n

With SFDX installed, on Terminal, execute this command after changing the project name and URL (single line, no breaks):<\/p>\n\n\n\n

sfdx force:auth:web:login --setalias PROJECT_NAME_HERE --instanceurl https:\/\/login_or_test_here.salesforce.com --setdefaultusername<\/code><\/p>\n\n\n\n

5) It will prompt to login on the browser, then execute on Terminal:<\/p>\n\n\n\n

sfdx force:org:display -u PROJECT_NAME_HERE --verbose<\/code><\/p>\n\n\n\n

6) Copy to the Clipboard the entry immediately after “Sfdx Auth Url<\/strong>“. It should be something like force:\/\/PlatformCLI::<\/em>6Bep…3ad@instancename.sandbox.my.salesforce.com<\/em><\/a><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

7) Storing authentication URL in GitHub safely<\/strong><\/p>\n\n\n\n

On GitHub, go to Settings \/ Secrets \/ Actions and create a new repository secret with the name “ORG_SFDX_URL” and paste the content copied in the previous step.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

8) On GitHub, go to Actions, configure a simple workflow and name the script file “syncRepositoryToOrg.yml<\/strong>“.<\/p>\n\n\n\n

(you can copy this file<\/a>)<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

9) Setting up GitHub Action to backup the org<\/strong><\/p>\n\n\n\n

Copy the contents below into the new YML script and press “Start commit” (green button at top right).<\/p>\n\n\n\n

(you can copy this file<\/a>)<\/p>\n\n\n\n

\n

name: Detect changes in the org and sync into the repository<\/p>\n\n\n\n

# When the workflow will run<\/p>\n\n\n\n

on:<\/p>\n\n\n\n

schedule:<\/p>\n\n\n\n

# Runs at 12:00 UTC every day.<\/p>\n\n\n\n

– cron: ‘0 12 * * *’<\/p>\n\n\n\n

# Allows you to run this workflow manually from the Actions tab<\/p>\n\n\n\n

workflow_dispatch:<\/p>\n\n\n\n

inputs:<\/p>\n\n\n\n

# this will be refered to as ${{ github.event.inputs.commit_text }}<\/p>\n\n\n\n

commit_text:<\/p>\n\n\n\n

description: ‘Commit text to use’<\/p>\n\n\n\n

required: true<\/p>\n\n\n\n

default: ‘New Manual Sync commit’<\/p>\n\n\n\n

jobs:<\/p>\n\n\n\n

sync_job:<\/p>\n\n\n\n

runs-on: ubuntu-latest<\/p>\n\n\n\n

steps:<\/p>\n\n\n\n

– name: Install Salesforce CLI<\/p>\n\n\n\n

run: |<\/p>\n\n\n\n

wget https:\/\/developer.salesforce.com\/media\/salesforce-cli\/sfdx\/channels\/stable\/sfdx-linux-x64.tar.xz<\/p>\n\n\n\n

mkdir ~\/sfdx<\/p>\n\n\n\n

tar xJf sfdx-linux-x64.tar.xz -C ~\/sfdx –strip-components 1<\/p>\n\n\n\n

echo “$HOME\/sfdx\/bin” >> $GITHUB_PATH<\/p>\n\n\n\n

~\/sfdx\/bin\/sfdx version<\/p>\n\n\n\n

– name: ‘Checkout source code’<\/p>\n\n\n\n

uses: actions\/checkout@main<\/p>\n\n\n\n

– name: ‘Create file to authenticate to the org via SFDX’<\/p>\n\n\n\n

run: echo ${{ secrets.ORG_SFDX_URL }} > DEV-LOGIN.txt<\/p>\n\n\n\n

– name: ‘Authenticate to the org using SFDX’<\/p>\n\n\n\n

run: sfdx force:auth:sfdxurl:store -f DEV-LOGIN.txt -d -a backupfiles<\/p>\n\n\n\n

– name: ‘Create project with manifest, Copy package.xml, Navigate to the project folder, Download metadata using SFDX’<\/p>\n\n\n\n

run: |<\/p>\n\n\n\n

rm DEV-LOGIN.txt<\/p>\n\n\n\n

if test -d “.\/backupfiles\/force-app”; then<\/p>\n\n\n\n

echo force-app folder exists<\/p>\n\n\n\n

else<\/p>\n\n\n\n

sfdx force:project:create –projectname backupfiles –manifest<\/p>\n\n\n\n

fi<\/p>\n\n\n\n

if test -f “.\/backupfiles\/sfdx-project.json”; then<\/p>\n\n\n\n

echo sfdx-project.json file exists<\/p>\n\n\n\n

else<\/p>\n\n\n\n

cp .\/sfdx-project.json .\/backupfiles\/sfdx-project.json<\/p>\n\n\n\n

fi<\/p>\n\n\n\n

if test -f “.\/backupfiles\/manifest\/package.xml”; then<\/p>\n\n\n\n

echo package.xml file exists<\/p>\n\n\n\n

else<\/p>\n\n\n\n

cp .\/package.xml .\/backupfiles\/manifest<\/p>\n\n\n\n

# below causes ERROR running force:source:manifest:create: This directory does not contain a valid Salesforce DX project.<\/p>\n\n\n\n

#sfdx force:source:manifest:create -m ApexClass,ApexComponent,ApexPage,ApexTrigger,AuraDefinitionBundle,CustomField,CustomLabels,CustomMetadata,CustomObject,FieldSet,FlexiPage,Flow,FlowCategory,FlowDefinition,LightningComponentBundle,LightningMessageChannel,NamedCredential,PermissionSet,RemoteSiteSetting,StaticResource,ValidationRule,Workflow,WorkflowFieldUpdate,WorkflowRule,WorkflowTask -o .\/backupfiles\/manifest<\/p>\n\n\n\n

fi<\/p>\n\n\n\n

cd .\/backupfiles<\/p>\n\n\n\n

sfdx force:source:retrieve -u backupfiles -x manifest\/package.xml<\/p>\n\n\n\n

– name: Save repository owner email<\/p>\n\n\n\n

run: |<\/p>\n\n\n\n

echo “owner_email=$(git log -n 1 –pretty=format:%ae )” >> $GITHUB_ENV<\/p>\n\n\n\n

– name: Stage files and check for modified files<\/p>\n\n\n\n

id: git-check<\/p>\n\n\n\n

run: |<\/p>\n\n\n\n

git init<\/p>\n\n\n\n

git config user.email “${{ env.owner_email }}”<\/p>\n\n\n\n

git config user.name “${{ github.repository_owner }}”<\/p>\n\n\n\n

git add .<\/p>\n\n\n\n

echo “modified=$(if git diff-index –quiet HEAD –; then echo “false”; else echo “true”; fi)” >> $GITHUB_OUTPUT<\/p>\n\n\n\n

– name: Commit and push if there modified files<\/p>\n\n\n\n

if: steps.git-check.outputs.modified == ‘true’<\/p>\n\n\n\n

run: |<\/p>\n\n\n\n

git commit -m “${{ github.event.inputs.commit_text }} on ${{ github.event.repository.updated_at }}”<\/p>\n\n\n\n

echo “git-push=$(git push -u origin main)\\n” >> $GITHUB_OUTPUT<\/p>\n<\/blockquote>\n\n\n\n

<\/p>\n\n\n\n

10) Running the backup for the first time<\/strong><\/p>\n\n\n\n

Go to Actions and click “Detect changes in the org and backup\u2026”, then click “Run workflow”. It will ask what branch to run the workflow from and the commit text to use (enter your choices). Click the green button “Run workflow”.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

11) The workflow will be queued. You can click on it to see it being executed. The source code will be stored in the “backupfiles” folder.<\/p>\n\n\n\n

12) In addition, the workflow will check your org every day at midnight (UTC) and backup any changes.<\/p>\n","protected":false},"excerpt":{"rendered":"

Steps to implement daily backups of a Salesforce org with GitHub Actions: 1) Preparing the GitHub repository Decide the project name and whether to use production (login) or sandbox (test). Create a repository in GitHub. 2) In the GitHub repository root, create the file sfdx-project.json below, change the project name and URL and commit: (you […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_uf_show_specific_survey":0,"_uf_disable_surveys":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-671","post","type-post","status-publish","format-standard","hentry","category-blog"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/posts\/671","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/comments?post=671"}],"version-history":[{"count":1,"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/posts\/671\/revisions"}],"predecessor-version":[{"id":677,"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/posts\/671\/revisions\/677"}],"wp:attachment":[{"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/media?parent=671"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/categories?post=671"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.felineflock.com\/index.php\/wp-json\/wp\/v2\/tags?post=671"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}