diff options
Diffstat (limited to 'contrib/build-using-docker/README.md')
| -rw-r--r-- | contrib/build-using-docker/README.md | 69 |
1 files changed, 0 insertions, 69 deletions
diff --git a/contrib/build-using-docker/README.md b/contrib/build-using-docker/README.md deleted file mode 100644 index ec571e0..0000000 --- a/contrib/build-using-docker/README.md +++ /dev/null @@ -1,69 +0,0 @@ - -Showcase how to build and install -================================= - -Sometimes happy developers (like me) have no choice but using horribly -restricted systems where setting up tools to run even something as simple as -configure/make/install becomes a nightmare. I found it to be easier to have a -Dockerfile to build on a totally unrelated machine (but where I have the needed -privileges) and then just copy-paste the built result over to where I need it. - -WARN: Default configuration uses an alpine base image that means build will - dynamically link to musl libc and so won't run on most other systems. - This is because for a quick-n-dirty walktrough about what this tool does - this is ways enough. Consult "Other targets" further down and configure a - base image that fits your needs. - - -## Setup basic stuff to reduce annoyance - -```sh -mkdir /tmp/some-empty-dir -cd /tmp/some-empty-dir -IMG=bulk-ln-showcase:latest -``` - -## Make and install dockerimage - -```sh -curl -sSL http://git.hiddenalpha.ch/bulk-ln.git/plain/contrib/build-using-docker/Dockerfile | sudo docker build . -f - -t "${IMG:?}" -``` - -## Grab distribution archive - -Most probably we wanna get the distribution archive. We can copy it out the -dockerimage into our working dir on the host using: - -```sh -sudo docker run --rm -i "${IMG:?}" sh -c 'true && cd dist && tar c *' | tar x -``` - - -## Play around - -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:?}" sh -``` - - -## Other targets - -The dockerfile is parameterized and should work for other systems too. For -example to compile for debian we could use example command as below. - -To build for other systems it should be enough to adjust below command. - -```sh -curl -sSL http://git.hiddenalpha.ch/bulk-ln.git/plain/contrib/build-using-docker/Dockerfile | sudo docker build . -f - -t "${IMG:?}" \ - --build-arg PARENT_IMAGE=debian:9-slim \ - --build-arg PKGS_TO_ADD="curl gcc git make libc-dev ca-certificates tar" \ - --build-arg PKGS_TO_DEL="curl gcc git make libc-dev" \ - --build-arg PKGINIT="apt-get update" \ - --build-arg PKGADD="apt-get install -y --no-install-recommends" \ - --build-arg PKGDEL="apt-get purge -y" \ - --build-arg PKGCLEAN="apt-get clean" -``` - |