Skip to content

fix(docker): Resolve build failure and clarify documentation #1783

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

elyashium
Copy link

@elyashium elyashium commented Jul 29, 2025

What kind of change does this PR introduce?

A bugfix for the Docker build process and a documentation update.

Issue Number:

Screenshots/videos:

image

If relevant, did you update the documentation?

Yes, the INSTALLATION.md file has been updated to provide clearer and more accurate
instructions for running the project with Docker.

Summary

This pull request resolves a critical failure in the Docker build process. The build was
failing for two reasons:

  1. The Dockerfile did not enable corepack, leading to a Yarn version mismatch as specified
    in package.json.
  2. The Dockerfile did not copy the yarn.lock file, causing the yarn install --immutable
    command to fail as it requires the lockfile to be present.

This PR corrects the Dockerfile by adding the necessary corepack enable command and
including yarn.lock in the files copied to the image.

Additionally, the "Run locally using Docker" section of INSTALLATION.md has been
rewritten to be more explicit, removing the reliance on make and providing direct,
cross-platform docker commands to improve clarity and accessibility for all developers.

Does this PR introduce a breaking change?

No, this PR fixes a broken process and makes it work as intended.

Checklist

Please ensure the following tasks are completed before submitting this pull request.

…ck to use the correct Yarn version and copying the yarn.lock file to satisfy the --immutable install flag. Fixes json-schema-org#1782
…-org#1782

Revised the Docker section to provide clearer, step-by-step instructions for building and running the development environment using Docker. Added details about directory navigation, image naming, port mapping, and live code updates.
@elyashium elyashium requested a review from a team as a code owner July 29, 2025 19:07
@github-project-automation github-project-automation bot moved this to Ready to review in PR - Triage Group Jul 29, 2025

This comment was marked as outdated.

Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Welcome to the JSON Schema Community. Thanks a lot for creating your first pull request!! 🎉🎉 We are so excited you are here! We hope this is only the first of many! For more details check out README.md file.

This comment was marked as outdated.

Copy link

github-actions bot commented Jul 29, 2025

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
website ✅ Ready (View Log) Visit Preview d62841d

Copy link

codecov bot commented Jul 29, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (a061202) to head (d62841d).

Additional details and impacted files
@@            Coverage Diff            @@
##              main     #1783   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           31        31           
  Lines          636       636           
  Branches       196       196           
=========================================
  Hits           636       636           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

This comment was marked as outdated.

3 similar comments
Copy link

Hi @elyashium! Thanks a lot for your contribution!

I noticed that the following required information is missing or incomplete: kind of change description

Please update the PR description to include this information. You can find placeholders in the PR template for these items.

Thanks a lot!

Copy link

Hi @elyashium! Thanks a lot for your contribution!

I noticed that the following required information is missing or incomplete: kind of change description

Please update the PR description to include this information. You can find placeholders in the PR template for these items.

Thanks a lot!

Copy link

Hi @elyashium! Thanks a lot for your contribution!

I noticed that the following required information is missing or incomplete: kind of change description

Please update the PR description to include this information. You can find placeholders in the PR template for these items.

Thanks a lot!

This comment was marked as outdated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Ready to review
Development

Successfully merging this pull request may close these issues.

Build Error : Dockerfile build fails due to Yarn version mismatch and missing corepack instructions in INSTALLATION.md
1 participant