Skip to content

chaining.md

Latest commit

 

History

History
79 lines (67 loc) · 2.07 KB

chaining.md

File metadata and controls

79 lines (67 loc) · 2.07 KB
title Chain multiple caches
description Learn how to deploy and chain multiple caches for Docker Trusted Registry, to cover multiple regions or offices
keywords docker, dtr, tls

If your users are distributed geographically, consider chaining multiple DTR caches together for faster pulls.

cache chaining

Too many levels of chaining might slow down pulls, so you should try different configurations and benchmark them, to find out the right configuration.

In this example we'll show how to configure two caches. A dedicated cache for the Asia region that pulls images directly from DTR, and a cache for China, that pulls images from the Asia cache.

Cache for the Asia region

This cache has TLS, and pulls images directly from DTR:

version: 0.1
storage:
  delete:
    enabled: true
  filesystem:
    rootdirectory: /var/lib/registry
http:
  addr: :5000
  tls:
    certificate: /certs/asia-ca.pem
    key: /certs/asia-key.pem
middleware:
  registry:
      - name: downstream
        options:
          blobttl: 24h
          upstreams:
            - originhost: https://<dtr-url>
          cas:
            - /certs/dtr-ca.pem

Cache for the China region

This cache has TLS, and pulls images from the Asia cache:

version: 0.1
storage:
  delete:
    enabled: true
  filesystem:
    rootdirectory: /var/lib/registry
http:
  addr: :5000
  tls:
    certificate: /certs/china-ca.pem
    key: /certs/china-key.pem
middleware:
  registry:
      - name: downstream
        options:
          blobttl: 24h
          upstreams:
            - originhost: https://<dtr-url>
              upstreamhosts:
                - https://<asia-cache-url>
          cas:
            - /certs/asia-cache-ca.pem
            - /certs/dtr-ca.pem

Both CAs are needed for the downstream cache.

Similarly, the China cache needs to be registered with DTR. See deploy a simple cache for how to use the API. Ultimately the downstream cache needs to be configured for the user in question.