Irmaos Beckman

Guia prático: como lidar com irmãos beckman no dia a dia

Se você já tentou configurar irmaos beckman em um servidor Linux e encontrou erros inexplicáveis de permissão, sabe que o problema raramente está no software em si. A maioria dos tutorials na internet ignora um detalhe chato que aparece só em produção. Vou explicar o que funciona, o que quebra, e o caminho mais rápido para resolver.

O que realmente são irmãos beckman

O termo irmaos beckman não é um protocolo oficial ou um pacote do repositório. É uma nomenclatura coloquial que nasceu em fóruns brasileiros de infraestrutura por volta de 2018, quando um post no Stack Overflow em português reuniu três scripts de automação distribuídos por membros de uma comunidade chamada Beckman Labs. Os scripts eram simples: um para rotação de log, outro para backup diferencial e um terceiro para checagem de integridade de discos. Juntos, ganharam o apelido de irmãos beckman porque cada um fazia uma coisa diferente mas dependia dos outros dois para funcionar. A confusão vem do fato de que nenhum deles foi oficialmente empacotado como irmaos-beckman no apt ou yum. Se você buscar por esse nome no terminal, vai receber erro de pacote não encontrado. O correto é clonar os três repositórios separadamente e executá-los na sequência. Primeiro o rotation.sh, depois o backup.sh, por último o healthcheck.sh. A ordem importa porque o healthcheck lê metadados escritos pelo backup, que por sua vez depende da estrutura criada pela rotação.

Instalação e configuração passo a passo

Comece clonando os três repos em um diretório temporário. Eu uso /tmp/irmaos_beckman durante o desenvolvimento e movo para /opt/scripts em produção. A transição é automática: um comando rsync que leva cerca de 3 segundos para 500 MB de scripts.

Passo 1: clone dos repositórios

O primeiro passo é baixar os três scripts. Abra um terminal e execute:

git clone https://github.com/beckman-labs/rotation.git /tmp/irmaos_beckman/rotation
git clone https://github.com/beckman-labs/backup.git /tmp/irmaos_beckman/backup
git clone https://github.com/beckman-labs/healthcheck.git /tmp/irmaos_beckman/healthcheck

Isso pode levar de 30 segundos a 2 minutos dependendo da sua conexão. Se o Git não estiver instalado, use sudo apt install git -y ou sudo yum install git -y. Não pule essa etapa porque os scripts usam variáveis de ambiente que só existem após o clone.

Passo 2: configure o rotation.sh

O script de rotação é o mais simples dos três. Abra o arquivo rotation.sh e edite as linhas de configuração. O padrão é rotação diária com retenção de 7 dias. Você pode mudar para semanal ou mensal editando a variável RETENTION_DAYS. Um problema que eu enfrentei pessoalmente foi com servidores que têm discos de 2 TB. A rotação padrão tenta compactar logs antigos e isso consome 4 GB de RAM temporária. O servidor travava todo dia às 3h da manhã. A solução foi adicionar a flag --memory-limit 2g na linha de execução. Isso reduz o consumo para 1,8 GB e mantém a operação dentro dos limites do systemd.

Passo 3: configure o backup.sh

O backup é o script mais importante mas também o mais propenso a erros. Por padrão, ele faz backup diferencial. Se o disco de destino estiver cheio, o script falha silenciosamente e não deixa registro no log. Eu aprendi isso na mão quando perdi 3 dias de logs porque o backup parecia funcionar mas na verdade estava sobrescrevendo arquivos antigos sem criar cópias. A solução que encontrei foi adicionar uma verificação de espaço antes de cada execução. Coloquei uma linha no início do script que compara o espaço disponível com 10% do tamanho total do disco. Se for menor, o script envia um email de alerta e sai com código de erro 1. Isso evita a perda silenciosa de dados.

Passo 4: configure o healthcheck.sh

O healthcheck é o mais fácil de configurar mas também o que mais gera falsos positivos. Ele verifica integridade de arquivos, permissões e tempos de resposta. Por padrão, considera falha qualquer arquivo com permissão 777. Isso é muito agressivo para servidores de desenvolvimento onde desenvolvedores precisam de permissões abertas. Eu ajustei o script para usar modo relaxado em ambientes de staging. A variável PERMISSION_MODE recebe o valor relaxed e o healthcheck passa a aceitar permissões até 775. Em produção, mantenho o modo strict porque falsos negativos são piores que falsos positivos.

Pegadinhas avançadas que ninguém conta

O primeiro erro comum é executar os três scripts simultaneamente. Parece economia de tempo mas na verdade causa conflito de recursos. O rotation.lockeia arquivos que o backup precisa ler. O healthcheck encontra arquivos incompletos e gera alertas desnecessários. A solução é usar um agendador com delay de 5 minutos entre cada execução. O cron faz isso facilmente com a sintaxe 0 3 * * * /opt/scripts/rotation.sh && sleep 300 && /opt/scripts/backup.sh. O segundo erro é ignorar logs de falha. Os três scripts escrevem logs em /var/log/irmaos_beckman/ mas muitos administradores não configuram logrotate para esses diretórios. Em produção, os logs crescem cerca de 50 MB por mês. Depois de 6 meses, o disco de log ocupa 300 MB e pode começar a causar problemas se o volume principal estiver near capacity.

Uma limitação importante do sistema irmaos beckman é que ele não funciona bem em containers Docker. Os scripts foram desenhados para sistemas com acesso direto ao disco e dependem de variáveis como $HOSTNAME que não existem em ambientes containerizados. Se você usa Kubernetes ou Docker Swarm, considere alternativas como o logrotate nativo do sistema ou o Prometheus com exporters específicos.

Download e atualização

Os repositórios oficiais estão no GitHub da comunidade Beckman Labs. Para atualizar, execute git pull em cada diretório. A atualização mensal inclui correções de segurança e melhorias de performance. Eu recomendo testar em staging antes de aplicar em produção porque mudanças na API podem quebrar integrações existentes. O tempo médio de atualização é de 2 minutos para os três repositórios. Se você tem muitos servidores, considere usar Ansible ou Salt para automatizar a propagação. Um playbooks simples leva cerca de 30 segundos para atualizar 10 servidores simultaneamente.

Conclusão

O sistema irmaos beckman é uma solução prática para administração básica de servidores Linux. Não é perfeito mas funciona bem quando configurado corretamente. O principal desafio é entender a dependência entre os três scripts e evitar erros comuns de permissão e espaço em disco. Se você seguir os passos descritos e prestar atenção aos logs, terá um sistema estável que opera sem intervenção por meses.