Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hardisgroupcom/sfdx-hardis
Swiss-army-knife Toolbox for Salesforce. Orchestrates base commands and assist users with interactive wizards to make much more than native sfdx + Allows you to define a complete CI/CD Pipeline and Schedule a daily Metadata backup & monitoring of your orgs
https://github.com/hardisgroupcom/sfdx-hardis
ai apex automation cicd code-quality data-loader deployment devops documentation grafana monitoring plugin quality salesforce salesforce-api salesforce-developers salesforce-lightning salesforce-metadata salesforcedx sfdx
Last synced: 2 days ago
JSON representation
Swiss-army-knife Toolbox for Salesforce. Orchestrates base commands and assist users with interactive wizards to make much more than native sfdx + Allows you to define a complete CI/CD Pipeline and Schedule a daily Metadata backup & monitoring of your orgs
- Host: GitHub
- URL: https://github.com/hardisgroupcom/sfdx-hardis
- Owner: hardisgroupcom
- License: agpl-3.0
- Created: 2021-01-25T22:47:10.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T20:33:18.000Z (about 2 months ago)
- Last Synced: 2024-10-29T22:49:29.049Z (about 2 months ago)
- Topics: ai, apex, automation, cicd, code-quality, data-loader, deployment, devops, documentation, grafana, monitoring, plugin, quality, salesforce, salesforce-api, salesforce-developers, salesforce-lightning, salesforce-metadata, salesforcedx, sfdx
- Language: TypeScript
- Homepage: https://sfdx-hardis.cloudity.com
- Size: 63 MB
- Stars: 196
- Watchers: 7
- Forks: 39
- Open Issues: 38
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-sfdx-plugins - sfdx-hardis - platform.com/), [@hardisgroupcom](https://github.com/hardisgroupcom)) (Community supported plugins)
README
[](https://sfdx-hardis.cloudity.com)
# sfdx-hardis
_Presented at_ [_Dreamforce 23_](https://reg.salesforce.com/flow/plus/df23/sessioncatalog/page/catalog/session/1684196389783001OqEl) _and [_Dreamforce 24!_](https://reg.salesforce.com/flow/plus/df24/sessioncatalog/page/catalog/session/1718915808069001Q7HH)_
[**Upgrade now to sfdx-hardis v5 !**](https://github.com/hardisgroupcom/sfdx-hardis/releases/tag/v5.0.1)
[](https://npmjs.org/package/sfdx-hardis)
[](https://npmjs.org/package/sfdx-hardis)
[](https://npmjs.org/package/sfdx-hardis)
[](https://hub.docker.com/r/hardisgroupcom/sfdx-hardis/tags)
[](https://GitHub.com/hardisgroupcom/sfdx-hardis/stargazers/)
[](https://gitHub.com/hardisgroupcom/sfdx-hardis/graphs/contributors/)
[](https://github.com/hardisgroupcom/sfdx-hardis/actions?query=workflow%3AMega-Linter+branch%3Amain)
[](https://github.com/aquasecurity/trivy)
[](https://github.com/hardisgroupcom/sfdx-hardis/blob/main/package.json)
[](http://makeapullrequest.com)
Toolbox for Salesforce DX, by [**Cloudity**](https://cloudity.com/) & friends, 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 **ready to use CI/CD Pipeline** for your Salesforce project](https://sfdx-hardis.cloudity.com/salesforce-ci-cd-home/)
- [**Backup Metadatas** and **monitor any Salesforce org**](https://sfdx-hardis.cloudity.com/salesforce-monitoring-home/)
[_Please see the full list of commands in Online documentation_](https://sfdx-hardis.cloudity.com)
___
**sfdx-hardis** commands are also available with UI in [**SFDX Hardis Visual Studio Code Extension**](https://marketplace.visualstudio.com/items?itemName=NicolasVuillamy.vscode-sfdx-hardis)
[](https://marketplace.visualstudio.com/items?itemName=NicolasVuillamy.vscode-sfdx-hardis)
___
_See Dreamforce presentation_
[](https://www.youtube.com/watch?v=o0Mm9F07UFs)
## Installation
### With IDE
You can install [Visual Studio Code](https://code.visualstudio.com/) extension [VsCode SFDX Hardis](https://marketplace.visualstudio.com/items?itemName=NicolasVuillamy.vscode-sfdx-hardis)
Once installed, click on  in VsCode left bar, and follow the additional installation instructions
[](https://www.youtube.com/watch?v=LA8m-t7CjHA)
___
### As SFDX Plugin
#### Pre-requisites
- Install Node.js ([recommended version](https://nodejs.org/en/))
- Install Salesforce DX by running `npm install @salesforce/cli --global` command line
#### Plugin installation
```sh-session
sf plugins install sfdx-hardis
```
For advanced use, please also install dependencies
```sh-session
sf plugins install @salesforce/plugin-packaging
sf plugins install sfdmu
sf plugins install sfdx-git-delta
sf plugins install texei-sfdx-plugin
```
If you are using CI/CD scripts, use `echo y | sf plugins install ...` to bypass prompt.
___
### Docker
You can use sfdx-hardis docker images to run in CI
- Docker Hub
- [**hardisgroupcom/sfdx-hardis:latest**](https://hub.docker.com/r/hardisgroupcom/sfdx-hardis) (with latest @salesforce/cli version)
- [**hardisgroupcom/sfdx-hardis:latest-sfdx-recommended**](https://hub.docker.com/r/hardisgroupcom/sfdx-hardis) (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**](https://github.com/orgs/hardisgroupcom/packages) (with latest @salesforce/cli version)
- [**ghcr.io/hardisgroupcom/sfdx-hardis:latest-sfdx-recommended**](https://github.com/orgs/hardisgroupcom/packages) (with recommended @salesforce/cli version, in case the latest version of @salesforce/cli is buggy)
_See [Dockerfile](https://github.com/hardisgroupcom/sfdx-hardis/blob/main/Dockerfile)_
## Usage
```sh-session
sf hardis:
```
## Articles
Here are some articles about [sfdx-hardis](https://sfdx-hardis.cloudity.com/)
- English
[](https://nicolas.vuillamy.fr/how-to-deploy-conga-composer-configuration-using-salesforce-cli-plugins-c2899641f36b)
[](https://nicolas.vuillamy.fr/what-devops-experts-want-to-know-about-salesforce-ci-cd-with-sfdx-hardis-q-a-1f412db34476)
[](https://developer.salesforce.com/podcast/2023/06/sfdx)
[](https://salesforcedevops.net/index.php/2023/03/01/sfdx-hardis-open-source-salesforce-release-management/)
[](https://nicolas.vuillamy.fr/assisted-solving-of-salesforce-deployments-errors-47f3666a9ed0)
[](https://nicolas.vuillamy.fr/handle-salesforce-api-versions-deprecation-like-a-pro-335065f52238)
[](https://nicolas.vuillamy.fr/how-to-mass-download-notes-and-attachments-files-from-a-salesforce-org-83a028824afd)
[](https://medium.com/@dimitrimonge/freeze-unfreeze-users-during-salesforce-deployment-8a1488bf8dd3)
[](https://nicolas.vuillamy.fr/how-to-detect-bad-words-in-salesforce-records-using-sfdx-data-loader-and-sfdx-hardis-171db40a9bac)
[](https://nicolas.vuillamy.fr/reactivate-all-the-sandbox-users-with-invalid-emails-in-3-clicks-2265af4e3a3d)
[](https://nicolas.vuillamy.fr/invalid-scope-mine-not-allowed-deploy-your-listviews-anyway-443aceca8ac7)
- French
- [Versions d'API Salesforce décommissionnées: Que faire ?](https://leblog.hardis-group.com/portfolio/versions-dapi-salesforce-decommissionnees-que-faire/)
- [Exporter en masse les fichiers d’une org Salesforce](https://leblog.hardis-group.com/portfolio/exporter-en-masse-les-fichiers-dune-org-salesforce/)
- [Suspendre l’accès aux utilisateurs lors d’une mise en production Salesforce](https://leblog.hardis-group.com/portfolio/suspendre-lacces-aux-utilisateurs-lors-dune-mise-en-production-salesforce/)
## Contributing
Everyone is welcome to contribute to sfdx-hardis (even juniors: we'll assist you !)
- Install Node.js ([recommended version](https://nodejs.org/en/))
- 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 sf hardis:somecommand -someparameter somevalue`
## Dependencies
**sfdx-hardis** partially relies on the following SFDX Open-Source packages
- [Salesforce Data Move Utility](https://github.com/forcedotcom/SFDX-Data-Move-Utility)
- [SFDX Git Delta](https://github.com/scolladon/sfdx-git-delta)
- [Texei Sfdx Plugin](https://github.com/texei/texei-sfdx-plugin)
## Contributors
## Commands
[**Read Online Documentation to see everything you can do with SFDX Hardis :)**](https://sfdx-hardis.cloudity.com)