Como publicar o Metabase na Zenifra

O Metabase pode ser publicado na Zenifra como um projeto HTTP a partir da imagem oficial. Este guia mostra a configuração recomendada, as variáveis necessárias e como validar o resultado.

Pré-requisitos

Conta verificada e acesso ao console.
Permissão para criar projetos na organização (project.create).
Crédito ou cartão cadastrado para o plano escolhido; veja Modelos de pagamento.

O Metabase está no catálogo público de Templates. Use Implantar para criar a aplicação com a configuração recomendada, ou Personalizar para revisar plano, armazenamento e variáveis e, se quiser, criar um banco de dados junto antes de confirmar. Os passos abaixo mostram uma configuração manual a partir da imagem oficial.

Passo 1: criar o projeto HTTP

No console, clique em + Criar Projeto, escolha HTTP e preencha:

Campo	Valor
Origem do projeto	Imagem Docker
Imagem	`docker.io/metabase/metabase:v0.56.2.3`
Registry	Público, sem autenticação
Plano	Premium Plus (2 vCPU e 2 GB de RAM) ou superior. O Metabase precisa de pelo menos 2 GB de RAM para iniciar de forma estável.
Porta	`3000`
Instâncias	1 para começar. Com o banco de aplicação em PostgreSQL, é possível aumentar depois.
Armazenamento persistente	Não, ao usar banco externo

Escolha um nome entre 6 e 32 caracteres, com letras minúsculas, números e hífens; ele também define o endereço *.clients.zenifra.com. Para testes, o modelo por hora é o mais barato; para uso contínuo, compare com o mensal.

Armazenamento

Não é necessário quando o Metabase usa um PostgreSQL gerenciado como banco de aplicação (recomendado). Sem banco externo, o Metabase grava suas configurações em arquivo local, que é perdido ao reiniciar.

Passo 2: configurar variáveis de ambiente

Cadastre as variáveis abaixo no passo Variáveis de ambiente:

MB_DB_TYPE=postgres
MB_DB_HOST=<host-do-postgresql>
MB_DB_PORT=<porta-do-postgresql>
MB_DB_DBNAME=app
MB_DB_USER=app
MB_DB_PASS=<senha-do-postgresql>

Crie antes um PostgreSQL gerenciado e copie host, porta e senha do console. Para um teste rápido, você pode omitir essas variáveis, sabendo que as configurações serão perdidas ao reiniciar. Veja Variáveis de ambiente.

Passo 3: criar e validar

Revise o custo estimado e clique em Criar Projeto. Ao final, o console abre a página do projeto com o endereço público.

Abra a URL do projeto. A primeira inicialização do Metabase pode levar alguns minutos; acompanhe os logs do projeto até a interface responder. Conclua o assistente inicial criando a conta de administrador e conecte sua primeira fonte de dados.

Se a aplicação não responder, confira os logs do projeto, a porta configurada e o guia de solução de problemas.

Recomendações para produção

Use sempre o PostgreSQL gerenciado como banco de aplicação.
Conecte o Metabase às suas bases com um usuário somente leitura.
Restrinja o acesso por IP com controle de acesso quando o plano permitir.

Para remover o projeto, abra-o em Projetos e clique em Excluir. A exclusão é permanente e apaga o armazenamento.