Ini File
Resumo
- Gerencie (adicione, remova, altere) configurações individuais em um arquivo no estilo INI sem ter que gerenciar o arquivo como um todo.
- Adiciona seções ausentes se elas não existirem.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
allow_no_value | boolean | Escolhas: - false (default) - true | Permitir opção sem valor e sem o símbolo '='. |
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. |
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. |
create | boolean | Escolhas: - false - true(default) | Se definido como no, o módulo falhará se o arquivo ainda não existir. Por padrão, ele criará o arquivo se ele estiver ausente. |
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. |
no_extra_spaces | boolean | Escolhas: - false (default) - true | Não insira espaços antes e depois do símbolo '='. |
option | string | | Se definido (necessário para alterar um valor ), este é o nome da opção. Pode ser omitido se adicionar / remover uma seção inteira . |
owner | string | | Nome do usuário que deve possuir o arquivo / diretório, como seria alimentado para chown . |
path - required aliases: dest | path | | Caminho para o arquivo no estilo INI; este arquivo é criado se necessário. |
section - required | string | | Nome da section no arquivo INI. Isso é adicionado state=presentautomaticamente quando um único valor está sendo definido. Se deixado em branco ou definido como null, a opção será colocada antes da primeira section. O uso nulltambém é necessário se o formato de configuração não suportar seções. |
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 SE Linux. 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 system política, quando aplicável. Quando definido como _default, ele usará a userparte da política, se disponível. |
state | string | Escolhas: - present (default) - absent | Se definido como absenta option ou section será removida se presente em vez de criada. |
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. |
value | string | | O valor da string a ser associado a uma opção . Pode ser omitido ao remover uma opção . |
Exemplos
# Certifique-se de que "fav = limonada está na section" [drinks] "no arquivo especificado
ini_file:
path: /etc/conf
section: drinks
option: fav
value: lemonade
mode: '0600'
backup: yes
# Certifique-se de que "temperatura = frio está na section" [bebidas] "no arquivo especificado
ini_file:
path: /etc/anotherconf
section: drinks
option: temperature
value: cold
backup: yesValores Retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
changed | string | Sempre | Status da modificação do arquivo |
diff | string | Sempre | diff |
msg | string | Sempre | Mensagem com informações da execução do módulo |
path | string | Sempre | Caminho |
backup_file | string | backup_file is not None | Arquivo de backup |