shellphish/mechaphish repository overview

⁠CGC cloud setup

ATTENTION: THIS REPOSITORY IS HERE FOR HISTORICAL PURPOSES ONLY. THE MECHANICAL PHISH WAS AN AWESOME PIECE OF SOFTWARE, DEPLOYED DURING THE CGC AND OTHER COOL COMPETITIONS, BUT IT HAS NOT BEEN MAINTAINED SINCE 2016, AND HAS BITROTTED AND BEEN OBSOLETED BY OTHER INTERNAL AND PUBLIC PROTOTYPES. PLEASE DO NOT CONTACT ANYONE, ANYWHERE, ABOUT ANYTHING RELATED TO THIS REPOSITORY. THE INDIVIDUAL COMPONENTS OF THE MECHANICAL PHISH, SUCH AS REX, PATCHEREX, AND angr ITSELF, CONTINUE TO BE MAINTAINED IN THEIR OWN REPOSITORIES.

This repository contains scripts and data used in managing the configuration of the CGC cloud servers.

⁠Using this repository

1. Get Ansible⁠ (pip install -r requirements.txt)

2. Clone this repository.

3. Build or download the VM image in roles/crs/vm/files/cgc-vm.qcow2 (see tester-qemu-docker⁠).

4. Run ansible-playbook

⁠Playbooks

• Setup

  Install and run Kubernetes on CGC nodes:

    ansible-playbook -i inventory/mechaphish/hosts setup.yml -b
  

  Copy

  This will setup users, install dependencies and spawn a new Kubernetes instance.

• Teardown

  Use teardown.yml playbook to stop Kubernetes and reset nodes to their original state:

    ansible-playbook -i inventory/mechaphish/hosts teardown.yml -b
  

  Copy

• Virtual Competition

    ansible-playbook -i inventory/mechaphish/hosts setup-virtualcompetition.yml -b
  

  Copy

• Registry

    ansible-playbook -i inventory/mechaphish/hosts setup-registry.yml -b
  

  Copy

⁠Run commands

You can also use the ansible command directly to run tasks on remote hosts:

ansible all -i inventory/mechaphish/hosts -a "uptime"

Adding -vvvv (or --verbose) will get you lots of useful debug info.

⁠Repository structure

⁠setup.yml, teardown.yml, etc.

Top-level ansible playbooks.

⁠roles/

Application-specific configuration.

⁠inventory/

Host or host-group specific configuration. CGC nodes are grouped in different sets. The main inventory lives at inventory/NAME/hosts and host and group variables files live in inventory/NAME/{host,group}_vars.

⁠kubernetes/

Dockerfile and replication controller settings for Kubernetes images.

⁠tools/

• crs: handy script to start/stop crs
• powercontrol.py: poorman IPMI
• virtualcompetition: start/stop virtual-competition
• update-vm-image: install latest components into DECREE VM image. Requires:

  pip install paramiko stopit
  apt-get --no-install-recommends install qemu-kvm
  adduser gitlab-runner kvm
  

  Copy

⁠sshp/

List of hosts to use with sshp (requires sshp⁠).

sshp -f sshp/ips.txt uptime

⁠CGC cloud servers

Google Spreadsheet⁠