Gerenciamento de serviços OpenRC no Alpine: rc-update, rc-service, runlevels e rc-status

Objetivo

Habilitar um serviço para iniciar no boot, iniciá-lo ou pará-lo imediatamente e verificar o que está de fato em execução no Alpine Linux 3.2x, sabendo para onde vai (ou não vai) por padrão o log do OpenRC durante o boot.

Pré-requisitos

Acesso root; o pacote que fornece o serviço já instalado com apk add.

Passos

1. Entenda a divisão em dois comandos: a documentação do Alpine afirma que "the init system manages the services, startup and shutdown of your computer" (o sistema init gerencia os serviços, a inicialização e o desligamento do computador) e separa o controle em tempo de execução da configuração de boot. Para manipular um serviço em execução, usa-se rc-service; para habilitá-lo no boot, usa-se rc-update. A instalação de um pacote não faz nenhuma das duas coisas automaticamente.
2. Controle um serviço agora: rc-service sshd start, rc-service sshd stop ou rc-service sshd status. Esses comandos têm efeito imediato e não alteram a configuração de boot; parar sshd ou networking dentro de uma sessão SSH pode derrubar essa sessão.
3. Habilite um serviço para iniciar no boot: rc-update add sshd default o adiciona ao runlevel default, exemplo da própria documentação. Se o nome do runlevel for omitido (rc-update add sshd), o alvo é o runlevel que estiver ativo no momento. "Enabling a service means putting it in a runlevel" e "a runlevel is simply a directory in" /etc/runlevels, contendo um link simbólico para o script do serviço em /etc/init.d.
4. Para desabilitá-lo: rc-update delete sshd o remove do runlevel atual; rc-update delete sshd -a o remove de todos os runlevels em que ele está, a forma documentada de desvincular totalmente um serviço.
5. Para ver tudo o que está configurado nos runlevels: rc-update show -v lista os serviços por runlevel, incluindo (com -v) os que não estão atribuídos a nenhum. Para ver tudo o que está de fato em execução no runlevel atual: rc-status, que por padrão lista os serviços do runlevel ativo, ou rc-status boot para um runlevel específico.
6. Se for preciso capturar a saída dos scripts durante o boot para diagnóstico, saiba que ela não é capturada por padrão. O /etc/rc.conf padrão do OpenRC upstream informa que rc_logger "launches a logging daemon to log the entire rc process to" /var/log/rc.log (no Linux, não no runlevel sysinit) e o traz comentado (#rc_logger="NO"); verifique o arquivo no host e depois defina rc_logger="YES". Isso registra a sequência de inicialização do próprio OpenRC, não necessariamente o stdout/stderr de um daemon em execução, que depende do log do próprio daemon (em geral via syslog, por meio de um serviço de syslog instalado e habilitado separadamente).

Resultado esperado

rc-update show -v lista o serviço no runlevel desejado; rc-status mostra o serviço como iniciado, depois de habilitado e de ter passado por um boot ou ter sido iniciado manualmente; depois de ativar rc_logger, o arquivo /var/log/rc.log existe e contém entradas da sequência de boot a partir do boot seguinte.

Limites e base de verificação

O comando rc-service <name> start, executado em um serviço que não está em nenhum runlevel, vale apenas para o boot atual e é revertido na próxima reinicialização, a menos que o serviço também seja adicionado com rc-update; por outro lado, rc-update add sozinho não inicia o serviço imediatamente. Remover um serviço de todos os runlevels com rc-update delete -a não o interrompe se ele estiver em execução; se a intenção for um desligamento completo, pare-o explicitamente antes.