blob: ca2650cd1a58fd1ef94b75675552665d453aef8a (
plain)
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
|
## Gitaly documentation
The historical reasons for the inception of Gitaly and our design decisions are
written in [the design doc](doc/DESIGN.md).
#### Configuring Gitaly
Running Gitaly requires it to be configured correctly, options are described in
GitLab's [configuration documentation](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/administration/gitaly/index.md).
The reference guide is documented in https://gitlab.com/gitlab-org/gitlab/blob/master/doc/administration/gitaly/reference.md.
#### Developing Gitaly
- When new to Gitaly development, start by reading the [beginners guide](doc/beginners_guide.md).
- When developing on Gitaly-Ruby, read the [Gitaly-Ruby doc](doc/ruby_endpoint.md)
- The Gitaly release process is described in [our process doc](doc/PROCESS.md)
- Tests use Git repositories too, [read more about them](doc/test_repos.md)
- Praefect uses SQL. To create a new SQL migration see [sql_migrations.md](sql_migrations.md)
#### Gitaly Cluster
Gitaly does not replicate any data. If a Gitaly server goes down, any of its
clients can't read or write to the repositories stored on that server. This
means that Gitaly is not highly available. How this will be solved is described
[in the HA design document](doc/design_ha.md)
For configuration please read [praefects configuration documentation](doc/configuration/praefect.md).
#### Technical explanations
- [Delta Islands](delta_islands.md)
- [Disk-based Cache](design_diskcache.md)
- [Tips for reading Git source code](reading_git_source.md)
- [gitaly-ssh](../cmd/gitaly-ssh/README.md)
- [Git object quarantine during git push](object_quarantine.md)
- [Logging in Gitaly](logging.md)
#### Proposals
- [Snapshot storage](proposals/snapshot-storage.md)
- [Praefect Queue storage](proposals/praefect-queue-storage.md)
|
