Tutorial do Rocky Linux 10 / Quadlet no Rocky Linux 10: serviço Podman e início automático

Para operar contêineres Podman como um serviço no Rocky Linux 10, você pode declarar condições de execução em um arquivo Quadlet e deixar o systemd gerenciar a inicialização, parada e reinicialização. Para a inicialização automática de contêineres de usuários regulares na inicialização, você precisa verificar o target do Quadlet para iniciar e a configuração de linger que mantém o gerenciador de usuários mesmo sem login.

Relação entre Quadlet e serviços de usuário

Quadlet é um recurso do Podman que descreve condições de contêiner, como imagens, portas e volumes, em um arquivo. O gerador Quadlet do Podman, invocado pelo systemd, lê esse arquivo para criar um arquivo de serviço regular, e então ele é gerenciado pelo systemctl. Além de registrar longos comandos podman run, ele pode gerenciar a política de reinício do serviço e o alvo de inicialização juntos.

O laboratório de origem usou o usuário comum lfstudent no Rocky Linux 10.2 com Podman 5.8.2, systemd 257, gerenciamento de recursos cgroups v2 e SELinux Enforcing. Reutilize a imagem oficial do Nginx verificada na lição Podman rootless e o conteúdo local, publicando apenas no 127.0.0.1:18028. Este Quadlet é executado como um serviço de usuário; distinga seus comandos dos comandos sudo systemctl que gerenciam serviços do sistema.

podman version
podman info --format '{{.Host.Security.Rootless}}'
podman info --format '{{.Host.CgroupsVersion}}'
systemctl --user list-unit-files
podman ps -a
ss -lnt 'sport = :18028'
loginctl show-user "$(id -un)" -p Linger

O valor rootless deve ser true, e cgroups devem ser v2. Se houver serviços, containers ou materiais existentes com o mesmo nome, não os sobrescreva com novas configurações, mas verifique-os primeiro. O linger existente dessa VM era não, e para a prática, foi alterado para sim apenas para aquele usuário, sendo restaurado no final.

Confirme as opções suportadas de acordo com a versão instalada. Documentação da série Podman 5.8 Quadlet explica o caminho de pesquisa do usuário, o método de criação e a correspondência de cada configuração. Não presuma que novas opções na documentação mais recente sejam suportadas em pacotes para distribuições anteriores.

Após verificar os serviços do usuário gerenciados por esta conta, defina linger apenas para o respectivo usuário. Esta não é uma opção para um único contêiner, mas afeta a duração de vida do gerenciador de usuário para essa conta. Contas que anteriormente foram definidas como sim não são alteradas arbitrariamente para não ao final da prática.

sudo loginctl enable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger

O manual do loginctl explica que linger é um recurso que inicia o gerenciador de usuário na inicialização e o mantém ativo mesmo após o logout.

Caminho do documento e preparação do arquivo Quadlet completo

O seguinte é executado em um shell de usuário normal. O diretório de dados lf-course28 é recém-criado, reutilizando as referências de imagens registradas na Lição 27. Se a Lição 27 não foi realizada, você precisará baixar a imagem oficial e verificar a fonte e o digest para preparar primeiro o mesmo arquivo de referência.

LAB28="$HOME/lf-course28"
test ! -e "$LAB28" || { printf 'Inspect the existing lab directory and stop.\n' >&2; exit 1; }
mkdir -m 0755 "$LAB28"
mkdir -m 0755 "$LAB28/site"
printf 'LF28 Quadlet service works\n' > "$LAB28/site/index.html"
chmod 0644 "$LAB28/site/index.html"
mkdir -p "$HOME/.config/containers/systemd"
cat "$HOME/lf-course27/image.ref"

Salve o seguinte conteúdo completo em ~/.config/containers/systemd/lf-course28.container. O caminho home aqui é o caminho real do usuário da prática. Se estiver executando com outra conta, modifique o caminho de origem do Volume para corresponder a essa conta e especifique a referência da imagem com o valor que você confirmou.

test ! -e "$HOME/.config/containers/systemd/lf-course28.container" || { printf 'Inspect the existing Quadlet file and stop.\n' >&2; exit 1; }
cat > "$HOME/.config/containers/systemd/lf-course28.container" <<'EOF'
[Unit]
Description=Course28 rootless web service
[Container]
Image=docker.io/library/nginx@sha256:583b7f2fce1cdb8da5ad5c39ebd3c33b98b87d493190e548bdee1fa8c619c311
ContainerName=lf-course28-web
Label=lf.course=28
PublishPort=127.0.0.1:18028:80
Volume=/home/lfstudent/lf-course28/site:/usr/share/nginx/html:ro,Z
Pull=never
[Service]
Restart=on-failure
RestartSec=2
TimeoutStartSec=90
[Install]
WantedBy=default.target
EOF
Seção · Configurações Função neste serviço
[Container] Estes são os requisitos de execução do Podman, como imagem, nome, porta e montagem.
Pull=never Ele utiliza uma imagem salva localmente que já foi verificada. Se não estiver no cache, a inicialização falhará, então prepare-a com antecedência.
Volume=…:ro,Z Forneça novos documentos dedicados em modo somente leitura e aplique o contexto SELinux adequado para o contêiner.
Restart=on-failure Reinicie o serviço quando ele terminar de forma anormal. Isto é diferente de uma parada explícita.
WantedBy=default.target Vincule o serviço ao alvo de inicialização padrão do gerenciador de usuários.

Como esta configuração não acompanha automaticamente tags de imagem cujo conteúdo pode mudar, a atualização envolve revisar o novo digest, alterar o arquivo e, em seguida, verificar novamente. Apenas novos caminhos dedicados são usados para montagens, e não se deve montar nem alterar os rótulos de todo o diretório home.

Criação do serviço, execução e verificação real via HTTP.

systemctl --user daemon-reload
systemctl --user cat lf-course28.service
systemctl --user start lf-course28.service
systemctl --user show lf-course28.service -p ActiveState -p SubState -p FragmentPath -p UnitFileState -p NRestarts
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18028/
journalctl --user -u lf-course28.service -b -n 30 --no-pager

O serviço realmente criado estava em /run/user/1000/systemd/generator/lf-course28.service, e seu status era generated. O arquivo criado continha comandos de execução do container e comandos de parada/limpeza. Não edite este arquivo diretamente; modifique o arquivo original .container e recrie-o executando daemon-reload.

Este serviço estava ativo/em execução e retornou LF28 Quadlet service works. O tipo padrão do serviço criado é notify, e o programa de monitoramento de container conmon sinaliza seu início, mas isso sozinho não é considerado suficiente para determinar que a aplicação web responde corretamente. A resposta HTTP real e o conteúdo esperado são verificados separadamente. Um reset de conexão foi observado uma vez logo após o início, então foram usadas tentativas limitadas.

O método de aplicar systemctl --user enable lf-course28.service ao serviço criado como um arquivo normal não é usado. O gerador Quadlet lida com as configurações [Install] do arquivo original. Condições nas quais o próprio gerenciador de usuários inicia na inicialização precisam ser verificadas separadamente.

Compare a terminação anormal com uma parada explícita.

O teste tem como alvo apenas o contêiner criado neste tutorial. O ID do contêiner e o número de reinicializações são registrados antes da inicialização, e a terminação anormal é reproduzida usando o sinal SIGKILL, que é uma terminação forçada. O mesmo comando não é aplicado diretamente aos serviços de produção.

podman inspect lf-course28-web --format '{{.Id}}'
systemctl --user show lf-course28.service -p NRestarts
podman kill --signal KILL lf-course28-web
systemctl --user show lf-course28.service -p ActiveState -p SubState -p NRestarts
podman inspect lf-course28-web --format '{{.Id}}'
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18028/

No laboratório de origem, o ID do contêiner mudou de 01951ad831a1… para 610769498aeb…, o contador do serviço se tornou NRestarts=1, e uma solicitação HTTP separada retornou o conteúdo esperado. Imediatamente após a parada, as consultas podem falhar devido à espera por reinicialização ou substituição do contêiner, então compare os resultados junto com os logs do serviço e o status após a estabilização. Nessa recuperação, um novo contêiner é criado segundo as condições de execução geradas; os processos do contêiner anterior não são preservados.

systemctl --user stop lf-course28.service
systemctl --user is-active lf-course28.service
podman container exists lf-course28-web
systemctl --user start lf-course28.service

Após a parada explícita, ele estava inativo, e a verificação da existência do contêiner retornou o código de saída 1. Mesmo após 3 segundos, ele não foi recriado automaticamente, e respondeu novamente após ser iniciado manualmente. Durante a operação do serviço, o gerenciamento é baseado nas políticas e status do systemd, em vez de aplicar redundantemente uma política de reinício separada ao Podman. o documento systemd.service explica o comportamento das condições de reinício e paradas manuais.

Verifique a persistência após logout e inicialização antes do login

Inicie o serviço, encerre a sessão SSH e reconecte-se sem emitir outro comando de início. No laboratório de origem, o HTTP ainda funcionava às 02:32:48 com o horário de início do serviço inalterado às 02:30:56. Comparar os horários de início ajuda a distinguir a persistência de um serviço iniciado recentemente pelo próximo login.

systemctl --user show lf-course28.service -p ActiveState -p ActiveEnterTimestamp -p ActiveEnterTimestampMonotonic
loginctl show-user "$(id -un)" -p Linger
curl -fsS http://127.0.0.1:18028/
cat /proc/sys/kernel/random/boot_id
sha256sum "$HOME/lf-course28/site/index.html"
sudo systemctl reboot

Reiniciar irá desconectar a conexão SSH. Execute isso apenas em uma VM de prática dedicada onde o acesso ao console esteja disponível e, após reconectar, verifique o novo ID de inicialização e status antes de iniciar manualmente o serviço. O seguinte comando é uma consulta para comparar se o serviço começou antes do primeiro login.

cat /proc/sys/kernel/random/boot_id
systemctl --user show lf-course28.service -p ActiveState -p SubState -p ActiveEnterTimestampMonotonic -p UnitFileState
loginctl show-session "$XDG_SESSION_ID" -p TimestampMonotonic
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18028/
sha256sum "$HOME/lf-course28/site/index.html"
journalctl --user -u lf-course28.service -b -n 30 --no-pager

Na verificação da origem, o ID de inicialização havia mudado e o serviço estava ativo/em execução. O carimbo de data/hora de ativação do serviço, medido em microssegundos desde essa inicialização, foi de 319329250 microssegundos, e o início da primeira sessão SSH foi de 361617018 microssegundos. A comparação dentro da mesma inicialização mostra que o serviço começou cerca de 42 segundos antes do login. Os hashes do documento e do arquivo Quadlet eram os mesmos, e o corpo HTTP foi preservado.

A reinicialização desta VM levou um total de cerca de 5 minutos e 22 segundos, incluindo aproximadamente 4 minutos e 57 segundos na fase do kernel, e o auto-teste cbc-aes-aesni deixou rc=-110 avisos. A primeira tentativa de SSH durante o atraso na inicialização falhou, e a verificação foi realizada após confirmar as respostas do console e que o sistema estava pronto para a conexão. A inicialização automática do Quadlet foi confirmada, mas este resultado não deve ser interpretado como um ambiente que passou normalmente no auto-teste de criptografia. Não misture a causa do atraso na inicialização com as configurações de inicialização automática dos serviços.

Distinção entre serviços que não foram criados e serviços que não conseguiram iniciar

Quando aparece Unit not found, a geração do serviço pode ter falhado antes da execução do contêiner. Primeiro, verifique a extensão do arquivo .container , o caminho de pesquisa do usuário, o nome da seção e as chaves suportadas pela versão instalada. Se houver um arquivo criado, mas a execução falhar, verifique o cache de imagens, a fonte de montagem, as portas e os logs da aplicação.

QUADLET_UNIT_DIRS="$HOME/.config/containers/systemd" /usr/lib/systemd/system-generators/podman-system-generator --user --dryrun
systemctl --user cat lf-course28.service
systemctl --user status lf-course28.service --no-pager
journalctl --user -u lf-course28.service -b -n 40 --no-pager
podman ps -a

O laboratório de origem colocou um NotARealKey incorreto em uma pasta de teste separada fora do caminho de pesquisa real e apenas realizou uma execução de teste do gerador. O gerador retornou o código de saída 1 e unsupported key e não criou o comando de execução. A execução de teste limitada às fontes normais teve código de saída 0, e o serviço permaneceu ativo durante a execução. Você pode diagnosticar a sintaxe em um caminho separado sem corromper deliberadamente arquivos operacionais.

Após alterar as configurações originais, daemon-reload é a tarefa de reler a definição do serviço. Para recriar um contêiner já em execução com as novas configurações, você precisa realizar systemctl --user restart lf-course28.service considerando o tempo de inatividade necessário e verificar novamente o status, a resposta atual e os dados. Qualquer modificação incorreta deve ser revertida para o original armazenado e verificada novamente na mesma ordem.

Desativando a inicialização automática e limpando a prática.

Ao remover a configuração de prática, primeiro pare o serviço do usuário. Após mover o Quadlet original para fora do caminho de pesquisa e executar daemon-reload, os arquivos gerados e as conexões de destino de inicialização também são limpos. Se for um serviço que continuará a operar, não execute este comando de limpeza.

systemctl --user stop lf-course28.service
mv "$HOME/.config/containers/systemd/lf-course28.container" "$HOME/lf-course28/lf-course28.container.saved"
systemctl --user daemon-reload
systemctl --user show lf-course28.service -p LoadState
podman container exists lf-course28-web
restorecon -RFv "$HOME/lf-course28/site"
ss -lnt 'sport = :18028' 

O resultado da limpeza da fonte foi LoadState=not-found, o código de saída da verificação de existência do contêiner foi 1, e nenhum processo escutando na porta 18028. Os documentos foram mantidos intactos, e o contexto SELinux do caminho dedicado que havia terminado de ser usado foi revertido para o contexto de arquivo geral do diretório home. Apenas diretórios de configuração vazios que não existiam antes da prática foram removidos, e as configurações originais do usuário foram mantidas.

Execute a desativação de linger abaixo somente se o valor original era no e esta conta não precisa manter outros serviços de usuário após o logout. Se já era yes, preserve essa configuração.

sudo loginctl disable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger

Após a limpeza no laboratório de origem, foi restaurada para não, e as configurações locais existentes de SSH, firewall, Nginx, hosts, fstab, mapeamento de ID de usuário e SELinux foram preservadas. As definições de serviço e materiais permanecem no diretório de registro dedicado para restauração e revisão.