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.

🌐 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.ymlda 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 imagese 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:
| Componente | Linha | Fonte | Por quê |
|---|---|---|---|
| MariaDB | 10.11 | Docker Hub / repositório MariaDB | LTS, com suporte até fevereiro de 2028 |
| Redis | 7.4 e 7.2 | Docker Hub / AlmaLinux | últimas linhas do Redis 7, com suporte até o fim de 2029 |
| nginx | 1.30 | Docker Hub | branch 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-fpmestava 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 --diffpara 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 -rpedir. - À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
- Relatórios informam, pessoas decidem – verificar automaticamente, aplicar deliberadamente.
- Responda três perguntas antes de um upgrade major – está tudo lá, tudo é compatível, consigo voltar?
- Core e apps são um único upgrade – o Nextcloud só está pronto quando os apps rodam de novo.
- Compare o que realmente roda – não o índice, mas a imagem da sua própria plataforma.
- Pronto significa
changed=0– o drift check encerra cada dia de atualização.
