Awesome
Waffles!
Waffles is a suite of Bash scripts to manage server resources in an idempotent fashion.
Installation and Usage
To install Waffles, just clone the git repo and source the init.sh
file:
$ git clone https://github.com/wffls/waffles /opt/waffles
$ source /opt/waffles/init.sh
$ apt.pkg --help
You can integrate Waffles into a Bash script by sourcing the init.sh
file
within the script:
#!/bin/bash
source /opt/waffles/init.sh
# Install memcached
apt.pkg --package memcached --version latest
# Set the listen option
file.line --file /etc/memcached.conf --line "-l 0.0.0.0" --match "^-l"
# Determine the amount of memory available and use half of that for memcached
memory_bytes=$(elements System.Memory.Total 2>/dev/null)
memory=$(( $memory_bytes / 1024 / 1024 / 2 ))
# Set the memory available to memcached
file.line --file /etc/memcached.conf --line "-m $memory" --match "^-m"
# Manage the memcached service
service.sysv --name memcached
# If any changes happened, restart memcached
if [[ -n $waffles_total_changes ]]; then
exec.mute /etc/init.d/memcached restart
fi
Development
Waffles tries to be as simple as possible while still providing useful utilities for everyday systems administration. If you find a bug or would like to add a feature, just make a patch and open a Pull Request.
Testing
Adding unit and acceptance tests are encouraged but not required for Pull Requests.
Unit Tests
Unit tests can be found in tests/core.sh
. They're mainly used to verify
certain functions work correctly.
Acceptance Tests
Acceptance tests are used to verify resources work correctly. Test Kitchen and Docker are used to run the suite of tests. Use the install.sh Waffles script to set up Test Kitchen and all other requirements on an Ubuntu-based system.
Test files can be found in tests/kitchen/resources
. Each resource test
requires 5 functions:
- setup
- create
- update
- delete
- teardown
If any of the functions aren't applicable to the resource test you're writing,
just issue a return
.
You can execute tests by running:
$ cd /opt/waffles/tests/kitchen
$ ./test.sh --platform ubuntu-1404 --resource file.line
--platform
will take any regex compatible with the kitchen test
command.
--resource
is the name of any resource you want to test. If you want to run
all tests, use all
as the value.
More Information
See wffls.github.io for more information.