Connecting a Salto environment with a Git branch offers several advantages:
Documentation: Ensure all configuration changes are recorded and easily traceable. This can assist identifying changes during audit processes.
Integrate with Ticketing Systems: Link changes directly to business requirement tickets for enhanced tracking and accountability.
Collaboration: Improve teamwork and code quality through pull requests (PRs) and peer reviews.
Automation: Leverage continuous integration (CI) jobs to automate testing and validation of changes before they are deployed
Supported Git Providers
Salto fully supports the following Git providers:
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
Go to the specific Git provider help article to learn more about connecting to it.
Native Git integration does not support attaching pull requests with deployments records.
Connecting an Environment to a Git Branch
To connect an environment to a Git branch, follow these steps:
Navigate to the Environment Settings
Go to the ‘Version Control’ Section
Click on ‘Connect Git’
Define Your Git Usage:
Optionally, enable deployment protection through pull requests. Learn more here.
Choose your preferred push settings:
Automatically push every change (recommended):
Requires shared Git credentials used solely for pushing changes identified in fetch operations.
Initial connection includes a push of all environment files.
Automatic push for deployments only:
Changes deployed via Salto will be automatically pushed to the Git branch.
Changes detected in fetch operations will remain un-pushed and can be manually pushed via the Git widget in the environment header.
Manual Push Mode:
Salto will not automatically push any environment changes.
Authenticate with your Git provider
If automatic push is enabled, you will be promoted to authenticate with shared Git credentials. These shared credentials will be used for pushing environment changes detected in fetch operations. Upon any other git operations such as creating, updating and merging a pull request, the user will be prompted to authenticate with his personal Git credentials.
For the other push modes, 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.