File
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: absentValores 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 . |