GitLab Helm chart Alpha

The charts are now in beta. See the beta documentation for more information.

We have been working hard on the chart and it’s underlying containers, and are excited to reach alpha and share it with the GitLab community.

This effort has required extensive changes across the product:

  • Support for directly uploading to object storage
  • No dependency on shared storage
  • New containers for each component of GitLab
  • New Helm chart

While much of the underlying work has been completed, there are a few changes that will be arriving after alpha has started. This means that there are a few features of GitLab that may not work as expected.

Release cadence

In order to maximize our testing opportunity in alpha, the chart and containers will be rebuilt off master as changes are merged. This means that fixes and improvements will be available immediately, instead of waiting for a specific release.

Along with the issues and merge requests in this repository, a changelog is being made available to more easily follow along with updates throughout the alpha period.

Kubernetes deployment support

GitLab development and testing is taking place on Google Kubernetes Engine, however other Kubernetes deployments should also work. In the event of a specific non-GKE deployment issue, please raise an issue.

We are currently using Kubernetes version 1.8.7 for development. We plan to announce the minimum required Kubernetes version during beta.

GitLab Enterprise Edition

During alpha, GitLab Enterprise Edition is required while we bring object storage support to Community Edition. GitLab EE offers same functionality as GitLab CE when no license is supplied.

We will be adding support for GitLab Community Edition before making these charts generally available.

Technical support during alpha

Technical support is limited during this alpha phase. Due to the in-development nature, standard GitLab support will not be able to assist.

Before opening an issue please review the known issues and limitations, and search to see if a similar issue already exists.

We greatly appreciate the wider testing of the community during alpha, and encourage detailed issues to be reported so we can address them. However we might not be able to provide support for every user request.

We also reserve the right to close issues without providing a reason. Issues can accumulate quickly and we need to spend more time moving the charts forward than doing issue triage.

We welcome any improvements contributed in the form of Merge Requests.

Known issues and limitations

The chart and containers are a work in progress, and not all features are fully functional. Below is a list of the known issues and limitations, although it may not be exhaustive. We recommend also reviewing the open issues.

Helm chart issues/limitations:

Features that are currently out of scope:

Path to beta and general availability

The next phase in the chart lifecycle after alpha will be a beta phase. Our goals for entering beta are:

  • All features of GitLab are fully functional
  • Backup and restore are supported
  • Upgrades are supported
  • Object storage support for S3 compatible interfaces
  • No expected breaking changes
  • Releases are versioned

Once beta is complete, the next phase will be general availability. Our goals for the charts to be generally available are:

  • High availability, with self-healing pods
  • Scalable to very large deployments
  • Down-time free upgrades
  • Production grade monitoring, logging
  • Mature support and documentation for common Kubernetes deployment targets, like: on-premise, EKS, AKS, PKS.
  • No breaking changes