molecule/README.md

# molecule

Molecule - Automated Ansible roles testing

[![Build Status](https://img.shields.io/drone/build/docker/molecule?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/docker/molecule)
[![Docker Hub](https://img.shields.io/badge/dockerhub-latest-blue.svg?logo=docker&logoColor=white)](https://hub.docker.com/r/xoxys/molecule)
[![Quay.io](https://img.shields.io/badge/quay-latest-blue.svg?logo=docker&logoColor=white)](https://quay.io/repository/thegeeklab/molecule)
[![Source: Gitea](https://img.shields.io/badge/source-gitea-blue.svg?logo=gitea&logoColor=white)](https://gitea.rknet.org/docker/molecule)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitea.rknet.org/docker/molecule/src/branch/master/LICENSE)

Docker image to automate Ansible deployment tests with Molecule. The image was build to use with any docker based CI system.

## Environment variables

```Shell
# Target directory to clone custom modules
MOLECULE_LIBRARY_DIR=$(pwd)/library

# If you use custom modules you can specify a git repo containing these files.
# The repo will be cloned so ansible can use it.
MOLECULE_CUSTOM_MODULES_REPO=

# Target base directory to clone plugins
MOLECULE_PLUGINS_DIR=$(pwd)/plugins

# If you have custom filters you can specify a git repo containing these files.
# Will be cloned to $MOLECULE_PLUGINS_DIR/filter
MOLECULE_CUSTOM_FILTERS_REPO=
```

## License

This project is licensed under the MIT License - see the [LICENSE](https://gitea.rknet.org/docker/molecule/src/branch/master/LICENSE) file for details.

## Maintainers and Contributors

[Robert Kaussow](https://gitea.rknet.org/xoxys)
publish to quay and dockerhub 2020-09-02 22:17:22 +02:00			`# molecule`

			`Molecule - Automated Ansible roles testing`
Initial commit 2019-02-28 10:08:43 +01:00
refactoring 2020-02-20 17:24:52 +01:00			`[![Build Status](https://img.shields.io/drone/build/docker/molecule?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/docker/molecule)`
fix wording in badges 2020-09-05 17:22:29 +02:00			`[![Docker Hub](https://img.shields.io/badge/dockerhub-latest-blue.svg?logo=docker&logoColor=white)](https://hub.docker.com/r/xoxys/molecule)`
publish to quay and dockerhub 2020-09-02 22:17:22 +02:00			`[![Quay.io](https://img.shields.io/badge/quay-latest-blue.svg?logo=docker&logoColor=white)](https://quay.io/repository/thegeeklab/molecule)`
			`[![Source: Gitea](https://img.shields.io/badge/source-gitea-blue.svg?logo=gitea&logoColor=white)](https://gitea.rknet.org/docker/molecule)`
update readme and license 2020-02-22 18:08:14 +01:00			`[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitea.rknet.org/docker/molecule/src/branch/master/LICENSE)`
refactoring 2019-03-18 14:45:18 +01:00
refactoring and drop driverbased molecule builds 2019-11-22 21:52:56 +01:00			`Docker image to automate Ansible deployment tests with Molecule. The image was build to use with any docker based CI system.`
refactoring 2019-03-18 14:45:18 +01:00
			`## Environment variables`

refactoring 2020-02-20 17:24:52 +01:00			```Shell
update readme 2020-02-21 01:33:18 +01:00			`# Target directory to clone custom modules`
rework molecule wrapper 2020-02-20 23:24:46 +01:00			`MOLECULE_LIBRARY_DIR=$(pwd)/library`

refactoring 2020-02-20 17:24:52 +01:00			`# If you use custom modules you can specify a git repo containing these files.`
			`# The repo will be cloned so ansible can use it.`
			`MOLECULE_CUSTOM_MODULES_REPO=`
refactoring and drop driverbased molecule builds 2019-11-22 21:52:56 +01:00
update readme 2020-02-21 01:33:18 +01:00			`# Target base directory to clone plugins`
rework molecule wrapper 2020-02-20 23:24:46 +01:00			`MOLECULE_PLUGINS_DIR=$(pwd)/plugins`

refactoring 2020-02-20 17:24:52 +01:00			`# If you have custom filters you can specify a git repo containing these files.`
update readme 2020-02-21 01:33:18 +01:00			`# Will be cloned to $MOLECULE_PLUGINS_DIR/filter`
refactoring 2020-02-20 17:24:52 +01:00			`MOLECULE_CUSTOM_FILTERS_REPO=`
			```

update readme and license 2020-02-22 18:08:14 +01:00			`## License`
refactoring 2020-02-20 17:24:52 +01:00
update readme and license 2020-02-22 18:08:14 +01:00			`This project is licensed under the MIT License - see the [LICENSE](https://gitea.rknet.org/docker/molecule/src/branch/master/LICENSE) file for details.`
refactoring 2020-02-20 17:24:52 +01:00
update readme and license 2020-02-22 18:08:14 +01:00			`## Maintainers and Contributors`
refactoring 2020-02-20 17:24:52 +01:00
			`[Robert Kaussow](https://gitea.rknet.org/xoxys)`