Installing GitLab on Kubernetes

These Helm charts are in beta. GitLab is working on a cloud-native set of Charts which will replace these.

Officially supported cloud providers are Google Container Service and Azure Container Service.

The easiest method to deploy GitLab in Kubernetes is to take advantage of the official GitLab Helm charts. Helm is a package management tool for Kubernetes, allowing apps to be easily managed via their Charts. A Chart is a detailed description of the application including how it should be deployed, upgraded, and configured.

The GitLab Helm repository is located at https://charts.gitlab.io. You can report any issues related to GitLab's Helm Charts at https://gitlab.com/charts/charts.gitlab.io/issues. Contributions and improvements are also very welcome.

Prerequisites

To use the charts, the Helm tool must be installed and initialized. The best place to start is by reviewing the Helm Quick Start Guide.

Add the GitLab Helm repository

Once Helm has been installed, the GitLab chart repository must be added:

helm repo add gitlab https://charts.gitlab.io

After adding the repository, Helm must be re-initialized:

helm init

Using the GitLab Helm Charts

GitLab makes available three Helm Charts: an easy to use bundled chart, and a specific chart for GitLab itself and the Runner.

• gitlab-omnibus: The easiest way to get started. Includes everything needed to run GitLab, including: a Runner, Container Registry, automatic SSL, and an Ingress.
• gitlab: Just the GitLab service, with optional Postgres and Redis.
• gitlab-runner: GitLab Runner, to process CI jobs.