Skip to content

darkwizard242/ansible-role-serverspec

Repository files navigation

build-test release Ansible Role Maintainability Rating Reliability Rating Security Rating GitHub tag (latest SemVer) GitHub repo size

Ansible Role: serverspec

Role to install serverspec on Debian/Ubuntu and EL systems. Serverspec is used for infrastructure testing.

Requirements

Serverspec is a gem and thus, it does require ruby installed. This role automatically installs ruby as well (if it's not already available).

Role Variables

Available variables are listed below (located in defaults/main.yml):

Variables list:

ruby_app_debian_package: ruby-full
ruby_app_el_package: ruby
ruby_desired_state: present
serverspec_app: serverspec
serverspec_desired_state: present
serverspec_user_install: no
serverspec_include_dependencies: yes

Variables table:

Variable Description
ruby_app_debian_package Defines the app to install on Debian based systems i.e. ruby-full
ruby_app_el_package Defines the app to install on Enterprise Linux (Redhat/CentOS) systems i.e. ruby
ruby_desired_state Defined to dynamically chose whether to install (i.e. either present or latest) or uninstall (i.e. absent) the package. Defaults to present.
serverspec_app Defines the app to install on Debian based systems i.e. serverspec
serverspec_desired_state Defined to dynamically chose whether to install (i.e. either present or latest) or uninstall (i.e. absent) the gem. Defaults to present.
serverspec_user_install Defined to dynamically set whether to install serverspec gem into a user's local gems.
serverspec_include_dependencies Defined to dynamically set whether to install relative dependencies of serverspec or not.

Dependencies

None

Example Playbook

For default behaviour of role (i.e. installation of serverspec gem) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.serverspec

For customizing behavior of role (i.e. removal of serverspec gem) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.serverspec
  vars:
    serverspec_desired_state: absent

For customizing behavior of role (i.e. installing serverspec without it's required dependencies) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.serverspec
  vars:
    serverspec_include_dependencies: no

License

MIT

Author Information

This role was created by Ali Muhammad, a DevOps/CloudOps Engineer who loves to learn and contribute to Open Source community.