README.md

About

Scripts here are for use with Ansible.

Ansible is a configuration management tool that can make it easier to update multiple Recalbox machines at once, which can be a significant time saving in a classroom environment.

Ansible must be run on a separate host computer on the same network as the Recalbox machines to be updated.

Ansible is only official supported for running on a Linux host computer, but it is possible to run Ansible inside Windows.

An ARM Linux-based Recalbox machine is required for each target machine.

Setup your host computer

Install Ansible on the host computer.

pip3 install ansible

OR

sudo apt update && sudo apt upgrade && sudo apt install ansible -y

Set up SSH login to your Recalbox target machine(s).

ssh-keygen
ssh-copy-id [email protected]

Install McAirPos on your target Recalbox machine(s)

$ ansible-playbook -i "rampage.local," --user "root" ./ansible_install.yml

PLAY [Install McAirPos to allow playing MakeCode Arcade games] ***************************************

... various task details ...


PLAY RECAP *******************************************************************************************
rampage.local              : ok=4    changed=2    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

Optional

For long lists of targets, add all Recalbox machines to a group named arcades in the inventory file /etc/ansible/hosts.

[arcades]
asteroids.local	ansible_user=root
rampage.local	ansible_user=root

Then run the playbook with a simpler command:

ansible-playbook -l 'arcades,' ./ansible_install.yml