Archive
Resumo
- Cria ou estende um arquivo.
- A origem e o arquivo estão no host remoto e o arquivo não é copiado para o host local.
- Os arquivos de origem podem ser excluídos após o arquivamento, especificando remove = True.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
attributes aliases: attr | 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. |
dest | path | | O nome do arquivo do arquivo de destino. O diretório pai deve existir no host remoto.Isso é necessário quando path se refere a vários arquivos, especificando um glob, um diretório ou vários caminhos em uma lista. |
exclude_path | list / elements=path | | Caminho absoluto remoto, glob ou lista de caminhos ou globs para o arquivo ou arquivos a serem excluídos da lista de caminhos e expansão glob. |
force_archive | boolean | Escolhas: - false (default) - true | Permite que você force o módulo a tratar isso como um arquivo, mesmo se apenas um único arquivo for especificado.Por padrão, o comportamento é mantido. ou seja, A quando um único arquivo é especificado, ele é apenas compactado (não arquivado). |
format | string | Escolhas: - gz (default) - bz2 - tar - xz - zip | O tipo de compactação a ser usado. |
group | string | | Nome do grupo que deve possuir o arquivo / diretório, como seria alimentado para chown . |
mode | raw | | As permissões que o arquivo ou diretório resultante deve ter.Para aqueles acostumados com / usr / bin / chmod, lembre-se de 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 a 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 . |
path - required | list / elements=path | | Caminho absoluto remoto, glob ou lista de caminhos ou globs para o arquivo ou arquivos a compactar ou arquivar. |
remove | boolean | Escolhas: - false (default) - true | Remova quaisquer arquivos de origem e árvores adicionados após adicionar ao arquivo. |
serole | 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. |
setype | 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. |
seuser | string | | A parte do tipo do contexto do arquivo SELinux. Quando definido como _default, ele usará a typeparte da política, se disponível. |
seuer fragmento | 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. |
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. |
Notas
- Requer pacotes tarfile, zipfile, gzip e bzip2 no host de destino.
- Requer lzma ou backports.lzma se estiver usando o formato xz.
- Pode produzir arquivos ou arquivos compactados gzip , bzip2 , lzma e zip .
Exemplos
# Compactar diretório / caminho / para / foo / em /path/to/foo.tgz
archive:
path: /path/to/foo
dest: /path/to/foo.tgz
# Compacte o arquivo / caminho / para / foo regular em /path/to/foo.gz e remova-o
archive:
path: /path/to/foo
remove: yes
# Crie um arquivo zip de / path / to / foo
archive:
path: /path/to/foo
format: zip
# Crie um arquivo bz2 de vários arquivos, com raiz em / path
archive:
path:
- /path/to/foo
- /path/wong/foo
dest: /path/file.tar.bz2
format: bz2
# Crie um arquivo bz2 de um caminho globbed, enquanto exclui dirnames específicos
archive:
path:
- /path/to/foo/*
dest: /path/file.tar.bz2
exclude_path:
- /path/to/foo/bar
- /path/to/foo/baz
format: bz2
# Crie um arquivo bz2 de um caminho global, enquanto exclui um conjunto de dirnames
archive:
path:
- /path/to/foo/*
dest: /path/file.tar.bz2
exclude_path:
- /path/to/foo/ba*
format: bz2
# Use gzip para compactar um único arquivo (ou seja, não o arquive primeiro com tar)
archive:
path: /path/to/foo/single.file
dest: /path/file.gz
format: gz
# Crie um arquivo tar.gz de um único arquivo.
archive:
path: /path/to/foo/single.file
dest: /path/file.tar.gz
format: gz
force_archive: trueValores Retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
arquivado lista / elementos = string | list / elements=string string | sucesso | Quaisquer arquivos compactados ou adicionados ao arquivo. |
arcroot fragmento | | sempre | A raiz do arquivo. |
expansion_exclude_paths lista / elementos = string | list / elements=string | sempre | A lista de caminhos de exclusão correspondentes do argumento exclude_path. |
caminhos_expandidos lista / elementos = string | list / elements=string | sempre | A lista de caminhos correspondentes do argumento de caminhos. |
ausência de lista / elementos = string | list / elements=string | sucesso | Todos os arquivos que estavam faltando na fonte. |
Estado fragmento | string | sempre | O estado atual do arquivo arquivado. Se 'ausente', nenhum arquivo de origem foi encontrado e o arquivo não existe. Se 'compactar', o arquivo de origem do arquivo está no estado compactado. Se 'arquivar', o arquivo ou os caminhos de origem estão atualmente arquivados. Se 'incompleto', então um arquivo foi criado, mas nem todos os caminhos de origem foram encontrados. |
Valores Retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
state | str | Sempre | O estado atual do arquivo arquivado. Se absent, nenhum arquivo de origem foi encontrado e o arquivo não existe. Se compress, o arquivo de origem do arquivo está no estado compactado. Se archive, o arquivo de origem ou os caminhos estão arquivados no momento. Se incomplete, um arquivo foi criado, mas nem todos os caminhos de origem foram encontrados. |
missing | list | Sucesso | Todos os arquivos que estavam faltando na fonte. |
archived | list | Sucesso | Todos os arquivos que foram compactados ou adicionados ao arquivo. |
arcroot | str | Sempre | A raiz do arquivo. |
expanded_paths | list | Sempre | A lista de caminhos correspondentes do argumento paths. |
expanded_exclude_paths | list | Sempre | A lista de caminhos de exclusão correspondentes do argumento exclude_path. |