The Magnanimous-Turbo-Chainsaw repository contains system, configuration, and deployment tools used by the RPC-Tools team. These tools deliver our value added services to environments which enables a versioning structure and tool validation.

These tools will be leveraged by job automation and humans alike with the intention to rapidly deploy and maintain value added tooling across environments.

Run the setup script on a deployment host which will be managed by the MTC. There are many ways to setup an environment with the MTC tooling, just do what works best for the environment.

Download the setup script and execute it.

wget https://raw.githubusercontent.com/rcbops/magnanimous-turbo-chainsaw/master/scripts/setup.sh -O /opt/mtc-setup.sh
bash /opt/mtc-setup.sh

Run a single command.

curl https://raw.githubusercontent.com/rcbops/magnanimous-turbo-chainsaw/master/scripts/setup.sh | bash

Clone the tools and execute the setup script.

git clone https://github.com/rcbops/magnanimous-turbo-chainsaw /opt/magnanimous-turbo-chainsaw
bash /opt/magnanimous-turbo-chainsaw/scripts/setup.sh

If working with a proxy, make sure the noproxy, http_proxy, and https_proxy options are set, as needed. The setup process will react to proxies ensuring our tooling is configured in a way that is proxy friendly.

With the MTC setup, change directories to the scripts path and source the workspace script.

source setup-workspace.sh

This will ensure the deployment workspace is loaded and ready to run workloads.

While this process is optional, it is recommended. Before running any major deployment it is recommended to probe the environment for any host that is unreachable. The following playbook will probe all hosts throughout an environment and blacklist any host that is not available.

With the MTC setup, change directories to the playbooks path and run the probe playbook.

ansible-playbook probe-systems.yml

At the completion of this playbook the /tmp/mtc.blacklist file will have been created which will ensure no workloads are run against the unresponsive hosts.

With the MTC setup, change directories to the scripts path and run the cleanup tooling.

cd /opt/magnanimous-turbo-chainsaw
bash ./scripts/cleanup-legacy-elk.sh

With the MTC setup, change directories to the scripts path and run the deployment tooling.

cd /opt/magnanimous-turbo-chainsaw
bash ./scripts/deploy-fleet.sh

With the MTC setup, change directories to the scripts path and run the deployment tooling.

cd /opt/magnanimous-turbo-chainsaw
bash ./scripts/deploy-elk.sh

With the MTC setup, change directories to the scripts path and run the deployment tooling.

cd /opt/magnanimous-turbo-chainsaw
bash ./scripts/deploy-skydive.sh

In the event that the underlying system is running openstack-ansible for an OpenStack cloud deployment it's recommended to update the MTC repositories whenever the system's roles have been changed or modified; after an OpenStack version upgrade. This can be done by running a simple Ansible galaxy command.

# Make sure to have the OSA_PATH defined
${HOME}/ansible_venv/bin/ansible-galaxy install -r "${OSA_PATH}/ansible-role-requirements.yml"\
                                                --ignore-errors \
                                                --force \
                                                --roles-path="${HOME}/ansible_venv/repositories/roles"

All of the tools covered by the MTC can be tested on a local test instance. Recommended specifcations are >= 4GiB of RAM with 32GiB or disk space on root.

To spin up a test instance, run the following command.

cd /opt/magnanimous-turbo-chainsaw
bash ./tests/run-tests.sh