Skip to content
Runbooks

Dependency proxy for containers runbook

Summary

Section titled “Summary”

The Dependency Proxy for GitLab Container Registry acts as a local proxy for frequently accessed Docker images from Docker Hub.

Note: For general Package Registry architecture, troubleshooting, and operational procedures, see the main Package Registry runbook.

API

Section titled “API”
  • v2/:group_id/dependency_proxy/containers/:image/manifests/*tag
  • v2/:group_id/dependency_proxy/containers/:image/blobs/:sha
  • v2/:group_id/dependency_proxy/containers/:image/blobs/:sha/upload/authorize
  • v2/:group_id/dependency_proxy/containers/:image/blobs/:sha/upload
  • v2/:group_id/dependency_proxy/containers/:image/manifests/*tag/upload/authorize
  • v2/:group_id/dependency_proxy/containers/:image/manifests/*tag/upload

Observability

Section titled “Observability”

Troubleshooting

Section titled “Troubleshooting”

Service Changes

Section titled “Service Changes”

Common Operations

Section titled “Common Operations”

Test Docker pull through proxy

Section titled “Test Docker pull through proxy”

docker pull $GITLAB_HOST:$PORT/$GROUP_PATH/dependency_proxy/containers/library/alpine:latest

References

Section titled “References”