Gerenciamento de projetos
Tudo que envolve um projeto Aurabase: criação, regiões, equipe, funções, chaves de API, monitoramento, faturamento. Um projeto = um banco de dados Postgres dedicado no cluster da sua organização + um namespace completo.
Um projeto, um namespace completo#
Um projeto Aurabase fornece: um banco de dados PostgreSQL dedicado com quatro subesquemas (hospedado no cluster CNPG da sua organização ou em um cluster inteiramente dedicado ao projeto na oferta corporativa), um par de chaves de API (anon + service_role), um identificador UUID que serve como prefixo para todas as suas rotas (/v1/<service>/{project_id} — não há domínio por projeto), um bucket de armazenamento padrão, um escopo para funções de ponta e um orçamento.
O faturamento é por consumo no plano Pro e taxa fixa no Enterprise. Um projeto pode ser pausado (os recursos permanecem alocados, não faturados) ou excluído (dados excluídos em até 30 dias).
Crie um projeto#
No console (console.aurabase.cloud): um nome e um mecanismo de banco de dados. A região é aquela que sua implantação declara para seu cluster de banco de dados — a única disponível, mostrada no formulário — e o plano é da sua organização. Provisioning leva de 45 segundos a 1,5 minutos (medido: cerca de 45 s quando o cluster da organização é criado, cerca de 90 s com a CLI, que aguarda a ativação do projeto) — base criada no cluster PostgreSQL da sua organização (ou cluster dedicado provisionado em tempo real na oferta corporativa), esquemas inicializados, chaves geradas, tipos TypeScript pré-gerados. Ao excluir o último projeto de uma organização, seu cluster é excluído imediatamente; o próximo projeto cria um novo.
# Alternativa CLI (não interativa)
aura projects create my-saas --org <org-slug>
# Chaves API do projeto (vinculadas em aurabase.toml ou --project-id)
aura projects api-keys --project-id <project-uuid>
As chaves são exibidas apenas uma vez após a criação. Eles podem ser regenerados (antigos invalidados imediatamente) no Studio ou via Settings › Connection.
8 regiões GA · Paris por padrão#
Seu projeto está fixado em sua região de criação. Dados, backups, réplicas e caches CDN permanecem nesta região. A mudança de região envolve uma migração assistida pela nossa equipe (contato migrate@aurabase.cloud).
fr-par— Paris · Scaleway (FR)de-fsn— Falkenstein / Nürnberg · Hetzner (DE)fi-hel— Helsinki · Hetzner (FI)
Somente empresa: fixação em nível de país, compromisso contratual. Nenhuma certificação de terceiros (SecNumCloud FR, C5 DE) foi ainda comprometida – roteiro público em nossa Central de Confiança.
Quatro funções padrão, RBAC personalizado disponível#
Cada projeto possui um owner exclusivo (o criador padrão, transferível). Além disso, você convida membros com uma função predefinida ou uma função personalizada definida por meio de política.
| Função | Permissões | Máximo por projeto |
|---|---|---|
owner | Gestão completa, faturamento, exclusão de projetos | 1 |
admin | Gestão de equipes, políticas, implantações; sem faturamento | Ilimitado |
developer | Ler e escrever tabelas, funções e migrações | Ilimitado |
viewer | Acesso somente leitura a dados e logs; sem segredos | Ilimitado |
Um viewer nunca vê os segredos ou valores de service_role_key. Os logs de auditoria registram cada acesso a recursos confidenciais por 30 dias (2 anos no Enterprise).
Anon, service_role, JWT personalizado#
Três tipos de chaves. Use o caminho certo para a superfície certa.
| Chave | Visibilidade | Usar |
|---|---|---|
anon_key | Público | Pacotes de clientes e aplicativos móveis. RLS se aplica e as reivindicações são anon. |
service_role_key | Segredo | Apenas back-end. Ignora RLS. Nunca envie-o no código do cliente. |
user_jwt | Sessão | Emitido por aura-auth após login. Expira após 15 minutos e gira automaticamente. |
Métricas ao vivo + cotas#
O Studio expõe métricas em tempo real em cada serviço: solicitações/seg, latência p50/p99, conexões ativas, taxa de erros, uso/saída de armazenamento. Exporte para Datadog, Grafana Cloud, Honeycomb via webhook ou endpoint Prometheus.
- REQ/S do banco de dados: 1 240 (média 5 minutos)
- P99 LEIA: 8ms (selecione os últimos 100)
- ARMAZENAMENTO: 4,2GB (100 GB · Plano Pro)
- INV. DE BORDA: 48k (este mês · Cota de 5 milhões)