Fichiers et branches GitHub node

Lit et écrit des fichiers, des branches et des commits dans un dépôt, p. ex. « Que dit le README sur main ? » ou enregistrer un fichier avec un commit. Découvre sa configuration, les entrées et sorties, le test et la résolution des erreurs.

10 min de lectureMis à jour le 10 septembre 2026

Fonction du node

Lit et écrit des fichiers, des branches et des commits dans un dépôt, p. ex. « Que dit le README sur main ? » ou enregistrer un fichier avec un commit.

Utilise Fichiers et branches GitHub 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 Fichiers et branches GitHub 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 branches
Lister les commits
Lire un fichier
Lire une branche
Créer une branche
Supprimer une branche
Lire un commit
Comparer des versions
Lire le README
Enregistrer un fichier
Supprimer un fichier
Chercher du code
Lister les tags

Paramètres

Champ	Signification	Zone
Action	Choix: Lister les branches, Lister les commits, Lire un fichier, Lire une branche, Créer une branche, Supprimer une branche, Lire un commit, Comparer des versions, Lire le README, Enregistrer un fichier, Supprimer un fichier, Chercher du code, Lister les tags	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
Branches protégées uniquement	Configure cette valeur dans le panneau du node.	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
Branch	Quelle branche, p. ex. main.	Standard
Chemin du fichier	Chemin dans le dépôt, p. ex. src/index.ts ou README.md.	Standard
Par personne	Nom GitHub ou e-mail.	Standard
Modifié depuis	Uniquement les entrées modifiées depuis ce moment, p. ex. 2026-01-31T00:00:00Z.	Standard
Modifié jusqu'au	Configure cette valeur dans le panneau du node.	Standard
Version (Branch)	La branche à lire, p. ex. main. Les pros peuvent indiquer un hash de commit.	Standard
Nouvelle branche	Configure cette valeur dans le panneau du node.	Standard
Point de départ	Branche, tag ou commit à partir duquel tu crées la branche. Vide : la branche par défaut.	Standard
Commit ou branche	Configure cette valeur dans le panneau du node.	Standard
De	Version plus ancienne, branche ou commit.	Standard
Jusqu'à	Version la plus récente, branche ou commit.	Standard
Contenu	Le nouveau contenu du fichier.	Standard
Format du contenu	Choix: Texte, Base64	Standard
Message de commit	En bref, ce qui a changé.	Standard
Version précédente du fichier	Réservé aux pros. Vide : déterminée automatiquement.	Standard
Terme de recherche	Un mot-clé est requis. Les pros peuvent utiliser des filtres, p. ex. repo:octocat/hello-world.	Standard
Compte GitHub	Laisse vide, l'étape utilise alors 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

Lire le README de la branche par défaut : 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",
  "path": "README.md"
}

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 branches, Lister les commits, Lire un fichier, Lire une branche, Lire un commit, Comparer des versions, Lire le README, Chercher du code, Lister les tags. Ces actions demandent « Autoriser les modifications » : Créer une branche, Supprimer une branche, Enregistrer un fichier, Supprimer un fichier.

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.