Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/naftulikay/ansible-role-vagrant-docker

An Ansible role for installing Docker in a Vagrant machine.
https://github.com/naftulikay/ansible-role-vagrant-docker

ansible docker vagrant

Last synced: 9 days ago
JSON representation

An Ansible role for installing Docker in a Vagrant machine.

Awesome Lists containing this project

README

        

# ansible-role-vagrant-docker [![Build Status][svg:travis]][travis]

An Ansible role for installing, configuring, and starting Docker within a Vagrant machine. Simply depends on the
upstream [`naftulikay.docker`][docker] and [`naftulikay.vagrant-base`][vagrant-base] roles and
specifies that `vagrant_user` should be added to the `docker` system group.

Available on Ansible Galaxy at [`naftulikay.vagrant-docker`][galaxy].

## Requirements

Officially tested operating systems are listed in the Galaxy manifest.

## Role Variables


vagrant_user

The user name of the Vagrant user, defaults to vagrant.

> Please see the upstream [`naftulikay.vagrant-base`][vagrant-base] and [`naftulikay.docker`][docker] roles for
additional supported variables.

## Dependencies

- [`naftulikay.docker`][docker]: Installs and configures Docker.
- [`naftulikay.vagrant-base`][vagrant-base]: Provides base Vagrant configuration.

## Example Playbook

Here are some example playbooks to get started with.

### Defaults

Simply get that Docker dockering in Vagrant:

```yaml
---
- name: install
hosts: all
become: true
roles: [vagrant-docker]
```

If your Vagrant box uses a non-`vagrant` name for the Vagrant user:

```yaml
---
- name: install
hosts: all
become: true
roles: [{ role: vagrant-docker, vagrant_user: notvagrant }]
```

## License

MIT

[svg:travis]: https://travis-ci.org/naftulikay/ansible-role-vagrant-docker.svg?branch=master
[travis]: https://travis-ci.org/naftulikay/ansible-role-vagrant-docker
[galaxy]: https://galaxy.ansible.com/naftulikay/vagrant-docker/
[vagrant-base]: https://galaxy.ansible.com/naftulikay/vagrant-base/
[docker]: https://galaxy.ansible.com/naftulikay/docker/