From b627374773e3256fbd08fb204fcced3233b9c97e Mon Sep 17 00:00:00 2001
From: Andreas Fankhauser (@tux-six)
Date: Wed, 6 Jul 2022 22:23:22 +0200
Subject: Add contrib Dockerfile about how to build from tarball

- rename README.txt -> README.md
- Add contrib Dockerfile as sample how to build from tarball
- Fix bashism 'set -o posix'
---
 contrib/build-using-docker/README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 contrib/build-using-docker/README.md

(limited to 'contrib/build-using-docker/README.md')

diff --git a/contrib/build-using-docker/README.md b/contrib/build-using-docker/README.md
new file mode 100644
index 0000000..503136e
--- /dev/null
+++ b/contrib/build-using-docker/README.md
@@ -0,0 +1,29 @@
+
+Showcase how to build and install
+=================================
+
+Make and install inside a dockerimage.
+
+```sh
+    curl -sSL http://git.hiddenalpha.ch/bulk-ln.git/plain/contrib/build-using-docker/Dockerfile | sudo docker build . -f -
+```
+
+Afer that we can use the image hash printed in last line to refer to our built
+image (replace IMG_REF in commands below by that hash). Alternatively we could
+add [`--tag`](https://docs.docker.com/engine/reference/commandline/build/)
+option to our build command to give the resulting image a name.
+
+Most probably we wanna get the distribution archive. We can copy it out the
+dockerimage to our host using:
+
+```sh
+    sudo docker run --rm -i  IMG_REF  sh -c 'true && cd dist && tar c *' | tar x
+```
+
+Or if we wanna browse the image or play around with the built utility we could
+launch a shell. Once in the shell, try `bulk-ln --help`.
+
+```sh
+    sudo docker run --rm -ti  IMG_REF  sh
+```
+
-- 
cgit v1.3.1