molecule/README.md

# molecule

Custom image for Ansible Molecule test automation

<!-- spellchecker-disable -->

[![Build Status](https://ci.rknet.org/api/badges/container/molecule/status.svg)](https://ci.rknet.org/repos/container/molecule)
[![Docker Hub](https://img.shields.io/badge/dockerhub-latest-blue.svg?logo=docker&logoColor=white)](https://hub.docker.com/r/thegeeklab/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/container/molecule)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitea.rknet.org/container/molecule/src/branch/main/LICENSE)

<!-- spellchecker-enable -->

Custom container image to automate Ansible deployment tests with [Molecule](https://ansible.readthedocs.io/projects/molecule/).

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

# If the variable is set, the value is written to `ANSIBLE_VAULT_PASSWORD_FILE=/root/.vaultpasswd
and automatically passed to molecule.
MOLECULE_ANSIBLE_VAULT_PASSWORD=my_secret
```

## License

This project is licensed under the MIT License - see the [LICENSE](https://gitea.rknet.org/container/molecule/src/branch/main/LICENSE) file for details.
publish to quay and dockerhub 2020-09-02 20:17:22 +00:00			`# molecule`

refactor: migrate to woodpecker ci (#335) Reviewed-on: https://gitea.rknet.org/container/molecule/pulls/335 Co-authored-by: Robert Kaussow <mail@thegeeklab.de> Co-committed-by: Robert Kaussow <mail@thegeeklab.de> 2023-11-08 08:03:37 +00:00			`Custom image for Ansible Molecule test automation`
Initial commit 2019-02-28 09:08:43 +00:00
refactor: migrate to woodpecker ci (#335) Reviewed-on: https://gitea.rknet.org/container/molecule/pulls/335 Co-authored-by: Robert Kaussow <mail@thegeeklab.de> Co-committed-by: Robert Kaussow <mail@thegeeklab.de> 2023-11-08 08:03:37 +00:00			`<!-- spellchecker-disable -->`

			`[![Build Status](https://ci.rknet.org/api/badges/container/molecule/status.svg)](https://ci.rknet.org/repos/container/molecule)`
migrate to thegeeklab namespace 2020-09-21 20:11:00 +00:00			`[![Docker Hub](https://img.shields.io/badge/dockerhub-latest-blue.svg?logo=docker&logoColor=white)](https://hub.docker.com/r/thegeeklab/molecule)`
publish to quay and dockerhub 2020-09-02 20:17:22 +00:00			`[![Quay.io](https://img.shields.io/badge/quay-latest-blue.svg?logo=docker&logoColor=white)](https://quay.io/repository/thegeeklab/molecule)`
refactor: migrate to woodpecker ci (#335) Reviewed-on: https://gitea.rknet.org/container/molecule/pulls/335 Co-authored-by: Robert Kaussow <mail@thegeeklab.de> Co-committed-by: Robert Kaussow <mail@thegeeklab.de> 2023-11-08 08:03:37 +00:00			`[![Source: Gitea](https://img.shields.io/badge/source-gitea-blue.svg?logo=gitea&logoColor=white)](https://gitea.rknet.org/container/molecule)`
			`[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitea.rknet.org/container/molecule/src/branch/main/LICENSE)`

			`<!-- spellchecker-enable -->`
refactoring 2019-03-18 13:45:18 +00:00
refactor: migrate to woodpecker ci (#335) Reviewed-on: https://gitea.rknet.org/container/molecule/pulls/335 Co-authored-by: Robert Kaussow <mail@thegeeklab.de> Co-committed-by: Robert Kaussow <mail@thegeeklab.de> 2023-11-08 08:03:37 +00:00			`Custom container image to automate Ansible deployment tests with [Molecule](https://ansible.readthedocs.io/projects/molecule/).`
refactoring 2019-03-18 13:45:18 +00:00
			`## Environment variables`

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

refactoring 2020-02-20 16:24:52 +00: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 20:52:56 +00:00
update readme 2020-02-21 00:33:18 +00:00			`# Target base directory to clone plugins`
rework molecule wrapper 2020-02-20 22:24:46 +00:00			`MOLECULE_PLUGINS_DIR=$(pwd)/plugins`

refactoring 2020-02-20 16:24:52 +00:00			`# If you have custom filters you can specify a git repo containing these files.`
update readme 2020-02-21 00:33:18 +00:00			`# Will be cloned to $MOLECULE_PLUGINS_DIR/filter`
refactoring 2020-02-20 16:24:52 +00:00			`MOLECULE_CUSTOM_FILTERS_REPO=`
add option to pass Ansible vault password 2020-10-08 09:13:26 +00:00
			# If the variable is set, the value is written to `ANSIBLE_VAULT_PASSWORD_FILE=/root/.vaultpasswd
			`and automatically passed to molecule.`
			`MOLECULE_ANSIBLE_VAULT_PASSWORD=my_secret`
refactoring 2020-02-20 16:24:52 +00:00			```

update readme and license 2020-02-22 17:08:14 +00:00			`## License`
refactoring 2020-02-20 16:24:52 +00:00
refactor: migrate to woodpecker ci (#335) Reviewed-on: https://gitea.rknet.org/container/molecule/pulls/335 Co-authored-by: Robert Kaussow <mail@thegeeklab.de> Co-committed-by: Robert Kaussow <mail@thegeeklab.de> 2023-11-08 08:03:37 +00:00			`This project is licensed under the MIT License - see the [LICENSE](https://gitea.rknet.org/container/molecule/src/branch/main/LICENSE) file for details.`