Aller au contenu
Logo Aurabase
aurabase

Bases de préproduction par pull request

Une branche est une copie d'un projet avec sa propre URL et ses propres clés d'API. Créez-en une par pull request en CI, pointez la prévisualisation dessus, et laissez-la expirer ou supprimez-la au merge.

Guide pratique5 min de lectureNiveau intermédiaireRévisé le 12 nov. 2026

Une pull request = une base#

aura branch create clone un projet PostgreSQL (schéma, policies de sécurité au niveau des lignes, fonctions, triggers, vues et lignes) dans un nouveau projet avec sa propre URL et ses propres clés d'API. Une pull request peut y jouer sa migration, et les relecteurs y essayer le résultat, sans aucune contention sur le projet source. La liste complète de ce qui est cloné ou non, et les limites, sont dans les branches de base de données.

Informations

Une branche est une copie faite à la création, en un temps proportionnel aux données (14 secondes pour 333 Mo sur la pile de test locale). Ce n'est pas un clone copy-on-write, et elle ne suit pas la source ensuite.

En CI#

Il n'y a aucune GitHub Action à installer : la CLI fait le travail. Authentifiez-vous avec un Personal Access Token (aura login --token), puis créez la branche à partir du projet sur lequel vous testez et récupérez ce dont la prévisualisation a besoin :

open-preview.shbash
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
close-preview.shbash
aura login --token "$AURA_PAT"
aura branch delete "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --force

Les clés ne sont affichées qu'une fois, à la création de la branche : conservez-les tout de suite dans le job (ou dans les secrets du déploiement de prévisualisation). Pour jouer les migrations de la pull request sur la branche, liez le dossier à celle-ci puis poussez : aura link --project-id <id de la branche> puis aura db push.

Les commandes aura branch ont été exécutées sur une pile locale ; aura login --token est la connexion des recettes CI de la page Déploiement. Le workflow GitHub ou GitLab qui les entoure reste à écrire de votre côté.

Contenu de la branche#

La branche contient les lignes de la source (ajoutez --no-data pour le schéma seul), y compris les données personnelles qu'elles portent : il n'y a aucune anonymisation. Créez la branche à partir d'un projet de préproduction, pas de la production, si la prévisualisation ne doit pas voir de données réelles. Les utilisateurs d'authentification, les objets de stockage, les fonctions edge et les secrets ne sont pas clonés ; alimentez-les dans la mise en place de votre prévisualisation.

TTL et quotas#

Une branche vit 72 heures par défaut, jusqu'à 30 jours (--ttl). Les branches échues sont supprimées automatiquement, de même qu'une branche dont la création échoue. Une branche ne compte pas dans votre limite de projets ; elle compte dans la limite de branches actives de votre plan (1 en Free, 10 en Pro, 25 en Team), voir les limites. Au-delà, aura branch create échoue avec BRANCH_LIMIT_REACHED : supprimez une branche ou attendez son TTL.

Pour aller plus loin#