Skip to content

Commit

Permalink
Add Installation Guide with Ansible
Browse files Browse the repository at this point in the history
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]>
  • Loading branch information
hswong3i committed May 29, 2020
1 parent 249a143 commit 46399ac
Showing 1 changed file with 37 additions and 0 deletions.
37 changes: 37 additions & 0 deletions getting-started/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -545,6 +545,43 @@ Note that Podman does not officially support device-mapper. Thus, the `exclude_g

This project is using [go modules](https://github.com/golang/go/wiki/Modules) for dependency management. If the CI is complaining about a pull request leaving behind an unclean state, it is very likely right about it. After changing dependencies, make sure to run `make vendor` to synchronize the code with the go module and repopulate the `./vendor` directory.

### 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
```

## Configuration files

### registries.conf
Expand Down

0 comments on commit 46399ac

Please sign in to comment.