Archive

6 min

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: true

Valores 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.