Skip to content
This repository was archived by the owner on Jun 30, 2026. It is now read-only.

docs: add development troubleshooting guide for Yarn/Corepack CI/CD issues - #264

Closed
Romuald Lemesle (RomuDeuxfois) wants to merge 2 commits into
mainfrom
docs/ci-cd-yarn-corepack-troubleshooting
Closed

Romuald Lemesle (RomuDeuxfois) wants to merge 2 commits into
mainfrom
docs/ci-cd-yarn-corepack-troubleshooting

Conversation

@RomuDeuxfois

Copy link
Copy Markdown
Member

Summary

Adds a new Development Troubleshooting page to the documentation covering common build and CI/CD issues, specifically:

Yarn / Corepack Issues

  • HTTP 500 from repo.yarnpkg.com: Transient upstream failures when Corepack tries to download the Yarn binary. Documented 4 workarounds:
    1. Retry the build (transient issue)
    2. Pin and cache the Yarn binary via Corepack (corepack prepare)
    3. Use COREPACK_NPM_REGISTRY as a fallback registry
    4. Install Yarn without Corepack (last resort)
  • Corepack not found: Node.js version requirements and enabling Corepack

Network / Proxy Issues

  • Proxy configuration for Yarn and Node.js
  • SSL certificate errors and NODE_EXTRA_CA_CERTS

Changes

  • docs/development/troubleshooting.md — New troubleshooting page
  • mkdocs.yml — Added page to the Development section navigation

Context

Triggered by a report from Angélique Jard in the Engineering/⚙️ CI-CD Teams channel about 2 builds failing (CircleCI + Drone) with HTTP 500 errors from repo.yarnpkg.com. No existing documentation covered this scenario.

Closes #261


🤖 [AI-generated] — This PR was created by the Doc Agent based on a Teams channel trigger.

…ssues

Adds a new troubleshooting page under the Development section covering:
- Yarn/Corepack HTTP 500 errors from repo.yarnpkg.com
- CI/CD build failure workarounds (CircleCI, Drone, GitHub Actions)
- Corepack environment variables and fallback strategies
- Network and proxy-related build issues

Closes #261
@xfournet
Xavier Fournet (xfournet) deleted the docs/ci-cd-yarn-corepack-troubleshooting branch June 30, 2026 14:35
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add troubleshooting guide for Yarn/Corepack HTTP 500 errors

1 participant