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

  1. 01Ouvre un workflow et ajoute GitHub Pull Requests depuis le catalogue.
  2. 02Si ton compte GitHub n'est pas encore connecté, connecte-le directement depuis le panneau du node ou dans Connecteurs.
  3. 03Renseigne les champs requis et associe les valeurs des étapes précédentes.
  4. 04Teste le node avec un petit jeu de données et vérifie sa sortie.
  5. 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

ChampSignificationZone
ActionChoix: 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érificationsStandard
Propriétaire (utilisateur ou org)Le nom GitHub à qui appartient le dépôt, p. ex. anymize.Standard
DépôtNom du dépôt, p. ex. hello-world.Standard
StatutChoix: Ouvert, Fermé, TousStandard
Branche cible uniquementUniquement les pull requests qui visent cette branche, p. ex. main.Standard
Branche source uniquementAu format propriétaire:branche, p. ex. anymize:feature/foo.Standard
TriChoix: Créées récemment, Modifiées récemment, Les plus commentées, Ouvertes depuis le plus longtempsStandard
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 pagesCharge les pages suivantes jusqu'à tout avoir, 1000 entrées au maximum.Standard
PageLa 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 PRConfigure cette valeur dans le panneau du node.Standard
TitreConfigure 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
TexteDescription, avis ou commentaire. Le Markdown est pris en charge.Standard
En brouillonConfigure cette valeur dans le panneau du node.Standard
Autoriser les modifications par les mainteneursConfigure 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 mergeComment le PR est fusionné. En cas de doute, choisis « Merge-Commit ».Standard
Titre du commit de mergeConfigure cette valeur dans le panneau du node.Standard
Message du commit de mergeConfigure cette valeur dans le panneau du node.Standard
Seulement si les vérifications sont au vertDésactivé : intègre aussi si des vérifications manquent ou échouent.Standard
Nouveau statutChoix: Ne pas modifier, Ouverte, FerméeStandard
Nouvelle branche cibleConfigure cette valeur dans le panneau du node.Standard
RelecteursNoms GitHub, séparés par des virgules.Standard
Équipes de relectureIdentifiants d'équipe, séparés par des virgules.Standard
VerdictPour « Demander des modifications » et « Commenter », un texte est requis.Standard
FichierChemin du fichier dans le dépôt, p. ex. src/index.ts.Standard
LigneConfigure cette valeur dans le panneau du node.Standard
CôtéNouvelle version (à droite) ou ancienne version (à gauche).Standard
CommitVide : la version actuelle de la pull request.Standard
Branche ou commitConfigure cette valeur dans le panneau du node.Standard
Compte GitHubLaisse vide pour utiliser ton compte GitHub connecté.Standard
Exécuter une fois par élémentDé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éeSignificationType
StandardReçoit le résultat complet de l'étape précédente.JSON
SortieSignificationType
StandardMet 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.