ansible/docsite/rst/modules/get_url.rst
2012-10-08 07:44:38 -04:00

1.8 KiB

get_url

0.6

Downloads files from HTTP, HTTPS, or FTP to the remote server. The remote server must have direct access to the remote resource.

parameter required default choices comments
url yes
    HTTP, HTTPS, or FTP URL
    dest yes
      absolute path of where to download the file to.If dest is a directory, the basename of the file on the remote server will be used. If a directory, thirsty=yes must also be set.
      thirsty no no
      • yes
      • no
      if yes, will download the file every time and replace the file if the contents change. if no, the file will only be downloaded if the destination does not exist. Generally should be yes only for small local files. prior to 0.6, acts if yes by default. (added in Ansible 0.7)
      others no
        all arguments accepted by the file module also work here

        Example from Ansible Playbooks

        get_url url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440
        


        Notes

        This module doesn't yet support configuration for proxies or passwords.