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 <[email protected]>
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 <[email protected]>
Signed-off-by: Joris Van den Bossche <[email protected]>
---
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
~~~~~~~~~~~~~~~~~~~~
