【自动化运维神器Ansible】Ansible常用模块之unarchive模块详解

• 源文件检查：验证指定的归档文件是否存在且可读
• 完整性验证：通过校验和（如提供）验证文件完整性
• 目标检查：确认目标路径存在且可写
• 工具选择：根据文件格式选择适当的解压工具（tar/unzip等）
• 解压执行：实际解压文件到目标位置
• 结果验证：检查解压后的文件是否符合预期
• 清理工作：根据配置清理临时文件和源归档
• 结果返回：将执行状态返回给Ansible

• 描述：指定要解压的归档文件路径
• 类型：字符串（必需）
• 注意：可以是本地路径或远程URL（需remote_src配合）

- name: 解压本地归档文件unarchive:src: /tmp/package.tar.gzdest: /opt/application

• 描述：控制是否从远程获取源文件
• 类型：布尔值
• 默认：no（本地文件）
• 注意：设为yes时可解压目标主机上的文件

- name: 解压远程主机上的归档unarchive:src: /tmp/remote_pkg.zipdest: /opt/remote_src: yes

• 描述：指定解压目标目录
• 类型：字符串（必需）
• 注意：目录必须存在，否则会报错

- name: 解压到指定目录unarchive:src: /tmp/app.tar.gzdest: /opt/

• 描述：传递给解压工具的额外选项
• 类型：列表
• 注意：选项需与所用工具兼容

- name: 使用额外解压选项unarchive:src: /tmp/data.tar.gzdest: /data/extra_opts: ["--strip-components=1"]

• 描述：是否保留比归档中更新的现有文件
• 类型：布尔值
• 默认：no
• 注意：保护本地修改的重要参数

- name: 解压但保留较新文件unarchive:src: /tmp/configs.tar.gzdest: /etc/keep_newer: yes

• 描述：HTTPS下载时是否验证证书
• 类型：布尔值
• 默认：yes

  - name: 从URL解压并跳过证书验证unarchive:src: https://example.com/pkg.zipdest: /opt/validate_certs: no

• 注意：仅影响从URL获取的情况

- name: 基础解压示例unarchive:src: /tmp/application.tar.gzdest: /opt/

- name: 传输并解压归档hosts: app_serverstasks:- name: 复制归档到目标主机copy:src: /local/path/package.tar.gzdest: /tmp/package.tar.gz- name: 解压归档unarchive:src: /tmp/package.tar.gzdest: /opt/appremote_src: yes

- name: 应用升级部署hosts: productionvars:app_version: "2.3.1"tasks:- name: 下载新版本包get_url:url: "https://repo.example.com/app/{{ app_version }}/app.tar.gz"dest: "/tmp/app_{{ app_version }}.tar.gz"- name: 备份当前版本command: "tar -czf /backups/app_{{ ansible_date_time.date }}.tar.gz /opt/app"- name: 解压新版本unarchive:src: "/tmp/app_{{ app_version }}.tar.gz"dest: "/opt/"extra_opts: ["--strip-components=1"]- name: 清理临时文件file:path: "/tmp/app_{{ app_version }}.tar.gz"state: absent

- name: 分发集群配置hosts: cluster_nodestasks:- name: 从管理节点获取配置包unarchive:src: "http://config-server/configs/cluster_configs.tar.gz"dest: "/etc/"owner: "root"group: "root"mode: "0644"remote_src: yesvalidate_certs: no

- name: 打包并分发应用hosts: buildertasks:- name: 创建应用归档archive:path: "/build/app/"dest: "/dist/app.tar.gz"- name: 分发到web服务器copy:src: "/dist/app.tar.gz"dest: "/tmp/app.tar.gz"delegate_to: "{{ item }}"loop: "{{ groups['web_servers'] }}"- name: 部署应用hosts: web_serverstasks:- name: 解压应用unarchive:src: "/tmp/app.tar.gz"dest: "/var/www/"remote_src: yes- name: 设置权限file:path: "/var/www/app"owner: "www-data"group: "www-data"mode: "0755"recurse: yes

- name: 从互联网部署软件hosts: alltasks:- name: 下载软件包get_url:url: "https://example.com/packages/software-1.0.tar.gz"dest: "/tmp/software.tar.gz"- name: 解压安装unarchive:src: "/tmp/software.tar.gz"dest: "/opt/"- name: 清理安装包file:path: "/tmp/software.tar.gz"state: absent

• 完整性验证：

- name: 安全解压示例unarchive:src: "/tmp/secure_pkg.tgz"dest: "/opt/"checksum: "sha256:abcd1234..."

• 权限控制：

- name: 解压并设置权限unarchive:src: "/tmp/config.tar.gz"dest: "/etc/"owner: "root"group: "root"mode: "0600"

• 来源验证：
  • 优先使用内部仓库
  • HTTPS下载需验证证书
  • 敏感数据考虑加密传输

• 表现：Unsupported archive format
• 原因：文件损坏或格式不被识别
• 解决：
  • 检查文件完整性
  • 明确指定format参数
  • 确保目标主机有对应解压工具

• 表现：No space left on device
• 原因：磁盘空间不足
• 解决：
  • 检查目标磁盘空间
  • 使用df模块预先验证
  • 考虑清理或扩展存储

• 表现：Permission denied
• 原因：
  • 无法读取源文件
  • 无法写入目标位置
• 解决：
  • 使用become提权
  • 检查SELinux/AppArmor设置
  • 验证目标路径权限

• 详细模式：使用-vvv参数获取详细输出
• 手动验证：

tar -tvf archive.tar.gz # 预览内容 unzip -l package.zip # 查看zip内容

• 分步执行：复杂流程分解测试
• 使用check模式：--check参数预测变更

- name: 调试解压问题hosts: problematic_hosttasks:- name: 检查归档文件stat:path: "/tmp/problem.tar.gz"register: archive_stat- name: 显示文件信息debug:var: archive_stat- name: 测试解压unarchive:src: "/tmp/problem.tar.gz"dest: "/tmp/test_output"remote_src: yesregister: unarchive_result- name: 显示解压结果debug:var: unarchive_result