cookiecutter-ansible-role/{{cookiecutter.app_name}}_role
2021-02-19 04:51:23 -08:00
..
.github #30 New way of templates. 2020-11-25 16:28:31 +01:00
defaults [#46] Static tests instead of parameters 2020-12-29 11:41:27 +01:00
files
handlers
meta #16 Remove debian jessie support 2020-10-06 09:19:05 +02:00
molecule/default typo 2020-12-30 11:14:13 +01:00
tasks Add newline at EOF in service.yml 2021-01-20 09:07:06 +01:00
templates
.ansible-lint follow excluding convention 2021-02-17 18:24:53 +01:00
.yamllint #55 exclude non-role files from linting 2021-02-17 18:22:37 +01:00
{% raw %}.gitattributes{% endraw %} #57 gitattributes for yaml detection 2021-02-18 12:39:38 +01:00
{% raw %}.gitignore{% endraw %}
{% raw %}.travis.yml{% endraw %} Update {% raw %}.travis.yml{% endraw %} 2020-12-03 09:52:35 +01:00
CHANGELOG.md Fix typo 2020-10-05 13:29:45 +02:00
LICENSE
logo.gif
README.md [#46] Static tests instead of parameters 2020-12-29 11:41:27 +01:00
test-requirements.txt

{{ cookiecutter.app_name | replace('_',' ') | title }} Ansible role

Logo

[![Build Status](https://travis-ci.com/idealista/{{ cookiecutter.app_name }}_role.png)](https://travis-ci.com/idealista/{{ cookiecutter.app_name }}_role) [![Ansible Galaxy](https://img.shields.io/badge/galaxy-idealista.{{ cookiecutter.app_name }}_role-B62682.svg)](https://galaxy.ansible.com/idealista/{{ cookiecutter.app_name }}_role)

This ansible role installs {% if cookiecutter.documentation_URL != "" %}[{% endif %}{{ cookiecutter.app_name | replace('_',' ') | title }}{% if cookiecutter.documentation_URL != "" %}]({{ cookiecutter.documentation_URL }}){% endif %} in a Debian environment. It has been tested for the following Debian versions: {% if cookiecutter.debian_stretch_support == 'True' %}* Stretch{% endif %} {% if cookiecutter.debian_buster_support == 'True' %}* Buster{% endif %}

This role has been generated using the cookiecutter tool, you can generate a similar role that fits your needs using the this cookiecutter template.

Getting Started

These instructions will get you a copy of the role for your Ansible playbook. Once launched, it will install {{ cookiecutter.app_name | replace('_',' ') | title }} in a Debian system.

Prerequisities

Ansible {{ cookiecutter.ansible_version }} version installed.

Molecule 3.x.x version installed.

For testing purposes, Molecule with Docker as driver and Goss as verifier.

Installing

Create or add to your roles dependency file (e.g requirements.yml):

- src: idealista.{{ cookiecutter.app_name }}_role
  version: 1.0.0
  name: {{ cookiecutter.app_name }}_role

Install the role with ansible-galaxy command:

ansible-galaxy install -p roles -r requirements.yml -f

Use in a playbook:

---
- hosts: someserver
  roles:
    - role: {{ cookiecutter.app_name }}_role

Usage

Look to the defaults properties file to see the possible configuration properties, it is very likely that you will not need to override any variables.

Testing

Install dependencies

$ pipenv sync

For more information read the pipenv docs.

Testing

$ pipenv run molecule test 

Built With

![Ansible](https://img.shields.io/badge/ansible-{{ cookiecutter.ansible_version }}-green.svg) ![Molecule](https://img.shields.io/badge/molecule-{{ cookiecutter.molecule_version }}-green.svg) Goss

Versioning

For the versions available, see the [tags on this repository](https://github.com/{{ cookiecutter.github_user }}/{{ cookiecutter.app_name }}_role/tags).

Additionaly you can see what change in each version in the CHANGELOG.md file.

Authors

See also the list of [contributors](https://github.com/{{ cookiecutter.github_user }}/{{ cookiecutter.app_name }}_role/contributors) who participated in this project.

License

Apache 2.0 License

This project is licensed under the Apache 2.0 license - see the LICENSE file for details.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.