Dev/Warrior

The Warrior is a virtual machine appliance used by volunteers to participate in projects.

Packages

The Warrior image is built off Alpine Linux 3.6.2 (VM version 3.0), Alpine Linux 3.12.0 (VM version 3.1), Alpine Linux 3.13.2 (VM version 3.2):

• kernel 4.9.32 (VM version 3.0), kernel ? (VM version 3.1), kernel ? (VM version 3.2)
• the virtual machine image is prepared using the stage.sh script and contains a pre-installed /root/boot.sh script that downloads and boots the warrior.

The warrior itself runs in a Docker container running Debian 10 Buster that contains Python 3.9, NodeJS, wget-at, and numerous other dependencies.

Warrior VM versions 3.0 and 3.1 ship with a Docker container running Ubuntu 16.04 that contains

• Python 3.5.2, pip 8.1.1
• Perl v5.22.1
• gcc 5.4.0, make 4.1, bash 4.3.48
• curl 7.47.0

VM versions 3.0 and 3.1 will automatically be updated use the new, updated container configuration the next time they are booted up and connected to the internet.

Bootup

The virtual machine is self-updating. It does the following:

1. Start the virtual machine
2. Linux boots
3. boot.sh downloads and launches /root/startup.sh
4. startup.sh prepares and runs a Docker container with the warrior runner
5. Point your web browser to http://localhost:8001 and go.

Viewing container logs

Starting with VM version 3.2, you can view basic logs from the virtual machine console: press ALT+F2 for Warrior logs, press ALT+F3 for automatic updater logs, and press ALT+F1 to return to the splash screen.

Logging into the Warrior

To log into the warrior,

1. Press Alt+F4 (make sure you capture your keyboard in the VM first or instead press Alt+Right several times).
2. The username is root and the password is archiveteam
3. You are now logged in as root.
4. Check the docker container with docker ps. This will give you docker container identifier, among others. If you are using VM version 3.2, there should be containers named warrior (the Warrior itself), watchtower (automatic updater, runs every hour), and instantwtower (automatic updater, runs once on VM startup). VM versions 3.0 and 3.1 will automatically be updated use these new, named containers the next time they are booted up and connected to the internet.
5. Enter the inside of the docker container with docker exec -it identifier /bin/bash

Testing Core Warrior Code

This part may be outdated and refer to Warrior version 2

Since the Warrior pulls from GitHub, it is important to commit only stable changes into the master branch. Recommended Git branching practices use a development branch.

To test core Warrior code, you can switch from the master branch to the development branch. The Warrior will fetch the corresponding seesaw-kit repository branch.

To change branches,

1. Log in as root
2. Execute cd /home/warrior/warrior-code2
3. Execute sudo -u warrior git checkout development
4. Execute reboot

By the same route you can return your warrior to the master branch.

The code for each project is stored in /home/warrior/projects/<PROJECTNAME>/

Developer Documentation

• Infrastructure overview
• Source code repositories
• Warrior overview
• Starting a new project
• Writing Seesaw grab scripts
• Setting up a tracker
• Setting up Rsync and Megawarc Factory
• Project management and leadership