[openjpa] 01/02: add documentation about how to run with Podman

[st...@apache.org]

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

struberg pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/openjpa.git

commit 745795b1d9b8481088c656128ce50f3967495493
Author: Mark Struberg <st...@apache.org>
AuthorDate: Wed Jun 16 15:26:47 2021 +0200

    add documentation about how to run with Podman
    
    This is an important information for people who use Podman instead of
    Docker.
---
 README.adoc | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.adoc b/README.adoc
index 10613f4..384c071 100644
--- a/README.adoc
+++ b/README.adoc
@@ -36,6 +36,18 @@ We assume that Docker is installed to be used by your current user.
 The respective database image has to be started manually before starting the build.
 The reason for not starting it as part of the build itself is to be able to look at the database content after the build did run.
 
+[TIP]
+====
+*Hint for running with Podman*
+
+Some distributions switched from native Docker to Podman.
+If you get an error like `missing DOCKER_HOST` then you might try running the following command:
+
+  export DOCKER_HOST="unix:/run/user/$(id -u)/podman/podman.sock"
+  podman system service -t 3600 &
+  mvn ...
+====
+
 To start e.g. a PostgreSQL Docker image you can simply invoke the following command.
 Note the -N Maven option which stands for 'non-recursive'.
 This is used because the docker container is configured only at the root project but not at his children.