# Déploiements sous contrô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.

Source: https://aicodeops.dev/fr/docs/gated-deploys · Mis à jour le: 2026-10-18

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

1. Le changement d'une session réussit ses tests et sa revue par IA, et une personne l'approuve. Consultez [Barrières qualité](https://aicodeops.dev/fr/docs/quality-gates).
2. AI CodeOps ouvre la pull request.
3. 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.
4. 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

1. Ouvrez **Release → Deployments** et choisissez **Deploy targets**.
2. Pour chaque projet, saisissez la **Deploy webhook URL**. Ce doit être une adresse `https://` publique.
3. Saisissez l'**Environment** vers lequel il déploie. La valeur par défaut est `production`.
4. Saisissez éventuellement un **Signing secret**.
5. 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 :

```json
{
  "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 :

```json
{ "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](https://aicodeops.dev/fr/docs/approvals-and-policies).

## Enregistrer un déploiement à la main

Pour les déploiements qui ont lieu en dehors d'AI CodeOps :

1. Ouvrez **Release → Deployments** et choisissez **Record deployment**.
2. Choisissez le **Project** et saisissez l'**Environment**.
3. Définissez le **Status** : succeeded, in progress, queued ou failed.
4. Ajoutez éventuellement une **Version** et un **Commit SHA** (au moins 7 caractères).
5. 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](https://aicodeops.dev/fr/docs/evidence-packs) 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](https://aicodeops.dev/fr/docs/api), et [Barrière de livraison dans la CI](https://aicodeops.dev/fr/docs/release-gate-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

- [Rollback](https://aicodeops.dev/fr/docs/rollback)
- [Barrières qualité](https://aicodeops.dev/fr/docs/quality-gates)
- [Déploiements sous contrôle et suivi des rollbacks](https://aicodeops.dev/fr/product/deploy)

## 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.
