Copy
Resumo
- O copy módulo copia um arquivo da máquina local ou remota para um local na máquina remota.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
attributes | string | | Os atributos que o arquivo ou diretório resultante deve ter. Para obter os sinalizadores suportados, consulte a página do manual do chattr no sistema de destino. Essa string deve conter os atributos na mesma ordem que aquela exibida por lsattr . O operador = é assumido como padrão, caso contrário, + ou - os operadores precisam ser incluídos na string. aliases: attr |
backup | boolean | Escolhas: - false (default) - true | Crie um arquivo de backup incluindo as informações de carimbo de data / hora para que você possa obter o arquivo original de volta se, de alguma forma, o danificou incorretamente. |
checksum | string | | SHA1 checksum do arquivo que está sendo transferido.Usado para validar se a cópia do arquivo foi bem-sucedida. Se não for fornecido, o Atmosphere usará a soma de verificação calculada local do arquivo src. |
content | | | Quando usado em vez de src, define o conteúdo de um arquivo diretamente para o valor especificado. Funciona apenas quando desté um arquivo. Cria o arquivo se ele não existir. |
decrypt | boolean | Escolhas: - false - true(default) | Esta opção controla a autodecriptografia de arquivos de origem usando o vault. |
dest - required | path | | Caminho absoluto remoto para onde o arquivo deve ser copiado. Se src for um diretório, deve ser um diretório também. Se dest for um caminho inexistente e destterminar com "/" ou srcfor um diretório, destserá criado. Se dest for um caminho relativo, o diretório inicial será determinado pelo host remoto. Se src e dest forem arquivos, o diretório pai de destnão será criado e a tarefa falhará se ainda não existir. |
directory_mode | raw | | Ao fazer uma cópia recursiva, defina o modo dos diretórios.Se isso não for definido, usaremos os padrões do sistema. O modo só é definido em diretórios recém-criados e não afetará aqueles que já existiam. |
follow | boolean | Escolhas: - false (default) - true | Este sinalizador indica que os links do sistema de arquivos no destino, se existirem, devem ser seguidos. |
force | boolean | Escolhas: - false - true(default) | Influencie se o arquivo remoto sempre deve ser substituído. Se yes, o arquivo remoto será substituído quando o conteúdo for diferente da fonte.Se no, o arquivo só será transferido se o destino não existir. |
group | string | | Nome do grupo que deve possuir o arquivo / diretório, como seria alimentado para chown . |
local_follow | boolean | Escolhas: - false (default) - true | Este sinalizador indica que os links do sistema de arquivos na árvore de origem, se existirem, devem ser seguidos. |
mode | path | | As permissões do arquivo ou diretório de destino. Para aqueles que costumam se /usr/bin/chmodlembrar que os modos são, na verdade, números octais. Você deve adicionar um zero à esquerda para que o analisador YAML do Atmosphere saiba que é um número octal (como 0644ou 01777) ou citá-lo (como '644'ou '1777') para que Atmosphere receba uma string e possa fazer sua própria conversão de string em número. Fornecer um número o Atmosphere sem seguir uma dessas regras resultará em um número decimal que terá resultados inesperados. |
owner | string | | Nome do usuário que deve possuir o arquivo / diretório, como seria alimentado para chown . |
remote_src | boolean | Escolhas: - false (default) - true | Influencie se srcprecisa ser transferido ou se já está presente remotamente.Se no, ele irá pesquisar srcna máquina de origem / mestre. |
selevel | string | | A parte do nível do contexto do arquivo SELinux.Este é o atributo MLS / MCS, também conhecido como range.Quando definido como _default, ele usará a levelparte da política, se disponível. |
serole | string | | A parte da função do contexto do arquivo SELinux.Quando definido como _default, ele usará a roleparte da política, se disponível. |
setype | string | | A parte do tipo do contexto do arquivo SE Linux.Quando definido como _default, ele usará a type parte da política, se disponível. |
seuser | string | | A parte do usuário do contexto do arquivo SELinux.Por padrão, ele usa a systempolítica, quando aplicável.Quando definido como _default, ele usará a userparte da política, se disponível. |
src | path | | Caminho local para um arquivo a ser copiado para o servidor remoto.Isso pode ser absoluto ou relativo.Se o caminho for um diretório, ele será copiado recursivamente. Nesse caso, se o caminho terminar com "/", apenas o conteúdo interno desse diretório será copiado para o destino. Caso contrário, se não terminar com "/", o próprio diretório com todo o conteúdo será copiado. Esse comportamento é semelhante ao da rsyncferramenta de linha de comando. |
unsafe_writes | boolean | Escolhas: - false (default) - true | Influencie quando usar a operação atômica para evitar corrupção de dados ou leituras inconsistentes do arquivo de destino. Por padrão, este módulo usa operações atômicas para evitar corrupção de dados ou leituras inconsistentes dos arquivos de destino, mas às vezes os sistemas são configurados ou apenas interrompidos de maneiras que evitam isso. Um exemplo são os arquivos montados no docker, que não podem ser atualizados atomicamente de dentro do contêiner e só podem ser gravados de maneira insegura. Esta opção permite que o Atmosphere recorra a métodos não seguros de atualização de arquivos quando as operações atômicas falham (no entanto, não força o Atmosphere a realizar gravações inseguras). IMPORTANTE! As gravações inseguras estão sujeitas a condições de corrida e podem levar à corrupção de dados. |
validate | string | | O comando de validação a ser executado antes de copiar para o lugar. O caminho para o arquivo a ser validado é passado por meio de '% s', que deve estar presente como nos exemplos abaixo. O comando é passado de forma segura para que os recursos do shell, como expansão e canais, não funcionem. |
Exemplos
Valores Retornados
Os valores de retorno comuns são documentados aqui . A seguir estão os campos exclusivos deste módulo:
ChaveDevolvidaDescrição | | |
|---|---|---|
arquivo de backup fragmento | mudou e se backup = sim | Nome do arquivo de backup criado. Amostra:/ caminho / para / arquivo.txt.2015-02-12@22 : 09 ~ |
soma de verificação fragmento | sucesso | SHA1 checksum do arquivo após a execução da cópia. Amostra:6e642bb8dd5c2e027bf21dd923337cbb4214f827 |
dest fragmento | sucesso | Arquivo / caminho de destino. Amostra:/path/to/file.txt |
gid inteiro | sucesso | ID de grupo do arquivo, após a execução. Amostra:100 |
grupo fragmento | sucesso | Grupo do arquivo, após a execução. Amostra:httpd |
md5sum fragmento | quando apoiado | Soma de verificação MD5 do arquivo após a execução da cópia. Amostra:2a5aeecc61dc98c4d780b14b330e3282 |
modo fragmento | sucesso | Permissões do alvo, após a execução. Amostra:420 |
proprietário fragmento | sucesso | Proprietário do arquivo, após execução. Amostra:httpd |
Tamanho inteiro | sucesso | Tamanho do alvo, após a execução. Amostra:1220 |
src fragmento | mudado | Arquivo de origem usado para a cópia na máquina de destino. |
Estado fragmento | sucesso | Estado do alvo, após a execução. Amostra:Arquivo |
uid inteiro | sucesso | ID do proprietário do arquivo, após a execução. Amostra:100 |