From ad1b52246784a812a389b7c67aaa4849732be420 Mon Sep 17 00:00:00 2001 From: Joris Van den Bossche Date: Wed, 4 Sep 2024 11:56:50 +0200 Subject: [PATCH] GH-43669: [Docs][Dev] Document archery --debug flag in section about docker (#43935) ### Rationale for this change This feature was added in https://github.com/apache/arrow/pull/40129, but adding it to the docker page in the developer docs for better visibility. * GitHub Issue: #43669 Authored-by: Joris Van den Bossche Signed-off-by: Joris Van den Bossche --- .../developers/continuous_integration/docker.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/source/developers/continuous_integration/docker.rst b/docs/source/developers/continuous_integration/docker.rst index 68f3c7d709791..129b5d0bcf135 100644 --- a/docs/source/developers/continuous_integration/docker.rst +++ b/docs/source/developers/continuous_integration/docker.rst @@ -156,6 +156,18 @@ The following example starts an interactive ``bash`` session in the container archery docker run ubuntu-cpp bash +**Build the image with increased debugging output:** + +To enable additional logging output for debugging, pass the ``--debug`` flag +to ``archery``. + +.. code:: bash + + archery --debug docker run ubuntu-cpp + +In addition to enabling ``DEBUG``-level logging, this also translates to +passing ``--progress=plain`` to docker(-compose) build command. + Docker Volume Caches ~~~~~~~~~~~~~~~~~~~~