CircleCI Field Guide
GitHub Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage
Edit page

Network and Storage Defaults

Most users can change their Network & Storage defaults to reduce unnecessary credit burn with minimal material impact to their pipelines.

Here’s our recommended defaults for most users:

Setting CircleCI Default Our Recommendation
Artifacts 30 days 7 days
Workspaces 15 days 1 day*
Caches 15 days 7 days

*Workspaces may need to be increased due to some nuanced but nonetheless significant considerations. See below!

Impact and Rationale

Artifacts

The impact of reducing Artifacts from 30 days to 7 days, simply means that artifacts will only be available 7 days from creation instead of 30.

Common use cases for artifacts are additional debug logs, test reports, or generated assets tend to have a limited shelf-life of usefulness. Clearly, if folks need to access such artifacts beyond 7 days from creation, they’ll need to increase this.

Workspaces

This is the most nuanced configuration option. The only times workspaces are re-used, is when either of the 2 conditions occur:

  • A workflow is “on hold” for longer than the workspace retention period. Downstream jobs may then fail because the workspace no longer exists

We should explicitly check whether this is a use-case of the customer before recommending a 1-day retention period.

  • A user retries a workflow “from failed” beyond the workspace retention period. This workflow may then fail, as the workspace no longer exists

Caches

The main impact of reducing cache retention from 15 days to 7 days, is that the customer may see slower builds more frequently as a result of hitting a cold cache.

We think that most folks consider a weekly cold cache as being acceptable. However given the cadence of builds through a typical project pipeline, many teams end up creating new cache entries more than once per week (e.g updating dependencies), and they are unlikely to see any material impact here at all.