Add hashed storage path calculations

Author: yakatz

manifests/custom_hook.pp

@@ -8,19 +8,29 @@
 #     source          => 'puppet:///modules/my_module/post-receive',
 #   }
 #
+# @example Calculate hashed storage path
+#   gitlab::custom_hook { 'my_custom_hook':
+#     project         => 93,
+#     type            => 'post-receive',
+#     source          => 'puppet:///modules/my_module/post-receive',
+#   }
+#   # Hook path will be `@hashed/6e/40/6e4001871c0cf27c7634ef1dc478408f642410fd3a444e2a88e301f5c4a35a4d`
+#
+# @param project The GitLab project name, or the hashed directory name or project ID number
 # @param namespace The GitLab group namespace for the project.
-# @param project The GitLab project name.
 # @param type The custom hook type. Should be one of pre-receive, post-receive, or update.
 # @param content Specify the custom hook contents either as a string or using the template function. If this paramter is specified source parameter must not be present.
 # @param source Specify a file source path to populate the custom hook contents. If this paramter is specified content parameter must not be present.
 # @param repos_path The GitLab shell repos path. This defaults to '/var/opt/gitlab/git-data/repositories' if not present.
+# @param hashed_storage Whether to treat the project name as a hashed storage directory name or ID number
 define gitlab::custom_hook (
-  String                                        $namespace,
-  String                                        $project,
+  Variant[String,Integer]                       $project,
   Enum['update', 'post-receive', 'pre-receive'] $type,
+  Optional[String]                              $namespace = undef,
   Optional[String]                              $content = undef,
   Optional[String]                              $source = undef,
   Optional[Stdlib::Absolutepath]                $repos_path = undef,
+  Optional[Boolean]                             $hashed_storage = false,
 ) {
   if $repos_path {
     $_repos_path = $repos_path
@@ -38,7 +48,30 @@
     fail("gitlab::custom_hook[${name}]: Must specify either content or source, but not both")
   }
 
-  $hook_path = "${_repos_path}/${namespace}/${project}.git/custom_hooks"
+  if ! ($hashed_storage) and ! ($namespace) {
+    fail("gitlab::custom_hook[${name}]: Must specify either namespace or hashed_storage")
+  }
+
+  if ($hashed_storage) and ($namespace) {
+    fail("gitlab::custom_hook[${name}]: Must specify either namespace or hashed_storage, but not both")
+  }
+
+
+  if ($namespace) {
+    $hook_path = "${_repos_path}/${namespace}/${project}.git/custom_hooks"
+  } elseif ($hashed_storage) {
+    if ($project.is_a(Integer)) {
+      $_project_hash = sha256(String($project))
+    } else {
+      $_project_hash = $project
+    }
+
+    if ($_project_hash.length != 64) {
+      fail("gitlab::custom_hook[${name}]: Invalid project hash ${_project_hash}")
+    }
+
+    $hook_path = "${_repos_path}/@hashed/${_project_hash[0,2]}/${_project_hash[2,2]}/${_project_hash}.git/custom_hooks"
+  }
 
   File {
     owner => $gitlab::service_user,