AnsibleByExample

Ansible fetch — Copy from Windows

Beginneransiblefetchmodulefiles
2024-01-013By Luca Berton

Lesson 1 of 15 in Foundations

Ansible Foundations to Production — full curriculum
  1. 1. Introduction to Ansible and Automation
  2. 2. Installing and Configuring Ansible
  3. 3. Running Ad-Hoc Commands
  4. 4. Writing Your First Playbook
  5. 5. Understanding and Using Modules
  6. 6. Variables and Facts
  7. 7. Conditionals and Loops
  8. 8. Handlers and Idempotency
  9. 9. Structuring Projects with Roles
  10. 10. Inventory Management
  11. 11. Using Ansible Vault for Secrets
  12. 12. Debugging and Troubleshooting
  13. 13. Real-World Automation Examples
  14. 14. Final Project: Deploy a Web Server
  15. 15. Bonus - What's Next with Ansible?
View path overview →

How to Copy files from Windows remote hosts with Ansible?

Ansible Copy files from Windows remote hosts

  • ansible.builtin.fetch
  • Copy files from remote nodes

Today we're talking about the Ansible module fetch. The full name is ansible.builtin.fetch which means is part of the collection of modules "builtin" with ansible and shipped with it. This module is pretty stable and out for years. The purpose is to copy files from remote locations. Please note that the opposite is done by Ansible copy module for Linux and Ansible win_copy module for Windows.

Parameters

  • dest path - the local path
  • src string - Remote file path
  • fail_on_missing boolean - yes / no
  • validate_checksum boolean - yes / no
  • flat boolean - no / yes

The parameter list is pretty wide but I'll summarize the most useful. The only required parameters are "dest" which specifies a directory to save the file into and the "src" specifies the source files in the remote hosts. It must be a file, not a directory. The "fail_on_missing" boolean is set to true so the task is going to fail if the file doesn't exist. The file is going to be transferred and validated in the source and the destination with a checksum. If we don't want this behavior we could override with the "validate_checksum" option. The "flat" option allows you to override the default behavior of appending hostname/path/to/file to the destination.

Playbook

Copy files from Windows remote hosts with Ansible Playbook.

code

---
- name: fetch module Playbook
  hosts: all
  become: false
  vars:
    myfile: 'C:\Users\vagrant\Desktop\example.txt'
    dump_dir: "logs"
  tasks:
    - name: fetch file
      ansible.builtin.fetch:
        src: "{{ myfile }}"
        dest: "{{ dump_dir }}"

execution

ansible-pilot $ ansible-playbook -i virtualmachines/win/inventory copy\ files\ from\ remote\ hosts/fetch-windows.yml
PLAY [fetch module Playbook] **************************************************************************
TASK [Gathering Facts] ****************************************************************************
ok: [WindowsServer]
TASK [fetch file] *********************************************************************************
changed: [WindowsServer]
PLAY RECAP ****************************************************************************************
WindowsServer              : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
ansible-pilot $

idempotency

ansible-pilot $ ansible-playbook -i virtualmachines/win/inventory copy\ files\ from\ remote\ hosts/fetch-windows.yml
PLAY [fetch module Playbook] **************************************************************************
TASK [Gathering Facts] ****************************************************************************
ok: [WindowsServer]
TASK [fetch file] *********************************************************************************
ok: [WindowsServer]
PLAY RECAP ****************************************************************************************
WindowsServer              : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
ansible-pilot $

before execution

fetch before execution

after execution

ansible-pilot $ ls -al copy\ files\ from\ remote\ hosts/logs 
total 0
drwxr-xr-x  3 lberton  staff   96 Jan 31 12:34 .
drwxr-xr-x  5 lberton  staff  160 Jan 31 12:34 ..
drwxr-xr-x  3 lberton  staff   96 Jan 31 12:34 WindowsServer
ansible-pilot $ ls -al copy\ files\ from\ remote\ hosts/logs/WindowsServer 
total 0
drwxr-xr-x  3 lberton  staff  96 Jan 31 12:34 .
drwxr-xr-x  3 lberton  staff  96 Jan 31 12:34 ..
drwxr-xr-x  3 lberton  staff  96 Jan 31 12:34 C:
ansible-pilot $ ls -al copy\ files\ from\ remote\ hosts/logs/WindowsServer/C:/Users/vagrant/Desktop
total 8
drwxr-xr-x  3 lberton  staff  96 Jan 31 12:34 .
drwxr-xr-x  3 lberton  staff  96 Jan 31 12:34 ..
-rw-r--r--  1 lberton  staff  15 Jan 31 12:34 example.txt
ansible-pilot $ cat copy\ files\ from\ remote\ hosts/logs/WindowsServer/C:/Users/vagrant/Desktop/example.txt
example content%
ansible-pilot $

code with ❤️ in GitHub

Conclusion

Now you know how to Copy files from Windows remote hosts with Ansible.

All Tutorials