Fabric脚本镜像不可用的错误处理：多镜像重试安装AWS Systems Manager

当然可以搞定这个痛点！我们可以给Fabric脚本加一个多镜像自动重试机制，让它按你设定的顺序逐个尝试镜像源，直到找到可用的那个完成安装。下面是具体的实现思路和可直接复用的代码示例：

核心实现思路 #

• 先定义一个镜像源优先级列表：把官方源、备用公共镜像、自定义镜像按可靠性从高到低排列
• 循环遍历每个镜像：尝试下载、安装SSM Agent，一旦成功就停止循环
• 异常捕获与重试：每个镜像尝试失败时，捕获错误并自动切换到下一个镜像
• 最终兜底：如果所有镜像都失败，再抛出明确的错误信息

完整Fabric脚本示例 #

from fabric import task

# 按优先级排序的SSM Agent镜像源列表（根据你的操作系统调整路径）
SSM_MIRRORS = [
    # 官方源（优先尝试）
    "https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb",
    # 国内公共镜像（比如清华镜像，适合国内环境）
    "https://mirrors.tuna.tsinghua.edu.cn/aws/ssm-agent/latest/debian_amd64/amazon-ssm-agent.deb",
    # 你的自定义私有镜像（最后尝试）
    "https://your-internal-mirror.example.com/ssm-agent/latest/debian_amd64/amazon-ssm-agent.deb"
]

@task
def install_ssm_agent(c):
    """尝试从多个镜像源安装AWS SSM Agent，直到成功"""
    for mirror in SSM_MIRRORS:
        print(f"\n🔍 正在尝试镜像源: {mirror}")
        try:
            # 1. 下载镜像包，添加超时避免长时间等待
            c.run(f"wget --timeout=15 -O /tmp/amazon-ssm-agent.deb {mirror}", warn=False)
            
            # 2. 检查下载的文件是否有效（非空）
            c.run("test -s /tmp/amazon-ssm-agent.deb")
            
            # 3. 执行安装（修复依赖如果有问题）
            c.run("sudo dpkg -i /tmp/amazon-ssm-agent.deb || sudo apt-get install -f -y")
            
            # 4. 启动并设置开机自启
            c.run("sudo systemctl enable --now amazon-ssm-agent")
            
            # 5. 验证服务是否正常运行
            service_status = c.run("sudo systemctl is-active amazon-ssm-agent", hide=True).stdout.strip()
            if service_status == "active":
                print(f"✅ 成功通过镜像 {mirror} 完成SSM Agent安装与启动！")
                # 清理临时文件
                c.run("rm -f /tmp/amazon-ssm-agent.deb", warn=False)
                return
            else:
                print(f"⚠️ 安装完成但服务未启动，将尝试下一个镜像源")
                
        except Exception as e:
            print(f"❌ 当前镜像源失败: {str(e)}")
            # 清理临时文件，避免残留
            c.run("rm -f /tmp/amazon-ssm-agent.deb", warn=False)
            continue
    
    # 所有镜像尝试失败的兜底逻辑
    print("\n❌ 所有镜像源均无法使用，SSM Agent安装失败！")
    raise RuntimeError("所有SSM Agent镜像源都不可用，请检查网络或更新镜像列表")

关键细节说明 #

• 镜像适配：示例是Debian/Ubuntu系统的deb包，如果是RHEL/CentOS，需要替换为rpm包的镜像地址，安装命令换成yum install或dnf install
• 超时设置：给wget加上--timeout参数，避免在某个卡顿的镜像上浪费时间
• 依赖修复：安装时加上|| sudo apt-get install -f -y，可以自动修复deb包的依赖问题
• 状态验证：不只是安装，还要检查服务是否启动，确保真的安装成功

额外优化建议 #

• 可以针对不同操作系统分支处理镜像列表，比如用c.run("lsb_release -si", hide=True)判断系统类型，返回对应镜像
• 添加日志输出，把每个尝试的结果写入本地日志文件，方便后续排查问题
• 如果需要批量部署，可以结合Fabric的批量主机功能，统一执行这个任务

内容的提问来源于stack exchange，提问作者Arin Ekandem