Systemd

5 min

Resumo

Gerenciar unidades systemd

Parâmetros

Parâmetro	Tipo	Escolhas \| Valores padrão	Comentários
daemon_reexec	boolean	Escolhas: False ← True	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: False ← True	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: False True	Se a unidade deve iniciar na inicialização. É necessário pelo menos um item de state e enabled.
force	boolean	Escolhas: False True	Se deseja substituir os links simbólicos existentes.
masked	boolean	Escolhas: False True	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: False ← True	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: system ← user global	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: reloaded restarted started stopped	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`.