File

4 min

Resumo

Defina atributos de arquivos, links simbólicos ou diretórios.
Como alternativa, remova arquivos, links simbólicos ou diretórios.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
access_time	string		Este parâmetro indica a hora em que o tempo de acesso ao arquivo deve ser definido. Deve ser preserve quando nenhuma modificação for necessária, YYYYMMDDHHMM.SS ao usar o formato de hora padrão ou now. Padrão None significa que preserve é o padrão para state=[file,directory,link,hard] e now é o padrão para state=touch.
access_time_format	string	Default: - "% Y% m% d% H% M.% S"	Quando usado com access_time, indica o formato de hora que deve ser usado. Com base no formato Python padrão (veja o documento time.strftime).
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.
follow	boolean	Escolhas: - false - true(default)	Este sinalizador indica que os links do sistema de arquivos, se existirem, devem ser seguidos.
force	boolean	Escolhas: - false (default) - true	Força a criação de links simbólicos em dois casos: o arquivo fonte não existe (mas aparecerá mais tarde); o destino existe e é um arquivo (portanto, precisamos desvincular o path arquivo e criar um link simbólico para o srcarquivo no lugar dele).
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 0644 ou 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.
modification_time	string		Este parâmetro indica a hora em que a hora de modificação do arquivo deve ser definida. Deve ser preservequando nenhuma modificação for necessária, YYYYMMDDHHMM.SS ao usar o formato de hora padrão ou now. O padrão é Nenhum, o que significa que preserveé o padrão para state=[file,directory,link,hard] e now é o padrão para state=touch.
modification_time_format	string	Default: - "% Y% m% d% H% M.% S"	Quando usado com modification_time, indica o formato de hora que deve ser usado.Com base no formato Python padrão (veja o documento time.strftime).
owner	string		Nome do usuário que deve possuir o arquivo / diretório, como seria alimentado para chown .
path - required aliases: dest, name	path		Caminho para o arquivo que está sendo gerenciado.
recurse	boolean	Escolhas: - false (default) - true	Defina recursivamente os atributos de arquivo especificados no conteúdo do diretório. Isso se aplica apenas quando stateestá definido como directory.
selevel	string		A parte do nível do contexto do arquivo SE Linux. 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 SELinux. Quando definido como _default, ele usará a typeparte 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 do arquivo ao qual vincular.Isso se aplica apenas a state=linke state=hard, pois state=link, isso também aceitará um caminho não existente. Os caminhos relativos são relativos ao arquivo que está sendo criado ( path), que é como o comando Unix ln -s SRC DEST trata os caminhos relativos.
state	string	Escolhas: - file (default) - absent - directory - hard - link - touch	Se absent, os diretórios serão excluídos recursivamente e os arquivos ou links simbólicos serão desvinculados. No caso de um diretório, se diff for declarado, você verá os arquivos e pastas excluídos listados em path_contents. Observe que absentnão causará file falha se path não existir, pois o estado não foi alterado. Se directory, todos os subdiretórios intermediários serão criados se eles não existirem. Se file, sem quaisquer outras opções, isso funcione principalmente como uma 'estatística' e retornará o estado atual de path. Se hard, o link físico será criado ou alterado. Se link, o link simbólico será criado ou alterado. Se touch, um arquivo vazio será criado se pathnão existir, enquanto um arquivo ou diretório existente receberá acesso ao arquivo atualizado e horários de modificação (semelhante à maneira como touch funciona a partir da 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.

Exemplos

# Altere a propriedade do arquivo, grupo e permissões
  file:
    path: /etc/foo.conf
    owner: foo
    group: foo
    mode: '0644'

# Crie um arquivo inseguro
  file:
    path: /work
    owner: root
    group: root
    mode: '1777'

# Crie um link simbólico
  file:
    src: /file/to/link/to
    dest: /path/to/symlink
    owner: foo
    group: foo
    state: link

# Crie dois links físicos
  file:
    src: '/tmp/{{ item.src }}'
    dest: '{{ item.dest }}'
    state: hard
  loop:
    - { src: x, dest: y }
    - { src: z, dest: k }

# Toque em um arquivo, usando modos simbólicos para definir as permissões (equivalente a 0644)
  file:
    path: /etc/foo.conf
    state: touch
    mode: u=rw,g=r,o=r

# Toque no mesmo arquivo, mas adicione / remova algumas permissões
  file:
    path: /etc/foo.conf
    state: touch
    mode: u+rw,g-wx,o-rwx

# Toque novamente no mesmo arquivo, mas não altere os horários, isso torna a tarefa idempotente
  file:
    path: /etc/foo.conf
    state: touch
    mode: u+rw,g-wx,o-rwx
    modification_time: preserve
    access_time: preserve

# Crie um diretório se ele não existir
  file:
    path: /etc/some_directory
    state: directory
    mode: '0755'

# Atualizar modificação e tempo de acesso de determinado arquivo
  file:
    path: /etc/some_file
    state: file
    modification_time: now
    access_time: now

# Defina o tempo de acesso com base em segundos a partir do valor da época
  file:
    path: /etc/another_file
    state: file
    access_time: '{{ "%Y%m%d%H%M.%S" | strftime(stat_var.stat.atime) }}'

# Alterar recursivamente a propriedade de um diretório
  file:
    path: /etc/foo
    state: directory
    recurse: yes
    owner: foo
    group: foo

# Remover arquivo (excluir arquivo)
  file:
    path: /etc/foo.txt
    state: absent

# Remover diretório recursivamente
  file:
    path: /etc/foo
    state: absent

Valores Retornados

Chave	Tipo	Retornado quando	Descrição
dest	string	state = touch, state = hard, state = link	Arquivo / caminho de destino, igual ao valor passado para o caminho .
path	string	state = absent, state = directory, state = file	Arquivo / caminho de destino, igual ao valor passado para o caminho .