1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
package git
import (
"context"
"errors"
"fmt"
"gitlab.com/gitlab-org/gitaly/v16/internal/git/repository"
"gitlab.com/gitlab-org/gitaly/v16/internal/gitaly/config"
"gitlab.com/gitlab-org/gitaly/v16/internal/log"
"gitlab.com/gitlab-org/gitaly/v16/internal/metadata"
"gitlab.com/gitlab-org/gitaly/v16/internal/metadata/featureflag"
"gitlab.com/gitlab-org/gitaly/v16/internal/transaction/txinfo"
"gitlab.com/gitlab-org/gitaly/v16/proto/go/gitalypb"
labkittracing "gitlab.com/gitlab-org/labkit/tracing"
)
// envInjector is responsible for injecting environment variables required for tracing into
// the child process.
var envInjector = labkittracing.NewEnvInjector()
// WithDisabledHooks returns an option that satisfies the requirement to set up
// hooks, but won't in fact set up hook execution.
func WithDisabledHooks() CmdOpt {
return func(_ context.Context, _ config.Cfg, _ CommandFactory, cc *cmdCfg) error {
cc.hooksConfigured = true
return nil
}
}
// WithRefTxHook returns an option that populates the safe command with the
// environment variables necessary to properly execute a reference hook for
// repository changes that may possibly update references
func WithRefTxHook(repo repository.GitRepo) CmdOpt {
return func(ctx context.Context, cfg config.Cfg, gitCmdFactory CommandFactory, cc *cmdCfg) error {
if repo == nil {
return fmt.Errorf("missing repo: %w", ErrInvalidArg)
}
// The reference-transaction hook does not need any project-specific information
// about the repository. So in order to make the hook usable by sites which do not
// have a project repository available (e.g. object pools), this function accepts a
// `repository.GitRepo` and just creates an ad-hoc proto repo.
if err := cc.configureHooks(ctx, &gitalypb.Repository{
StorageName: repo.GetStorageName(),
GitAlternateObjectDirectories: repo.GetGitAlternateObjectDirectories(),
GitObjectDirectory: repo.GetGitObjectDirectory(),
RelativePath: repo.GetRelativePath(),
}, cfg, gitCmdFactory, nil, ReferenceTransactionHook); err != nil {
return fmt.Errorf("ref hook env var: %w", err)
}
return nil
}
}
// WithPackObjectsHookEnv provides metadata for gitaly-hooks so it can act as a pack-objects hook.
func WithPackObjectsHookEnv(repo *gitalypb.Repository, protocol string) CmdOpt {
return func(ctx context.Context, cfg config.Cfg, gitCmdFactory CommandFactory, cc *cmdCfg) error {
if !cfg.PackObjectsCache.Enabled {
return nil
}
if repo == nil {
return fmt.Errorf("missing repo: %w", ErrInvalidArg)
}
userDetails := &UserDetails{
Protocol: protocol,
UserID: metadata.GetValue(ctx, "user_id"),
Username: metadata.GetValue(ctx, "username"),
RemoteIP: metadata.GetValue(ctx, "remote_ip"),
}
if err := cc.configureHooks(
ctx,
repo,
cfg,
gitCmdFactory,
userDetails,
PackObjectsHook,
); err != nil {
return fmt.Errorf("pack-objects hook configuration: %w", err)
}
cc.globals = append(cc.globals, ConfigPair{
Key: "uploadpack.packObjectsHook",
Value: cfg.BinaryPath("gitaly-hooks"),
})
return nil
}
}
// ReceivePackRequest abstracts away the different requests that end up
// spawning git-receive-pack.
type ReceivePackRequest interface {
GetGlId() string
GetGlUsername() string
GetGlRepository() string
GetRepository() *gitalypb.Repository
}
// WithReceivePackHooks returns an option that populates the safe command with the environment
// variables necessary to properly execute the pre-receive, update and post-receive hooks for
// git-receive-pack(1).
func WithReceivePackHooks(req ReceivePackRequest, protocol string) CmdOpt {
return func(ctx context.Context, cfg config.Cfg, gitCmdFactory CommandFactory, cc *cmdCfg) error {
if err := cc.configureHooks(ctx, req.GetRepository(), cfg, gitCmdFactory, &UserDetails{
UserID: req.GetGlId(),
Username: req.GetGlUsername(),
Protocol: protocol,
}, ReceivePackHooks); err != nil {
return err
}
return nil
}
}
// configureHooks updates the command configuration to include all environment
// variables required by the reference transaction hook and any other needed
// options to successfully execute hooks.
func (cc *cmdCfg) configureHooks(
ctx context.Context,
repo *gitalypb.Repository,
cfg config.Cfg,
gitCmdFactory CommandFactory,
userDetails *UserDetails,
requestedHooks Hook,
) error {
if cc.hooksConfigured {
return errors.New("hooks already configured")
}
objectHash, err := DetectObjectHash(ctx, gitCmdFactory, repo)
if err != nil {
return fmt.Errorf("detecting object hash: %w", err)
}
var transaction *txinfo.Transaction
if tx, err := txinfo.TransactionFromContext(ctx); err == nil {
transaction = &tx
} else if !errors.Is(err, txinfo.ErrTransactionNotFound) {
return err
}
payload, err := NewHooksPayload(
cfg,
repo,
objectHash,
transaction,
userDetails,
requestedHooks,
featureflag.FromContext(ctx)).Env()
if err != nil {
return err
}
cc.env = append(
cc.env,
payload,
fmt.Sprintf("%s=%s", log.GitalyLogDirEnvKey, cfg.Logging.Dir),
)
cc.env = envInjector(ctx, cc.env)
cc.globals = append(cc.globals, ConfigPair{Key: "core.hooksPath", Value: gitCmdFactory.HooksPath(ctx)})
cc.hooksConfigured = true
return nil
}
|