Ir para o conteúdo
Aura Logo
aurabase

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.

Explicação6 min lidoNível inicianteRevisado em 15 de abr. de 2026

A fonte em inglês mudou desde esta tradução. Algumas informações podem estar desatualizadas.
Esta página foi traduzida automaticamente. A versão em inglês é oficial.

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.

clibash
# 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>
Dica

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)
Informações

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çãoPermissõesMáximo por projeto
ownerGestão completa, faturamento, exclusão de projetos1
adminGestão de equipes, políticas, implantações; sem faturamentoIlimitado
developerLer e escrever tabelas, funções e migraçõesIlimitado
viewerAcesso somente leitura a dados e logs; sem segredosIlimitado
Atenção

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.

ChaveVisibilidadeUsar
anon_keyPúblicoPacotes de clientes e aplicativos móveis. RLS se aplica e as reivindicações são anon.
service_role_keySegredoApenas back-end. Ignora RLS. Nunca envie-o no código do cliente.
user_jwtSessãoEmitido 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)

Para ir mais longe#