Fabric 是基於 SSH 的 Python 自動化部署工具,能將重複的遠端操作 (部署、重啟、備份) 封裝為可重複執行的腳本。本文從安裝、基本用法、參數傳遞、本地/遠端混合操作、多伺服器角色定義、錯誤處理到密碼管理,完整記錄實戰經驗。
pip install fabric==1.14.0 # 或 2.x 版本,API 差異較大,本文以 1.x 為例
# 驗證
fab --version
# fabfile.py
def hello():
print("Hello world!")
# 執行
fab hello
# 輸出: Hello world!
def hello(name, value):
print(f"{name} = {value}!")
# 執行方式
fab hello:name=age,value=20
fab hello:age,20 # 位置參數
local()from fabric.api import local
def lsfab():
local('cd ~/project && ls -la')
run()、cd()from fabric.api import env, run, cd
env.hosts = ['user@host:port']
env.password = 'password' # 或使用 SSH Key
def deploy():
with cd('/home/user/project'):
run('git pull')
run('pip install -r requirements.txt')
run('systemctl restart myapp')
from fabric.api import local, run, cd, execute
def local_commit():
local('git add . && git commit -m "auto" && git push')
def remote_deploy():
with cd('/var/www/app'):
run('git pull')
run('systemctl reload nginx')
def full_deploy():
execute(local_commit)
execute(remote_deploy)
@rolesfrom fabric.api import env, roles, run, execute
env.roledefs = {
'web': ['web1@10.0.0.1', 'web2@10.0.0.2'],
'db': ['db@10.0.0.10'],
}
@roles('web')
def update_web():
run('git pull && systemctl reload nginx')
@roles('db')
def migrate_db():
run('python manage.py migrate')
def deploy_all():
execute(update_web)
execute(migrate_db)
from fabric.colors import green, red, yellow
def status():
print(green("Success"))
print(red("Failed"))
print(yellow("Warning"))
settings(warn_only=True):忽略失敗繼續執行,需自行檢查 result.failed。with settings(abort_exception=MyException):。ssh-keygen,公鑰加入遠端 ~/.ssh/authorized_keys,免密碼登入。env.forward_agent = True,本地 Key 透過 SSH 轉發至遠端再連第三台。os.environ 或加密配置檔 (如 ansible-vault 風格)。env.passwords = {'host1': 'pwd1', 'host2': 'pwd2'} 字典對應。invoke 為核心,API 不相容 (如 run → Connection.run)。invoke + paramiko。Fabric 讓「手動 SSH 執行指令」變成「一鍵部署」,是運維自動化的利器。