Tutorial do Rocky Linux 10 / Podman rootless no Rocky Linux 10: portas, volumes e dados persistentes

Usar Podman sem root no Rocky Linux 10 permite que contêineres sejam executados com privilégios de usuário comum. No entanto, para manter os dados com segurança ao substituir contêineres, é necessário verificar individualmente a faixa de exposição de portas, os dados armazenados no host, o mapeamento de ID de usuário e o contexto SELinux.

Verificando o status sem root em um ambiente de usuário comum

Os containers funcionam isolando os processos, o sistema de arquivos e a rede de um aplicativo enquanto compartilham o kernel do host. Rootless significa executar sem privilégios de root no host. Mesmo que você apareça como root dentro do container, você não é o mesmo que o usuário root do host.

O ambiente de laboratório de origem era Rocky Linux 10.2, Podman 5.8.2, crun 1.30.1, com SELinux em modo Enforcing, e o usuário comum lfstudent tem um ID de usuário e grupo (UID·GID) de 1000. O administrador instala os pacotes, mas os comandos subsequentes podman são executados no shell de login desse usuário comum. Se você usar sudo podman, acessará um armazenamento de imagens separado e contêineres pertencentes ao root. Não misture esses dois ambientes.

sudo dnf install podman
id
podman version
podman info --format '{{.Host.Security.Rootless}}'
podman info --format '{{.Store.GraphRoot}}'
grep "^$(id -un):" /etc/subuid /etc/subgid
podman unshare cat /proc/self/uid_map /proc/self/gid_map

A consulta sem root deve retornar true, e o armazenamento de imagens deste usuário era /home/lfstudent/.local/share/containers/storage. A configuração de ID subordinado fornece um intervalo para mapear UIDs e GIDs adicionais dentro de contêineres para o usuário regular. Nesta VM, lfstudent:524288:65536 já está registrado, então não foi modificado. Se não existir ou se sobrepor ao intervalo de outro usuário, o administrador deve verificar toda a alocação e configurá-la; não adicione os números de exemplo como estão.

Documentação do Rocky Linux rootless Podman explica o mapeamento de usuários, armazenamento local e condições de sessão de login. O exercício de origem usou armazenamento local XFS e com cgroups v2 gerenciando recursos de processo. Não assuma que um diretório home compartilhado ou outras configurações de sessão sejam o mesmo ambiente.

Fontes das imagens e registro dos digests

Uma imagem agrupa os programas e arquivos iniciais usados para criar um contêiner; um registro distribui imagens. Este exemplo usa a imagem docker.io/library/nginx do Docker Hub, mantida através do repositório oficial dos Dockerfiles do NGINX. Use o nome de imagem totalmente qualificado em vez de um nome curto que omita seu registro e repositório.

LAB27="$HOME/lf-course27"
test ! -e "$LAB27" || { printf 'Inspect the existing lab directory and stop.\n' >&2; exit 1; }
podman ps -a
podman images
mkdir -m 0755 "$LAB27"
podman pull docker.io/library/nginx:stable-alpine
podman image inspect docker.io/library/nginx:stable-alpine --format '{{.Id}} {{.Digest}} {{.RepoDigests}} {{.Architecture}}'
podman image inspect docker.io/library/nginx:stable-alpine --format '{{index .RepoDigests 0}}' > "$LAB27/image.ref"
IMAGE27=$(cat "$LAB27/image.ref")

Se o mesmo diretório de prática ou contêiner lf-course27-web já existir, pare e verifique o estado existente. O teste de ausência test ! -e retorna o código de saída 0 se o caminho não existir e 1 se existir, e não exibe uma mensagem separada quando normal. Comandos subsequentes são executados no mesmo shell de usuário regular e, se recém-logado, LAB27 e IMAGE27 são redefinidos a partir do arquivo de registro.

stable-alpine é uma tag cujo conteúdo pode mudar. Nesta imagem amd64, o Nginx era 1.30.6, e a referência registrada foi docker.io/library/nginx@sha256:583b7f2fce1cdb8da5ad5c39ebd3c33b98b87d493190e548bdee1fa8c619c311. Os RepoDigests podem incluir tanto índices multi-arquitetura quanto referências de imagens de plataforma, e o digest desta imagem de plataforma era sha256:bb8f722b4be005fcd7827816a136ab779fd40185d85b5171be915cc7fc0575c7. Como esses valores se referem a alvos diferentes, números diferentes não são imediatamente considerados como corrupção.

Os comandos posteriores reutilizam a referência da imagem registrada e passam --pull=never para usar a imagem local. Fixar o digest é uma maneira de especificar claramente o alvo para esta execução, e não é uma função para aplicar atualizações de segurança automaticamente. Ao atualizar a imagem, você deve verificar novamente a nova origem e o novo digest e o comportamento da aplicação. A documentação podman pull explica os formatos de referência e opções de download.

Porta de loopback e diretório de documentos somente leitura

Vamos criar um diretório de documentos no host e usar um bind mount para vinculá-lo ao caminho de documentos do container. O 127.0.0.1:18027:80 abaixo conecta a própria porta de loopback 18027 da VM à porta 80 do container. Mesmo que você esteja executando a VM no Windows, o "host" aqui se refere à VM Rocky Linux executando o Podman.

ss -lnt 'sport = :18027'
mkdir -m 0755 "$LAB27/site"
printf 'LF27 persistent version A\n' > "$LAB27/site/index.html"
chmod 0644 "$LAB27/site/index.html"
podman run -d --name lf-course27-web --label lf.course=27 --pull=never -p 127.0.0.1:18027:80 -v "$LAB27/site:/usr/share/nginx/html:ro,Z" "$IMAGE27"
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18027/
podman port lf-course27-web
podman logs --tail 15 lf-course27-web

Execute quando uma porta estiver disponível. O conteúdo esperado é LF27 persistent version A, e a pesquisa de porta é 80/tcp → 127.0.0.1:18027. Foi observado um reset na primeira conexão imediatamente após o início, então o curl é configurado para tentar apenas um número limitado de vezes. Se as tentativas repetidas falharem, não apenas espere; verifique o início real em podman ps -a e os logs.

Omitir o IP do host no -p 18027:80 pode alterar o escopo de exposição. Desta vez, como é um teste local, foi vinculado explicitamente ao loopback, e nenhuma regra de firewall ou NAT de VM foi adicionada. A exposição externa envolve projetar e verificar separadamente o endereço de recebimento real, o caminho da rede e a política. Portas e opções de montagem podem ser verificadas na documentação oficial do podman run .

Opções de Montagem Significado e Escopo
ro Torna a montagem somente leitura no contêiner. É separado do proprietário do host modificar o arquivo original.
Z Rótula novamente o caminho original com um contexto SELinux não compartilhado adequado para este contêiner. Use apenas em diretórios dedicados recém-criados.
z Aplica um contexto compartilhado entre vários contêineres. Primeiro, determine se o escopo de compartilhamento necessário é exigido.
U Uma opção para alterar recursivamente a propriedade original de acordo com o mapeamento de usuário. Não é necessário para práticas simples de leitura somente, e o verdadeiro proprietário do arquivo do host pode ser alterado.

Aplicar :Z em todo o diretório home ou do sistema pode alterar o contexto de arquivo de outros programas também, então este exemplo apenas vincula um novo caminho site. Se dois contêineres independentes aplicarem :Z no mesmo caminho, a última alteração de contexto pode afetar o acesso ao contêiner anterior.

Na comparação de origem, quando o primeiro documento estava no estado user_home_t, usar apenas :ro resultou em HTTP 403 e logs de negação de acesso ao arquivo. Quando o mesmo material foi vinculado a :ro,Z, container_file_t e a categoria dedicada foi aplicada, retornou 200. As permissões gerais não foram alteradas para 0777, nem o SELinux foi desativado.

ls -Zd "$LAB27/site" "$LAB27/site/index.html"
podman exec lf-course27-web sh -c 'printf denied > /usr/share/nginx/html/blocked.txt'
printf 'LF27 persistent version B\n' > "$LAB27/site/index.html"
curl -fsS http://127.0.0.1:18027/

O teste de escrita é um comando que falha de propósito. Um código de saída diferente de zero é esperado com Read-only file system, e blocked.txt não deveria ser criado. Por outro lado, o arquivo original modificado no host foi fornecido imediatamente como LF27 persistent version B. Um mount somente leitura restringe escritas através desse mount do container. Isso não garante preservação permanente nem impede mudanças no lado do host.

Recrie o contêiner para verificar a preservação dos dados.

Vamos distinguir entre as camadas de arquivos graváveis dentro do contêiner e a montagem vinculada do host. Primeiro, crie um arquivo temporário interno e registre o ID atual do contêiner junto com o hash dos dados do host.

podman exec lf-course27-web sh -c 'printf ephemeral > /tmp/lf27-ephemeral'
podman inspect lf-course27-web --format '{{.Id}}'
sha256sum "$LAB27/site/index.html"
podman rm -f lf-course27-web
podman run -d --name lf-course27-web --label lf.course=27 --pull=never -p 127.0.0.1:18027:80 -v "$LAB27/site:/usr/share/nginx/html:ro,Z" "$IMAGE27"
podman inspect lf-course27-web --format '{{.Id}}'
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18027/
podman exec lf-course27-web test ! -e /tmp/lf27-ephemeral
sha256sum "$LAB27/site/index.html"

Mesmo que criado com o mesmo nome, o ID do contêiner mudou. O corpo B do documento do host e o SHA-256 b1601d1a277b5d3b6aab1018d58594ac3cd4eab0e2195d95064a83aedd95523b foram preservados, mas /tmp/lf27-ephemeral dentro do contêiner não estava presente. Isso foi confirmado sob a condição de deletar o contêiner e criar um novo, e não apenas parar e iniciar.

Porque um mount de vínculo continua a usar o caminho fora do contêiner, excluir o contêiner não significa que os dados serão apagados. No entanto, se o arquivo do host for excluído ou o dispositivo de armazenamento for danificado, os dados serão perdidos, então um backup separado é necessário. Você também pode usar um volume nomeado gerenciado pelo Podman, mas nesta aula, a regeneração real e a comparação de hash foram realizadas no mount de vínculo mencionado acima.

Entendendo o mapeamento de ID de usuário e a propriedade de arquivos

id
podman exec lf-course27-web id
podman exec lf-course27-web id nginx
podman top lf-course27-web user huser
podman unshare cat /proc/self/uid_map

O usuário padrão de execução do contêiner era root, mas a coluna de usuário do host do podman top era 1000. O UID 101 do contêiner do worker Nginx apareceu como 524388 no host. Não é necessário que o nome de usuário da imagem corresponda ao nome de usuário do host; o mapeamento numérico em cada namespace realmente afeta o acesso.

Mapeamento desta VM Valores visíveis no host
UID do contêiner 0 Executado por usuário regular UID 1000
UIDs do contêiner de 1 a 65536 Intervalo alocado a partir do subuid 524288
UID do contêiner 101 524288 + (101 - 1) = 524388

Esses números correspondem ao mapeamento padrão observado para este usuário. Eles podem variar conforme as opções de --userns e as faixas de subuid atribuídas a outros usuários. A documentação do podman unshare explica por que o UID e GID de um usuário comum aparecem como 0 nesse namespace.

Abaixo está um exemplo de como alterar a propriedade e revertê-la apenas para um novo arquivo de teste. Não aplique a materiais da web ou a todo o diretório home. Se o arquivo já existir, não sobrescreva e pare.

test ! -e "$LAB27/ownership.txt" || { printf 'Inspect the existing test file and stop.\n' >&2; exit 1; }
printf 'mapped uid test\n' > "$LAB27/ownership.txt"
chmod 0600 "$LAB27/ownership.txt"
podman unshare chown 101:101 "$LAB27/ownership.txt"
stat -c '%u:%g %a' "$LAB27/ownership.txt"
podman unshare stat -c '%u:%g %a' "$LAB27/ownership.txt"
cat "$LAB27/ownership.txt"
podman unshare chown 0:0 "$LAB27/ownership.txt"
stat -c '%u:%g %a' "$LAB27/ownership.txt"
rm -- "$LAB27/ownership.txt"

A pesquisa de host foi 524388:524388 600, a pesquisa dentro do namespace foi 101:101 600. Nesse estado, o comando cat executado pelo usuário comum falhou com um erro de permissão negada, como esperado. Quando revertido com podman unshare chown 0:0, tornou-se 1000:1000 600 no host. É importante não confundir 0 neste namespace com root no host.

Verifique o comportamento de logout e limpe o contêiner

A configuração do usuário de origem era Linger=no. Quando a sessão SSH de origem foi encerrada, o laboratório observou que o contêiner Nginx recebeu um SIGTERM e desligou normalmente junto com a terminação do gerenciador de usuário do systemd. podman run -d significa executar sem se conectar ao terminal, e não é uma configuração que garante a continuidade do serviço após reinicialização ou logout. Para execução de longo prazo, tanto o serviço do usuário quanto as condições de persistência da sessão devem ser configurados juntos.

podman ps -a
podman inspect lf-course27-web --format '{{.State.Status}}'
podman logs --tail 20 lf-course27-web
loginctl show-user "$(id -un)" -p Linger
podman rm -f lf-course27-web
restorecon -RFv "$LAB27/site"
ls -Zd "$LAB27/site" "$LAB27/site/index.html"
stat -c '%u:%g %a' "$LAB27/site/index.html"
ss -lnt 'sport = :18027' 

Após confirmar que se trata do seu contêiner de prática, apenas remova seu nome. Para manter os materiais como arquivos domésticos regulares quando o contêiner não usar mais o caminho, você pode restaurar o contexto. Neste ambiente, container_file_t, que é configurável pelo usuário, foi mantido apenas com restorecon -R, e após aplicar -RF ao caminho exato de prática, retornou para user_home_t. Não é aplicado a outros caminhos de contêiner em uso.

Após a limpeza, o contêiner de prática e o listener na porta 18027 desapareceram, e o Documento B permaneceu com UID·GID 1000, modo 0644. As configurações existentes de SSH, Nginx, firewall, hosts e fstab, assim como os mapeamentos de usuário originais, foram preservados. Os pacotes do Podman, o suporte a políticas e o cache de imagens permaneceram. As alterações de pacotes devem ser comparadas com uma linha de base registrada; não exclua substituições locais existentes do SELinux apenas para corresponder a outro laboratório.