(arrow) branch main updated: GH-43669: [Docs][Dev] Document archery --debug flag in section about docker (#43935)

[jo...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

jorisvandenbossche pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/arrow.git


The following commit(s) were added to refs/heads/main by this push:
     new 9abad7a21d GH-43669: [Docs][Dev] Document archery --debug flag in section about docker (#43935)
9abad7a21d is described below

commit 9abad7a21d33ea20ce66ebbe3a2be26515eee279
Author: Joris Van den Bossche <jo...@gmail.com>
AuthorDate: Wed Sep 4 11:56:50 2024 +0200

    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 <jo...@gmail.com>
    Signed-off-by: Joris Van den Bossche <jo...@gmail.com>
---
 docs/source/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 68f3c7d709..129b5d0bcf 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
 ~~~~~~~~~~~~~~~~~~~~