AI CodeOps

Next.js : déploiement sous contrôle en staging, puis en production

Mis à jour le

Créez un changement d'interface Next.js avec UI Implementation, fusionnez-le via la barrière, appelez votre webhook de déploiement en staging et ne livrez en production qu'après le staging.

Utiliser ce template

Une page de tarifs est un changement que vous voulez faire essayer avant que vos clients ne le découvrent. Ce template crée un changement d'interface Next.js, l'envoie en staging par votre propre pipeline une fois fusionné, et bloque la production tant que le staging ne l'a pas reçu.

Quels agents interviennent

ÉtapeAgent
UI planUI Designer
ImplementBuilder
Code reviewReviewer
Behavior testTester

L'UI Designer planifie la mise en page, les états et l'accessibilité (ordre du focus, libellés, état pressé du bouton bascule). Après l'étape Implement, la passe de code écrit le changement et le script de test de votre package.json s'exécute dans un bac à sable hors ligne. Les étapes Code review et Behavior test lisent ensuite le changement écrit et le résultat de test, et la revue des constats lit le diff. Les constats high ou critical ouverts et les tests en échec bloquent, et une personne autre que celle qui a lancé la session approuve avant l'ouverture de la pull request, lorsque l'espace de travail compte un autre approbateur.

Envoyer les fusions en staging

Ouvrez Release → Deployments, choisissez Deploy targets et, pour le projet, saisissez :

ChampExemple de valeur
Deploy webhook URLhttps://deploy.example.com/hooks/web-staging
Environmentstaging
Signing secretune chaîne aléatoire que votre pipeline connaît aussi

Lorsque vous fusionnez la pull request depuis la console, la barrière qualité s'exécute d'abord de nouveau. AI CodeOps envoie ensuite un POST pr_merged, signé avec X-CodeOps-Signature, et enregistre un déploiement comme in progress. Votre pipeline effectue le build et déploie en staging. Un appel de webhook en échec ouvre un incident.

Promouvoir en production uniquement depuis le staging

Votre pipeline ne peut pas renvoyer le résultat final. Une fois le staging en bonne santé, choisissez donc Record deployment, avec l'environnement staging, le statut succeeded et le Commit SHA que vous avez déployé. Le job de production interroge alors la barrière :

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\",\"commitSHA\":\"$COMMIT_SHA\",\"requireDeployedTo\":\"staging\"}" \
  | jq -e '.allowed == true'

L'URL de la pull request permet de retrouver la session ; le SHA du commit doit correspondre à l'enregistrement de staging. Sans cet enregistrement, la réponse est un refus : « Not yet deployed to "staging" — promote there before releasing ». Consultez Déploiements sous contrôle.

Si la production tourne mal, faites le rollback dans votre pipeline et marquez le déploiement comme rolled back, comme l'explique Effectuer le rollback d'un déploiement. Pour le volet revue de la même application, commencez par le template de revue de PR Next.js.

Questions fréquentes

AI CodeOps héberge-t-il un environnement de prévisualisation ou de staging ?

Non. Il appelle le webhook de déploiement que vous avez défini, et c'est votre propre pipeline qui déploie. AI CodeOps ne détient aucun identifiant pour votre infrastructure.

Pourquoi la vérification de production indique-t-elle que le changement n'est pas encore en staging ?

Un déploiement par webhook reste in progress, car votre pipeline ne peut pas renvoyer son résultat. Enregistrez le déploiement en staging comme succeeded, avec son SHA de commit, avant de livrer.