Plugin to integrate Fabric with ploy.
ploy_fabric is best installed with easy_install, pip or with zc.recipe.egg in a buildout.
Once installed, it’s functionality is immediately usable with ploy.
The plugin adds the following commands to ploy.
Runs a Fabric task with simplified syntax for arguments. You can just put positional arguments on the command line behind the task name. For keyword arguments user the name=value syntax. For example:
ploy do something arg key=value
- Runs a Fabric task and passes on command line options to Fabric. This basically reflects the fab script of Fabric.
Instances only get the new fabfile option to specify which file to look in for tasks. The location is relative to ploy.conf.
For the Python side, each instance gains the do(task, *args, **kwargs) method. The task argument is the name of a task from the Fabric script which should be run. The remaining arguments are passed on to that task.
Another helper added to each instance is a context manager accessible via the fabric attribute on instances. With that you can switch to a new ssh connection with a different user in your Fabric tasks:
from fabric.api import env, run def sometask(): run("whoami") # prints the default user (root) with env.instance.fabric(user='foo'): run("whoami") # prints 'foo' if the connection worked run("whoami") # prints the default user (root)
All changes to the Fabric environment are reverted when the context manager exits.
Fabric task decorator
With ploy_fabric.context you can decorate a task to use a specific user with a separate connection. All changes to the Fabric environment are reverted when the context manager exits. This is useful if you want to run a task from inside another task.
from fabric.api import env, run from ploy_fabric import context @context # always run with the default user def sometask(): run("whoami") # prints the default user (root) @context(user=None) # always run with the default user (alternate syntax) def someothertask(): env.forward_agent = True run("whoami") # prints the default user (root) @context(user='foo') # always run as foo user def anothertask(): env.forward_agent = False run("whoami") # prints the default user (user) someothertask() assert env.forward_agent == False
The Fabric environment has the following settings by default.
- Always set to True, ssh connections are handled by this plugin and ploy.
- Always set to True, handled by ploy.
- The unique id of the current instance, only manipulate if you know what you do!
- Path to the known_hosts file managed by ploy.
- Dictionary allowing access to the other instances to get variables or call methods on.
- The current instance to access variables from the config attribute or other things and methods.
- The directory of ploy.conf.
Any option of the instance starting with fabric- is stripped of the fabric- prefix and overwrites settings in the environment with that name.
1.1.0 - 2014-10-27
- Require Fabric >= 1.4.0 and vastly simplify the necessary patching. [fschulze]
- Close all newly opened connections after a Fabric call. [fschulze]
- Add context manager and decorator to easily switch fabric connections. [fschulze]
1.0.0 - 2014-07-19
- Added documentation. [fschulze]
1.0b6 - 2014-07-15
- Allow overwriting of fabric env from config with options prefixed by fabric-, i.e. fabric-shell = /bin/sh -c. [fschulze]
1.0b5 - 2014-07-08
- Packaging and test fixes. [fschulze]
- Fix task listing for do command. [fschulze]
1.0b4 - 2014-07-04
- Use unique id for host string to avoid issues. [fschulze]
- Added fab command which is just a wrapper for Fabric with all it’s options and reworked do command into a simple version to just run a task. [fschulze]
- Renamed mr.awsome to ploy and mr.awsome.fabric to ploy_fabric. [fschulze]
1.0b3 - 2014-06-09
- When depending on Fabric, skip 1.8.3 which added a version pin on paramiko. [fschulze]
- Only add Fabric to install_requires if it can’t be imported. That way we don’t get problems if it’s already installed as a system packages or in a virtualenv. [fschulze]
1.0b2 - 2014-05-15
- Register fabfile massager for all instances. [fschulze]
- Use context manager for output filtering and filter in do helper. [fschulze]
- Moved setuptools-git from setup.py to .travis.yml, it’s only needed for releases and testing. [fschulze]
1.0b1 - 2014-03-24
- Initial release [fschulze]