Most CircleCI pain is self-inflicted and predictable. Here are the mistakes we see most, and the fix for each.
Mistake 1: No caching, so dependencies download every build
Fix: Cache dependencies and use orbs for common steps. Make it the default in your templates and enforce it in review or CI so the mistake cannot come back.
Mistake 2: Secrets in config instead of project/context env vars
Fix: Store secrets in contexts with restricted access. Make it the default in your templates and enforce it in review or CI so the mistake cannot come back.
Mistake 3: One giant job instead of parallel workflows
Fix: Split tests with parallelism for speed. Make it the default in your templates and enforce it in review or CI so the mistake cannot come back.
A safer baseline
Workflow with caching and an orb.
version: 2.1
orbs: { node: circleci/node@5 }
jobs:
test:
docker: [{ image: cimg/node:20.11 }]
steps:
- checkout
- node/install-packages
- run: npm test
workflows:
build: { jobs: [test] }Want senior help putting CircleCI to work - or a team bootcamp on it? CodeWizard runs Israel's largest DevOps community and embeds named senior engineers with a transparent hours log. Book a free consult or explore the Academy.