ansible.builtin.get_url: descarga archivos de HTTP, HTTPS o FTP al ejemplo de nodo

Nota

Este módulo es parte de ansible-base e incluido en todas las instalaciones de Ansible. En la mayoría de los casos, puede utilizar el nombre corto del módulo get_url incluso sin especificar el collections: palabra clave. A pesar de eso, le recomendamos que utilice el FQCN para facilitar la vinculación a la documentación del módulo y evitar conflictos con otras colecciones que puedan tener el mismo nombre de módulo.

Nuevo en la versión 0.6: de ansible.builtin

• Sinopsis
• Parámetros
• Notas
• Ver también
• Ejemplos de
• Valores devueltos

Sinopsis

• Descarga archivos de HTTP, HTTPS o FTP al servidor remoto. El servidor remoto debe tener acceso directo al recurso remoto.
• De forma predeterminada, si una variable de entorno <protocol>_proxy está configurado en el host de destino, las solicitudes se enviarán a través de ese proxy. Este comportamiento se puede anular estableciendo una variable para esta tarea (consulte estableciendo el medio ambiente), o usando la opción use_proxy.
• Las redirecciones HTTP pueden redirigir de HTTP a HTTPS, por lo que debe asegurarse de que su entorno de proxy para ambos protocolos sea correcto.
• Desde Ansible 2.4 cuando se ejecuta con --check, hará una solicitud HEAD para validar la URL pero no descargará el archivo completo ni lo verificará con hashes.
• Para los destinos de Windows, use el ansible.windows.win_get_url módulo en su lugar.

Parámetros

Notas

Nota

• Para los destinos de Windows, use el ansible.windows.win_get_url módulo en su lugar.

Ver también

Ver también

ansible.builtin.uri

La documentación oficial sobre el ansible.builtin.uri módulo.

ansible.windows.win_get_url

La documentación oficial sobre el ansible.windows.win_get_url módulo.

Ejemplos de

- name: Download foo.conf
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    mode: '0440'

- name: Download file and force basic auth
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    force_basic_auth: yes

- name: Download file with custom HTTP headers
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    headers:
      key1: one
      key2: two

- name: Download file with check (sha256)
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    checksum: sha256:b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c

- name: Download file with check (md5)
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    checksum: md5:66dffb5228a211e61d6d7ef4a86f5758

- name: Download file with checksum url (sha256)
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    checksum: sha256:http://example.com/path/sha256sum.txt

- name: Download file from a file path
  get_url:
    url: file:///tmp/afile.txt
    dest: /tmp/afilecopy.txt

- name: < Fetch file that requires authentication.
        username/password only available since 2.8, in older versions you need to use url_username/url_password
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    username: bar
    password: '{{ mysecret }}'

Valores devueltos

Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:

Autores

• Jan-Piet Mens (@jpmens)