Fetch
Resumo
- É usado para buscar arquivos de máquinas remotas e armazená-los localmente em uma árvore de arquivos, organizada por nome de host.
- Os arquivos que já existem em dest serão sobrescritos se forem diferentes do src .
- Este módulo também é compatível com destinos Windows.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
dest - required | string | | Um diretório para salvar o arquivo. Por exemplo, se o diretório dest for /backup, um arquivo src denominado /etc/profile no host host.example.com, seria salvo em /backup/host.example.com/etc/profile. O nome do host é baseado no nome do inventário. |
fail_on_missing | boolean | Escolhas: - false - true(default) | Quando definido como yes, a tarefa falhará se o arquivo remoto não puder ser lido por algum motivo. |
flat | boolean | Escolhas: - false (default) - true | Permite que você substitua o comportamento padrão de anexar o nome do host / caminho / para / arquivo ao destino. Se dest terminar com '/', ele usará o nome de base do arquivo de origem, semelhante ao módulo de cópia. Isso pode ser útil se estiver trabalhando com um único host ou se estiver recuperando arquivos com nomes exclusivos por host. Se estiver usando vários hosts com o mesmo nome de arquivo, o arquivo será sobrescrito para cada host. |
src - required | string | | O arquivo no sistema remoto a ser buscado. Este deve ser um arquivo, não é um diretório. A busca recursiva pode ser suportada em uma versão posterior. |
validate_checksum | boolean | Escolhas: - false - true(default) | Verifique se as somas de verificação de origem e destino correspondem depois que os arquivos são buscados. |
Exemplos
# Armazene o arquivo em /tmp/fetched/host.example.com/tmp/somefile
fetch:
src: /tmp/somefile
dest: /tmp/fetched
# Especificando um caminho diretamente
fetch:
src: /tmp/somefile
dest: /tmp/prefix-{{ inventory_hostname }}
flat: yes
# Especificando um caminho de destino
fetch:
src: /tmp/uniquefile
dest: /tmp/special/
flat: yes
# Armazenar em um caminho em relação ao manual
fetch:
src: /tmp/uniquefile
dest: special/prefix-{{ inventory_hostname }}
flat: yes