Puppet module for Gitlab custom hooks.

1. Description
2. Setup - The basics of getting started with custom_hooks
   • What custom_hooks affects
   • Setup requirements
   • Beginning with custom_hooks
3. Usage - Configuration options and additional functionality
4. Limitations - OS compatibility, etc.
5. Development - Guide for contributing to the module

This module uses the puppet Deferred function to create custom hooks on your Gitlab repos when using hashed storage.

This module makes use of the Puppet 6 Deferred function. It is therefore only compatible with Puppet 6+.

This module relies on the to_yaml function of the stdlib module.

This module requires a valid Gitlab access token with read_api access https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html

Add any custom_hook::hook defined type resources to your GitLab gitaly nodes. You can declare you custom hooks like so. Substitute 'content' for 'source' below if you need a template.

custom_hooks::hook { 'foo':
  ensure    => present,
  external_url => 'https://gitlab.auto.saas-n.com',
  hook_type => 'pre-receive',
  project   => 'lemery/test-project',
  repo_path    => '/var/opt/gitlab/git-data/repositories',
  source    => "file:///root/test.sh",
  token        => '<seekrit token>',
  use_ssl      => true,
  verify_ssl   => false,
}

Declare your hook with ensure => absent and they will be removed.

As above.

This section is deprecated.

Requires Puppet 6+

There are always bugs. Pull requests very welcome.