MomsFriendlyDevCo Init Scripts

A collection of setup scripts to deploy a Linux environment.

Quick start guide

Clone the repo and run one of the ROLE-* scripts to setup a server matching that profile.

For example if you want a Node web server run:

# Make sure Git is installed
sudo apt install -y git

# Clone everything
git clone https://github.com/MomsFriendlyDevCo/Init.git
cd Init

# Install the required ROLE
./ROLE-server-node

Cherry-picking guide

Each script is designed to be run as a non-root user (escapting to sudo when needed).

These scripts follow the sequence '-' where the number dictates the order they should be run.

You can queue up multiple scripts on the command line, picking the items you require.

For example to install NodeJS, Python and Ruby you could run:

./020-node && ./020-python && ./020-ruby

Rules

Each action script (i.e. any script matching ???-*) must follow the following:

Each script must:

• Include a Bash hashbang (i.e. #!/bin/bash) as the first line and be executable
• Include documentation in the header
• Import the common library via source common somewhere in its header (NOTE: any script in ./utils/ needs to use [ -z "$INIT_READY" ] && source common as the current directory may not be the same as $INIT_HOME
• Fail gracefully and not stop application flow unless a critical failure has occured
• Be runnable multiple times - this is to support future upgrades. A script must be capable of being run again at some future date with no side effects

Each script should:

• Use INIT status <text> or INIT skip <text> as a reporting mechanism instead of plain echo
• Require little to no interaction past the initial execution

General Syntax

This package comes complete with various helper functions which are all called with the init syntax.

All commans in this set exit 0 (i.e. no failures). Any that returns a boolean will either return the string 0 or 1 and should be queried in Bash with equality:

if [ `INIT apt-has foo bar baz` == 1 ]; then
    echo "Foo, Bar + Baz are all installed"
else
    echo "Foo, Bar + Baz are all missing!"
fi