Tutorial do Debian 13 / Gerenciar serviços Quadlet, reinícios, linger e início antes do login
Para operar contêineres sem root como serviços de usuário no Debian 13, você cria o Quadlet original e gerencia os serviços gerados pelo gerenciador systemd do usuário. A reinicialização em terminação anormal, a parada explícita, a persistência após logout e a inicialização automática durante o boot são condições diferentes, portanto cada uma deve ser verificada separadamente. Neste tutorial, criamos contêineres web e volumes separados, preservamos o valor original de linger e, em seguida, verificamos a resposta HTTP.
Distinguir o arquivo-fonte Quadlet do serviço gerado
Quadlet é um recurso do Podman que lê arquivos com extensões como .container para gerar serviços systemd. Usuários comuns geralmente colocam a fonte em ~/.config/containers/systemd e a gerenciam com systemctl --user. Se você modificar um arquivo .service gerado diretamente em /run/user/UID/systemd/generator, ele desaparecerá na próxima regeneração, por isso você deve corrigir o arquivo original.
Este tutorial foi executado em um ambiente Podman 5.4.2, cgroup v2, com gerenciador de usuário systemd. De acordo com a documentação do Quadlet do Podman 5.4.2, usamos as chaves suportadas Image, ContainerName, PublishPort, Volume e Pull. Para evitar problemas onde os serviços não são gerados ao usar diretamente chaves da documentação mais recente, primeiro verifique a versão instalada e a saída do gerador.
O serviço gerado não é algo gerenciado via systemctl enable como um arquivo de serviço permanente comum. Se você colocar WantedBy=default.target na seção [Install] do arquivo original, o gerador cria um link para o target padrão do usuário. Não tente mudar de contas adicionando User= em um arquivo original sem root; trabalhe como o usuário normal real.
Preparar a sessão do usuário, a imagem e o volume dedicado
Use o ambiente Podman do usuário normal verificado na lição anterior. Apenas as instalações de pacotes são feitas com sudo, e os seguintes comandos podman e systemctl --user são executados como usuário normal. A porta 8080 e o nome lf-web28 devem estar disponíveis. Este exemplo usa lf-web28-data, que é diferente do volume da lição anterior.
sudo apt install podman uidmap passt fuse-overlayfs curl
podman --version
podman info --format json
systemctl --user is-system-running
loginctl show-user "$(id -un)" -p Linger
ss -ltn
Em um novo terminal Bash, execute o seguinte bloco de preparação. Linger se aplica a todo o gerenciador de usuário da conta, então considere o escopo de manutenção antes de usá-lo em uma conta com outros serviços de usuário. Mantenha um registro separado do valor original para evitar alterar uma conta que originalmente era yes para no durante a limpeza.
set -euo pipefail
record="$HOME/lf-course28-linger-before.txt"
qdir="$HOME/.config/containers/systemd"
for p in "$record" "$qdir/lf-web28.container"; do
if test -e "$p"; then
echo "Path already exists: $p" >&2
exit 1
fi
done
if podman container exists lf-web28; then exit 1; fi
if podman volume exists lf-web28-data; then exit 1; fi
loginctl show-user "$(id -un)" -p Linger --value > "$record"
cat "$record"
podman pull docker.io/library/httpd:2.4.71-trixie
image=$(podman image inspect docker.io/library/httpd:2.4.71-trixie --format '{{index .RepoDigests 0}}')
case "$image" in
docker.io/library/httpd@sha256:*) ;;
*) echo "Check the image reference." >&2; exit 1 ;;
esac
podman image exists "$image"
podman volume create lf-web28-data
podman run --rm --network none -v lf-web28-data:/data --entrypoint /bin/sh "$image" -c 'printf "LF QUADLET 28\n" > /data/index.html'
mkdir -p "$qdir"
Este exercício busca a imagem com antecedência e usa um digest. Pull=never no serviço impede que ele tente baixar na inicialização, então, se a imagem não estiver local, a inicialização falhará. Não presuma que ela se recuperará automaticamente mesmo se a imagem for deletada; estabeleça procedimentos para retenção e atualização de imagens juntos. O diretório raiz da web da imagem oficial do httpd pode ser verificado em guia da imagem httpd.
Escrever o Quadlet completo e inspecionar a saída do gerador
Salve toda a configuração abaixo no mesmo terminal. Como o CONF do heredoc não está entre aspas, o $image definido anteriormente será expandido para o digest real. Este arquivo é a configuração para aquele usuário.
cat > "$qdir/lf-web28.container" <<CONF
[Unit]
Description=LF rootless web lab 28
[Container]
Image=$image
ContainerName=lf-web28
PublishPort=127.0.0.1:8080:80
Volume=lf-web28-data:/usr/local/apache2/htdocs:ro
Pull=never
[Service]
Restart=on-failure
RestartSec=2
TimeoutStartSec=180
[Install]
WantedBy=default.target
CONF
| Configurações | Significado |
|---|---|
| PublishPort=127.0.0.1:8080:80 | Publique a porta apenas no loopback da VM. |
| Volume=...:ro | Monte o volume de dados da web como somente leitura. |
| Restart=on-failure | Solicite ao systemd para reiniciar serviços que saíram devido a falha. |
| RestartSec=2 | Aguarde entre reinícios. Isso não remove o limite para falhas repetidas. |
| TimeoutStartSec=180 | Defina um limite de tempo para aguardar o início do serviço. Isso não verifica o status de prontidão HTTP. |
| WantedBy=default.target | O gerador se conecta para iniciar a partir do target padrão do gerenciador de usuários. |
Antes de o gerenciador reler o arquivo-fonte, limite a busca do gerador ao diretório do exercício, examine a saída e execute daemon-reload. --dryrun é um recurso para visualizar os conteúdos gerados e não inicia o contêiner.
QUADLET_UNIT_DIRS="$qdir" /usr/lib/systemd/system-generators/podman-system-generator --user --dryrun
systemctl --user daemon-reload
systemctl --user cat lf-web28.service
systemctl --user show lf-web28.service -p FragmentPath -p SourcePath
Nesta VM, o SourcePath era lf-web28.container no diretório home, e o FragmentPath era /run/user/1000/systemd/generator/lf-web28.service. O arquivo gerado incluía comandos Podman run/cleanup e o digest da imagem. Se o serviço não existir, verifique o caminho da fonte, a extensão do arquivo, as chaves suportadas e erros do gerador, e não crie manualmente nem sobrescreva o arquivo gerado.
Habilitar linger, iniciar o serviço e verificar HTTP
Habilitar linger inicia o gerenciador de usuário desta conta na inicialização e o mantém disponível após o logout. Como o manual loginctl do Debian explica, isso afeta o gerenciador de usuário, e não apenas este serviço único. No laboratório registrado, linger valia inicialmente no e foi alterado para yes apenas para verificação.
sudo loginctl enable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
systemctl --user start lf-web28.service
systemctl --user is-active lf-web28.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
podman port lf-web28
A resposta esperada é LF QUADLET 28. O estado active significa que o serviço gerado está ativo, e isso não equivale ao HTTP estar pronto. Na verificação, uma solicitação imediatamente após o início falhou com Empty reply from server (resposta vazia do servidor), mas teve sucesso depois que estava pronto. Não atribua todas as falhas a um atraso de prontidão; tente a solicitação novamente logo após, e se continuar falhando, verifique os seguintes logs e o status das portas e volumes.
systemctl --user status lf-web28.service --no-pager
journalctl --user -u lf-web28.service -n 50 --no-pager
podman logs lf-web28
podman inspect lf-web28
Comparar o reinício após falhas com uma parada explícita
A seguinte comparação é limitada a contêineres de prática dedicados que fornecem apenas arquivos estáticos. Não aplique testes de término forçado como estão em serviços de escrita reais, como bancos de dados. Primeiro, registre o ID do contêiner e a contagem de reinicializações, depois envie um sinal KILL para produzir uma falha de término.
first=$(podman inspect lf-web28 --format '{{.Id}}')
systemctl --user show lf-web28.service -p NRestarts
podman kill --signal KILL lf-web28
sleep 3
systemctl --user is-active lf-web28.service
systemctl --user show lf-web28.service -p NRestarts
podman inspect lf-web28 --format '{{.Id}}'
curl --noproxy '*' -fsS http://127.0.0.1:8080/
Na verificação, o NRestarts aumentou, o ID do contêiner mudou e as respostas HTTP foram novamente bem-sucedidas. Os 3 segundos são um exemplo para iniciar a verificação e não garantem o tempo de recuperação em todos os ambientes. Se falhas repetidas atingirem o limite, corrija a causa encontrada no diário, depois use reset-failed e reinicie apenas o serviço afetado. As contagens de reinicialização podem ser redefinidas por reinicializações do administrador e não são usadas como estão para estatísticas de falhas de longo prazo.
Agora solicite explicitamente uma parada no systemd. Ter Restart=on-failure não significa que o serviço será reiniciado automaticamente após uma solicitação de parada do administrador. As condições da política seguem a explicação sobre reinício de serviço no systemd.
systemctl --user stop lf-web28.service
sleep 3
if systemctl --user is-active --quiet lf-web28.service; then
echo "The explicitly stopped service is still active." >&2
exit 1
fi
systemctl --user show lf-web28.service -p ActiveState
podman ps -a --filter name=lf-web28
systemctl --user start lf-web28.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
Após a parada, o resultado foi inactive e o contêiner dedicado também foi removido. O exemplo para com um erro se permanecer ativo, e se parar normalmente, verifica ActiveState=inactive antes de reiniciar. Se uma resposta não estiver pronta imediatamente após a inicialização, verifique o status e os logs conforme descrito na seção anterior e tente novamente a solicitação. Os volumes permanecem independentemente da remoção do contêiner.
Verificar a inicialização antes do login e a permanência após logout
Após a reinicialização, faça login via SSH com o mesmo usuário, e o serviço estar ativo por si só não prova que ele inicia automaticamente antes do login. Isso ocorre porque serviços gerenciados pelo usuário podem iniciar durante o processo de login. Neste tutorial, uma sonda independente que realiza requisições HTTP GET como root, que não depende de serviços de usuário, foi programada para registrar respostas e listas de sessões em horários em que nenhuma sessão de login existe.
Para verificar da mesma forma, após confirmar que todos os caminhos dedicados abaixo não existem, uma sonda de gerenciamento como root pode ser preparada. Ela não modifica timers existentes ou logs em outros servidores. Mesmo que o código seja executado como root, ele realiza requisições HTTP GET e consultas de sessão e grava seu próprio log de evidências exclusivo de root; não adiciona dependências como user@1000.service.
for p in /var/backups/lf-debian13-28 /usr/local/sbin/lf-boot28-probe /etc/systemd/system/lf-boot28-probe.service /etc/systemd/system/lf-boot28-probe.timer; do
if test -e "$p"; then echo "Already exists: $p" >&2; exit 1; fi
done
sudo install -d -m 700 /var/backups/lf-debian13-28
sudo tee /usr/local/sbin/lf-boot28-probe > /dev/null <<'PROBE'
#!/bin/bash
set -euo pipefail
label=${1:-boot}
case "$label" in boot|logout) ;; *) exit 1;; esac
dest="/var/backups/lf-debian13-28/$label-$(cat /proc/sys/kernel/random/boot_id).txt"
{
date -u --iso-8601=seconds
cat /proc/uptime
loginctl list-sessions --no-legend
for i in $(seq 1 15); do
if curl --noproxy '*' --max-time 2 -fsS http://127.0.0.1:8080/ | grep -Fx 'LF QUADLET 28'; then echo HTTP_PROBE_PASSED; exit 0; fi
sleep 1
done
exit 1
} > "$dest" 2>&1
PROBE
sudo chmod 700 /usr/local/sbin/lf-boot28-probe
sudo tee /etc/systemd/system/lf-boot28-probe.service > /dev/null <<'UNIT'
[Unit]
Description=Read-only HTTP evidence before user login for lab 28
After=network-online.target
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/lf-boot28-probe boot
UNIT
sudo tee /etc/systemd/system/lf-boot28-probe.timer > /dev/null <<'TIMER'
[Unit]
Description=One boot HTTP evidence for lab 28
[Timer]
OnBootSec=35s
AccuracySec=1s
Unit=lf-boot28-probe.service
[Install]
WantedBy=timers.target
TIMER
sudo systemctl daemon-reload
sudo systemctl enable lf-boot28-probe.timer
Primeiro, teste se ele é mantido após o logout. Se o agendamento abaixo for bem-sucedido, faça logout de todas as sessões interativas do usuário alvo, espere pelo menos 70 segundos e, em seguida, faça login novamente para ler os dados registrados. Manter a sessão aberta imediatamente após o agendamento não é uma verificação de logout. Se uma unidade transitória com o mesmo nome permanecer, verifique o estado existente e evite a execução duplicada.
sudo systemd-run --unit=lf-logout28-probe --on-active=15s --timer-property=AccuracySec=1s /usr/local/sbin/lf-boot28-probe logout
A sonda registra a lista de sessões antes de seu loop de tentativa, então essa lista sozinha é insuficiente se você fizer login enquanto ela ainda estiver tentando. Após reconectar, inspecione sudo journalctl -b -u lf-logout28-probe.service --no-pager e compare o horário de conclusão bem-sucedida do trabalho com o horário de login mostrado por loginctl session-status. Use a consulta de diário equivalente para lf-boot28-probe.service após a reinicialização. Aceite evidências apenas se a sonda tiver tido sucesso e terminado antes do usuário alvo fazer login. Considere os deslocamentos de fuso horário ao comparar o carimbo de data/hora UTC do arquivo com os horários do diário/sessão. As esperas de 70/90 segundos permitem as tentativas limitadas da sonda sob carga normal; apenas o tempo decorrido não é prova.
Após efetuar login novamente, verifique o tempo da sonda, a lista de sessões e HTTP_PROBE_PASSED usando o seguinte comando. Diferencie entre a sessão do usuário da classe manager e a sessão de login real da classe de usuário. Se a conta de destino ainda mantinha outra sessão de login durante a sondagem, o resultado não comprova a permanência do serviço após o encerramento de todas as sessões dessa conta.
sudo cat "/var/backups/lf-debian13-28/logout-$(cat /proc/sys/kernel/random/boot_id).txt"
sudo systemctl show lf-logout28-probe.service -p Result -p ExecMainStatus
A seguir estão os passos para reiniciar normalmente a VM após verificar o acesso à console e o impacto em outros serviços em operação. Anote o ID de inicialização antes de começar e, após o reinício, mantenha esse usuário desconectado por pelo menos 90 segundos. Acessar antes da contagem de tempo terminar pode confundir os resultados, então compare o tempo registrado com o tempo de login real também.
cat /proc/sys/kernel/random/boot_id
sudo systemctl reboot
Após efetuar login novamente, verifique se o novo ID de inicialização é diferente do anterior e leia os registros dessa inicialização. Se não houver log ou se ele falhar, não é considerado um sucesso de inicialização automática.
cat /proc/sys/kernel/random/boot_id
sudo cat "/var/backups/lf-debian13-28/boot-$(cat /proc/sys/kernel/random/boot_id).txt"
systemctl --user is-active lf-web28.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
Na VM de verificação, o HTTP foi bem-sucedido por volta de 46 segundos após a nova inicialização, quando existia apenas a sessão do gerenciador e o estado era lingering. Um teste de logout separado também teve sucesso quando não havia sessão de usuário real. A sondagem inicial programada com a precisão padrão do temporizador não foi usada como evidência porque se sobrepunha ao novo login de verificação, e foi verificada novamente especificando AccuracySec=1s. O critério é se os resultados permaneceram antes do login, e não o tempo exato de execução.
Remover o arquivo-fonte e o volume e restaurar linger
Parar irá interromper a execução atual, mas se o original com [Install] permanecer, ele pode voltar na próxima inicialização do gerenciador de usuários. Para remover a configuração de prática, exclua o original correspondente e execute daemon-reload para limpar os links gerados. O primeiro bloco abaixo deve ser executado como um usuário regular.
systemctl --user stop lf-web28.service
rm -- "$HOME/.config/containers/systemd/lf-web28.container"
systemctl --user daemon-reload
podman ps -a --filter name=lf-web28
podman volume rm lf-web28-data
Excluir volumes significa deletar dados, então primeiro salve qualquer conteúdo necessário. Em seguida, remova apenas os timers e scripts do sistema de prática. Registros de evidências podem ser deixados em um caminho de backup acessível apenas ao root.
sudo systemctl disable --now lf-boot28-probe.timer
sudo rm -- /etc/systemd/system/lf-boot28-probe.timer /etc/systemd/system/lf-boot28-probe.service /usr/local/sbin/lf-boot28-probe
sudo systemctl daemon-reload
original_linger=$(cat "$HOME/lf-course28-linger-before.txt")
case "$original_linger" in
no) sudo loginctl disable-linger "$(id -un)" ;;
yes) echo "Preserving the original enabled linger state." ;;
*) echo "Cannot determine the original linger value." >&2; exit 1 ;;
esac
loginctl show-user "$(id -un)" -p Linger
ss -ltn
Na limpeza real, o arquivo-fonte Quadlet, os serviços gerados, os contêineres, os volumes e as sondas próprios do exercício foram removidos, a porta de escuta 8080 foi fechada, e o linger voltou à sua configuração original no. Imagens existentes e outros serviços foram preservados. Ao decidir se deve continuar executando serviços de usuários regulares, gerencie junto os tempos de vida das contas, retenção de dados, e procedimentos de atualização e restauração.




