Tutorial do Rocky Linux 10 / Gerenciar serviços systemd com drop-ins e ativação por socket

Ao alterar as configurações de serviço do systemd no Rocky Linux 10, diferencie recarregar definições de unidade de aplicar novas configurações em um processo em execução . Use um drop-in para as substituições necessárias, em vez de editar uma unidade empacotada diretamente. Verifique os valores efetivos do gerenciador, o processo real e as novas conexões juntos.

Diferencie unidades, serviços, sockets e status de inicialização

O systemd gerencia serviços e outros recursos do sistema. Cada definição gerenciada é uma unidade . Uma .service define como executar um processo; uma .socket define sockets de escuta e o serviço a ser ativado sob demanda. Um socket é um ponto de extremidade para comunicação.

As unidades fornecidas pelo pacote geralmente são verificadas em /usr/lib/systemd/system , e as configurações adicionadas pelo administrador podem ser encontradas em /etc/systemd/system . O caminho da unidade carregada e os arquivos de complementos podem ser consultados em FragmentPath e DropInPaths . As regras para o caminho completo são explicadas no manual systemd.unit .

Comando Papel Principal Pontos para Distinguir
start / stop Iniciar / parar a unidade atual É separado das configurações de inicialização.
enable / disable Crie ou remova links simbólicos de ativação de acordo com [Install] Executar apenas ativar não inicia o processo atual.
daemon-reload Recarrega as configurações da unidade gerenciadas pelo systemd Não substitui automaticamente o comando ou as variáveis de ambiente dos processos em execução.
reload Solicitar o recarregamento das configurações personalizadas no serviço O serviço deve suportar isso.
restart Pare a unidade e depois a inicie novamente O processo será substituído e a interrupção do serviço pode ocorrer.

O manual oficial do systemctl distingue entre reload do serviço e daemon-reload do gerenciador systemd. enable --now e disable --now solicitam, respectivamente, habilitar o início automático e iniciar agora, ou desabilitar o início automático e parar agora, portanto, é necessário adquirir o hábito de verificar os dois estados separadamente.

Crie uma unidade de prática que não se sobreponha aos serviços existentes

O laboratório de origem utilizou uma VM dedicada com Rocky Linux 10.2. systemd era 257-23.el10_2.2, GNU coreutils era 9.5, e Python era 3.12.15, com SELinux em modo enforcing mantido. Não modifique unidades SSH ou de serviços web que estão realmente em operação.

Verifique se uma conta geral lfstudent existe para a aula. Se você usar uma conta de prática diferente, substitua User= na unidade abaixo por essa conta. Se houver unidades existentes ou arquivos suplementares com o mesmo nome, pare e examine o conteúdo primeiro.

id lfstudent
systemctl --version
systemctl list-unit-files 'lf-course20*'
sudo ls -ld /etc/systemd/system/lf-course20* 2>/dev/null
sudo ss -lntp '( sport = :19020 )'

Nesta VM, a unidade específica e o caminho não existiam, e a porta 19020 também estava disponível. A ausência de um caminho para ls é um resultado que pode ser esperado durante esta verificação prévia. O procedimento não é excluir arquivos quando nomes correspondentes são encontrados e depois continuar.

Execute sudoedit /etc/systemd/system/lf-course20.service para criar o novo arquivo da unidade e salve todo o conteúdo abaixo.

[Unit]
Description=Course20 isolated process lifecycle lab

[Service]
Type=simple
User=lfstudent
Environment=COURSE20_VALUE=base20
ExecStart=/usr/bin/sleep 300

[Install]
WantedBy=multi-user.target

Este serviço executa sleep sob uma conta geral e aguarda 300 segundos. COURSE20_VALUE é uma variável de ambiente inofensiva usada para comparação. Após 300 segundos, ele pode se tornar inativo se terminar naturalmente, então ao comparar processos, verifique se está em execução e reinicie se necessário para comparação imediata.

sudo restorecon -v /etc/systemd/system/lf-course20.service
sudo systemd-analyze verify /etc/systemd/system/lf-course20.service
sudo systemctl daemon-reload
systemctl is-enabled lf-course20.service
systemctl is-active lf-course20.service
sudo systemctl enable lf-course20.service
systemctl is-enabled lf-course20.service
systemctl is-active lf-course20.service
sudo systemctl start lf-course20.service
systemctl show lf-course20.service -p FragmentPath -p DropInPaths \
  -p MainPID -p ActiveState -p ExecStart -p Environment

Na verificação da fonte, a unidade era inicialmente disabled / inactive, após habilitar passou a ser enabled / inactive, e após iniciar passou a ser active. O habilitar criou um link sob multi-user.target.wants de acordo com o [Install] desta unidade. Isso não é interpretado como o resultado de um teste de inicialização, e neste exercício, o link é removido durante a limpeza. Se houver erros de verificação de sintaxe, resolva-os antes da ativação e do início.

Adicione o drop-in e verifique os resultados do recarregamento do gerenciador.

Um drop-in é um pequeno arquivo suplementar que adiciona ou substitui algumas configurações da unidade original. Normalmente é escrito em unit-name.d/*.conf e é afetado pela ordem e prioridade de múltiplos arquivos. Na operação real, systemctl edit também pode ser usado, mas desta vez, um novo arquivo é criado diretamente para comparar o tempo de salvamento do arquivo e o recarregamento do gerenciador.

sudo mkdir /etc/systemd/system/lf-course20.service.d
sudoedit /etc/systemd/system/lf-course20.service.d/10-course.conf

O conteúdo completo do novo arquivo suplementar é o seguinte. Ele é criado apenas nos caminhos onde se confirma que o arquivo original não existe.

[Service]
Environment=COURSE20_VALUE=override20
ExecStart=
ExecStart=/usr/bin/sleep 600

Após zerar a lista existente de comandos de execução com ExecStart= vazio, um novo comando foi especificado. Para substituir comandos de execução em um serviço simples típico, você precisa entender esta regra de inicialização da lista. Consulte o manual systemd.service e as regras de ExecStart.

systemctl show lf-course20.service -p NeedDaemonReload -p MainPID
sudo systemctl daemon-reload
systemctl cat lf-course20.service
systemctl show lf-course20.service -p DropInPaths -p MainPID \
  -p ExecStart -p Environment

Depois que o arquivo foi adicionado, o laboratório de origem observou NeedDaemonReload=yes . Após recarregar as definições da unidade, DropInPaths listou o novo arquivo, o comando de execução do gerente tornou-se sleep 600 e o valor do ambiente tornou-se override20 . No entanto, o ID do processo em execução (PID) permaneceu inalterado .

systemctl cat Tenha cuidado mesmo ao apenas visualizar a saída. No momento em que o gerenciador systemd ainda não reconheceu o novo drop-in, a saída pode estar sem o novo arquivo junto com um aviso de alteração. Após reler, compare novamente o caminho, o conteúdo do arquivo e os valores efetivos reconhecidos pelo gerenciador systemd.

Comparar o processo real após reiniciar o serviço

O comando a seguir lê apenas a linha de comando do processo atual e uma variável prática, não as configurações do gerenciador. Outras variáveis de ambiente podem conter informações confidenciais, então o ambiente completo não é exibido na tela. Se o processo terminou ou o PID é 0, inicie-o novamente e então compare.

course_pid=$(systemctl show lf-course20.service -p MainPID --value)
sudo python3 - "$course_pid" <<'PY'
from pathlib import Path
import sys
proc = Path('/proc') / sys.argv[1]
print(proc.joinpath('cmdline').read_bytes().replace(bytes([0]), b' ').decode())
for item in proc.joinpath('environ').read_bytes().split(bytes([0])):
    if item.startswith(b'COURSE20_VALUE='):
        print(item.decode())
PY

O resultado da fonte após apenas o daemon-reload foi o seguinte. As configurações do gerenciador são novos valores, mas os processos já em execução mantiveram seu comando e ambiente originais.

/usr/bin/sleep 300
COURSE20_VALUE=base20

Este serviço de prática não definiu ExecReload, que possui seu próprio comportamento de releitura. A seguinte solicitação de reload é uma comparação para verificar que esta operação não é suportada.

sudo systemctl reload lf-course20.service
systemctl is-active lf-course20.service
sudo systemctl restart lf-course20.service
systemctl show lf-course20.service -p MainPID -p ExecStart -p Environment

O reload real falhou com status de saída 3 e Job type reload is not applicable, mas o serviço existente estava ativo. Após a reinicialização, o PID mudou, e se você executar o bloco de verificação de processo real acima novamente, poderá ver sleep 600 e COURSE20_VALUE=override20. O suporte para reload varia de serviço para serviço, então este resultado não se generaliza para todos os serviços.

Verifique se a remoção do arquivo suplementar o restaura para o original. Após remover apenas o arquivo suplementar criado desta vez, recarregue e reinicie. Não exclua quaisquer outros drop-ins se existirem.

sudo rm -- /etc/systemd/system/lf-course20.service.d/10-course.conf
sudo rmdir /etc/systemd/system/lf-course20.service.d
sudo systemctl daemon-reload
sudo systemctl restart lf-course20.service
systemctl show lf-course20.service -p DropInPaths -p ExecStart -p Environment
sudo systemctl disable --now lf-course20.service

Na verificação, DropInPaths estavam vazios, e o processo real também retornou para sleep 300 / base20. O último comando limpou tanto a execução atual quanto o link de inicialização automática. Não use uma operação abrangente como systemctl revert apenas para remover este drop-in: isso também pode remover outros arquivos de unidade personalizados ou substituições.

Verifique se as solicitações de socket executam o serviço.

A ativação por socket é uma forma na qual o systemd espera por uma conexão e inicia o serviço quando necessário. O próximo exercício é um serviço de eco simples que recebe solicitações apenas de 127.0.0.1:19020 na mesma VM. Ele devolve os bytes recebidos e não adiciona nenhuma porta de firewall externa.

Crie um novo arquivo /etc/systemd/system/lf-course20-echo.socket e salve todo o seguinte conteúdo.

[Unit]
Description=Course20 loopback echo socket lab

[Socket]
ListenStream=127.0.0.1:19020
Accept=yes

[Install]
WantedBy=sockets.target

Salve o seguinte conteúdo em um novo arquivo /etc/systemd/system/lf-course20-echo@.service. Um nome que tenha @ é um modelo que cria uma instância para cada conexão.

[Unit]
Description=Course20 one-connection echo worker

[Service]
User=lfstudent
ExecStart=/usr/bin/cat
StandardInput=socket
StandardOutput=socket

Accept=yes é uma configuração que executa um serviço a partir de um template para cada conexão. Como o socket é passado para a entrada e saída padrão, cat pode retornar exatamente o que recebe. Nem todos os programas suportam ativação por socket. A relação entre o método de entrega e os nomes pode ser encontrada no manual systemd.socket .

sudo restorecon -v /etc/systemd/system/lf-course20-echo.socket \
  /etc/systemd/system/lf-course20-echo@.service
sudo systemd-analyze verify /etc/systemd/system/lf-course20-echo.socket \
  /etc/systemd/system/lf-course20-echo@.service
sudo systemctl daemon-reload
sudo systemctl start lf-course20-echo.socket
systemctl show lf-course20-echo.socket -p ActiveState -p Listen -p Accept
systemctl list-units --all 'lf-course20-echo@*' --no-pager

Neste ponto, o socket está ativo e aguardando no endereço de loopback, mas pode não haver ainda um serviço por conexão. Novamente, antes da primeira solicitação, o número de instâncias era 0. Não se assume que os estados do socket e do processo do trabalhador devam ser os mesmos.

Execute o seguinte cliente Python completo dentro da VM. Envie uma linha e finalize o envio, depois colete as respostas até que o par feche a conexão. TCP (Protocolo de Controle de Transmissão) não garante que a mensagem inteira chegará em um único recv , então leia repetidamente.

python3 - <<'PY'
import socket

message = b'echo20-ok' + bytes([10])
with socket.create_connection(('127.0.0.1', 19020), timeout=3) as connection:
    connection.sendall(message)
    connection.shutdown(socket.SHUT_WR)
    received = b''
    while True:
        part = connection.recv(1024)
        if not part:
            break
        received += part
    if received != message:
        raise RuntimeError('echo response mismatch')
    print(received.decode(), end='')
PY
systemctl is-active lf-course20-echo.socket
sudo journalctl -u 'lf-course20-echo@*' --since '5 minutes ago' --no-pager

A saída esperada é echo20-ok , e o socket permanece ativo. No laboratório de origem, os bytes retornados de duas conexões diferentes correspondiam às solicitações, e o diário registrou que diferentes instâncias de serviço foram iniciadas e encerradas normalmente para cada conexão. O laboratório de origem também verificou separadamente o exemplo completo de cliente acima. Se o socket continuar em escuta após o fim do processo worker, a próxima solicitação inicia uma nova instância do serviço.

Verifique a parada do socket e a remoção do arquivo de prática.

Encerrar apenas uma instância de serviço não significa que toda a funcionalidade tenha sido parada. Para evitar novas conexões, verifique também o caminho do socket ativo. Este socket de prática não tinha inicialização automática ativada, então você pode parar o socket atual.

sudo systemctl stop lf-course20-echo.socket
sudo ss -lntp '( sport = :19020 )'
systemctl list-units --all 'lf-course20-echo@*' --no-pager

Não deve haver recepção na porta 19020. Após o desligamento no laboratório de origem, uma nova conexão TCP falhou com o número de erro 111, correspondendo ao Connection refused. Se o socket estiver ativado em outro serviço, as condições de ativação para a próxima inicialização devem ser organizadas separadamente, e o comando de prática não deve ser aplicado diretamente ao socket operacional existente.

Verifique os três arquivos criados desta vez, que não estavam presentes inicialmente, quanto ao seu conteúdo e nomes, e depois remova-os. As conexões de inicialização automática e de drop-in já foram limpas na etapa anterior. Se uma instância de gerenciamento de conexão ainda estiver em execução no modelo, prossiga após verificar que a solicitação foi encerrada.

sudo systemctl disable --now lf-course20.service
sudo rm -- /etc/systemd/system/lf-course20.service \
  /etc/systemd/system/lf-course20-echo.socket \
  /etc/systemd/system/lf-course20-echo@.service
sudo systemctl daemon-reload
systemctl show lf-course20.service lf-course20-echo.socket -p LoadState -p ActiveState
sudo ss -lntp '( sport = :19020 )'
getenforce

Após a limpeza, a unidade era LoadState=not-found e ActiveState=inactive, e sua porta de escuta estava ausente. O conteúdo original da unidade SSH e PID, arquivos de firewall e política de execução correspondiam ao estado pré-laboratório. Verifique separadamente os arquivos salvos da unidade, valores do gerenciador, processos em execução e resultados de conexão para distinguir salvar uma definição de alterar um serviço em execução.