Dia de atualização: Nextcloud 35, um alarme falso e por que o Ansible nunca instala meus kernels

Uma tarde, três servidores, tudo atualizado: o salto para o Nextcloud 35 com Ansible, um período de espera para o Trivy, um alarme falso no meu relatório de atualizações e o motivo pelo qual meus playbooks nunca instalam um kernel.

Ilustração: um homem numa mesa de homelab com monitores mostrando Update Day

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

Toda segunda-feira um pequeno script me manda por e-mail um relatório de versões: quais versões fixadas estão desatualizadas, quais imagens foram reconstruídas sob a mesma tag, quais pacotes estão pendentes nos hosts? Desta vez a lista era longa – incluindo o salto do Nextcloud 34 para o 35 nas duas instâncias. No fim da tarde estava tudo atualizado, nada quebrado, e o drift check mostrava changed=0.

Este post percorre as etapas em ordem. Cada uma traz sua própria pequena lição – e uma delas foi um bug na minha própria ferramenta.

Índice

📬 O relatório informa, não age

O script de verificação roda num servidor do meu homelab e é estritamente somente leitura. Ele compara os pins em versions.yml com o Docker Hub e o GitHub, verifica se uma imagem foi reconstruída sob a mesma tag, compara a versão do PHP nos pods com o php.net e conta os pacotes pendentes por host. Ele não muda nada – as atualizações eu aplico pessoalmente, de forma deliberada, um host por vez.

Desta vez o relatório dizia: Nextcloud 35.0.2 disponível, Trivy 0.76.1 disponível, a imagem do WordPress “reconstruída” e seis pacotes de kernel nos três hosts.

Como o relatório funciona: o script é um programa Python no HP3, um servidor do meu homelab que também puxa os backups noturnos dos três servidores – e não nos próprios servidores. Uma entrada no cron o inicia toda segunda-feira às 07:17, e ele envia o e-mail pela sua própria conta de e-mail. Em cinco passos:

  • Ele lê o versions.yml da cópia local do repositório – todas as versões fixadas vivem nesse único lugar.
  • Ele consulta o Docker Hub sobre cada imagem e o GitHub sobre o release mais recente de cada binário, e compara com o pin.
  • Ele entra em cada servidor via SSH, lista as imagens realmente presentes com crictl images e compara com o build atual sob a mesma tag.
  • Ele lê a versão do PHP dentro dos pods em execução e compara com o php.net.
  • Ele conta os pacotes pendentes por host com dnf check-update.

Todas as descobertas acabam num único e-mail – junto com os comandos para as execuções de atualização na ordem certa. Executá-los fica por minha conta.

Foi assim que o relatório ficou neste dia de atualização (só os nomes dos dois servidores Nextcloud e os nomes de host dos comandos foram alterados):

== Container images (pin vs Docker Hub) ==
  nextcloud_image_fpm          34.0.5-fpm             (newest overall 35.0.2-fpm)
  nextcloud_image_nginx        1.30.6-alpine          (newest overall 1.31.8-alpine)
  nextcloud_image_collabora    26.04.5.2.1            ok
  nextcloud_image_fpm_exporter 2.2.0                  ok
  blog_image_wordpress         7.1.4-php8.5-fpm       ok
  blog_image_nginx             1.30.6-alpine          (newest overall 1.31.8-alpine)
  blog_image_mariadb           10.11.19               (newest overall 13.0.2)
  blog_image_redis             7.4.12-alpine          (newest overall 8.10.3-alpine)
  blog_image_mysqld_exporter   v0.21.0                ok
  blog_image_fpm_exporter      2.2.0                  ok

== Binaries / charts (pin vs GitHub latest release) ==
  k3s_version                  v1.37.1+k3s1           ok
  helm_version                 v4.3.1                 ok
  helm_diff_version            3.15.15                ok
  node_exporter_version        1.12.1                 ok
  prometheus_version           3.15.1                 ok
  mysqld_exporter_version      0.21.0                 ok
  loki_version                 3.7.9                  ok
  alloy_version                1.21.3                 ok
  trivy_version                0.75.0                 -> v0.76.1
  blog_wp_cli_version          2.12.0                 ok
  cert_manager_chart_version   1.21.3                 ok

== Same tag rebuilt upstream (image refresh needed) ==
  blog   wordpress:7.1.4-php8.5-fpm         REBUILT upstream

== PHP in the pods ==
  blog   PHP 8.5.12
  cloud1 PHP 8.5.12
  cloud2 PHP 8.5.12
  php.net 8.4: 8.4.27
  php.net 8.5: 8.5.12

== Host packages (dnf check-update) ==
  blog     6 pending  incl. kernel, kernel-core, kernel-modules, kernel-tools ...
  cloud1   6 pending  incl. kernel, kernel-core, kernel-modules, kernel-tools ...
  cloud2   6 pending  incl. kernel, kernel-core, kernel-modules, kernel-tools ...

Update runs (one host at a time, blog first):
  ansible-playbook blog-update.yml -l <blog host> --vault-password-file .vault_pass
  ansible-playbook nextcloud-update.yml -l <nextcloud host> --vault-password-file .vault_pass   (one at a time)
  then per host: --tags common_rkhunter,common_aide_refresh
Pins (versions.yml) are changed by hand or via the Renovate PRs - this report only informs.

Por que não a versão mais nova em todo lugar? Para alguns componentes o relatório aponta uma versão major mais nova. Isso não é descuido, e sim uma decisão:

ComponenteLinhaFontePor quê
MariaDB10.11Docker Hub / repositório MariaDBLTS, com suporte até fevereiro de 2028
Redis7.4 e 7.2Docker Hub / AlmaLinuxúltimas linhas do Redis 7, com suporte até o fim de 2029
nginx1.30Docker Hubbranch estável; o ingress controller traz sua própria versão

Para pacotes de uma distribuição, o número da versão diz pouco de qualquer forma: muitas vezes ele fica atrás do do fabricante, porque a distribuição aplica as correções do seu próprio jeito. Então, se um pacote está vulnerável não se vê comparando com o fabricante, e sim pelo aviso de segurança da distribuição.

A lição: “atual” não significa “versão major mais nova”, e sim: o estado mais recente da linha que você escolheu deliberadamente e que ainda tem suporte.

📦 Para reproduzir: weekly-update-check.zip (script, wrapper do cron e um README curto, 4 KB). Os hosts são placeholders no topo do check.py; os pins vêm do versions.yml no meu repositório público. Licença MIT, sem garantia – revise você mesmo antes de usar.

A lição: um relatório que só informa pode se dar ao luxo de ser minucioso. Decidir o que entra, e quando, continua com um humano.

☁️ Nextcloud 34 → 35: primeiro verificar, depois saltar

Um upgrade major nunca é automático no Nextcloud. Não dá para pular versões, e os apps da app store precisam de um release compatível com a nova versão major. Então, antes do salto, verifiquei:

  • A imagem existe? nextcloud:35.0.2-fpm estava no Docker Hub.
  • Os apps são compatíveis? A API da app store lista os apps disponíveis por versão da plataforma. Todos os nove apps da store em cada instância – entre eles Collabora, Deck, notify_push e Groupfolders – tinham um release para a 35.
  • Os requisitos batem? O Nextcloud 35 exige pelo menos MariaDB 10.11 e abandona o PHP 8.2. O banco de dados já rodava 10.11, e o PHP vem dentro da imagem do container.
  • Existe caminho de volta? Além do backup noturno, fiz um dump novo do banco de dados logo antes do upgrade.

Primeiro defini o novo pin só para uma instância, nas variáveis de host dela. A segunda instância e o padrão global ficaram na 34.0.5 até a primeira rodar limpa. Só então a 35.0.2 foi para o versions.yml, e os dois pins de host foram removidos de novo.

A lição: um upgrade major não começa com o upgrade. Ele começa com três perguntas: está tudo lá, tudo é compatível, e eu consigo voltar?

⚙️ O que realmente acontece durante o upgrade

Não é o Ansible que executa o upgrade – é a imagem do Nextcloud. Ao iniciar, o entrypoint dela compara a versão instalada com a da imagem. Se a imagem for mais nova, ele copia o código novo e roda occ upgrade, que migra o banco de dados. Enquanto isso, o Nextcloud fica em modo de manutenção.

O playbook garante duas coisas:

  • Recreate em vez de rolling update: com uma imagem nova, o pod antigo para completamente antes de o novo iniciar. Caso contrário, código antigo e novo trabalhariam no mesmo diretório ao mesmo tempo.
  • Uma startup probe paciente: o PHP-FPM só inicia depois do upgrade. A startupProbe permite até dez minutos, para que o Kubernetes não confunda uma migração longa do banco de dados com um crash.

Levou 40 e 47 segundos. O log, porém, tinha linhas que à primeira vista assustam: “Disabled incompatible app: richdocuments” – e assim por diante para cada app da store. Isso é esperado: durante um upgrade major, o Nextcloud desativa todo app cuja versão instalada não combina com o novo release major. A execução seguinte de nextcloud-update.yml busca os releases compatíveis, reativa os apps e reinicia o pod, para que o OPcache pare de rodar bytecode antigo.

Depois disso todos os apps estavam de volta, a maioria numa versão nova (Collabora 11 → 12, Groupfolders 22 → 23). Novidade é o app embutido sharing para o compartilhamento unificado do Nextcloud 35.

A lição: um upgrade major tem dois passos que andam juntos – o core, depois os apps. Pare depois do primeiro e você tem um Nextcloud sem Office.

🔍 Como eu defino “pronto”

“A página carrega” não é o meu teste de aceitação. Depois de cada instância eu verifiquei:

  • o log do Nextcloud: nenhum erro desde o upgrade, só dois ou três avisos conhecidos sobre apps desativados de propósito
  • os logs do servidor web: nenhuma resposta 5xx
  • o autoteste do notify_push
  • no host: nenhuma negação do SELinux, MariaDB e Redis nos seus próprios domínios, nenhuma unit com falha, todos os targets do Prometheus up
  • e por fim o drift check: uma execução do playbook em check mode que não pode mais mudar nada

As duas instâncias reportaram changed=0. Só então considero um upgrade concluído: o servidor é exatamente o que o código descreve.

A lição: “funciona” é uma sensação, changed=0 é uma constatação.

🧪 O drift check em detalhe

O drift check é um segundo script, completamente diferente: scripts/check-drift.sh no repositório público. Ele não roda agendado, e sim à mão, na máquina de onde executo o Ansible – sempre logo depois de uma execução real do playbook e depois de cada upgrade.

A ideia: o Ansible descreve como um servidor deve ser. Rode o mesmo playbook de novo em check mode e não pode sobrar nada a fazer. O script faz exatamente isso:

  • Ele chama ansible-playbook … --check --diff para um host. Em check mode o Ansible não muda nada; ele só reporta o que faria.
  • Ele pega a saída como JSON e filtra as tasks que reportariam “changed” – com o diff. Para objetos do Kubernetes ele esconde os campos de controle do servidor, para que só sobrem diferenças reais.
  • O código de saída diz o resultado: 0 = sem drift, 1 = drift, 2 = a própria execução de verificação falhou.

Foi assim que ficou hoje depois do upgrade:

$ scripts/check-drift.sh nextcloud-k3s.yml <host>

<host>: changed=0 failed=0
NO DRIFT

E é assim que um achado se parece – um caso anterior em que uma task reportava “changed” a cada execução, embora nada tivesse mudado:

### would change: rkhunter | Build / refresh file-properties database

<host>: changed=1 failed=0
DRIFT: 1 task(s) would change

Um achado logo depois de uma execução real sempre significa uma de duas coisas: alguém mudou algo à mão no servidor, ou uma task no código não é idempotente. Você quer saber de qualquer uma delas antes que a próxima execução “conserte” isso em silêncio.

A lição: o drift check é a vistoria final contra a planta. Ele não prova que tudo funciona – ele prova que o servidor corresponde exatamente ao código.

⏳ Duas semanas de espera para o Trivy

O Trivy, meu scanner noturno de imagens, tinha uma versão nova. Não instalei. Em março de 2026 o pipeline de release do Trivy foi comprometido e distribuiu um build manipulado. Desde então tenho uma regra: Trivy só em releases com pelo menos duas semanas, sempre fixado com um checksum SHA-256 tirado do arquivo de checksums do release.

A versão 0.76.1 saiu em 21 de outubro, então está liberada a partir de 4 de novembro. Conferi o checksum com antecedência – o arquivo baixado bate com o arquivo oficial de checksums. O commit espera mais um dia.

A lição: para ferramentas de segurança, “novo” não é automaticamente “mais seguro”. Um período de espera custa pouco, e em março teria ajudado.

🧩 O alarme falso: um índice novo, a mesma imagem

O relatório marcou wordpress:7.1.4-php8.5-fpm como “rebuilt upstream”. O playbook de atualização a puxou – e não reiniciou nada. O log do containerd mostrou por quê: ele leu cerca de 21 KB, e o ID da imagem continuou o mesmo.

A explicação: meu script tinha comparado o digest do índice. Uma tag no Docker Hub aponta para um índice, que lista as imagens de cada plataforma. Se a imagem de outra arquitetura muda, ou só uma atestação, o índice ganha um digest novo – mas a imagem amd64 que eu rodo continua idêntica, byte por byte.

A correção foi pequena: o script agora resolve o índice, pega a entrada linux/amd64 e compara o config digest dela com o ID da imagem no host. É exatamente isso que o container executa. Desde então: “none – every pinned tag is current”.

A lição: um digest novo não significa uma imagem nova. Compare o que realmente roda.

🐧 Por que o Ansible nunca instala meus kernels

Sobraram os pacotes de kernel. Meu playbook de pacotes instala todas as atualizações – menos kernels, de propósito. O serviço SSH é endurecido com systemd, entre outras coisas com ProtectKernelModules=yes. Toda sessão SSH, inclusive a do Ansible, roda portanto no seu próprio mount namespace, no qual /usr/lib/modules aparece vazio e somente leitura. Uma instalação de kernel via SSH falha ali sempre.

Por isso os kernels seguem outro caminho:

  • dnf-automatic instala só atualizações de segurança, à noite, como serviço systemd – fora de qualquer sessão SSH. O kernel novo era uma dessas atualizações de segurança.
  • Às 03:30 o host reinicia se needs-restarting -r pedir.
  • Às 04:00 o AIDE renova sua baseline, para que o kernel novo não vire alarme no dia seguinte.

Desta vez eu não quis esperar a noite. Em vez de instalar o pacote via SSH, iniciei dnf-automatic-install.service à mão em cada host – o mesmo caminho da noite, só que mais cedo. Depois um reboot, um host após o outro. Cada um voltou depois de 40 a 50 segundos, com o kernel novo, nenhuma negação do SELinux e todos os pods rodando.

O horário antecipado teve um efeito colateral: a verificação diária do AIDE roda à meia-noite, antes da renovação das 04:00. Se nada fosse feito, ela reportaria o kernel novo como alteração. Por isso cada host precisa depois da renovação do AIDE e do rkhunter.

A lição: o hardening tem efeitos colaterais na sua própria automação. Em vez de enfraquecer o hardening, dê à atualização do kernel um caminho próprio e adequado.

🎯 As lições

  1. Relatórios informam, pessoas decidem – verificar automaticamente, aplicar deliberadamente.
  2. Responda três perguntas antes de um upgrade major – está tudo lá, tudo é compatível, consigo voltar?
  3. Core e apps são um único upgrade – o Nextcloud só está pronto quando os apps rodam de novo.
  4. Compare o que realmente roda – não o índice, mas a imagem da sua própria plataforma.
  5. Pronto significa changed=0 – o drift check encerra cada dia de atualização.
Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes