CI Coverage PyPI License

maaspower#

Power control webhook server for Canonical’s MAAS.

The requirements for such webhooks are defined here:

  • https://maas.io/docs/snap/3.1/ui/power-management#heading–webhook

Source

gilesknap/maaspower

PyPI

pip install maaspower

Docker

docker run ghcr.io/gilesknap/maaspower:latest

Documentation

https://gilesknap.github.io/maaspower

Releases

gilesknap/maaspower

This project implements MAAS power control for machines that do not already have a BMC type supported by MAAS. It uses webhooks to control any number of remote switching devices that can power cycle such machines.

The project uses an extensible architecture so more switching device types may be added see Add API

At present it supports these flavours of switching control:

  • Command line interface. Anything that is controllable by a command line utility that can be installed on the machine running this webhook service.

  • SmartThings API: a popular Samsung IoT protocol that is supported by thousands of devices

  • Web UI controlled devices - uses selenium to connect to the web UI and control the device. A basic DSL describes the UI fields to scrape.

  • Cisco IOS PoE Switches

  • TPLink Kasa Smart Plugs

How the documentation is structured#

Documentation is split into four categories, also accessible from links in the top bar.

Tutorials for installation and typical usage. New users start here.

Practical step-by-step guides for the more experienced user.

Explanations of how it works and why it works that way.

Technical reference material including APIs and release notes.