Pular para o conteúdo principal

Testes do Podman

Copiar e executar os scripts localizados em scripts/podman_testing no servidor de teste Podman.

Configuração Inicial e Gerenciamento​

  1. copy.docker.duplistatus.local: Copia a imagem do Docker do daemon local do Docker para o Podman (para testes locais).
  2. copy.docker.duplistatus.remote: Copia a imagem do Docker de um servidor de desenvolvimento remoto para o Podman (requer acesso SSH).
    • Crie a imagem no servidor de desenvolvimento usando: docker build . -t wsj-br/duplistatus:devel
  3. start.duplistatus: Inicia o contêiner no modo sem privilégios (rootless).
  4. pod.testing: Testa o contêiner dentro de um pod do Podman (com privilégios de root).
  5. stop.duplistatus: Interrompe o pod e remove o contêiner.
  6. clean.duplistatus: Interrompe contêineres, remove pods e limpa imagens antigas.

Configuração de DNS​

Os scripts detectam e configuram automaticamente as configurações de DNS do sistema host:

  • Detecção Automática: Usa resolvectl status (systemd-resolved) para extrair servidores DNS e domínios de pesquisa
  • Suporte de Fallback: Recorre à análise de /etc/resolv.conf em sistemas sem systemd
  • Filtragem Inteligente: Filtra automaticamente endereços de localhost e servidores de nomes IPv6
  • Funciona com:
    • Tailscale MagicDNS (100.100.100.100)
    • Servidores DNS corporativos
    • Configurações de rede padrão
    • Configurações DNS personalizadas

Nenhuma configuração manual de DNS é necessária - os scripts lidam com isso automaticamente!

Monitoramento e Verificações de Saúde​

  • check.duplistatus: Verifica os logs, conectividade e saúde da aplicação.

Comandos de Depuração​

  • logs.duplistatus: Mostra os logs do pod.
  • exec.shell.duplistatus: Abre um shell no container.
  • restart.duplistatus: Para o pod, remove o container, copia a imagem, cria o container e inicia o pod.

Fluxo de Uso​

Servidor de Desenvolvimento​

Criar a imagem do Docker no servidor de desenvolvimento:

docker build . -t wsj-br/duplistatus:devel

Servidor Podman​

  1. Transfira a imagem do Docker:
    • Use ./copy.docker.duplistatus.local se o Docker e o Podman estiverem na mesma máquina
    • Use ./copy.docker.duplistatus.remote se estiver copiando de um servidor de desenvolvimento remoto (requer o arquivo .env com REMOTE_USER e REMOTE_HOST)
  2. Inicie o contêiner com ./start.duplistatus (autônomo, sem privilégios)
    • Ou use ./pod.testing para testar no modo pod (com root)
  3. Monitore com ./check.duplistatus e ./logs.duplistatus
  4. Pare com ./stop.duplistatus ao finalizar
  5. Use ./restart.duplistatus para um ciclo completo de reinicialização (parar, copiar imagem, iniciar)
    • Observação: Este script atualmente faz referência a copy.docker.duplistatus, que deve ser substituído pela variante .local ou .remote
  6. Use ./clean.duplistatus para remover contêineres, pods e imagens antigas

Testando a Aplicação

Se você estiver executando o servidor Podman na mesma máquina, use http://localhost:9666.

Se você estiver em outro servidor, obtenha a URL com:

echo "http://$(hostname -I | awk '{print $1}'):9666"

Notas Importantes​

Rede de Pod do Podman​

Quando executado em pods Podman, a aplicação requer:

  • Configuração explícita de DNS (manipulada automaticamente pelo script pod.testing)
  • Vinculação de porta a todas as interfaces (0.0.0.0:9666)

Os scripts lidam com esses requisitos automaticamente - nenhuma configuração manual necessária.

Modo sem Root vs Modo Root​

  • Modo autônomo (start.duplistatus): Executa sem privilégios com --userns=keep-id
  • Modo pod (pod.testing): Executa como root dentro do pod para fins de teste

Ambos os modos funcionam corretamente com a detecção automática de DNS.

Configuração de Ambiente​

Tanto copy.docker.duplistatus.local quanto copy.docker.duplistatus.remote exigem um arquivo .env no diretório scripts/podman_testing:

Para cópia local (copy.docker.duplistatus.local):

IMAGE=wsj-br/duplistatus:devel

Para cópia remota (copy.docker.duplistatus.remote):

IMAGE=wsj-br/duplistatus:devel
REMOTE_USER=your_username
REMOTE_HOST=your_hostname

O script start.duplistatus requer um arquivo .env com pelo menos a variável IMAGE:

IMAGE=wsj-br/duplistatus:devel

Nota: A mensagem de erro do script menciona REMOTE_USER e REMOTE_HOST, mas estes não são realmente utilizados por start.duplistatus—apenas IMAGE é obrigatório.