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

• 在没有自动化工具的情况下，管理员通常需要手动执行类似这样的命令：

tar -czvf archive.tar.gz /path/to/files --exclude="*.tmp"

• 为了更好地理解archive模块的工作机制，我们来看其内部工作流程：

• 路径验证：首先检查源路径是否存在，如果不存在则直接报错终止
• 文件收集：解析所有源路径和排除模式，收集实际要归档的文件列表
• 权限检查：确认目标路径有写入权限
• 临时工作区：创建临时目录用于构建归档文件
• 归档构建：按照指定格式创建归档文件
• 压缩处理：如果指定了压缩格式，应用相应的压缩算法
• 完整性验证：检查生成的归档文件是否完整可用
• 清理工作：删除临时工作文件
• 结果返回：将执行结果返回给Ansible

• 描述：指定要归档的文件或目录路径
• 类型：列表
• 注意：可以指定多个路径

- name: Archive multiple paths
  archive:
    path:
      - /var/log
      - /etc/nginx
    dest: /backups/logs.tar.gz

• 描述：归档文件的目标路径
• 类型：字符串
• 注意：如果不指定，默认在第一个源路径的父目录创建

- name: Archive with explicit destination
  archive:
    path: /data/files
    dest: /backups/files.tar.gz

• 描述：指定归档格式
• 类型：字符串
• 可选值：gz(默认)、bz2、xz、zip、tar
• 注意：zip格式在2.7+版本支持

- name: Create zip archive
  archive:
    path: /data/images
    dest: /backups/images.zip
    format: zip

• 描述：排除的文件模式列表
• 类型：列表
• 注意：支持通配符模式

- name: Archive with exclusions
  archive:
    path: /data
    dest: /backups/data.tar.gz
    exclude:
      - "*.tmp"
      - "*.log"

• 描述：归档成功后是否删除源文件
• 类型：布尔值
• 默认：no

- name: Archive and remove source
  archive:
    path: /tmp/logs
    dest: /backups/logs.tar.gz
    remove: yes

• 描述：设置归档文件的所有者、组和权限
• 类型：字符串/数字
• 注意：遵循与file模块相同的规则

- name: Archive with specific permissions
  archive:
    path: /etc/nginx
    dest: /backups/nginx.tar.gz
    owner: root
    group: backup
    mode: '0640'

- name: Archive a single directory
  archive:
    path: /var/log/nginx
    dest: /backups/nginx_logs.tar.gz

- name: Archive multiple paths
  archive:
    path:
      - /etc/nginx
      - /var/log/nginx
    dest: /backups/nginx_full.tar.gz

- name: Archive with complex exclusions
  archive:
    path: /data
    dest: /backups/clean_data.tar.gz
    exclude:
      - "*.tmp"
      - "temp/"
      - "*.bak"
    format: bz2

- name: Archive logs on remote and download
  hosts: webservers
  tasks:
    - name: Create archive
      archive:
        path: /var/log
        dest: /tmp/logs.tar.gz
        exclude: "*.gz"
    
    - name: Download archive
      fetch:
        src: /tmp/logs.tar.gz
        dest: /local/backups/{{ inventory_hostname }}_logs.tar.gz
        flat: yes

- name: Rotate and archive logs
  hosts: all
  vars:
    log_dir: /var/log/app
    backup_dir: /backups/logs
  tasks:
    - name: Ensure backup directory exists
      file:
        path: "{{ backup_dir }}"
        state: directory
        mode: '0755'
    
    - name: Archive old logs
      archive:
        path: "{{ log_dir }}"
        dest: "{{ backup_dir }}/app_logs_$(date +%Y%m%d).tar.gz"
        exclude: "*.gz"
        remove: yes
      when: ansible_date_time.weekday != "Monday"  # 非周一执行
    
    - name: Weekly full archive
      archive:
        path: "{{ log_dir }}"
        dest: "{{ backup_dir }}/app_logs_full_$(date +%Y%m%d).tar.gz"
      when: ansible_date_time.weekday == "Monday"  # 周一执行完整归档

- name: Pre-deployment backup
  hosts: app_servers
  tasks:
    - name: Create backup of current version
      archive:
        path: /opt/app/current
        dest: /backups/app_pre_deploy_$(date +%Y%m%d_%H%M%S).tar.gz
        format: xz
        owner: appuser
        group: appgroup

- name: Package and distribute configuration
  hosts: config_server
  tasks:
    - name: Archive config files
      archive:
        path: /etc/app_config
        dest: /tmp/app_config.tar.gz
    
    - name: Distribute archive
      copy:
        src: /tmp/app_config.tar.gz
        dest: /tmp/app_config.tar.gz
      delegate_to: "{{ item }}"
      loop: "{{ groups['app_servers'] }}"

- name: Apply configuration
  hosts: app_servers
  tasks:
    - name: Unarchive config files
      unarchive:
        src: /tmp/app_config.tar.gz
        dest: /etc/
        remote_src: yes

- name: Setup daily log archiving
  hosts: log_servers
  tasks:
    - name: Ensure archive script exists
      template:
        src: templates/archive_logs.sh.j2
        dest: /usr/local/bin/archive_logs.sh
        mode: '0755'
    
    - name: Add cron job for archiving
      cron:
        name: "Daily log archiving"
        job: "/usr/local/bin/archive_logs.sh"
        hour: 2
        minute: 30

- name: Secure archive creation
  archive:
    path: /data/confidential
    dest: /secure/backups/confidential_$(date +%Y%m%d).tar.gz
    owner: root
    group: security
    mode: '0600'
  vars:
    ansible_become: yes

• 表现：Failed to find required files to archive
• 原因：指定的源路径不存在
• 解决：
  • 检查路径拼写
  • 确保路径在目标主机存在
  • 使用stat模块预先检查

• 表现：Permission denied相关错误
• 原因：
  • 无法读取源文件
  • 无法写入目标位置
• 解决：
  • 使用become提权
  • 检查目标路径权限
  • 确保SELinux/AppArmor不阻止操作

• 表现：模块执行但未实际创建归档
• 原因：幂等性设计，相同内容不会重复创建
• 解决：
  • 使用force: yes强制创建
  • 修改目标文件名（如添加时间戳）

• 增加详细输出：使用-vvv参数运行playbook
• 预先检查：使用stat或find模块验证文件存在性
• 手动验证：在目标主机手动执行归档命令测试
• 分步执行：复杂归档任务分解为多个步骤

- name: Debug archive issues
  hosts: problematic_host
  tasks:
    - name: Check source files
      find:
        paths: /data/to/archive
        recurse: yes
      register: files_to_archive
    
    - name: Display file list
      debug:
        var: files_to_archive.files
    
    - name: Try archive with debug
      archive:
        path: /data/to/archive
        dest: /tmp/debug_archive.tar.gz
      register: archive_result
    
    - name: Show archive result
      debug:
        var: archive_result