Use custom Docker images for the GitLab chart
In certain scenarios (i.e. offline environments), you may want to bring your own images rather than pulling them down from the Internet. This requires specifying your own Docker image registry/repository for each of the charts that make up the GitLab release.
Default image format
Our default format for the image in most cases includes the full path to the image, excluding the tag:
image:
repository: repo.example.com/image
tag: custom-tag
The end result will be repo.example.com/image:custom-tag
.
Current images and tags
When planning an upgrade, your current values.yaml
and the target version of the
GitLab chart can be used to generate a Helm template.
This template will contain the images and their respective tags that will be
needed by the specified version of the chart.
# Gather the latest values
helm get values gitlab > gitlab.yaml
# Use the gitlab.yaml to find the images and tags
helm template versionfinder gitlab/gitlab -f gitlab.yaml --version 7.3.0 | grep 'image:' | tr -d '[[:blank:]]' | sort --unique
This command can also be used to verify any custom configurations.
Example values file
There is an example values file that demonstrates how to configure a custom Docker registry/repository and tag. You can copy relevant sections of this file for your own releases.
Some of the charts (especially third party charts) sometimes have slightly different conventions for specifying the image registry/repository and tag. You can find documentation for third party charts on the Artifact Hub.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support