Todos os artigos
Getting Started
O que é o CICDoo Primeiros passos: o assistente de configuração O Painel e o Mapa da infraestruturaConcepts
Fases de produção, staging e desenvolvimento Domínios, subdomínios e SSL Versões e edições do Odoo (Community ou Enterprise) Espaços de trabalho e colaboração em equipaServers
Adicionar um servidor Domínios do servidor e DNS Utilizar um balanceador de carga Ligar através de um servidor de salto Ações do servidor: deploy, registos e gráficos Deleting a serverProjects & Git
Criar um projeto Ligar o GitHub Project GitHub settings and webhook Ligar o GitLab Ramos e instâncias Etiquetar e filtrar projetos Alta disponibilidade com nós de aplicação Project environments, extensions and deletionInstances & Console
Criar uma instância Reiniciar, parar e remover uma instância Fazer merge de ramos entre fases Web IDE e acesso remoto SSH access to instances As definições da instância explicadas Deploys e a fila de tarefasAgent Tasks
O que são as tarefas de agente Configurar as tarefas de agente Executar uma tarefa e rever o resultado Tempo de agente e recargas Agent insights and task filtersMonitoring & Backups
Monitorizar a instância Cópias de segurança e restauro S3 storage, uploads and bulk backup actions Notificações de alerta (email e SMS)Workspaces & Permissions
Convidar membros do espaço de trabalho Permissões de membro e acesso a recursos Um membro não consegue ver ou usar um recurso Audit log and server activityAccount & Security
Autenticação de dois fatores (2FA) Definições de perfil e integrações Palavras-passe e recuperação da conta Instance security score and checks The Security page: every instance and member at a glanceBilling & Plans
Planos e preços Fazer upgrade e gerir a subscrição Se a subscrição de um projeto ficar por pagar O programa de parceiros de canal Onboarding a client as a partnerSupport & Tickets
Abrir um ticket de suporte Obter ajuda da equipa CICDooTroubleshooting
Resolução de problemas: não é possível ligar um servidor Resolução de problemas: um deploy falhou Resolução de problemas: git push falha com 403 depois de mover um repositório Resolução de problemas: a instância está em baixo ou lenta Resolução de problemas: problemas de domínio ou SSLProjetos e Git
Alta disponibilidade com nós de aplicação
Como correr uma base de dados Odoo de produção em vários servidores, com um projeto principal que corre a base de dados e nós de aplicação que a servem.
Como funciona
A alta disponibilidade permite que a produção de uma base de dados Odoo corra em vários servidores ao mesmo tempo. Se um servidor deixar de responder, os visitantes são enviados para os outros.
Um cluster é composto por projetos que correm o mesmo código:
- O principal: um projeto cuja instância de produção corre o Odoo e a base de dados. A sua base de dados fica aberta aos nós de aplicação, e a mais ninguém.
- Nós de aplicação: outros projetos, cada um num servidor de produção diferente, cuja instância de produção corre apenas o Odoo e usa a base de dados do principal.
- Réplicas: nós de aplicação que também guardam, no seu próprio servidor, uma cópia em espera da base de dados do principal, pronta a assumir se o principal se perder.
Os visitantes usam o endereço do principal. O CICDoo aponta esse endereço para o principal e para cada nó de aplicação que esteja a responder, e verifica cada nó a cada poucos minutos. Um nó que deixe de responder é retirado do endereço até recuperar.
A base de dados em si corre num só servidor, o do principal. Os nós de aplicação tornam redundante o lado do Odoo. Para proteger também a base de dados, adiciona uma réplica: se o servidor do principal se perder, promoves a réplica e o site continua a partir da cópia dela. Consulta "Réplicas e failover" mais abaixo.
Antes de começar
- Mesmo código: todos os projetos de um cluster têm de usar o mesmo repositório, o mesmo ramo predefinido, a mesma versão do Odoo e a mesma edição. Se o Time Machine estiver ativo, os commits fixados também têm de coincidir.
- Servidores diferentes: cada nó de aplicação tem de ter o seu próprio servidor de produção, diferente do do principal e dos dos outros nós.
- Proxy do Cloudflare: a distribuição do tráfego pelos nós funciona atualmente em servidores que têm o proxy do Cloudflare ativo. Usa servidores da mesma região, já que cada página servida por um nó de aplicação comunica com a base de dados do principal.
- Filestore partilhado: cada servidor do cluster tem de montar o mesmo armazenamento partilhado para o filestore do Odoo. Sem isso, um anexo carregado através de um nó não existe nos outros, e um visitante que chegue a outro nó perde a sessão. Pede ajuda ao suporte se precisares de ajuda para configurar isto.
- Ligações à base de dados: cada nó de aplicação abre as suas próprias ligações à base de dados do principal. À medida que adicionas nós, aumenta max_connections na Configuração do PostgreSQL da instância de produção do principal, no separador Definições da sua consola.
- Quantas réplicas: cada réplica precisa do seu próprio servidor de produção. Com as definições predefinidas do PostgreSQL, um principal consegue alimentar cerca de nove réplicas, e cada uma pode reter até 20 GB de alterações no disco do principal enquanto está atrasada.
As definições de alta disponibilidade estão em Definições do projeto, no separador Avançado, no cartão Alta disponibilidade. Precisas de permissão para alterar as definições do projeto.
Configurar o principal
Abre o projeto que vai correr a base de dados, vai a Definições do projeto > Avançado e, em Alta disponibilidade, define Função como Principal (aplicação + base de dados). Clica em Aplicar e confirma.
A instância de produção reinicia. Quando volta, a sua base de dados aceita ligações dos nós de aplicação do cluster. As ligações entre servidores são cifradas, a menos que os teus servidores partilhem uma rede privada.
A instância de produção tem de usar a sua própria base de dados incluída. Um projeto cuja instância de produção aponta para uma base de dados externa não pode ser principal.
Adicionar um nó de aplicação
Cria um projeto para o nó como farias normalmente: mesmo repositório e mesmo ramo predefinido, mesma versão e edição, e um servidor de produção só seu. Remove as instâncias de staging e de desenvolvimento que tenha: um nó de aplicação só corre produção, e os ramos de staging e de desenvolvimento ficam no projeto principal.
Depois abre as Definições do projeto > Avançado do nó, define Função como Nó de aplicação (usa a base de dados de um principal), escolhe o principal em Origem da base de dados, clica em Aplicar e confirma. Só são apresentados principais do mesmo espaço de trabalho que correm o mesmo código.
O nó não arranca de imediato. Primeiro o servidor do principal tem de o deixar entrar, o que acontece na sua próxima verificação, normalmente em cinco minutos. Até lá o cartão mostra "A aguardar que o principal permita este nó", e o nó arranca sozinho assim que for permitido. Alguns minutos depois de responder, começa a receber visitantes.
No principal, o cartão Alta disponibilidade lista os seus nós de aplicação e se o servidor da base de dados já aplicou a lista de acesso atual.
Réplicas e failover
Uma réplica é um nó de aplicação que também corre uma cópia em espera da base de dados do principal. O principal envia-lhe cada alteração, por isso a cópia fica normalmente apenas alguns segundos atrás. O Odoo numa réplica serve os visitantes como em qualquer nó de aplicação, usando a base de dados do principal.
Para adicionar uma, prepara um projeto exatamente como para um nó de aplicação, define Função como Réplica (nó de aplicação + cópia em espera da base de dados), escolhe o principal em Origem da base de dados e clica em Aplicar. O principal tem de correr PostgreSQL 13 ou posterior, que é o padrão a partir do Odoo 15, e a réplica tem de usar a mesma versão de PostgreSQL. Ao juntar-se, a base de dados própria do projeto réplica é substituída pela cópia; os dados antigos são postos de lado no servidor, não apagados. Numa base de dados grande, a primeira cópia demora algum tempo.
O cartão Alta disponibilidade da réplica mostra o estado da cópia:
- A copiar: a primeira cópia está a ser feita.
- A mudar para o novo principal: outra réplica foi promovida e esta cópia está a mudar para ela. Mantém os dados que já tem, por isso normalmente é rápido.
- Em sincronização: a cópia está a acompanhar o principal.
- Atrasada: a cópia ficou mais de algumas centenas de MB atrás, ou deixou de acompanhar por agora.
- Avariada: o principal já não guarda as alterações de que a cópia precisa. Clica em Reconstruir cópia para fazer uma nova.
Se o servidor do principal se perder, abre o cartão Alta disponibilidade da réplica, clica em Promover a principal e escreve o nome do projeto para confirmar. A base de dados da réplica passa a ser a do cluster, a réplica passa a ser o principal e todos os outros nós reiniciam ligados a ela. O site mantém o endereço. O principal antigo passa a ser um nó de aplicação: quando o servidor dele volta, arranca sem base de dados própria e não recebe visitantes até ter reiniciado dessa forma. As alterações feitas pelo principal antigo depois da última sincronização da cópia perdem-se, por isso promove apenas quando o principal não puder ser recuperado. A promoção nunca acontece automaticamente. As outras réplicas mantêm a sua cópia e passam para o novo principal. Se alguma estava à frente da réplica promovida, é rebobinada para coincidir com ela, e só se isso não for possível volta a copiar a base de dados. Se o cartão da réplica indicar que outra réplica tinha uma cópia mais recente, promove essa: perdes menos alterações.
Uma réplica usa as definições de PostgreSQL do principal. Depois de alterares a Configuração do PostgreSQL da instância de produção do principal, reinicia as réplicas.
Ler de uma réplica
No Odoo 18 e posterior, qualquer projeto de um cluster pode enviar o trabalho só de leitura para uma réplica: vistas de lista e formulário, vistas agrupadas, relatórios e exportações. Todas as escritas continuam a ir para o principal, e um pedido que afinal precisa de escrever é repetido lá automaticamente. Isto alivia o servidor de base de dados do principal.
Abre as Definições do projeto > Avançado do projeto, escolhe a réplica em Consultas só de leitura no cartão Alta disponibilidade e clica em Aplicar. Uma réplica também pode ler da sua própria cópia. O projeto reinicia quando a réplica o permitir, normalmente em cinco minutos.
As leituras de uma réplica podem estar um momento atrás do principal. Quando uma réplica se atrasa, para ou avaria, o CICDoo fecha-a aos leitores e o Odoo volta ao principal sozinho, sem reiniciar. Os leitores regressam a ela cerca de meia hora depois de voltar a sincronizar.
O que muda num nó de aplicação
- A sua instância de produção não tem base de dados própria. As definições da sua base de dados são geridas pelo CICDoo e não podem ser alteradas na configuração do Odoo da instância.
- As tarefas agendadas (crons do Odoo) só correm no principal.
- As cópias de segurança são feitas no principal. Faz cópias de segurança e restauros da base de dados do cluster a partir do projeto principal.
- Fazer push para o ramo de um nó de aplicação não faz nada por si só. O cluster é atualizado a partir do principal.
- A consola de um nó de aplicação esconde a shell da base de dados, as cópias de segurança e as definições de PostgreSQL, que estão no principal. Uma réplica mantém a shell da base de dados, que abre a sua cópia só de leitura.
Fazer deploy de atualizações
Faz push para o ramo do principal como de costume. O CICDoo atualiza então todo o cluster por ordem:
- Cada nó de aplicação é parado.
- O principal é atualizado, incluindo qualquer atualização de módulos, enquanto nenhum outro servidor está a usar a base de dados.
- Cada nó de aplicação é arrancado de novo com o código novo.
Podes acompanhar cada passo no separador Fila da instância onde corre. Se a atualização do principal falhar, os nós de aplicação não voltam a arrancar, e as suas entradas na fila indicam porquê. Corrige o problema e faz deploy de novo.
Como as atualizações de módulos precisam da base de dados só para si, o site fica indisponível enquanto o principal é atualizado, tal como acontece com uma única instância.
Sair de um cluster
Para remover um nó de aplicação, volta a definir a sua Função como Autónomo (base de dados própria) e clica em Aplicar. A sua instância de produção para, porque a sua própria base de dados não contém os dados do cluster. Restaura uma cópia de segurança nela antes de a voltar a arrancar.
Um principal não pode ser alterado enquanto ainda tiver nós de aplicação. Remove primeiro os nós.
Resolução de problemas
- O nó continua à espera de ser permitido: verifica se a instância de produção do principal está a correr e se o seu servidor está online. O principal tem de reiniciar uma vez depois de se tornar principal antes de algum nó ser permitido.
- O nó arranca mas o Odoo não sobe: abre os registos do nó. Uma mensagem a dizer que a base de dados do principal não está inicializada significa que o principal ainda não terminou o seu primeiro arranque.
- Os carregamentos ou as sessões não acompanham os visitantes entre nós: os servidores não estão a partilhar o filestore. Consulta "Antes de começar" acima.
- Uma réplica fica em A copiar: verifica se a instância de produção do principal está a correr. A cópia começa quando o principal tiver permitido a réplica, e o reinício da réplica no separador Fila mostra o progresso ou o erro.
Consulta Ramos e instâncias para saber como as instâncias correspondem aos ramos, e Utilizar um balanceador de carga para a definição de balanceador de carga ao nível do servidor, que é uma funcionalidade diferente.
Executa isto nos teus próprios servidores com o CICDoo
Liga um servidor e associa o teu repositório. Deployments, backups e monitorização ficam configurados, e os engenheiros de Odoo estão a uma mensagem de distância.
Ainda com dúvidas? Abra um ticket a partir da aplicação ou fale com um engenheiro.