Systemd
Resumo
- Gerenciar unidades systemd
Parâmetros
Parâmetro | Tipo | Escolhas | Valores padrão | Comentários |
|---|---|---|---|
daemon_reexec | boolean | Escolhas:
| Execute o comando daemon_reexec antes de fazer qualquer outra operação, o gerenciador systemd serializará o estado do gerenciador. aliases: daemon-reexec |
daemon_reload | boolean | Escolhas:
| Execute o daemon-reload antes de fazer qualquer outra operação, para certificar-se de que o systemd leu as alterações. Quando definido como True, executa o daemon-reload mesmo se o módulo não iniciar ou parar nada. aliases: daemon-reload |
enabled | boolean | Escolhas:
| Se a unidade deve iniciar na inicialização. É necessário pelo menos um item de state e enabled. |
force | boolean | Escolhas:
| Se deseja substituir os links simbólicos existentes. |
masked | boolean | Escolhas:
| Quando a unidade deva ser mascarada ou não, uma unidade mascarada é impossível de iniciar. |
name | string | | Nome da unidade. Este parâmetro recebe o nome de uma unidade com a qual trabalhar. Quando nenhuma extensão é fornecida, está implícito em um service como systemd. Ao usar em um ambiente chroot, você sempre precisa especificar o nome da unidade com a extensão. Por exemplo, crond.service. aliases: service, unit |
no_block | boolean | Escolhas:
| Não espere de forma síncrona a conclusão da operação solicitada. O trabalho enfileirado continuará sem o bloqueio do Atmosphere ao ser concluído. |
scope | string | Escolhas:
| Execute systemctl dentro de um determinado escopo do gerenciador de serviço, seja como o escopo do sistema padrão system, o usuário atual do escopo user ou o escopo de todos os usuários global. Para que o systemd funcione com o 'usuário', o usuário em execução deve ter sua própria instância de dbus iniciado e acessível (requisito do systemd). O processo dbus do usuário é normalmente iniciado durante o login normal, mas não durante a execução de tarefas Atmosphere. Caso contrário, você provavelmente obterá um erro 'Falha ao conectar ao barramento: nenhum arquivo ou diretório'. |
state | string | Escolhas:
| started/stopped são ações idempotentes que não executarão comandos a menos que necessário. restarted sempre irá saltar a unidade. reloaded sempre recarregará. |
Notas
- Um dos seguintes parâmetros é obrigatório state, enabled, masked, daemon_reload, daemon_reexec, e todos exceto daemon_reload e daemon_reexec também necessitam do parâmetro name.
- Globs não são suportados no nome, ou seja, postgres * .service.
- Suporta check_mode.
Exemplos
- name: Certifique-se de que uma unidade de serviço esteja funcionando
systemd:
state: started
name: httpd
- name: Pare o serviço cron no debian, se estiver em execução
systemd:
name: cron
state: stopped
- name: Reinicie o cron do serviço em centos, em todos os casos, também emita o daemon-reload para pegar as mudanças de configuração
systemd:
state: restarted
daemon_reload: True
name: crond
- name: Recarregue o serviço httpd, em todos os casos
systemd:
name: httpd.service
state: reloaded
- name: Habilite o serviço httpd e certifique-se de que não esteja mascarado
systemd:
name: httpd
enabled: True
masked: False
- name: Habilite uma unidade de cronômetro para dnf-automatic
systemd:
name: dnf-automatic.timer
state: started
enabled: True
- name: Forçar o systemd a reler as configurações
systemd:
daemon_reload: True
- name: Forçar o systemd a se reexecutar
systemd:
daemon_reexec: True
- name: Executar um serviço de usuário quando XDG_RUNTIME_DIR não estiver definido no login remoto
systemd:
name: myservice
state: started
scope: user
environment:
XDG_RUNTIME_DIR: "/run/user/{{ myuid }}"Valores retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
status | dictionary | success | Um dicionário com os pares chave=valor retornados de`systemctl show`. |