DocumentationWorkflowsApps et services
GitHub Releases node
Les versions publiées d'un dépôt : lister, lire, créer, modifier ou supprimer, avec une liste des changements générée automatiquement. Découvre sa configuration, les entrées et sorties, le test et la résolution des erreurs.
9 min de lectureMis à jour le
Fonction du node
Les versions publiées d'un dépôt : lister, lire, créer, modifier ou supprimer, avec une liste des changements générée automatiquement.
Utilise GitHub Releases 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 Releases 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 releases
- Lire une release
- Dernière release
- Release par tag
- Créer une release
- Modifier une release
- Supprimer une release
- Générer les changements
Paramètres
| Champ | Signification | Zone |
|---|---|---|
| Action | Choix: Lister les releases, Lire une release, Dernière release, Release par tag, Créer une release, Modifier une release, Supprimer une release, Générer les changements | 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 |
| 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 |
| ID de la release | Configure cette valeur dans le panneau du node. | Standard |
| Tag | Nom de la version, p. ex. v1.2.0. | Standard |
| Point de départ | Branche ou commit pour un nouveau tag. Vide : la branche par défaut. | Standard |
| Titre | Configure cette valeur dans le panneau du node. | Standard |
| Description | Ce qui est nouveau. Le Markdown est pris en charge. | Standard |
| En brouillon | Configure cette valeur dans le panneau du node. | Standard |
| En préversion | Configure cette valeur dans le panneau du node. | Standard |
| Générer la description automatiquement | Configure cette valeur dans le panneau du node. | Standard |
| Brouillon | Choix: Ne pas modifier, Oui, Non | Standard |
| Préversion | Choix: Ne pas modifier, Oui, Non | Standard |
| Tag précédent | Vide : la dernière release. | 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
Lire la dernière release : 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"
}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 releases, Lire une release, Dernière release, Release par tag, Générer les changements. Ces actions demandent « Autoriser les modifications » : Créer une release, Modifier une release, Supprimer une release.
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.