https://github.com/samdoran/container-alpine-ansible

Container for testing Ansible roles
https://github.com/samdoran/container-alpine-ansible

Last synced: 3 days ago
JSON representation

Container for testing Ansible roles

• Host: GitHub
• URL: https://github.com/samdoran/container-alpine-ansible
• Owner: samdoran
• Created: 2020-07-01T15:43:28.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-06-04T19:22:49.000Z (over 3 years ago)
• Last Synced: 2024-11-01T09:14:34.509Z (about 2 months ago)
• Size: 1.95 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Alpine Ansible Test Image #

[![Container Repository on Quay](https://quay.io/repository/samdoran/alpine-ansible/status "Container Repository on Quay")](https://quay.io/repository/samdoran/alpine-ansible)

This is a container for testing Ansible roles with [Molecule](https://molecule.readthedocs.io/en/latest/). It includes the latest version of Ansible available on this platform and is rebuilt regularly. It can also be used if you need to run Ansible on a specific operating system.

Note that Molecule does not use the Ansible version installed in the container when running tests.

## Build ##

To build your own version of this container, run:

    podman build -t alpine-ansible -f Containerfile .

## Testing a role using Molecule ##

If you don't already have a role repository, you can initialize one using this [cookiecutter template](https://github.com/samdoran/cookiecutter-ansible-role).

`molecule init template --url https://github.com/samdoran/cookiecutter-ansible-role`

Then run `molecule test` to run the full test suite against the role.

Run `molecule converge` to run the role against the test container but leave it running. This allows you to connect to the container using `molecule login` or just test running your role multiple times against an existing container.

If you already have a role being testing using Molecule, add this to the `platforms` section of your `molecule.yml` to use this image:

```yaml

platforms:

  - name: role-test

    image: "samdoran/${MOLECULE_DISTRIBUTION:-alpine}-ansible:latest"

    command: ${MOLECULE_COMMAND:-""}

    volumes:

      - /sys/fs/cgroup:/sys/fs/cgroup:ro

    privileged: yes

    pre_build_image: yes

```

The important parts are `pre_build_image: yes` and the `image` name. Molecule allows you to use environment variables in the configuration file, which is very handy. This allows you to easily change the container that molecule uses for tests (among other things) simply by changing the enivorment variable.

```

env MOLECULE_DISTRIBUTION=debian10 molecule test

```