Light

bertvv / ansible-role-skeleton Goto Github PK

View Code? Open in Web Editor NEW

13.0 3.0 14.0 38 KB

My scaffolding code for Ansible roles. Setting up manually is not recommended. A script to initialise a new role can be found here: https://github.com/bertvv/ansible-toolbox/

License: Other

Shell 100.00%

ansible-role-skeleton's Introduction

Ansible role `ROLENAME`

An Ansible role for PURPOSE. Specifically, the responsibilities of this role are to:

Requirements

No specific requirements

Role Variables

Variable	Default	Comments (type)
`role_var`	-	(scalar) PURPOSE

Dependencies

No dependencies.

Example Playbook

See the test playbooks in either the Vagrant or Docker test environment. See the section Testing for details.

Testing

This role can be tested using Ansible Molecule. Two test environments are provided: one powered by Docker (default), the other by Vagrant.

This Molecule configuration will:

Run Yamllint and Ansible Lint
Create a Docker container named db
Run a syntax check
Apply the role with a test playbook
Run black-box acceptance tests with BATS

# Start the container, apply the test playbook:
molecule converge
# Log in on the container
molecule login --host HOSTNAME
# Start the container (if necessary), run the tests and delete the container
molecule test

If you want to use the Vagrant test environment, always specify this on the command-line, e.g.

molecule test -s vagrant

Contributing

Issues, feature requests, ideas are appreciated and can be posted in the Issues section.

Pull requests are also very welcome. The best way to submit a PR is by first creating a fork of this Github project, then creating a topic branch for the suggested change and pushing that branch to your own fork. Github can then easily create a PR based on that branch. Don't forget to add your name to the contributor list below!

License

2-clause BSD license, see LICENSE.md

Contributors

Bert Van Vreckem (maintainer)

ansible-role-skeleton's People

Contributors

Stargazers

Watchers

Forkers

vonpupp jonasvermassen gitpocket universal-it-systems redbloodmage tkilias cdelgehier hubitor ziplex obih15 vpnj012k dustinliddick motoji

ansible-role-skeleton's Issues

Add guidelines for contributors

Review Contributions wiki page

Review current contents
Take some inspiration from John Arundel's contributor guidelines: https://github.com/bitfield/script/blob/master/CONTRIBUTING.md
Add link from all my Ansible roles on Github

Name include_vars task in main.yml:4

Fix run options for fixing SELinux issues inside guests

When the host system has SELinux enabled, mounted volumes inside the container may have permission problems.

See:

Ignore .ansible_cache

Add .ansible_cache/ to .gitignore

Update Vagrantfile

Define an environment where it's easy to support multiple platforms, e.g.:

require 'rbconfig'

ROLE_NAME = 'mariadb'
VAGRANTFILE_API_VERSION = '2'

distros = [
  { name: 'centos', ip: '10', box: 'bento/centos-7.6', python: 'python' },
  { name: 'fedora', ip: '11', box: 'bento/fedora-30' , python: 'python3'},
]

Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
  distros.each do |distro|
    srv_name = 'srv' + distro[:name]
    config.vm.define srv_name do |node|
      node.vm.hostname = srv_name
      node.vm.box = distro[:box]

      node.vm.network :private_network,
        ip: '192.168.56.' + distro[:ip]

      node.vm.provision 'ansible' do |ansible|
        ansible.host_vars = {
          srv_name => { "ansible_python_interpreter" => "/usr/bin/" + distro[:python] }
        }
        ansible.compatibility_mode = '2.0'
        ansible.playbook = 'test.yml'
      end
    end
  end
end

Have docker-tests.sh print out the version of Ansible

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.