realaravinth/debian-mirror-gitlab
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
debian-mirror-gitlab/doc/user/packages/dependency_proxy/index.md
Pirate Praveen d6737d101e New upstream version 13.6.5
2021-01-29 00:20:46 +05:30

3.4 KiB
Raw Blame History

stage group info
Package Package To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers

Dependency Proxy

The GitLab Dependency Proxy is a local proxy you can use for your frequently-accessed upstream images.

In the case of CI/CD, the Dependency Proxy receives a request and returns the upstream image from a registry, acting as a pull-through cache.

Prerequisites

To use the Dependency Proxy:

Supported images and packages

The following images and packages are supported.

Image/Package GitLab version
Docker 11.11+

For a list of planned additions, view the direction page.

View the Dependency Proxy

To view the Dependency Proxy:

  • Go to your group's Packages & Registries > Dependency Proxy.

The Dependency Proxy is not available for projects.

Use the Dependency Proxy for Docker images

CAUTION: Important: In some specific storage configurations, an issue occurs and container images are not pulled correctly from the cache. The problem occurs when an image is located in object storage. The proxy looks for it locally and fails to find it. View issue #208080 for details.

You can use GitLab as a source for your Docker images.

Prerequisites:

  • Your images must be stored on Docker Hub.
  • Docker Hub must be available. Follow this issue for progress on accessing images when Docker Hub is down.

To store a Docker image in Dependency Proxy storage:

  1. Go to your group's Packages & Registries > Dependency Proxy.

  2. Copy the Dependency Proxy URL.

  3. Use one of these commands. In these examples, the image is alpine:latest.

    • Add the URL to your .gitlab-ci.yml file:

      image: gitlab.example.com/groupname/dependency_proxy/containers/alpine:latest

    • Manually pull the Docker image:

      docker pull gitlab.example.com/groupname/dependency_proxy/containers/alpine:latest

    • Add the URL to a Dockerfile:

      FROM gitlab.example.com/groupname/dependency_proxy/containers/alpine:latest

GitLab pulls the Docker image from Docker Hub and caches the blobs on the GitLab server. The next time you pull the same image, GitLab gets the latest information about the image from Docker Hub, but serves the existing blobs from the GitLab server.

Clear the Dependency Proxy cache

Blobs are kept forever on the GitLab server, and there is no hard limit on how much data can be stored.

To reclaim disk space used by image blobs that are no longer needed, use the Dependency Proxy API.