DocumentationWorkflowsApps et services
GitHub Pull Requests node
Pull requests dans un dépôt : chercher, afficher, créer, relire ou merger, p. ex. générer automatiquement une PR de nettoyage depuis un workflow et ne l'intégrer que si les vérifications sont au vert. Découvre sa configuration, les entrées et sorties, le test et la résolution des erreurs.
12 min de lectureMis à jour le
Fonction du node
Pull requests dans un dépôt : chercher, afficher, créer, relire ou merger, p. ex. générer automatiquement une PR de nettoyage depuis un workflow et ne l'intégrer que si les vérifications sont au vert.
Utilise GitHub Pull Requests comme étape clairement définie dans un workflow anymize.
- Traite 1 entrée.
- Fournit 1 sortie aux étapes suivantes.
- S'exécute comme une étape normale du workflow.
Configurer le node
- 01Ouvre un workflow et ajoute GitHub Pull Requests depuis le catalogue.
- 02Si ton compte GitHub n'est pas encore connecté, connecte-le directement depuis le panneau du node ou dans Connecteurs.
- 03Renseigne les champs requis et associe les valeurs des étapes précédentes.
- 04Teste le node avec un petit jeu de données et vérifie sa sortie.
- 05Relie la sortie réussie et active le workflow après un test complet.
Actions et modes
Choisis la fonction voulue dans Action. Le panneau affiche ensuite les paramètres utiles.
- Lister les PR
- Lire un PR
- Créer un PR
- Merger un PR
- Fichiers modifiés
- Commits de la PR
- Modifier la PR
- Mettre à jour la branche
- Déjà mergée ?
- Demander une revue
- Retirer une demande de revue
- Lister les revues
- Soumettre une revue
- Commentaires de ligne
- Commenter une ligne
- Lire les vérifications
Paramètres
| Champ | Signification | Zone |
|---|---|---|
| Action | Choix: Lister les PR, Lire un PR, Créer un PR, Merger un PR, Fichiers modifiés, Commits de la PR, Modifier la PR, Mettre à jour la branche, Déjà mergée ?, Demander une revue, Retirer une demande de revue, Lister les revues, Soumettre une revue, Commentaires de ligne, Commenter une ligne, Lire les vérifications | Standard |
| Propriétaire (utilisateur ou org) | Le nom GitHub à qui appartient le dépôt, p. ex. anymize. | Standard |
| Dépôt | Nom du dépôt, p. ex. hello-world. | Standard |
| Statut | Choix: Ouvert, Fermé, Tous | Standard |
| Branche cible uniquement | Uniquement les pull requests qui visent cette branche, p. ex. main. | Standard |
| Branche source uniquement | Au format propriétaire:branche, p. ex. anymize:feature/foo. | Standard |
| Tri | Choix: Créées récemment, Modifiées récemment, Les plus commentées, Ouvertes depuis le plus longtemps | Standard |
| Nombre (max. 100) | Combien d'entrées sont chargées par appel. Sans effet avec « Charger toutes les pages », c'est alors toujours 100 par page. | Standard |
| Charger toutes les pages | Charge les pages suivantes jusqu'à tout avoir, 1000 entrées au maximum. | Standard |
| Page | La page à partir de laquelle charger, p. ex. la page suivante de l'appel précédent. Vide : la première. Sans effet avec « Charger toutes les pages ». | Standard |
| N° de PR | Configure cette valeur dans le panneau du node. | Standard |
| Titre | Configure cette valeur dans le panneau du node. | Standard |
| Branche source (de) | La branche avec tes modifications, p. ex. feature/foo. | Standard |
| Branche cible (vers) | La branche dans laquelle les modifications sont intégrées, généralement main. | Standard |
| Texte | Description, avis ou commentaire. Le Markdown est pris en charge. | Standard |
| En brouillon | Configure cette valeur dans le panneau du node. | Standard |
| Autoriser les modifications par les mainteneurs | Configure cette valeur dans le panneau du node. | Standard |
| Version vérifiée (commit) | Le commit qui a été vérifié. Si la pull request a changé depuis, rien ne se passe. Vide : la version actuelle. | Standard |
| Méthode de merge | Comment le PR est fusionné. En cas de doute, choisis « Merge-Commit ». | Standard |
| Titre du commit de merge | Configure cette valeur dans le panneau du node. | Standard |
| Message du commit de merge | Configure cette valeur dans le panneau du node. | Standard |
| Seulement si les vérifications sont au vert | Désactivé : intègre aussi si des vérifications manquent ou échouent. | Standard |
| Nouveau statut | Choix: Ne pas modifier, Ouverte, Fermée | Standard |
| Nouvelle branche cible | Configure cette valeur dans le panneau du node. | Standard |
| Relecteurs | Noms GitHub, séparés par des virgules. | Standard |
| Équipes de relecture | Identifiants d'équipe, séparés par des virgules. | Standard |
| Verdict | Pour « Demander des modifications » et « Commenter », un texte est requis. | Standard |
| Fichier | Chemin du fichier dans le dépôt, p. ex. src/index.ts. | Standard |
| Ligne | Configure cette valeur dans le panneau du node. | Standard |
| Côté | Nouvelle version (à droite) ou ancienne version (à gauche). | Standard |
| Commit | Vide : la version actuelle de la pull request. | Standard |
| Branche ou commit | Configure cette valeur dans le panneau du node. | Standard |
| Compte GitHub | Laisse vide pour utiliser ton compte GitHub connecté. | Standard |
| Exécuter une fois par élément | Désactivé (par défaut) : le node s'exécute une fois pour tout l'input. Activé : s'il reçoit plusieurs éléments (par ex. de « Séparer la liste »), il s'exécute une fois PAR élément, et {{ $json }} correspond alors à cet élément. C'est ainsi que tu traites une liste de fichiers entrée par entrée. | Standard |
| Si un élément échoue | « Ignorer » écrit un champ `error` pour l'élément en échec et poursuit avec les autres, au lieu de perdre toute l'exécution à cause d'un seul fichier illisible. | Standard |
| Pause entre les éléments (millisecondes) | Attente avant chaque exécution sauf la première. 1000 = 1 seconde par élément. Utile si le service distant te limite. Maximum 300000 (5 minutes). | Standard |
Entrées et sorties
| Entrée | Signification | Type |
|---|---|---|
| Standard | Reçoit le résultat complet de l'étape précédente. | JSON |
| Sortie | Signification | Type |
|---|---|---|
| Standard | Met le résultat à disposition de l'étape suivante au format JSON. | JSON |
Ce node peut traiter les listes élément par élément. La gestion des erreurs et la pause se trouvent dans les paramètres avancés.
Exemple et test
Créer un PR ouvert depuis un workflow : commence avec un petit jeu de données reconnaissable. Vérifie la sortie et utilise uniquement les champs présents.
Exemple de test
{
"owner": "octocat",
"repo": "hello-world",
"head": "feat/copilot-tools",
"base": "main",
"title": "Add Copilot Tools"
}Accès et sécurité
Le node travaille avec ton propre compte GitHub connecté. Il ne voit et ne modifie que ce que ce compte a le droit de faire. Vérifie les autorisations affichées au moment de la connexion. Le domaine correspondant (Issues, Pull Requests, Dépôts) doit aussi être activé dans les paramètres de ta connexion GitHub sous Connecteurs. Par défaut, tous les domaines sont activés.
Le réglage « Actions autorisées » de ta connexion GitHub sous Connecteurs s'applique aussi à ce node et il est vérifié à chaque exécution. Avec « Lecture seule » ou « Lire et créer des brouillons », seules les actions de lecture s'exécutent : Lister les PR, Lire un PR, Fichiers modifiés, Commits de la PR, Déjà mergée ?, Lister les revues, Commentaires de ligne, Lire les vérifications. Ces actions demandent « Autoriser les modifications » : Créer un PR, Merger un PR, Modifier la PR, Mettre à jour la branche, Demander une revue, Retirer une demande de revue, Soumettre une revue, Commenter une ligne.
Les clés et identifiants ont leur place dans les Secrets des workflows ou dans tes comptes connectés. Ne les colle jamais en texte clair dans les champs, les données de test ou les descriptions.
Résoudre les erreurs
- Aucune sortie : vérifie la dernière exécution et les champs fournis par le node précédent.
- Variable vide : ouvre la sortie précédente et utilise un nom de champ réellement présent.
- Connexion refusée : reconnecte le service avec les autorisations nécessaires.
- Action bloquée : passe « Actions autorisées » de la connexion sous Connecteurs sur « Autoriser les modifications », ou choisis une action de lecture.
- Liste traitée une seule fois : active l'exécution par élément.