lindes / break-fix

break-fix

Purpose

Reading documentation is one way to get up to speed on a technology. Implementing the tech is yet another; it familiarizes you with the components and their configuration files. These exercises allow a different approach: tinkering in a simulated/safe environment. Challenge yourself by spinning up a vagrant machine, breaking that environment with a provided script, and then learning the nitty-gritty details by making that technology work again.

Method

1. clone the repo
2. cd
3. vagrant up
4. vagrant ssh
5. cd /vagrant/scripts
6. execute a script
7. repair the damage

While you can work on this solo, consider inviting someone along for the ride. Pay attention to how they think, what they choose to investigate and when. Discuss tools used and troubleshooting tricks. Ask each other to whiteboard the components as you're working on them. Running the vagrant machines is a fun way to learn the technology, but interacting with another admin allows should accelerate the process.

Adding a new technology:

Directory Structure

<technology>/
├── Vagrantfile
└── scripts
    ├── break01.sh
    └── break02.sh

FAQ

1. We could distribute a box that starts out broken, without evidence of how it got that way?

• I want the vagrant file to be clean. A person should always start from a known good point. This allows a couple things:
  1. Study in advance; the student gets a good understanding of what a working environment is like
  2. If a user FUBARs an environment vagrant destroy -f && vagrant up gets them back to a known good point
  3. We only have to write break scripts, not fix scripts as well; it's easier to write breaks than fixes.