ansible/README.md

1.4 KiB

Ansible

Some basic Ansible 'stuff' for managing PiFrames.

This is very much WIP and nothing in this directory should NOT be used unless you plan on submitting patches / fixes / etc.

For now the goal of this code is to get a basic WireGuard deployment going for the PiFrameFleet area of the project.

Notes

  • Use setup-ansible-host.sh [ip] [user] to setup the ansible user + ssh public key on a host before running anything
  • Use deploy-software-updates.sh to update software on all frames
  • Use deploy-wireguard.sh to deploy wireguard on the dispatcher + all frames
    • Be sure to update frame IP address after running this so ansible uses the wireguard vpn instead of naked IP address
  • Use deploy-frames.sh to deploy frame configuration (this is a limited subset of config from the docs)
    • Monit
    • msmtprc / aliases
    • Scheduled hdmi on/off
  • See inventory.example for necessary config and layout of groups for the various ansible playbooks to work properly

Licensing

Unless otherwise stated all source code is licensed under the Apache 2 License.

Unless otherwise stated the non source code contents of this repository are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License