Hace unos poco dias mientras subia unos cambios de una aplicación me puse a buscar una herramienta que me pudiera ayudar con la automatización de esto de «subir cambios» y «desplegarlos» claro hecho en python o relacionado y encontre varias pero Fabric fue la que mas me llamo la atención, así que Fabric sera.

Que es Fabric?

Fabric es una libreria hecha en python para darnos facilidad al realizar tareas via «command line» y ssh, es como trabajar con «bash script» pero con python (Super poderes) y a eso agregarle mas Super poderes. En si fabric no es una herramienta para hacer «despliegues» o manejar procesos ni nada por el estilo pero tiene la capacidad para serlo y muchos la usan para ese tipo de cosas en conjunto con «SuperVisord» pueden hacer una buena combinación.

Instalación

pip install fabric

Que Puede hacer fabric

• Ejecutar tareas en servidores remotos
• Ejecutar tareas tanto como un single user o un sudo user
• Puede ser ejecutado sobre varios servidores la misma tarea
• Puede ejecutar tareas tanto en paralelo como en secuencia (Uno de tras de la otra)
• Tiene la capacidad de abortar tareas si algo inesperado sucede

Ejemplos

Hello word

#fabfile.py
def hello():
    print "Hola mundo"

Para ejecutar esta tarea con fabric es simplemente ir a directorio donde esta dicho archivo y ejecutar fab.

#simplemente
fab hello

#o espesificar el archivo de esta forma
fab hello -f fabfile.py

Todo bien hasta aqui e imprime mi «Hola mundo«, ahora si quiero que este mismo hola mundo se ejecute en diferentes servidores lo que tengo que hacer es lo siguiente.

#simplemente
fab hello -h localhost,remotehost.net,remotehost.dev

#o espesificar el archivo de esta forma
fab hello -f fabfile.py -h localhost,remotehost.net,remotehost.dev

Hecho esto su «script» se ejecutara en los sevidores proporcionados, esto fabric lo hace via ssh por lo que les pedira la clave de cada uno de esos servidores, una opcion para evitar esto es relizar un login ssh sin clave.

Hello Server

Este ejemplo lo que hara sera ejecutar un comando en cada uno de los servidores que ejecutemos nuestro «script».

#fabfile.py

def hello_server():
    run("uname -a")

El ejecutarlo sera igual que el ejemplo anterior.

#simplemente
fab hello_server -h localhost,remotehost.net,remotehost.dev

#o espesificar el archivo de esta forma
fab hello_server -f fabfile.py -h localhost,remotehost.net,remotehost.dev

Para ejecutar un comando en nuestro servidor remoto|local tenemos 2 opciones:
–run(«comando») Ejecutar un comando.
–sudo(«comando») Ejecuta un comando como super user.
–local(«comando») #Todo ver diferencias.

Ejemplo Completo

Digamos que realizamos algo en una app en desarrollo y queremos que produccion tenga esos cambios.

#fabfile.py

from fabric.api import run,env,prompt
from fabric.colors import red,green

env.hosts = ['localhost']

app_dir = "/var/www/superapp/"
env_dir = "/var/www/superapp/env/"

def activate_env():
    cd(env_dir)
    local("source bin/activate")
    print(green("Entorno activado"))

def load():
    local("git pull origin master")
    print(green("Pull realizado"))

def test():
    local("command to test your code")
    print(green("Aplicación probada"))

def reload_app():
    local("tumbar la aplicación previa e iniciarla nuevamente")

def deploy(message):
   
    print(message)

    cd(app_dir)
    
    load()
    
    test()

    result = prompt("Quiere reiniciar la aplicacion?[si/no]")

    if result == 'si':
        reload_app() 

Para ejecutar esto:

#simplemente
fab deploy:"mensaje"

Este ejemplo digamos que activa el entorno virtual (virtualEnv 😀 ), obtiene los cambios de un control de versiones, prueba el código y re inicia la aplicación con los nuevos cambios.

Los comandos utilizados

cd – Este es utilizado como el mismo comando por consola.
red / green – Estos comando retornan texto de dicho color y para ser imprimidos en la consola.
prompt – Detiene la ejecución y le pide al usuario que introduzca algún valor.

La variable env.hosts es utilizada para ya no tener que decir fab -H host1,host2,host3 sino que simplemente coloco ahi los targets a donde quiero ejecutar la tarea.

Referencia

Pagina oficial

Docs