Add Installation Guide with Ansible

Provide additional installation options by using Ansible with https://github.com/alvistack/ansible-role-podman from source code. Fixes containers/podman#5773 Signed-off-by: Wong Hoi Sing Edison <[email protected]>
alvistack · May 29, 2020 · 3be6432 · 3be6432
1 parent 249a143
commit 3be6432
Showing 1 changed file with 37 additions and 0 deletions.
diff --git a/getting-started/installation.md b/getting-started/installation.md
@@ -412,6 +412,43 @@ To enable the user namespaces permanently:
 echo 'kernel.unprivileged_userns_clone=1' > /etc/sysctl.d/userns.conf
 ```
 
+### Static build
+
+It is possible to build a statically linked binary of podman by using the
+officially provided
+[nix](https://nixos.org/nixos/packages.html?attr=podman-unwrapped&channel=nixpkgs-unstable&query=podman)
+package and the derivation of it [within this repository](nix/). The
+builds are completely reproducible and will create a x86\_64/amd64
+stripped ELF binary for [glibc](https://www.gnu.org/software/libc).
+
+#### Nix
+
+To build the binaries by locally install the nix package manager:
+
+``` shell
+curl -L https://nixos.org/nix/install | sh
+git clone https://github.com/containers/libpod.git && cd libpod
+nix build -f nix/
+./result/bin/podman --version
+```
+
+#### Ansible
+
+An [Ansible Role](https://github.com/alvistack/ansible-role-podman) is
+also available to automate the installation of above statically linked
+binary on its supported OS:
+
+``` bash
+sudo su -
+mkdir -p ~/.ansible/roles
+cd ~/.ansible/roles
+git clone https://github.com/alvistack/ansible-role-podman.git podman
+cd ~/.ansible/roles/podman
+pip3 install --upgrade --ignore-installed --requirement requirements.txt
+molecule converge
+molecule verify
+```
+
 ### Building missing dependencies
 
 If any dependencies cannot be installed or are not sufficiently current, they have to be built from source.