Visualizar bancos de dados por solicitação pull
Uma ramificação é uma cópia de um projeto com sua própria URL e chaves de API. Crie um por solicitação pull no CI, aponte a visualização para ele e deixe-o expirar ou exclua-o na mesclagem.
Uma solicitação pull = um banco de dados#
aura branch create clona um projeto PostgreSQL (esquema, políticas de segurança em nível de linha, funções, gatilhos, visualizações e linhas) em um novo projeto com seu próprio URL e chaves de API. Uma solicitação pull pode executar sua migração lá e os revisores podem testar o resultado, sem qualquer contenção no projeto de origem. A lista completa do que é ou não clonado e os limites estão nas ramificações do banco de dados branches de banco de dados.
Uma ramificação é uma cópia feita quando você a cria, em tempo proporcional aos dados (14 segundos para 333 MB na pilha de teste local). Não é um clone de cópia na gravação e não segue a fonte posteriormente.
Em CI#
Não há ação GitHub para instalar: a CLI faz o trabalho. Autentique-se com um token de acesso pessoal (aura login --token), crie a ramificação do projeto que você testa e mantenha o que a visualização precisa. Salve cada snippet como um script do seu pipeline:
aura login --token "$AURA_PAT"
aura branch create "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --ttl 3d --json > branch.json
# branch.json: id, slug, url, anon_key, service_role_key, expires_at
aura login --token "$AURA_PAT"
aura branch delete "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --force
As chaves são impressas apenas uma vez, quando o branch é criado: armazene-as no trabalho (ou como segredos da implantação de visualização) naquele momento. Para executar as migrações da solicitação pull na ramificação, vincule a pasta a ela e pressione: aura link --project-id <branch id> então aura db push.
Os comandos aura branch foram executados em uma pilha local; aura login --token é o login das receitas de CI na implantação implantação. O fluxo de trabalho GitHub ou GitLab em torno deles é seu para escrever.
O que o ramo contém#
A ramificação possui as linhas da origem (adicione --no-data apenas para o esquema), incluindo quaisquer dados pessoais que contenham: não há anonimato. Crie a ramificação a partir de um projeto de teste, não de produção, se a visualização não precisar ver dados reais. Usuários de autenticação, objetos de armazenamento, funções de borda e segredos não são clonados; propague-os em sua configuração de visualização.
TTL e cotas#
Uma filial vive 72 horas por padrão, até 30 dias (--ttl). As ramificações expiradas são excluídas automaticamente, assim como uma ramificação cuja criação falha. Uma ramificação não conta no limite do seu projeto; conta no limite de filiais ativas do seu plano (1 no Grátis, 10 no Pro, 25 no Team), consulte limites. Passado o limite, aura branch create falha com BRANCH_LIMIT_REACHED: exclua uma ramificação ou aguarde seu TTL.