j7s_branch_trigger/README.md

866 B

j7s-branch-trigger

Occasionally checks the state of branches on a provided repo using git remote ls.

If the "branches of concern" have updated since it last looked, it will send a POST to a web hook. The "branches of concern" are defined using a configured web hook.

Configuration

Configuration is done through the following environment variables which are checked at start up.

  • J7S_REPO - Required the url of the repo to check in the format you would hand git clone.
  • J7S_URL - Required the url to post to if a change is seen.
  • J7S_HISTORY_FILE - Default: '/tmp/branch-history.json' the location to save the last seen state.
  • J7S_PATTERN - Default: '(^HEAD$|refs/heads/(master|main)$)' python flavored regex to find branches of concern
  • J7S_LOOPTIME - Default: 1.0 minutes between checks of the state of of the repo