Skip to content

Commit

Permalink
docs: add git clone eof error troubleshooting (#1009)
Browse files Browse the repository at this point in the history
  • Loading branch information
Danyal-Faheem committed Apr 16, 2024
1 parent d8993f6 commit 675719e
Showing 1 changed file with 14 additions and 0 deletions.
14 changes: 14 additions & 0 deletions docs/troubleshooting.rst
Original file line number Diff line number Diff line change
Expand Up @@ -169,6 +169,8 @@ This issue should only happen in development mode. Long story short, it can be s

If you'd like to learn more, please take a look at `this Github issue <https://github.com/overhangio/tutor/issues/302>`__.

.. _high_resource_consumption:

High resource consumption on ``tutor images build`` by docker
-------------------------------------------------------------

Expand All @@ -193,3 +195,15 @@ Now build again::
tutor images build

All build commands should now make use of the newly configured builder. To later revert to the default builder, run ``docker buildx use default``.

.. note::
Setting a too low value for maximum parallelism will result in longer build times.

fatal: the remote end hung up unexpectedly / fatal: early EOF / fatal: index-pack failed when running ``tutor images build ...``
--------------------------------------------------------------------------------------------------------------------------------

This issue can occur due to problems with the network connection while cloning edx-platform which is a fairly large repository.

First, try to run the same command once again to see if it works as the network connection can sometimes drop during the build process.

If that does not work, follow the tutorial above for :ref:`High resource consumption <high_resource_consumption>` to limit the number of concurrent build steps so that the network connection is not being shared between multiple layers at once.

0 comments on commit 675719e

Please sign in to comment.