Fabric 是基于 SSH 协议的 Python 工具,相比传统的 ssh/scp 方式,用 Python 的语法写管理命令更易读也更容易扩展,管理单台或者多台机器犹如本地操作一般。
官网地址:http://fabfile.org
安装
省略python、pip管理工具安装过程
1
|
pip install fabric
|
验证是否安装成功
进入python编辑模式,输入代码,无错即表示成功安装
1
|
from fabric.api import local
|
fabric版hello world
fabric 默认文件fabfile.py,当然如果不想用这个名字,需要加-f参数
创建fabfile.py文件
1
|
vim fabrile.py
|
编辑代码
1
2
3
4
5
|
#coding:utf-8
from fabric.api import local #
def hello():
# local函数用来执行本地命令
local( 'echo "hello wolrd!"' )
|
执行代码
1
|
fab hello
|
可以通过fab -l查看可以执行的任务,当前为hello函数
运行结果
1
2
3
|
[localhost] local: echo "hello world!"
hello world!
Done.
|
传统维护方法:
1
|
$ ssh x.x.x.x 'uname -a' -- 输出略
|
Fabric 示例:
1
|
$ cat fabfile.py
|
1
2
3
|
from fabric.api import run
def uname():
run( 'uname -a' )
|
1
|
$ fab -H x.x.x.x uname -- 输出略
|
肉眼直观看上去,貌似比 ssh 方式要写不少代码,但是基于 ssh 方式中间可控环节比较少,例如:你想判断某服务是否已经启动,没有启动则执行启动等等操作。ssh 命令式的做法稍显麻烦。(当然龌龊一点可以在被操作机器上写好一个脚本,ssh 调用这个脚本)
说几个 Fabric 的优点吧:
- 角色定义
- 代码易读
- 封装了本地、远程操作(还需要自己封装system/popen/ssh操作么?)
- 参数灵活(动态指定 host/role 等,还有并发执行 基于multiprocessing )
- 完整的日志输出
罗列的这些,其实日常工作里基本都有类似的封装了,但是有现成的一个成熟的工具,干啥不用呢?对吧。
常用的配置:
- env.host -- 主机ip,当然也可以-H参数指定
- env.password -- 密码,打好通道的请无视
- env.roledefs -- 角色分组,比如:{'web': ['x', 'y'], 'db': ['z']}
- fab -l -- 显示可用的task(命令)
- fab -H -- 指定host,支持多host逗号分开
- fab -R -- 指定role,支持多个
- fab -P -- 并发数,默认是串行
- fab -w -- warn_only,默认是碰到异常直接abort退出
- fab -f -- 指定入口文件,fab默认入口文件是:fabfile/fabfile.py
更多请参考:fab --help
常用的函数:
- local('pwd') -- 执行本地命令
- lcd('/tmp') -- 切换本地目录
- cd('/tmp') -- 切换远程目录
- run('uname -a') -- 执行远程命令
- sudo('/etc/init.d/nginx start') -- 执行远程sudo,注意pty选项
示例1:管理远程 nginx 服务
1
|
$ cat fabfile.py
|
1
2
3
4
5
6
7
8
9
10
|
from fabric.api import *
@task
def nginx_start():
''' nginx start '''
sudo( '/etc/init.d/nginx start' )
@task
def nginx_stop():
''' nginx stop '''
sudo( '/etc/init.d/nginx stop' )
|
1
2
3
4
5
6
7
|
$ fab --list -- 查看可用命令
Available commands:
nginx_start nginx start
nginx_stop nginx stop
$ fab -H x.x.x.x nginx_start -- 启动 nginx
|
示例2:基于角色
1
|
$ cat fabfile.py
|
1
2
3
4
5
6
|
from fabric.api import *
env.roledefs = { 'nginx' : [ 'x.x.x.x' , 'y.y.y.y' ], 'mysql' : 'z.z.z.z' }
@task
def mysql_start()
''' mysql start '''
sudo( '/etc/init.d/mysql start' )
|
1
2
3
4
5
6
7
8
9
|
$ fab --list -- 查看可用命令
Available commands:
nginx_start nginx start
nginx_stop nginx stop
mysql_start mysql start
$ fab -R nginx nginx_start -- 启动 nginx
$ fab -R mysql mysql_start -- 启动 mysql
|
示例3:混合本地和远程操作
1
|
$ cat fabfile
|
1
2
3
4
5
6
7
8
|
def hello():
''' test hello '''
with lcd( '/tmp' ): # 切换到 /tmp 目录下
local( 'svn co http://xxx xxx' ) # check 代码到本地
local( 'tar czf xxx.tar.gz xxx/' ) # 压缩本地包
put( 'xxx.tar.gz' , '/tmp' ) # 上传压缩包到远程 /tmp 目录下
with cd( '/tmp' ): # 切换到远程 /tmp 目录
run( 'tar zxf xxx.tar.gz' ) # 远程解压
|
是不是看上去都是像本地一样?对吧。
示例4:多个目标服务器
相同密码或者手动输入:
1
|
env.hosts = [ 'root@ip1:22' ,root@ip2: 22 ]
|
不同密码或者不想手动输入(此方法也可定义不角色一组服务器):
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
#coding:utf-8
from fabric.api import local,cd,put,lcd,env,run,execute,roles
env.roledefs = {
'role1' :[ 'root@ip1:22' ,],
'role2' :[ 'root@ip2:22' ,]
}
env.passwords = {
'root@ip1:22' : 'pwd1' ,
'root@ip2:22' : 'pwd2'
}
@roles ( 'role1' )
def role1():
with cd( '/tmp' ):
run( 'ls -l' )
@roles ( 'role2' )
def role2():
with cd( '/tmp' ):
run( 'ls' )
def task():
execute(role1)
execute(role2)
|