---
title: Demander une exécution
description: Démarrer le traitement d'une issue automatiquement par la surveillance ou manuellement avec le bouton Demander une exécution.
---

# Demander une exécution

Une exécution démarre de deux façons : automatiquement à la réception d'une issue sur un dépôt surveillé, ou à la demande d'un membre depuis le dossier de l'issue.

**Qui peut le faire** : l'Opérateur, le Responsable et l'Administrateur. Le Lecteur ne voit pas la carte **Exécution**.

## Démarrage automatique

Quand une issue s'ouvre ou se rouvre sur un dépôt dont la case **Surveiller les nouvelles issues** est cochée, la plateforme met une exécution en file, si l'issue n'en a pas déjà une. Le détail de la réception est décrit dans [Réception des issues GitHub](../02-projets-et-depots/08-reception-des-issues.md).

Le nombre d'exécutions simultanées par dépôt est limité par le champ **Nombre maximal d'exécutions** de la politique (de 1 à 10 exécutions). Au-delà, les nouvelles issues attendent leur tour.

## Démarrage manuel, pas à pas

1. Ouvrez **Issues et exécutions**, puis l'issue concernée.
2. Dans la carte **Exécution**, cliquez sur **Demander une exécution**.
3. Le message **Demande en cours d'envoi** s'affiche brièvement.
4. La page de l'exécution s'ouvre. Son badge indique **En file**, puis **En cours**.

La demande manuelle suit les mêmes règles que le démarrage automatique : mêmes budgets, même plafond de concurrence, mêmes contrôles par le worker.

## Conditions à remplir

Le bouton n'est actif que si toutes ces conditions sont réunies :

| Condition | Où la régler |
| --- | --- |
| Le dépôt est actif | Case **Autoriser les travaux sur ce dépôt**, voir [Rattacher un dépôt](../02-projets-et-depots/03-rattacher-un-depot.md) |
| Le dépôt est lié à la GitHub App | **Vérifier et rattacher**, voir [Lier le dépôt à la GitHub App](../02-projets-et-depots/04-liaison-github-app.md) |
| Le dépôt est surveillé | Case **Surveiller les nouvelles issues**, voir [Surveillance et politique du dépôt](../02-projets-et-depots/05-surveillance-et-politique.md) |
| L'issue est ouverte sur GitHub | Sur GitHub |
| Aucune exécution n'existe déjà pour cette issue | Une seule exécution initiale par issue |

Quand une condition manque, la carte affiche **Demande indisponible** avec la raison :

- « L'issue est fermée sur GitHub : aucune exécution ne peut être demandée. »
- « Le dépôt doit être actif, lié à GitHub et sous surveillance pour demander une exécution. »

## Pendant un arrêt global

Si l'Administrateur a activé l'[arrêt global](../06-administration-et-supervision/09-arret-global.md), votre demande est quand même acceptée et mise en file. Le badge **En file** s'accompagne de **En attente de la levée de l'arrêt global**, et l'encadré du même nom précise : « La demande est enregistrée. Elle démarrera une seule fois après la levée de l'arrêt, avec ses budgets et ses verrous. ». Vous pouvez l'annuler en attendant.

## Une exécution existe déjà

Une issue n'a qu'une exécution initiale. Si elle existe, la carte affiche **Une exécution existe déjà pour cette issue**, son état et le lien **Suivre l'exécution**. Ce lien mène à la dernière tentative de l'issue.

Pour traiter l'issue de nouveau, utilisez les reprises : voir [Relancer, annuler, archiver](06-relancer-annuler-archiver.md).

## Ce qui se passe ensuite

Le worker prend l'exécution en charge. Avant chaque appel au modèle, il revérifie l'issue, le rattachement GitHub, la politique et vos droits. Si l'un d'eux a changé, l'exécution s'arrête sans effet.

## Refus courants

| Message | Cause | Que faire |
| --- | --- | --- |
| « Votre rôle ne permet pas de demander une exécution. » | Rôle Lecteur ou rôle retiré | Demandez un rôle Opérateur au Responsable du projet |
| « L'issue est fermée ou le dépôt n'est plus lié et surveillé. » | État changé entre l'affichage et le clic | Rechargez la page et vérifiez les conditions |
| « Exécution non demandée. Réessayez plus tard. » | Service momentanément indisponible | Réessayez dans quelques minutes |

> [!NOTE]
> Une exécution peut aussi être demandée par l'API avec une clé personnelle (scope `runs:create`). Voir [Intégration API](../07-integration-api/01-vue-d-ensemble.md) et [Ressources pour agents IA](../07-integration-api/07-agent-ia.md).

## Pour continuer

[Les cinq agents](04-les-cinq-agents.md)
