Skip to main content

Deploy stuff by diff-ing the state you want against the remote server.

Project description

PyPI version Travis.CI status

pyinfra automates service deployment. It does this by diff-ing the state of the server with the state defined in the deploy script. Deploys are asyncronous and highly performant. The inventory & deploy are managed with pure Python, allowing for near-infinite extendability.

When you run pyinfra you’ll see something like:

Design Features

pyinfra was designed from day one to enable ops to deploy things in a consistent, debuggable and maintainable manner. Notable design decisions:

  • outputs shell commands and files to upload

  • two-step deploy that enables dry-runs

  • fail fast where possible (eg touching a directory)

  • -v means print out remote stdout & stderr in realtime

  • always print raw stderr on operation failure for instant debugging

  • uses pure, 100% Python for the inventory and deploy scripts

    • with operations/hooks to safely use Python mid-deploy

  • properly agentless - even Python isn’t required on the remote side (just a shell!)

Development

pyinfra is still under heavy development, and while the CLI/API should be considered fairly stable there’s no guarantee of no breaking changes until v1. There are a number of critical specifications to be properly fleshed out before the v1 release:

  • spec/docs for roles/sub-deploys

  • spec/docs for extension modules/facts

  • spec/docs for extension deploys

To develop pyinfra itself:

# Create a virtualenv
venv create pyinfra

# Install pyinfra in dev mode, with dev requirements
pip install -e .[dev]

Use nosetests or the bundled helper script to run tests. This helper script also counts coverage:

# Test everything (API, modules & facts)
scripts/test.sh

# Set individual bits
scripts/test.sh [api|modules|facts]

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-0.2.dev3.tar.gz (62.9 kB view details)

Uploaded Source

Built Distribution

pyinfra-0.2.dev3-py2.py3-none-any.whl (87.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file pyinfra-0.2.dev3.tar.gz.

File metadata

  • Download URL: pyinfra-0.2.dev3.tar.gz
  • Upload date:
  • Size: 62.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyinfra-0.2.dev3.tar.gz
Algorithm Hash digest
SHA256 ab8b26a4db0f10d73db3d79498a99959e263f11ff567bbb6ec2059fd5c311e5e
MD5 608491e0dd3bddd77a47f66f7dde4ae2
BLAKE2b-256 088dd540eacb9e3f59bc8b9e578a96d77aeb1bd775f744096297fd2b4ef907b7

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyinfra-0.2.dev3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f099dc94b73e8115512bcdd2db618b5a5fbb035f78ed16adf9dc159e8fc709ca
MD5 fbd423b76b82720ca9c2abb257d226ff
BLAKE2b-256 cf511e38272d9a54a03dd98b75c0ba8fa4b1364966dbcffb745bb7c7ffcb3903

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