pyinfra automates infrastructure super fast at massive scale
Documentation • Getting Started • Examples • Help & Support • Contributing
pyinfra automates/provisions/manages/deploys infrastructure. It can be used for ad-hoc command execution, service deployment, configuration management and more. Design features include:
- 🚀 Super fast execution over thousands of hosts with predictable performance.
- 🚨 Instant debugging with stdout & stderr output on error or as required (
-v|-vv|-vvv). - 📦 Extendable with any Python package as configured & written in standard Python.
- 💻 Agentless execution against SSH/Docker/subprocess/winrm hosts.
- ❗️ Two stage process that enables
--dryruns before executing any changes. - 🔌 Integrated with Docker, Vagrant/Mech & Ansible out of the box.
When you run pyinfra you'll see something like (non animated version):
Quickstart
Install pyinfra with pipx (recommended) or pip:
pipx install pyinfra
Now you can execute commands on hosts via SSH:
pyinfra my-server.net exec -- echo "hello world"
Or execute in Docker, on 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:
# Install iftop apt package if not present
pyinfra @docker/ubuntu apt.packages iftop update=true _sudo=true
Which can then be saved as a Python file like deploy.py:
from pyinfra.operations import apt
apt.packages(
name="Ensure iftop is installed",
packages=['iftop'],
update=True,
_sudo=True,
)
The hosts can also be saved in a file, for example inventory.py:
targets = ["@docker/ubuntu", "my-test-server.net"]
And executed together:
pyinfra inventory.py 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.
1 maintainer
Metadata
1 maintainer
Release files for pyinfra 2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyinfra-2.3.tar.gz | 179.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyinfra-2.3-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 409.0 kB
Release files / pyinfra-2.3.tar.gz
| Download URL | pyinfra-2.3.tar.gz |
|---|---|
| Size | 179.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
352ed9234dbcbb4588e4a64b0efcfe9fe22da140e21d6f2bafe49c2058416a36
|
|
BLAKE2b-256 checksum How to use checksums |
5303a1c62469dc469c3ed0ca82a101b005ab48213f358e5edc36412c97a3783a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.10.4
|
Release files / pyinfra-2.3-py2.py3-none-any.whl
| Download URL | pyinfra-2.3-py2.py3-none-any.whl |
|---|---|
| Size | 229.7 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
3b9697541b1692bb30e0e934bce66f9cab6b6428d3d48a1c50d35aadaee2154d
|
|
BLAKE2b-256 checksum How to use checksums |
2b54208a12238724d3e85314d0b2e328c0b12a2c41a7864096881d82a8fc3a93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.10.4
|
