- Accueil
- Documentation
- Déploiements sous contrôle
Déploiements sous contrôle
Mis à jour le
Comment AI CodeOps confie un changement fusionné à votre pipeline : barrière qualité avant fusion, webhooks de déploiement, règles de politique par environnement et enregistrements de déploiement.
AI CodeOps ne déploie pas de code sur votre infrastructure. Il soumet le changement à ses barrières avant la fusion, appelle votre pipeline de déploiement lorsqu'elle a lieu et conserve un enregistrement de chaque déploiement. C'est votre propre pipeline qui effectue le build et la release.
Le parcours jusqu'à un déploiement
- Le changement d'une session réussit ses tests et sa revue par IA, et une personne l'approuve. Consultez Barrières qualité.
- AI CodeOps ouvre la pull request.
- Vous la fusionnez depuis la console. La barrière qualité s'exécute d'abord de nouveau : des constats high ou critical ouverts, des tests en échec ou une revue inachevée arrêtent la fusion.
- Si le projet du changement a une cible de déploiement, AI CodeOps appelle son webhook et enregistre un déploiement.
La fusion nécessite un rôle qui permet de gérer les déploiements : Owner, Admin, Developer, Member et DevOps Admin. Si la vérification de la barrière ne peut pas s'exécuter, la fusion n'a pas lieu : « The release check couldn't run just now. Try again in a moment. »
La barrière à la fusion s'applique aux pull requests qu'AI CodeOps a ouvertes pour une session. Une pull request écrite à la main par quelqu'un n'a pas de session : la barrière n'a donc ni constats ni tests sur lesquels la juger.
Définir une cible de déploiement
- Ouvrez Release → Deployments et choisissez Deploy targets.
- Pour chaque projet, saisissez la Deploy webhook URL. Ce doit être une adresse
https://publique. - Saisissez l'Environment vers lequel il déploie. La valeur par défaut est
production. - Saisissez éventuellement un Signing secret.
- Choisissez Save.
Laissez l'URL vide pour désactiver les déploiements automatiques de ce projet. Définir des cibles de déploiement nécessite un rôle qui permet de gérer les projets.
Ce que reçoit votre webhook
Lorsqu'un changement est fusionné depuis la console, AI CodeOps envoie un POST avec ce corps :
{
"event": "pr_merged",
"workspaceID": "wrk_…",
"projectID": "billing-api",
"repo": "acme/billing-api",
"prNumber": 42,
"prUrl": "https://github.com/acme/billing-api/pull/42"
}
Avec un secret de signature, la requête porte X-CodeOps-Signature: sha256=<hex> : un HMAC-SHA256 du corps brut, calculé avec votre secret comme clé. Vérifiez-le avant de déployer.
L'appel expire au bout de 10 secondes et ne suit pas les redirections. Une réponse 2xx enregistre le déploiement comme in progress. Toute autre réponse l'enregistre comme failed, avec « The deploy webhook answered HTTP … », et ouvre un incident. Choisissez Retry delivery sur la ligne pour le renvoyer ; chaque nouvelle tentative est un nouvel enregistrement.
Votre pipeline ne peut pas renvoyer le résultat final à AI CodeOps : un déploiement envoyé par webhook reste donc in progress dans l'historique. Pour consigner un déploiement terminé avec son résultat, enregistrez-le à la main (ci-dessous).
Autoriser ou refuser les déploiements automatiques
Les déploiements automatiques suivent les règles release.deploy de la politique de votre espace de travail, appliquées au nom de l'environnement. Par exemple, cette règle arrête les déploiements automatiques en production :
{ "id": "no-production-deploys", "action": "release.deploy", "resource": "production", "decision": "deny" }
Un déploiement refusé n'est jamais envoyé. Il est enregistré comme canceled, et la ligne affiche « not deployed » avec le motif. Si la politique ne peut pas être chargée, le déploiement est annulé de la même façon. Ces règles ne peuvent qu'autoriser ou refuser ; elles ne peuvent pas attendre une approbation. Une personne qui choisit Retry delivery relève de son rôle, pas de ces règles. Consultez Approbations et politiques.
Enregistrer un déploiement à la main
Pour les déploiements qui ont lieu en dehors d'AI CodeOps :
- Ouvrez Release → Deployments et choisissez Record deployment.
- Choisissez le Project et saisissez l'Environment.
- Définissez le Status : succeeded, in progress, queued ou failed.
- Ajoutez éventuellement une Version et un Commit SHA (au moins 7 caractères).
- Choisissez Record deployment.
Enregistrements de déploiement
Chaque enregistrement comporte le projet, l'environnement et un numéro de séquence par environnement, le commit ou la version, le statut, les heures de début et de fin, et la session qui a produit le changement. Les statuts sont queued, in progress, succeeded, failed, rolled back et canceled.
Un déploiement qui réussit pour le changement d'une session marque ce changement deployed sous Develop → Changes. Les enregistrements alimentent les métriques de livraison du tableau de bord, ainsi que le dossier de preuves du changement.
Vérifier une release depuis la CI
Votre pipeline peut interroger la barrière de livraison avant de déployer. Appelez POST /api/release/check avec une clé API de l'espace de travail, l'URL de la pull request ou le SHA du commit, et des options comme requireDeployedTo. Avec "requireDeployedTo": "staging", la release est refusée sauf si le changement a déjà un déploiement succeeded en staging : « Not yet deployed to "staging" — promote there before releasing ». Vérifiez allowed dans la réponse. Les champs sont décrits sur la page de l'API, et Barrière de livraison dans la CI propose des jobs de pipeline à copier.
Vous pouvez lancer la même vérification à la main sous Review & Gate → Release gate : saisissez l'URL d'une pull request ou le SHA d'un commit et choisissez Evaluate gate.
Étapes suivantes
Questions fréquentes
AI CodeOps déploie-t-il sur mes serveurs ?
Non. Il appelle un webhook de déploiement que vous définissez par projet, et c'est votre propre pipeline qui déploie. AI CodeOps ne détient aucun identifiant pour votre infrastructure.
Une politique peut-elle empêcher les déploiements automatiques en production ?
Oui. Une règle release.deploy peut refuser les déploiements automatiques par environnement. Un déploiement refusé est enregistré comme canceled, avec le motif, et rien n'est envoyé.
Un déploiement peut-il attendre une approbation humaine ?
Pas comme étape distincte. L'approbation a lieu plus tôt, sur le changement, avant l'ouverture de sa pull request. Les règles de déploiement ne peuvent qu'autoriser ou refuser.