Consolidate Your GitLab Stack with Gitaly on Kubernetes

Why It Matters

Consolidating Gitaly onto Kubernetes removes a separate VM layer, reducing infrastructure overhead and simplifying upgrades for GitLab users.

Key Takeaways

• Gitaly now GA on Kubernetes, eliminating hybrid VM setups.
• Benchmarks show 99%+ success rates matching VM deployments.
• Client retries handle pod restarts, preventing downtime during upgrades.
• Helm chart simplifies full GitLab or external Gitaly deployment.
• High‑availability Gitaly Cluster for K8s still in development.

Pulse Analysis

GitLab’s Gitaly service is the backbone of repository storage and Git operation handling. Historically, its memory‑intensive workload and need for fine‑grained cgroup control made native Kubernetes deployment difficult, forcing many enterprises into a hybrid model where Gitaly ran on dedicated VMs while other components lived in containers. This split required separate monitoring, patch cycles, and networking configurations, increasing operational burden and cost.

With the 18.11 release, GitLab ships Gitaly on Kubernetes as a generally available option. The solution leverages init containers to mount cgroup filesystems, configures each Git process in its own cgroup, and introduces configurable client‑retry logic that gracefully bridges the hard stop of pod restarts. In head‑to‑head benchmarks, a Kubernetes‑based GitLab instance achieved 99.16%‑100% success across clone, pull and push operations, essentially mirroring the reliability of traditional VM deployments. The official Helm chart streamlines installation, whether as part of a full GitLab stack or as an external service.

For organizations, this development means a single‑pane‑of‑glass infrastructure, eliminating the need to provision and maintain a separate VM fleet for Gitaly. The operational simplification translates into lower cloud spend, faster upgrade cycles, and a more consistent security posture. While true high‑availability via Gitaly Cluster (Praefect) on Kubernetes is still pending, the current GA release already delivers production‑grade reliability, positioning GitLab as a more attractive choice for cloud‑native DevOps teams.