pyinfra automates infrastructure super fast at massive scale. It can be used for ad-hoc command execution, service deployment, configuration management and more. Core design features include:
- 🚀 Super fast execution over thousands of targets with predictable performance.
- 🚨 Instant debugging with realtime stdin/stdout/stderr output (
- 🔄 Idempotent operations that enable diffs and
--dryruns before making any changes.
- 📦 Extendable with any Python package as configured & written in standard Python.
- 💻 Agentless execution against SSH/Docker/subprocess/WinRM hosts.
- 🔌 Integrated with Docker, Terraform, Vagrant/Mech & Ansible out of the box.
When you run pyinfra you'll see something like (non animated version):
Install pyinfra with
pipx (recommended) or
pipx install pyinfra
Now you can execute commands over SSH:
pyinfra my-server.net exec -- echo "hello world"
Or target Docker, the local machine, and other connectors:
pyinfra @docker/ubuntu exec -- echo "Hello world" pyinfra @local exec -- echo "Hello world"
As well as executing commands you can define state using operations:
pyinfra @docker/ubuntu apt.packages iftop update=true _sudo=true
Which can then be saved as a Python file like
from pyinfra.operations import apt apt.packages( name="Ensure iftop is installed", packages=["iftop"], update=True, _sudo=True, )
pyinfra @docker/ubuntu deploy.py
Now you know the building blocks of pyinfra! By combining inventory, operations and Python code you can deploy anything.
See the more detailed getting started or using operations guides. See how to use inventory & data, global arguments and the CLI or check out the documented examples.