Integrating your Salto environment with a Git branch enables version control and collaboration for your application configuration. Before setting up the connection, consider the following authentication and permission requirements:
Shared Git User for Automatic Pushes
You will need to provide a shared Git user. This user is responsible for pushing fetched changes to the branch, so it must have the necessary permissions to push commits.
Alternatively, you can enable manual push mode. In this mode, automatic pushes will not occur, and protection via PRs will not be available.Personal Git Credentials for Deployments
Each team member deploying to this environment must authenticate using their personal Git credentials.
If deployment pull requests are enabled, the user must have permission to create and update PRs for the environment branch, as well as squash and merge them.
If PRs are not enabled, the user must have direct push permissions for the environment branch.
More information per supported Git provider:
Other cloud or on-prem Git services and installations are supported as a native Git integration by providing your Git URL, credentials and commit email.
Setting Up a Git Connection
Navigate to the Environment Settings
Go to the ‘Version Control’ Section
Click on ‘Connect Git’
Define Your Git Usage:
Choose your preferred push settings:
Automatically push every change (recommended)
Manually select and push changes
Enable deployment protection via pull requests. Learn more.
Enable SFDX integration (salesforce only)
You will be promoted to authenticate with shared Git credentials.
(If manual push mode is enabled, you will be prompted to authenticate with your personal Git credentials).
Select a repository and click ‘Next’
Select or Create a branch and click ‘Select/Create Branch and Link’
👍🏻 Your environment is now connected to a Git branch. A Git widget will appear in the environment header, allowing you to navigate to the branch in your Git provider and manually push files in case auto push mode is not enabled.