• Página del proyecto
• Tutorial

Fabric es una herramienta para lanzar comandos de consola en local o vía ssh. Facilita la creación de scripts de administración.

Para instalar haremos:

$ pip install fabric

La instalación añade un script llamado fab, éste interpreta y ejecuta los fabfile's. Un ejemplo de fabfile.py:

from fabric.api import run
def host_type():
    run('uname -sra')

Para lanzarlo haremos:

$ fab -H 127.0.0.1,192.168.1.20 host_type
[127.0.0.1] Executing task 'host_type'
[127.0.0.1] run: uname -sra
[127.0.0.1] Login password for 'alfred': 
[127.0.0.1] out: Linux alfreds-laptop 3.0.0-13-generic #22-Ubuntu SMP Wed Nov 2 13:25:36 UTC 2011 i686 i686 i386 GNU/Linux
[127.0.0.1] out: 
[192.168.1.20] Executing task 'host_type'
[192.168.1.20] run: uname -sra
[192.168.1.20] out: Linux alfredspc 2.6.32-21-generic #32-Ubuntu SMP Fri Apr 16 08:10:02 UTC 2010 i686 GNU/Linux
[192.168.1.20] out: 
Done.
Disconnecting from 127.0.0.1... done.
Disconnecting from 192.168.1.20... done.

Para ver las funcionalidades de las que disponemos haremos:

$ fab --list

En la API de fabric (fabric.api) encontramos las siguientes funciones:

• local: execute a local command
• run: execute a remote command on all specific hosts, user-level permissions
• sudo: sudo a command on the remote server
• put: copy over a local file to a remote destination
• get: download a file from the remote server
• prompt: prompt user with text and return the input (like raw_input))
• reboot: reboot the remote system, disconnect, and wait for wait seconds

Cada función es una tarea, ha de estar dentro del directorio donde ejecutas fab.

fab [options] <command>[:arg1,arg2=val2,host=foo,hosts='h1;h2',...] ...

• -H indica distintos hosts donde se ejecutará.

def hello(name="world"):
    print("Hello %s!" % name)

$ fab hello:name=Jeff
$ fab hello:Jeff

Si creamos las siguientes variables:

env.user = 'username'
env.hosts = ['serverX', 'serverY', 'userX@serverZ']

Ejecutará las tareas en los servidores serverX y serverY con nombre de usuario 'username'. En el servidor serverZ utilizará userX.

También podemos especificar roles de servidores:

env.roledefs = {
    'webservers': ['www1', 'www2', 'www3', 'www4', 'www5'],
    'databases': ['db1', 'db2'],
    'nas': ['nas1', 'nas2']
} 
@roles('webservers', 'nas')
def get_version():
    run('cat /etc/issue')

Ejecutará get_versión únicamente en los hosts: www1, www2, www3, www4, www5, nas1 y nas2.

from fabric.api import *
 
env.hosts = ['userX@serverX']
 
def copy():
    # make sure the directory is there!
    run('mkdir -p /home/userX/mynewfolder')
    # our local 'localdirectory' (it may contain files or subdirectories)
    put('localdirectory', '/home/userX/mynewfolder')