ansible/README.md

1.6 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 setup-additional-wireguard-client.sh to create a wireguard config for a non-frame host (like your laptop/desktop used to manage a fleet of frames via the dispatcher)
  • Use deploy-dispatchers.sh to deploy dispatcher config (this is to fine-tune setup to include the frames)
  • Use deploy-frames.sh to deploy frame configuration (this is a limited subset of config from the docs)
  • See inventory.example and the host_vars directory 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