diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst index 7e78608d57..f942eb7bb2 100644 --- a/docs/troubleshooting.rst +++ b/docs/troubleshooting.rst @@ -171,6 +171,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 ------------------------------------------------------------- @@ -195,3 +197,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.