python三大神器之fabric

Fabric

Fabric是一個python的遠程執行shell的庫，同時它也是一個命令行工具。它提供了豐富的同 SSH 交互的接口，可以用來在本地或遠程機器上自動化、流水化地執行 Shell 命令。

安裝Fabric

Fabric的官網是 www.fabfile.org，源碼托管在Github上。你可以clone源碼到本地，然后通過下面的命令來安裝。但是在源碼安裝前，你必須先將Fabric的依賴包Paramiko裝上。

python setup.py develop

同時也可以使用pip安裝，因為fabric是python的一個第三方庫，只需一條命令即可：

 pip install fabric

python3 安裝時使用的是fabric3 :（ 安裝fabric3之前，需要先卸載fabric.）

1. # fabric3 支持 python3

2. pip uninstall fabric

3. pip3 install fabric3

fabric 不只是一個Python 模塊，fabric 還是一個命令行工具，可以使用fab -h查看幫助信息 

E:\my_data\hk-project>fab -V
Fabric3 1.14.post1
Paramiko 2.4.2
E:\my_data\hk-project>fab -h 

入門使用

fabric的使用方式是通過編寫一個python文件，該文件中包含多個函數，然后使用fab命令調用這些函數，做相應的任務。這些函數在fabric中稱為task。

# filename：abc.py
 ​
 from fabric.api import *
 ​
 def task1():
     print("hello")
     
 def hello():
     print("hello world")

寫好這個python文件后，在當前目錄的路徑下使用fab工具執行文件中的函數

[root@localhost python文件所在的目錄]# fab -f abc.py hello
 hello world
 ​
 # -f 指定fabfile文件，默認為fabfile.py，若文件名是當前目錄下的fabfile.py則無需指定

任務參數

此時你可能會想，如果這個函數有參數怎么辦呢？應該如何傳遞參數給函數呢？Fabric 支持 Shell 兼容的參數用法： <任務名>:<參數>, <關鍵字參數名>=<參數值>,... 用起來就是這樣。

 def hello(name="world"):
     print("hello {}".format(name))

我們可以這樣去指定參數 

$ fab hello:name=Jeff   # 或者 fab hello:Jeff
 hello Jeff
 ​
 Done.

小試牛刀

現在我們假設需要寫一個fabfile.py，能夠在每次web項目代碼更新后使用git提交並遠程服務器拉去最新代碼並運行，需求描述清楚了，開干吧！

# fabfile.py
 # 這里建議將該文件放入項目文件的根目錄中，方便git提交
 ​
 from fabric.api import local
 ​
 def test():
     local('python manage.py test myapp')
     # 測試是否能正常運行
     
 def commit():
     local('git add -p && git commit -m "for test"')
     
 def push():
     local('git push')
    
 def prepare_deploy():
     test()
     commit()
     push()

這個 prepare_deploy 任務可以單獨調用，也可以調用更細粒度的子任務。

故障

Fabric 會檢查被調用程序的返回值，如果這些程序沒有干凈地退出，Fabric 會終止操作。我們什么都不用做，Fabric 檢測到了錯誤並終止，不會繼續執行 commit 任務。

我們也可以對故障進行一定的處理和判斷

from fabric.api import local, settings, abort
 from fabric.contrib.console import confirm
 ​
 def test():
     with settings(warn_only=True):
         result = local('./manage.py test my_app', capture=True) 
         # result.return_code返回碼(0/1)和result.failed
     if result.failed and not confirm("Tests failed. Continue anyway?"): # confirm判斷用戶輸入
         abort("Aborting at user request.")  # 指定錯誤退出信息
         
 # 一個名為 warn_only 的設置（或着說 環境變量 ，通常縮寫為 env var ）可以把退出換為警告，以提供更靈活的錯誤處理。如果設置為False，則一條命令運行失敗會就會退出，不再執行后面的命令。

建立連接

終於到了連接了，這個工具主要作用就是在遠程執行命令呀，學會了這個，我們就可以在本地執行遠程服務器的命令了。

from fabric.api import *
 ​
 env.hosts = ['root@192.168.10.11:22']
 ​
 def deploy():
     run('ls')  # run()用於執行遠程命令，local()執行本地命令
     
 # 執行后會提示你輸入密碼，輸入密碼即可

至此，入門結束，后續還有更多api的講解，敬請關注！

參考鏈接：

fabric官方中文文檔：https://fabric-chs.readthedocs.io/zh_CN/chs/tutorial.html

Python 遠程部署利器 Fabric 模塊詳解：https://blog.csdn.net/freeking101/article/details/81103945