Skip to main content

pyinfra automates/provisions/manages/deploys infrastructure.

Project description

PyPI version PyPi downloads Docs status Execute tests status Codecov Coverage MIT Licensed

pyinfra automates/provisions/manages/deploys 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 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 --dry runs 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

pyinfra can be installed via pip:

pip install pyinfra

Now you can execute commands & operations over SSH:

# Execute an arbitrary shell command
pyinfra my-server.net exec -- echo "hello world"

# Install iftop apt package if not present
pyinfra my-server.net apt.packages iftop sudo=true update=true

These can then be saved to a deploy file, let's call it deploy.py:

from pyinfra.operations import apt

apt.packages(
    name='Ensure iftop is installed',
    packages=['iftop'],
    sudo=True,
    update=True,
)

And executed with:

pyinfra my-server.net deploy.py

or

pyinfra @docker/ubuntu deploy.py

Documentation

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyinfra-1.4.7.tar.gz (169.7 kB view details)

Uploaded Source

Built Distribution

pyinfra-1.4.7-py2.py3-none-any.whl (215.6 kB view details)

Uploaded Python 2Python 3

File details

Details for the file pyinfra-1.4.7.tar.gz.

File metadata

  • Download URL: pyinfra-1.4.7.tar.gz
  • Upload date:
  • Size: 169.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.4

File hashes

Hashes for pyinfra-1.4.7.tar.gz
Algorithm Hash digest
SHA256 5171f31d1150c20f75a873dd6ee8f2d1f0925a7cd427c4c5df49d43bad0e0441
MD5 6543f25b890e02c9d49d826305a682e8
BLAKE2b-256 42f6f638565194493b6b41cb4bdf03a4b32eda225ca432ffbe2eb13678c36cb0

See more details on using hashes here.

File details

Details for the file pyinfra-1.4.7-py2.py3-none-any.whl.

File metadata

  • Download URL: pyinfra-1.4.7-py2.py3-none-any.whl
  • Upload date:
  • Size: 215.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.4

File hashes

Hashes for pyinfra-1.4.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 a1d17c7257c4a1488903a453ff2e2d864872d610cc7fd25902f614a06a63487b
MD5 ecbcfc875703a71522ce3bfa36a0c9e1
BLAKE2b-256 192dadf1a86926c0fd98168b7be684605b858415d4864f22555f1046e51d2408

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page