From 675719e48e4bcf6c7f61b165a51506387efef6d2 Mon Sep 17 00:00:00 2001 From: Danyal Faheem <138459282+Danyal-Faheem@users.noreply.github.com> Date: Tue, 16 Apr 2024 12:07:09 +0500 Subject: [PATCH] docs: add git clone eof error troubleshooting (#1009) --- docs/troubleshooting.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst index 8c2bc8a..a6594a3 100644 --- a/docs/troubleshooting.rst +++ b/docs/troubleshooting.rst @@ -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 `__. +.. _high_resource_consumption: + High resource consumption on ``tutor images build`` by docker ------------------------------------------------------------- @@ -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 ` to limit the number of concurrent build steps so that the network connection is not being shared between multiple layers at once.