a935a2abbf | ||
---|---|---|
.devcontainer | ||
.github/workflows | ||
.husky | ||
.vscode | ||
auth | ||
config | ||
docs | ||
force-app/main/default | ||
node-scripts | ||
release-notes | ||
scripts | ||
.eslintignore | ||
.eslintrc.json | ||
.forceignore | ||
.gitignore | ||
.prettierignore | ||
.prettierrc | ||
CODEOWNERS | ||
CODE_OF_CONDUCT.md | ||
LICENSE | ||
README.md | ||
SECURITY.md | ||
SUPPORT.md | ||
github-mark.png | ||
jest.config.js | ||
package-lock.json | ||
package.json | ||
sfdx-project.json |
README.md
octoforce-actions
A lightweight open-source template Salesforce CI/CD built on the GitHub
actions platform.
Features
- Automation to create a development sandbox and UAT sandbox for each issue created.
- Automation to deploy metadata changes to UAT sandboxes for each pull request created against a release branch.
- Automation to compile release notes when changes are merged into a release branch.
- Script to authenticate against sandboxes using
SFDX
and encrypt the credentials for use in GitHub Actions. - Setup script for MacOS to setup
SFDX
andNodeJS
as well other development dependencies. - Basic Docker for configuration for use in
Codespaces
.
Limitations
- No automation to deploy changes to production.
- Setup script does not support Windows.
Background
This project is meant to be helpful guide and starting for Salesforce developers who want to automate their CI/CD process using GitHub Actions. It is not meant to be a complete solution for all Salesforce development teams.
Requirements
NodeJS 14.x is the minimum requirement for this project. More recent versions of NodeJS are still being tested. We are currently testing Node 18.x and have found issues with authentication against sandboxes using SFDX
web auth flow.
The setup scripts require MacOS to run locally, however is not required to make use of this template.
The sandbox authentication script requires SFDX
to be installed and configured and requires a bash environment.
License
This project is licensed under the terms of the MIT open source license. Please refer to MIT for the full terms.
Maintainers
Support
This template will receive basic maintenace such as bug fixes and security updates.