Como Subir MariaDB na Zenifra via Console

Permissões necessárias

Para criar este projeto por API, o usuário ou a API Key da organização precisa de database.create em organization:*. Depois da criação, use o ID retornado do projeto:

Ação	Scope mínimo
Criar MariaDB	`database.create` em `organization:*`
Visualizar o projeto do banco	`project.read` em `project:<project-id>`
Visualizar status do banco	`database.status.read` em `database:<project-id>`
Visualizar conexão	`database.connection.read` em `database:<project-id>`

Uma sessão de usuário owner tem acesso completo. Para assistant ou member, conceda exatamente o grant correspondente; uma API Key da organização usa o mesmo formato em permissions.resources. A criação não exige project.read, mas uma automação que também queira consultar o projeto precisa desse scope separadamente.

Pré-requisitos

conta criada e verificada
login realizado no console

Passo 1: Escolher o tipo de projeto

No console, clique em Criar projeto e selecione Banco de Dados MariaDB.

O que está incluído

MariaDB gerenciado
versões 10 e 11
3 instâncias fixas
failover automático
engine InnoDB por padrão
conexão com TLS obrigatório, via URI pronta e parâmetros individuais

Passo 2: Selecionar o plano

Escolha o plano e o modelo de pagamento que fazem sentido para o banco. O MariaDB está disponível a partir do db-starter (não há db-free para MariaDB). Como o banco sempre usa 3 instâncias, o valor do plano é cobrado para cada uma delas, e o armazenamento é cobrado por GB em cada instância. Veja os valores em Planos de Banco de Dados.

Modelos de pagamento

Modelo	Descrição
Por Hora	Cobra as instâncias, proporcionalmente ao tempo, enquanto o banco está executando
Por Mês	Contrato mensal com valor fixo
Por Ano	Contrato anual com valor fixo

Importante: O storage do banco é sempre persistente. Mesmo com o banco parado, o armazenamento continua existindo e sendo cobrado.

Passo 3: Configurar informações básicas

Nome do projeto

mínimo: 6 caracteres
máximo: 32 caracteres
apenas letras minúsculas, números e hífens

Descrição

Campo opcional para organização no console.

Passo 4: Configurar o banco

Versão do MariaDB

Escolha a versão desejada entre:

MariaDB 10
MariaDB 11

Usuário e banco padrão

username: app
database name: app

Senha

A senha é gerada pela plataforma e exibida uma única vez, ao final da criação. Guarde-a com cuidado, porque será usada para conectar a aplicação ou clientes externos. Se perder a senha, gere uma nova na edição do projeto.

Passo 5: Réplicas e failover

O MariaDB na Zenifra usa uma topologia fixa de 3 instâncias:

1 instância primária, que recebe as conexões de escrita e leitura
2 réplicas, que mantêm cópia dos dados e podem assumir em caso de falha da primária

A conexão disponibilizada no console aponta para a instância primária. Essa quantidade não pode ser alterada depois.

Passo 6: Storage

mínimo: 1 GB
máximo: 250 GB

Regras importantes:

o storage pode aumentar
o storage nunca pode diminuir
a alteração só está disponível no pagamento por hora; em mensal e anual, a capacidade fica fixa durante o contrato
aumentar storage pode causar alguns minutos de indisponibilidade

Passo 7: Finalizar a criação

revise as configurações
clique em Criar Projeto
aguarde a provisão do banco

Após a criação

O console exibirá:

ID do projeto
host (mariadb-<id-do-projeto>.managed.zenifra.com)
porta
username app
database name app
URI completa pronta para copiar, no formato mariadb://app:<senha>@<host>:<porta>/app?ssl=true

A senha aparece somente nessa tela. Depois, o console mostra a URI com a senha mascarada.

Backups: a Zenifra não oferece hoje backup automático nem restauração pelo console. Faça exportações periódicas com mariadb-dump/mysqldump e guarde as cópias fora do projeto.