


image: circleci/node:14.17.3-buster-browsers # DLC does nothing here, its caching depends on commonality of the image layers. That is, containers that are used to run your jobs are specified with the image key when using the docker executor and appear in the Spin up Environment step on your Jobs pages.ĭLC is only useful when creating your own Docker image with docker build, docker compose, or similar docker commands, it does not decrease the wall clock time that all builds take to spin up the initial environment. Note: DLC has no effect on Docker images used as build containers. If you are experiencing issues with cache-misses or need high-parallelism, consider trying the experimental docker-registry-image-cache orb. any job with parallelism beyond 30 will experience cache misses regardless of number of workflows running.A single job with 30 parallelism will work if only a single workflow is running, however, having more than one workflow will result in cache misses.Please note that high usage of parallelism (that is, a parallelism of 30 or above) in your configuration may cause issues with DLC, notably pulling a stale cache or no cache. In short, the less your Dockerfiles change from commit to commit, the faster your image-building steps will run.ĭocker Layer Caching can be used with both the machine executor and the Remote Docker Environment ( setup_remote_docker). DLC will save image layers created within your jobs, rather than impact the actual container used to run your job.ĭLC caches the individual layers of any Docker images built during your CircleCI jobs, and then reuses unchanged image layers on subsequent CircleCI runs, rather than rebuilding the entire image every time. This document provides an overview of DLC in the following sections:ĭocker Layer Caching (DLC) is a great feature to use if building Docker images is a regular part of your CI/CD process. The Performance and Scale usage plans (credits are charged per run job) and on installations of CircleCI server. Docker Layer Caching (DLC) can reduce Docker image build times on CircleCI.
