Skip to content

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

Closed
RomuDeuxfois wants to merge 2 commits intomainfrom
docs/ci-cd-yarn-corepack-troubleshooting
Closed

docs: add development troubleshooting guide for Yarn/Corepack CI/CD issues#264
RomuDeuxfois wants to merge 2 commits intomainfrom
docs/ci-cd-yarn-corepack-troubleshooting

Conversation

@RomuDeuxfois
Copy link
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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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