Fabric是一个Python库和命令行工具,旨在为应用部署和系统管理任务的SSH的流水线式操作,使之更加高效和方便。Fabric提供了一套基本的执行本地和远程shell命令、上传和下载文件的操作,包括一些辅助函数,例如驱动正在运行的用户输入或者放弃执行。

Fabric通过把大量频繁使用的SSH操作写入到一个脚本中(fabric.py),来远程执行一些应用部署或者系统维护的任务。Fabric是类似paramiko的一个库,是对paramiko的再次封装,所以比使用paramiko更简单。


Fabric的优点:


角色定义

代码易读

封装了本地、远程操作

参数灵活,能偶动态指定host/role等,还有并发执行(基于multiprocessing)

完整的日志输出


在Linux下安装方法:

使用pip来安装 

yum install python-pip -y
pip install fabric


Fabric通过命令行工具fab来执行定义在fabfile.py中的任务,常用的配置和函数如下:

常用的fab命令选项和参数:

-l    显示可用的task

-H    指定host,多个host用逗号分开

-R    指定role,多个role用逗号分开

-P    并分数,默认是串行

-w    warn_only,默认为遇到异常直接放弃执行并退出

-f    指定入口文件,fab默认入口文件是:fabfile.py


fabfile.py文件中常用配置和函数:


env.host        主机ip,也可以使用fab选项-H参数来指定

env.password    SSH密码,若已经设置好无密码登录,则可以忽略

env.roledefs    角色分组,如:{'web': ['x', 'y'], 'db': ['z']}

local('pwd')    执行本地命令

lcd('/tmp')        切换本地目录

cd('/tmp')        切换远程目录

run('uname -s')        执行远程命令

sudo('service httpd restart')    执行远程sudo,注意pty选项

env.exclude_hosts=['10.1.6.159'] 排除10.1.6.159 

fabric.operations.open_shell() 打开远程shell界面。

get 是下载

put 是上传


下面来一些例子:

#/usr/bin/python
#coding:utf8
from fabric.api import *
from fabric.colors import *
from fabric.context_managers import *
 
env.hosts=['10.1.6.186','10.1.6.159']
env.password='xxxxxx'
 
def task1():
    with cd('/home/guol'):
        run('ls -l')

不同的机器执行不同的task:

#!/usr/bin/python
from fabric.api import *
from fabric.colors import *
from fabric.context_managers import *
 
env.roledefs={'web1':['10.1.6.186'],'web2':['10.1.6.159']}
env.password='xxxxxx'  ##需要配置密码相同,,,,
 
@roles('web1')
def task1():
    with cd('/home/guol'):
        run('ls -l')
@roles('web2')
def task2():
    print(green("I'm fabric"))
 
def deploy():
    execute(task1)
    execute(task2)
执行结果:
root@vm11:/tmp# fab deploy
[10.1.6.186] Executing task 'task1'
[10.1.6.186] run: ls -l
[10.1.6.186] out: total 0
[10.1.6.186] out: -rw-r--r-- 1 root root 0 Dec 21 13:32 186-local
[10.1.6.186] out: 
 
[10.1.6.159] Executing task 'task2'
I'm fabric
 
Done.
Disconnecting from 10.1.6.186... done.


farbic的环境变量:

fabric的环境变量有很多,存放在一个字典中,

fabric.state.env,而它包含在fabric.api中。

为了方便,我们一般使用env来指代环境变量。

env环境变量可以控制很多fabric的行为,一般通过env.xxx可以进行设置。

 

fabric默认使用本地用户通过ssh进行连接远程机器,不过你可以通过env.user变量进行覆盖。

当你进行ssh连接时,fabric会让你交互的让你输入远程机器密码,如果你设置了env.password变量,则就不需要交互的输入密码。

下面介绍一些常用的环境变量:

abort_on_prompts    设置是否运行在交互模式下,例如会提示输入密码之类,默认是false

connection_attempts    fabric尝试连接到新服务器的次数,默认1次

cwd    目前的工作目录,一般用来确定cd命令的上下文环境

disable_known_hosts    默认是false,如果是true,则会跳过用户知道的hosts文件

exclude_hosts    指定一个主机列表,在fab执行时,忽略列表中的机器

fabfile    默认值是fabfile.py在fab命令执行时,会自动搜索这个文件执行。

host_string    当fabric连接远程机器执行run、put时,设置的user/host/port等

hosts    一个全局的host列表

keepalive    默认0 设置ssh的keepalive

loacl_user    一个只读的变量,包含了本地的系统用户,同user变量一样,但是user可以修改

parallel    默认false,如果是true则会并行的执行所有的task

pool_size    默认0 在使用parallel执行任务时设置的进程数

password    ssh远程连接时使用的密码,也可以是在使用sudo时使用的密码

passwords    一个字典,可以为每一台机器设置一个密码,key是ip,value是密码

path    在使用run/sudo/local执行命令时设置的$PATH环境变量

port    设置主机的端口

roledefs    一个字典,设置主机名到规则组的映射

roles    一个全局的role列表

shell    默认是/bin/bash -1 -c 在执行run命令时,默认的shell环境

skip_bad_hosts    默认false,为ture时,会导致fab跳过无法连接的主机

sudo_prefix    默认值"sudo -S -p '%(sudo_prompt)s' " % env 执行sudo命令时调用的sudo环境

sudo_prompt    默认值"sudo password:"

timeout    默认10 网络连接的超时时间

user   ssh使用哪个用户登录远程主机


设置主机列表的方法:


hosts,在上下文环境中我们称hosts为"host strings"

strings指定了username、hostname、port等 

组合username@hostname:port。username和port可以省略,则默认使用本地用户和22端口。

 

strings映射单个主机,但是有时候你想把一批主机加入一个组中

roles则提供了一个定义一系列主机的方法,这个映射可以通过env.rolesdefs来设置

它必须通过fabfile进行设置才可以使用。env.roledefs['webservers'] = ['www1', 'www2', 'www3']


fabric 中传参数的类型,下面是一个例子:

#!/usr/bin/python
from fabric.api import *
import fabric.operations
from fabric.colors import *
from fabric.context_managers import *
import datetime
 
env.passwords = {'root@192.168.1.1:22':'redhat123456','root@192.168.1.2:22':'redhat'}
 
@hosts('root@192.168.1.1:22')
def task1():
    filename = run('ls /root/my/') #查看远程目录上的文件(此例子中这个目录下只有一个a.txt) 把这个文件名传到task2上中去
    get('/root/my/*','/root/my') #下载到本地的/root/my目录下
    local('fab task2:name=%s' % filename) #执行本地命令,并传递filename这个参数给task2
@hosts('root@192.168.1.2:22')
def task2(name=''): #定义带参数的函数
    put('/root/my/%s' % name, '/root/my') #把本地的/root/my/a.txt上传到192.168.1.2的/root/my目录下
 
 
####
运行:
fab task1
单独运行task2的命令:
fab task2:name='a.txt'


最后再来一个例子:

#!/usr/bin/env python
# -*- coding:utf-8 -*-
 
from fabric.api import env,run,local,hosts,put,puts, cd
import fabric.operations
from fabric.colors import *
import datetime
 
 
# env.hosts =  []
#下面定义三个主机
env.passwords = {'root@192.168.10.91:22':'password',
                 'root@11.44.119.2:22':'password',
                 'root@11.44.119.1:22':'password'}
 
@hosts('root@192.168.10.91:22')
def uploadmusic():
    put('./data/*.mp3','/var/www/html/music/') #把本地/data/目录下的mp3文件上传到192.168.10.91
 
@hosts('root@11.44.119.2:22')
def rsyncmusic():
    with cd("/usr/local/tomcat/webapps/"):  #远程执行cd 命令,,下面是run执行的命令
        run('pwd')
        run('ls /root/')
        bak_webapi = 'tar -zcf webapi_%s.tar.gz webapi' % datetime.datetime.now().strftime("%Y%m%d%H%M")
        run(bak_webapi)
        put("./data/*.txt","webapi/WEB-INF/classes/data/")
        run("rm -rf webapi/WEB-INF/classes/data/index")
        run("echo ''>/usr/local/tomcat/webapps/webapi/WEB-INF/classes/data/a.txt")
        #fabric.operations.open_shell("python /root/zhou.py")
 
@hosts('root@11.44.119.1:22')
def shellhost():
    fabric.operations.open_shell() #远程到119.1上,并打开shell