Skip to content

No clear documentation on where to find gitlab-runner-helper images

I am trying to find some definitive information which outlines where to find the latest builds of docker-runner-helper. After hours of searching, I finally found this (https://docs.gitlab.com/runner/configuration/advanced-configuration.html#migrating-helper-image-to-registrygitlabcom) which states:

Helper image registry
In GitLab 15.0 and later, the helper image is pulled from the GitLab Container Registry. In addition, helper images are only published in the GitLab Container Registry.

Before 15.0, you could configure this behavior to use images from Docker Hub.

However, neither https://docs.gitlab.com/runner/install/docker.html nor https://docs.gitlab.com/ee/update/index.html mention anything about this change.

In addition, it seems you can't actually browse https://registry.gitlab.com/ in a web browser, so you can't actually see what is hosted there.

After some trial and error, I found some issues/merge requests on gitlab.com which pointed towards using the above registry.gitlab.com, so tested:

[ docker-gitlab]$ docker pull registry.gitlab.com/gitlab-org/gitlab-runner/gitlab-runner-helper:x86_64-fad44824
x86_64-fad44824: Pulling from gitlab-org/gitlab-runner/gitlab-runner-helper
538e7388ac67: Pull complete
Digest: sha256:3d135f5ac08c9a287597d4fb580a26f8f7db73514565324cdc08200b5a2e41a6
Status: Downloaded newer image for registry.gitlab.com/gitlab-org/gitlab-runner/gitlab-runner-helper:x86_64-fad44824
registry.gitlab.com/gitlab-org/gitlab-runner/gitlab-runner-helper:x86_64-fad44824

^^^ succeeds

[ docker-gitlab]$ docker pull gitlab/gitlab-runner-helper:x86_64-fad44824
Error response from daemon: manifest for gitlab/gitlab-runner-helper:x86_64-fad44824 not found: manifest unknown: manifest unknown

^^^ fails as docker is trying to pull from dockerhub

I guess this issue is about a few questions/comments:

  1. I believe documentation all needs to be updated (in at least the links I mentioned above) to be explicit that the repository has changed, and how to access it.
  2. Why did the helper stop being published to dockerhub, but main gitlab and runner still are???
  3. Why can't we browse https://registry.gitlab.com/ in a browser?