dotfiles/dev/README.md

# dev

This directory contains some useful dockerfiles/makefiles that can be used
to test the deployment ansible playbooks.

```bash
make arch # this builds a docker image based on archlinux and runs it
make debian # this builds a docker image based on debian and runs it
```

## Workflow

Start a builder in one shell:

```bash
while true; do make _run; done
```

Check for the docker IP of the started container:

```bash
docker inspect dotfiles-dev --format '{{.NetworkSettings.IPAddress}}'
```

Make sure that this matches the IP in [ansible-hosts](/dev/ansible-hosts)

Test the playbook:

```bash
ansible-playbook -v -i ansible-hosts ../playbook.yml
```

## Docker images

- Build: `make build-arch` or `make build-debian` to build the image.
- Run: `make run` to run the docker container. This bind-mounts `../` to
  `/root/.dotfiles`, making it possible to test the repo in the container.

## Docker + Ansible

Run `dotfiles-dev` image using `make run`. This starts the container with
the local repository bind-mounted on `/root/.dotfiles`. To use a custom volume:

```bash
docker run -v <volume>:/root/dofiles`
```

Ansible can now be used to test the installation.

```bash
make ansible
```

## Releasing

Use `make release` to build an image from scratch, run it, install dotfiles
in the container using ansible, then commit the resulting container.