README
¶
Quick Links: Migration Board | Roadmap | Open Conversations | Unassigned Conversations | Migrations | Want to Contribute? | GitLab Gitaly Issues | GitLab Gitaly Merge Requests | gitlab.com dashboard |
Gitaly is a Git RPC service for handling all the git calls made by GitLab.
To see where it fits in please look at GitLab's architecture
Project Goals
Fault-tolerant horizontal scaling of Git storage in GitLab, and particularly, on gitlab.com.
This will be achieved by focusing on two areas (in this order):
- Migrate from repository access via NFS to gitaly-proto, GitLab's new Git RPC protocol
- Evolve from large Gitaly servers managed as "pets" to smaller Gitaly servers that are "cattle"
Current Status
As of GitLab 11.1, most application code accesses Git repositories through Gitaly instead of direct disk access. We are close to removing all Git disk access from gitlab-rails (the Gitaly v1.1 milestone). We are even closer to fully supporting the subset of Git operations needed by gitlab.com (the v1.0 milestone). When these two milestones are closed the migration project will be complete.
The roadmap is available here.
The migration process is documented.
If you're interested in seeing how well Gitaly is performing on GitLab.com, we have dashboards!
Migrations
The progress of Gitaly's endpoint migrations is tracked via the Migration Board
Installation
Gitaly requires Go 1.8 or newer and Ruby 2.3. Run make to download
and compile Ruby dependencies, and to compile the Gitaly Go
executable.
Gitaly uses git. Version 2.18.0 is recommended, and 2.9.0 at a minimum.
Configuration
See configuration documentation
Contributing
See CONTRIBUTING.md.
Name
Gitaly is a tribute to git and the town of Aly. Where the town of Aly has zero inhabitants most of the year we would like to reduce the number of disk operations to zero for most actions. It doesn't hurt that it sounds like Italy, the capital of which is the destination of all roads. All git actions in GitLab end up in Gitaly.
Design
High-level architecture overview:
Edit this diagram directly in Google Drawings
Presentations
- Git Paris meetup, 2017-02-22 a high-level overview of what our plans are and where we are.
- Gitaly Basics, 2017-05-01
- Infrastructure Team Update 2017-05-11
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
internal
|
|
|
middleware/limithandler/testpb
Package test is a generated protocol buffer package.
|
Package test is a generated protocol buffer package. |
|
Package streamio contains wrappers intended for turning gRPC streams that send/receive messages with a []byte field into io.Writers and io.Readers.
|
Package streamio contains wrappers intended for turning gRPC streams that send/receive messages with a []byte field into io.Writers and io.Readers. |