sfdx-hardis

Presented at Dreamforce 23!

Toolbox for Salesforce DX, by Cloudity, natively compliant with most platforms and tools

It will allow you to:

• Do with simple commands what could be done manually in minutes/hours
• Define a complete CI/CD Pipeline for your Salesforce project
• Backup Metadatas and monitor any Salesforce org

Please see the full list of commands in Online documentation

sfdx-hardis commands are also available with UI in SFDX Hardis Visual Studio Code Extension

See Dreamforce presentation

Installation

With IDE

You can install Visual Studio Code extension VsCode SFDX Hardis

Once installed, click on in VsCode left bar, and follow the additional installation instructions

As SFDX Plugin

Pre-requisites

• Install Node.js (recommended version)
• Install Salesforce DX by running npm install @salesforce/cli --global command line

Plugin installation

sfdx plugins:install sfdx-hardis

For advanced use, please also install dependencies

sf plugins install @salesforce/plugin-packaging
sfdx plugins:install sfdmu
sfdx plugins:install sfdx-git-delta
sfdx plugins:install sfdx-essentials
sfdx plugins:install texei-sfdx-plugin

If you are using CI/CD scripts, use echo y | sfdx plugins:install ... to bypass prompt.

Docker

You can use sfdx-hardis docker images to run in CI

• Docker Hub
  • hardisgroupcom/sfdx-hardis:latest (with latest @salesforce/cli version)
  • hardisgroupcom/sfdx-hardis:latest-sfdx-recommended (with recommended @salesforce/cli version, in case the latest version of @salesforce/cli is buggy)

• GitHub Packages (ghcr.io)
  • ghcr.io/hardisgroupcom/sfdx-hardis:latest (with latest @salesforce/cli version)
  • ghcr.io/hardisgroupcom/sfdx-hardis:latest-sfdx-recommended (with recommended @salesforce/cli version, in case the latest version of @salesforce/cli is buggy)

See Dockerfile

Usage

sfdx hardis:<COMMAND> <OPTIONS>

Articles

Here are some articles about sfdx-hardis

• English

• French
  • Versions d'API Salesforce décommissionnées: Que faire ?
  • Exporter en masse les fichiers d’une org Salesforce
  • Suspendre l’accès aux utilisateurs lors d’une mise en production Salesforce

Contributing

Anyone is welcome to contribute to this sfdx-hardis

• Install Node.js (recommended version)
• Install typescript by running npm install typescript --global
• Install yarn by running npm install yarn --global
• Install Salesforce DX by running npm install @salesforce/cli --global command line
• Fork this repo and clone it (or just clone if you are an internal contributor)
• At the root of the repository:
  • Run yarn to install dependencies
  • Run sf plugins link to link the local sfdx-hardis to SFDX CLI
  • Run tsc --watch to transpile typescript into js everytime you update a TS file
• Debug commands using NODE_OPTIONS=--inspect-brk sfdx hardis:somecommand -someparameter somevalue

Dependencies

sfdx-hardis partially relies on the following SFDX Open-Source packages

• Salesforce Data Move Utility
• SFDX Essentials
• SFDX Git Delta
• Texei Sfdx Plugin

Contributors

Commands

hardis:auth

hardis:cache

hardis:config

hardis:doc

hardis:lint

hardis:mdapi

hardis:misc

hardis:org

hardis:package

Command	Title
hardiscreate	Create a new package
hardisinstall	Install packages in an org
hardismergexml	Merge package.xml files
hardisversion:create	Create a new version of a package
hardisversion:list	Create a new version of a package
hardisversion:promote	Promote new versions of package(s)

hardis:project

hardis:scratch

hardis:source

hardis:work