Base Ansible Role

This Ansible role sets up a system for web development with simple configurations. Here’s what it does:

• Updates APT cache
• Installs Filesystem ACLs
• Installs Direnv
• Sets up the Bash profile with useful command shortcuts and settings
• Configures Vim
• Adjusts Sysctl settings
• Creates a web-admin group and adds it to the current user

Role Variables

• console_user — Use this to set up a new user's BASH profile on the server. Default is ansible_user.
• shmmax_percent — How much memory to allocate for kernel.shmmax, default is 50%.
• shmall_percent — How much memory to allocate for kernel.shmall, default is 50%.
• default_groups — Groups to add the Ansible user or console_user to. Possible values are "web-admin", "www-data", and "adm".

Example Playbook

- hosts: servers
  roles:
     - { role: bbatsche.Base }

License

MIT

Testing

This role includes tests for verifying each task. To run these tests, make sure you have Vagrant and VirtualBox installed. The tests are written using Serverspec which requires Ruby and Bundler.

To execute all tests:

$ gem install bundler
$ bundle install
$ rake

The tests are designed for Ubuntu Trusty Tahr (14.04), Xenial Xerus (16.04), and Bionic Beaver (18.04).

To view available rake tasks (and tests):

$ rake -T

These tests are not designed to check for idempotence. They focus on ensuring that each task performs correctly. Idempotency is tested separately with integration tests.