Skip to main content

Custom version for developing pyinfra

Project description

pyinfra

Note: this is the v3 branch, which is currently in beta. See the docs for v3. If needed the 2.x branch is here, but is in bugfix only mode.

pyinfra automates infrastructure using Python. It’s fast and scales from one server to thousands. Great for ad-hoc command execution, service deployment, configuration management and more.


DocumentationGetting StartedExamplesHelp & SupportContributing

Chat ⇒ #pyinfra on Matrix


Why pyinfra? Design features include:

  • 🚀 Super fast execution over thousands of hosts with predictable performance.
  • 🚨 Instant debugging with realtime stdin/stdout/stderr output (-vvv).
  • 🔄 Idempotent operations that enable diffs and dry runs before making changes.
  • 📦 Extendable with the entire Python package ecosystem.
  • 💻 Agentless execution against anything with shell access.
  • 🔌 Integrated with connectors for Docker, Terraform, Vagrant and more.

Quickstart

Install pyinfra with pip:

pip install pyinfra

Now you can execute commands on hosts via SSH:

pyinfra my-server.net exec -- echo "hello world"

Or target Docker containers, 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.


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

Project details


Download files

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

Source Distribution

pyinfra_forked_by_stone-w4tch3r-0.3.3.tar.gz (184.6 kB view details)

Uploaded Source

Built Distribution

pyinfra_forked_by_stone_w4tch3r-0.3.3-py2.py3-none-any.whl (240.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file pyinfra_forked_by_stone-w4tch3r-0.3.3.tar.gz.

File metadata

File hashes

Hashes for pyinfra_forked_by_stone-w4tch3r-0.3.3.tar.gz
Algorithm Hash digest
SHA256 2b85c44c1ce77f10f2c8f92b497c8d5e766817c28dacf9e0feaee533631e781b
MD5 3b72574506d93ea18678b7ca02ae1367
BLAKE2b-256 ca2fdf2cdc74baa09f887a93cf9419218f67b927ee2c8c81ad9b09450ae26df6

See more details on using hashes here.

File details

Details for the file pyinfra_forked_by_stone_w4tch3r-0.3.3-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for pyinfra_forked_by_stone_w4tch3r-0.3.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f695a6a1215f296bd3bebd61f7ddcd293928b8672ef69f958b8387f60298f1cc
MD5 537755688baaf59240c3cead0d7383e9
BLAKE2b-256 90bf2aa08c9de8857910ee16038d0802266dc9d65e29e1069607217cc6a47851

See more details on using hashes here.

Supported by

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