O Ansible Tour, parte 4: Nextcloud – Collabora, push, banco de dados no host e occ, role por role
Parte 4 do Ansible Tour: por que cada peça do Nextcloud existe, como ela é implantada no K3s, configurada com occ e atualizada com segurança.

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
Parte 4 do Ansible Tour. Depois do blog na parte 3, vem a segunda aplicação: o Nextcloud. A série descreve a release v3.3.0, com mudanças posteriores acrescentadas como atualizações. O que é igual ao blog só é mencionado de passagem; o foco está no que é diferente.
O Nextcloud é uma nuvem de arquivos: arquivos, calendários, contatos, pastas de equipe e – com o Collabora – documentos editados em conjunto no navegador. Dois dos três servidores o executam, para grupos de tamanhos bem diferentes, com o mesmo código e valores diferentes no inventário. O trabalho é dividido entre next_mariadb e next_redis (banco de dados e cache no host), next_k3s_deploy (Nextcloud, Collabora e o serviço de push como objetos do Kubernetes), next_config (as configurações do Nextcloud) e nextcloud_verify, mais o playbook de atualização.
Índice
🏗️ O que roda, e por quê
Uma requisição faz o mesmo caminho que no blog: ingress, sidecar nginx, PHP-FPM num único pod. Tudo em volta é diferente:
- Dois diretórios separados no host para a aplicação e para os dados dos usuários. Uma imagem nova substitui os arquivos da aplicação; os arquivos dos usuários ficam onde estão e têm backup independente.
- MariaDB e Redis no host, não no cluster. O banco de dados é o componente mais pesado e mais valioso; no host ele recebe o sandbox completo do systemd, um domínio SELinux próprio e nenhuma camada de volume entre os dados e o disco. O Redis guarda os locks de arquivos: dois clientes de sincronização que salvam o mesmo arquivo no mesmo instante não podem corrompê-lo.
- Collabora Online, uma suíte de escritório que roda no servidor e é exibida no navegador. Nextcloud e Collabora conversam via WOPI: o editor pede ao servidor de arquivos um arquivo e que salve uma versão, assinando com uma chave.
- notify_push mantém aberta uma conexão WebSocket com os clientes e avisa sobre mudanças. Sem ele, cada cliente pergunta a cada trinta segundos.
- Um CronJob executa as tarefas em segundo plano a cada cinco minutos; as pré-visualizações são geradas antecipadamente por um app, em vez de no primeiro clique.
🗄️ next_mariadb e next_redis: serviços no host
O MariaDB recebe um sandbox do systemd antes de iniciar pela primeira vez. É por isso que o role recarrega o systemd diretamente e não por um handler: um handler rodaria no fim do play, e num servidor novo o banco de dados iniciaria primeiro sem o sandbox. Esse sandbox também foi o cenário do bug mais importante de setembro: NoNewPrivileges impediu o MariaDB de entrar no seu domínio SELinux, e o banco rodou sem confinamento por cinco semanas, embora o SELinux estivesse em enforcing. O deep dive sobre MariaDB conta essa história. Desde 16 de outubro de 2026 o MariaDB tem seu próprio /tmp em RAM; isso não pode ser combinado com PrivateTmp=yes, senão o diretório no disco vence silenciosamente.
Duas histórias menores mostram como os bugs podem ser silenciosos. O slow query log precisa de um diretório que o MariaDB não cria sozinho; sem ele, o banco rodava com o slow log desligado em silêncio – um diagnóstico que parecia ligado e não coletava nada. E o usuário do exporter recebia seu privilégio de novo a cada execução, porque o MariaDB reporta REPLICATION CLIENT com o nome mais novo BINLOG MONITOR e o role perguntava pelo antigo.
O usuário de banco do Nextcloud só pode fazer login a partir da rede dos pods. Mesmo com um erro no firewall, o MariaDB recusaria esse login vindo de qualquer outro lugar.
O Redis escuta no endereço do host para que os pods consigam alcançá-lo. No começo, só uma regra de firewall ficava entre a internet e o Redis – e que uma camada de proteção falhe em silêncio não é teoria aqui: o fail2ban ficou morto no blog por dois dias sem ninguém perceber. Por isso o Redis tem senha, que chega ao Nextcloud por um secret. Desde 26 de outubro de 2026 o Redis vem do module stream redis:7 do AppStream, em vez do padrão 6.2 do EL9.
A lição: é fácil colocar um banco de dados para rodar e difícil confiná-lo direito. Depois de cada hardening, ps -eZ mostra se ele ainda roda no seu domínio.
🚀 next_k3s_deploy: Nextcloud, Collabora e push
A mesma estrutura do blog, com uma diferença de comportamento: ele só espera quando um objeto realmente mudou. Como um pod alcança um banco de dados fora do cluster? Com um service sem seletor de pods e um objeto Endpoints preenchido à mão que aponta para o host. Para o Nextcloud, mariadb e redis passam a ser nomes comuns no cluster.
O pod do Nextcloud se instala sozinho a partir de variáveis de ambiente na primeira inicialização contra um banco vazio. Importante na operação: esses valores são lidos só dessa única vez. Depois disso as credenciais ficam no config.php, e mudar só o secret não muda nada. Numa nova versão principal, o entrypoint executa o upgrade antes de o PHP-FPM iniciar; isso pode levar minutos, então a startup probe dá dez minutos antes de a liveness probe entrar em ação. Três números precisam combinar para uploads de até 2 GB: o limite do PHP, o limite no sidecar nginx e o do ingress. O template diz isso exatamente onde os valores são definidos.
As configurações próprias vêm como custom.config.php de um ConfigMap, ao lado do config.php do Nextcloud: idioma, duração da sessão, cache e locking, pré-visualizações, o trusted proxy. Arquivos de configuração posteriores vencem, então um valor definido aqui não pode derivar pela interface web. O cache de bytecode recebe 256 MB e espaço para 20.000 arquivos: com todos os seus apps, uma instalação tem até 17.800 arquivos PHP, e o limite antigo de 10.000 fazia parte deles ser recompilada a cada requisição.
Desde 26 de outubro de 2026 o pod do Nextcloud é trocado sem downtime enquanto a imagem continuar a mesma – em mudanças de configuração e rebuilds da mesma tag. Quando a imagem muda, ele fica com Recreate, porque o entrypoint então copia código novo e executa o upgrade; enquanto isso, nenhum pod antigo pode servir a partir do mesmo diretório. O role decide isso a cada execução e volta para rolling update depois.
O Collabora assina cada requisição WOPI com uma chave que o Nextcloud verifica. A imagem atual não cria mais essa chave sozinha; ela rodava sem nenhuma, e o Nextcloud não conseguia verificar se as requisições realmente vinham do Collabora. O role a cria uma vez e a passa do openssl direto para um secret – a chave privada nunca toca o disco. O Collabora é o único contêiner que não descarta todas as capabilities: ele monta seu próprio sandbox para cada documento e precisa de direitos para isso, que um palpite a partir da documentação poderia quebrar de um jeito que só aparece quando um usuário abre um arquivo. Suas probes pedem uma página de dois bytes em vez do discovery document de 43 KB: o kubelet fecha a conexão depois de 10 KB, e o Collabora registrava cada fechamento desses como dois erros. No servidor maior, o Collabora pode usar seis de oito núcleos desde 26 de outubro de 2026; ao gerar pré-visualizações, ele batia no limite antigo de quatro.
A regra de rede tem um objetivo diferente no Nextcloud do que no blog. O Collabora processa documentos arbitrários que os usuários enviam – um ponto de entrada mais plausível do que a maior parte do código PHP – e não tem motivo nenhum para falar com o MariaDB ou o Redis. Por isso a regra só lhe permite requisições vindas do ingress e do Nextcloud, DNS e os callbacks WOPI na porta 443 do host, explicitamente não 3306 e 6379 no mesmo endereço.
Ingress e login. A mesma estrutura de master e minions do blog, com um minion para /push/ que carrega headers de WebSocket. O nome dele importa: o controller ordena as locations com regex pelo nome do ingress, e o nome errado fez a rota catch-all do Nextcloud responder primeiro no primeiro rollout. Em 26 de outubro de 2026 também se descobriu que o rate limit só conhecia /login – mas o Nextcloud envia seu formulário para /index.php/login. Desde julho, nem o rate limit nem o filtro do fail2ban tinham visto um único login real; agora os dois conhecem os dois caminhos.
Apps e push. O inventário lista só os desvios deliberados nos apps: quais ficam forçadamente desligados e quais devem estar ligados. Se um app ainda não tem versão compatível depois de um upgrade de versão principal, ele fica desligado, e o role informa exatamente qual – em vez de abortar no primeiro erro. O binário do notify_push vem junto com um app; por isso a versão dele é uma annotation no template do pod, para que uma atualização do app faça o rollout do pod de novo e binário e app nunca se desencontrem.
A lição: um caminho que você acha que é o da página de login não é necessariamente o que a aplicação usa. Teste as regras de proteção com o que o navegador realmente envia.
⚙️ next_config: ler, comparar, definir
As configurações do Nextcloud são definidas com occ, seguindo um padrão: ler o valor atual, comparar com o desejado, escrever só se divergir. Uma execução sem mudanças não reporta nada, e um valor que alguém alterou na interface web é redefinido e aparece como mudança. Isso torna o drift check significativo também para configurações da aplicação, não só para arquivos. As configurações de e-mail antes eram reescritas, todas as nove, a cada execução e ainda reportavam “ok” – uma senha SMTP alterada nunca aparecia.
O arquivo mais instrutivo do role é a política de senhas: no mínimo 12 caracteres e uma verificação contra senhas vazadas conhecidas, para a qual só os cinco primeiros caracteres do hash saem do servidor. Quando o app foi ligado num dos servidores, todo usuário com senha mais antiga que 300 dias ficou bloqueado, o admin incluído. Uma configuração do servidor antigo estava esquecida no banco de dados até o app que a lê ser ligado. Desde então o role define explicitamente cada chave da política, inclusive as que devem ficar desligadas.
A lição: antes de ligar um app, leia qual configuração ele já tem. Depois de uma migração costuma haver mais coisa ali do que você imagina.
🔄 nextcloud-update.yml: uma atualização com cuidado
Uma nuvem de arquivos da qual as pessoas dependem merece uma atualização cuidadosa. O playbook se recusa a rodar sem --limit e numa instância que não esteja saudável – em modo de manutenção ou com um upgrade de banco pendente. Depois ele reinicia só os deployments cuja imagem foi reconstruída upstream, executa occ upgrade e as atualizações de apps, e reinicia o pod uma segunda vez em seguida. O motivo: o Nextcloud roda com opcache.validate_timestamps=0, então o PHP nunca verifica se um arquivo mudou. Sem esse restart, o código antigo continuaria rodando, correções de segurança incluídas.
Se algo falhar, a parte rescue mostra o status, os pods e o fim do nextcloud.log e toma uma decisão cuidadosa: só sai do modo de manutenção se o upgrade em si tiver sido concluído. Caso contrário, os usuários cairiam numa instância atualizada pela metade.
A lição: um cache que nunca reverifica os arquivos é rápido e precisa de um restart depois de cada atualização de código. Isso pertence ao procedimento de atualização, não à memória de alguém.
🛠️ Na operação
- Atualizações:
ansible-playbook nextcloud-update.yml --limit <host>, primeiro com--check. Uma nova versão principal é uma nova tag de imagem emversions.ymle uma execução completa – sempre uma versão principal por vez, com release notes e um snapshot antes. - “Não foi possível carregar o Office”, tentar de novo funciona: um soluço breve entre navegador, Collabora e Nextcloud. Se acontecer com frequência, o Collabora precisa de mais processos pré-iniciados ou de mais memória.
- Modo de manutenção depois de uma atualização que falhou: primeiro
occ status; se houver um upgrade pendente, executeocc upgradee leia a saída, só então desligue o modo de manutenção. - Usuários bloqueados pela política de senhas:
occ config:app:get password_policy expirationprecisa ser 0. - O disco enche: o alerta vem em 80 por cento. A lixeira guarda 180 dias; as pré-visualizações podem ser regeneradas e limpas com
occ preview:cleanup, nunca comrm.
🎯 As lições da parte 4
- O que é valioso vai para o host, o que é substituível vai para o cluster – e um service sem seletor dá aos serviços do host um nome no cluster.
- Valores da primeira instalação são lidos só uma vez; depois vale o
config.php. - Uma regra de rede segue o ponto de entrada mais provável, aqui o Collabora.
- Ler, comparar, definir – também para configurações da aplicação, para que o drift check as veja.
- Antes de ligar um app, leia a configuração que ele já tem.
🧭 Para onde o tour vai agora
Com a parte 4, as duas aplicações estão cobertas. A parte 5 reúne todos os roles de segurança num só lugar, a parte 6 o monitoramento. A tecnologia por trás desta parte é explicada no deep dive sobre Nextcloud.
