Source Version Control Repositories Customization and Hooks
This document briefly describes how you can use the tools at https://my.cae.wisc.edu/ to customize a repository you own.
Customization
In order to provide a scalable and maintainable service, we do not currently allow for custom repository
hooks or additional changes outside of those available in the web pages.
Below are a set of other customization settings we do currently offer.
Please email unix-request@cae.wisc.edu if you have any
questions or suggestions.
- Hidden (on by default)
Some of the repository browsing pages have the ability to list the available set of projects. This setting removes the project from that listing. Authentication and Authorization rules still apply to accessing them. - Commit Notifications
An optional space separated list of email addresses that should receivecommit
/push
notification emails. If left unset, then no commit notifications will be sent.These emails are sent out as
the_commiter@cae.wisc.edu
, but bounce messages will go back tothe_owner@cae.wisc.edu
.
The messages can also be truncated to a particular owner defined length to prevent flooding peoples emails with excessively large diffs. The default message size is currently capped at 1M.For
git
repositories, the emails consist of a summary of the log messages of each of the commits involved in apush
followed by an overall diff summary of the changes. -
Commit Notification Branches
NOTE: This hook customization is only available forgit
repositories.
An optional space separated list of branches that should trigger commit notifications when pushed to the server. This settings has no effect if the commit notifications email list is not also set. - Production Branch
NOTE: This hook customization is only available forgit
repositories.
An optional name of a branch to consider as "production". - Production Group
NOTE: This hook customization is only available forgit
repositories.
An extra group whose membership is required to be able topush
to the Production Branch. - Testing Branch
NOTE: This hook customization is only available forgit
repositories.
An optional name of a branch to consider as "testing". If set, then commits must be pushed here prior to being pushed to the Production Branch. - Require Merge Commit Branches
NOTE: This hook customization is only available forgit
repositories.
An optional space separated list of branch names to require merge commits on (ie:git merge --no-ff --log
). Often set to the set of "Production Branch" and "Testing Branch" values. - Deny Non-FastForward Pushes
NOTE: This hook customization is only available forgit
repositories.
Whether or not to allow forced non-fastforward pushes (ie: pushing rebased branches). This controls the server sidereceive.denyNonFastForwards
setting.