Skip to content

Commit 2aa186b

Browse files
authored
Update docker-layer-caching.md
1 parent 6d3f5ba commit 2aa186b

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

jekyll/_cci2/docker-layer-caching.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,13 @@ Docker Layer Caching can be used with both the [`machine` executor]({{ site.base
2424
### Limitations
2525
{:.no_toc}
2626

27+
Please note that high usage of [parallelism]({{site.baseurl}}/2.0/configuration-reference/#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. For example:
28+
29+
- 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.
30+
- any job with `parallelism` beyond 30 will experience cache misses regardless of number of workflows runing.
31+
32+
If you are experiencing issues with cache-misses or need high-parallelism, consider trying the experimental [docker-registry-image-cache](https://circleci.com/orbs/registry/orb/cci-x/docker-registry-image-cache) orb.
33+
2734
**Note:** DLC has **no** effect on Docker images used as build containers. That is, containers that are used to _run_ your jobs are specified with the `image` key when using the [`docker` executor]({{ site.baseurl }}/2.0/executor-types/#using-docker) and appear in the Spin up Environment step on your Jobs pages.
2835

2936
DLC 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.

0 commit comments

Comments
 (0)