FAQ | This is a LIVE service | Changelog

Document how to use the GitLab dependency proxy for Docker images

There is a "gotcha" when using the dependency proxy for Docker images in that using CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX will fail unless the user triggering the pipeline has at least Guest permissions on the top-level uis group. (upstream issue)

This caused development of https://gitlab.developers.cam.ac.uk/uis/devops/iam/activate-account/infrastructure/-/merge_requests/325 to be complicated since whether a given pipeline would work depended on who triggered it.

Add a how-to guide which documents a mechanism to use the dependency proxy safely. This will probably consist of a before_script on the CI job, e.g:

some-job:
  before_script:
    - |-
      echo "Using docker login to authenticate to $CI_DEPENDENCY_PROXY_SERVER"
      echo "$CI_DEPENDENCY_PROXY_PASSWORD" | docker login $CI_DEPENDENCY_PROXY_SERVER -u $CI_DEPENDENCY_PROXY_USER --password-stdin

We also need to document to always use CI_DEPENDENCY_PROXY_DIRECT_GROUP_IMAGE_PREFIX when pulling the image.

Edited by Dr Rich Wareham