Ressources · Intégration n8n

Intégration CircleCI n8nAutomatiser CircleCI avec n8n.

Tes builds peuvent se lancer et rendre des comptes tout seuls. L'intégration CircleCI n8n porte 3 opérations sur une seule ressource Pipeline : lire un pipeline, en lister plusieurs, en démarrer un. Sans nœud trigger CircleCI, le workflow part d'un Schedule Trigger, d'un Webhook, ou du trigger d'un autre outil.

Tester l'intégration CircleCI sur n8nVoir les 3 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert l'intégration CircleCI n8n ?

L'intégration CircleCI n8n fait entrer tes pipelines dans le même plan de travail que le reste de ton outillage. n8n embarque un nœud CircleCI avec 3 opérations, toutes sur la ressource Pipeline, authentifiées par un Personal API Token enregistré une fois comme credential, c'est-à-dire l'identifiant que n8n garde pour toi. Depuis n'importe quel workflow, tu lances un pipeline, tu en relis un, ou tu récupères la liste et tu enchaînes sur ce qu'elle contient.

Le premier usage tient en une phrase : savoir ce qui s'est passé sans aller le chercher. pipeline.getAll ramène les pipelines d'un projet, le champ Branch dans Filters restreint le tout à la branche qui t'intéresse, et Return All activé fait enchaîner à n8n toutes les pages de l'API au lieu de s'arrêter à Limit. Un Schedule Trigger chaque matin, une écriture dans Google Sheets, et l'équipe a son historique de builds sans que personne le recopie.

Vient ensuite le geste qui change quelque chose. pipeline.trigger démarre un pipeline à la demande, et ce sont Branch ou Tag, dans Additional Fields, qui décident de ce qui sera construit. Le déploiement devient une étape de workflow : un formulaire interne, une validation dans Slack, un événement venu de GitHub, chacun peut finir sur un pipeline lancé sans que personne ouvre l'interface CircleCI.

Reste la relecture ciblée. Quand le workflow connaît déjà un numéro de pipeline, pipeline.get va chercher ce pipeline précis via Pipeline Number, et la suite du workflow travaille sur son enregistrement réel plutôt que sur une supposition. C'est l'opération qu'on branche juste après un lancement, avant d'annoncer quoi que ce soit.

Ce que l'API CircleCI propose au delà de ces 3 opérations reste atteignable : le nœud HTTP Request appelle n'importe quel endpoint de l'API et réutilise le même credential via l'authentification prédéfinie. Un workflow mélange donc très bien le nœud dédié pour le chemin courant et un appel brut pour le reste.

Un point d'architecture à anticiper : sans nœud trigger CircleCI, rien n'écoute de soi-même ici. Chaque workflow démarre ailleurs puis vient parler à CircleCI. La Formation n8n passe du temps sur ce montage, parce qu'il revient dès qu'un outil expose des actions et pas d'événements.

Connexion

Comment connecter CircleCI à n8n ?

  1. 01

    Générer le token côté CircleCI

    Il te faut un compte CircleCI et un Personal API Token : c'est la seule méthode d'authentification acceptée par le credential CircleCI de n8n. Le token se crée depuis les réglages de ton compte CircleCI, en suivant leur documentation sur la création d'un personal API token. Copie-le au moment où il s'affiche. Un token qu'on ne peut plus relire est un token à refaire.

  2. 02

    Enregistrer le credential dans n8n

    Dans n8n, ouvre le menu Credentials et crée un credential CircleCI. Colle le Personal API Token dans son champ, enregistre, c'est fini. Le credential vit une seule fois et se propose ensuite dans la liste déroulante de chaque nœud CircleCI que tu ajoutes. Sur n8n Cloud comme sur une instance auto-hébergée, le workflow se comporte exactement pareil, donc rien à réécrire si tu changes d'hébergement.

  3. 03

    Viser un vrai projet avant de construire

    Ajoute le nœud CircleCI, choisis le credential, puis renseigne Provider avec le gestionnaire de code qui héberge le projet, GitHub ou Bitbucket. Project Slug attend le projet sous la forme org-name/repo-name, exactement le format du placeholder n8n-io/n8n affiché dans le champ. Lance une fois pipeline.getAll avec un petit Limit pour vérifier que le couple répond avant d'empiler la suite.

Actions

Ce que le nœud CircleCI sait faire

Le nœud CircleCI expose 3 opérations sur 1 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceGetGet ManyTrigger
Pipeline✓✓✓

Pipeline

3 opérations
01

Get a pipeline

pipeline.get

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie un pipeline précis d'un projet, celui que tu désignes par son numéro, pour que la suite du workflow travaille sur son enregistrement réel.

Paramètres clés

  • Provider : le gestionnaire de code derrière le projet, github ou bitbucket.
  • Project Slug : le projet sous la forme org-name/repo-name, comme le placeholder n8n-io/n8n.
  • Pipeline Number : le numéro du pipeline visé, souvent récupéré par une expression qui va chercher cette valeur dans la sortie d'un nœud précédent plutôt que tapé à la main.
Cas d'usage
un workflow de mise en production qui lance un pipeline, patiente, puis relit ce pipeline-là avant de prévenir qui que ce soit.
02

Get many pipelines

pipeline.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène un ensemble de pipelines d'un projet plutôt qu'un seul. C'est l'opération à prendre quand la question porte sur une période et pas sur une exécution.

Paramètres clés

  • Project Slug : le projet au format org-name/repo-name, avec Provider réglé sur GitHub ou Bitbucket.
  • Return All : coché, n8n enchaîne les pages de l'API jusqu'au dernier pipeline ; décoché, Limit plafonne le nombre d'items renvoyés.
  • Branch, dans Filters : réduit la liste à une seule branche vcs, pour qu'un suivi de la branche principale le reste vraiment.
Cas d'usage
un récapitulatif hebdomadaire des pipelines par branche, exporté en lignes pour la personne qui suit l'activité des builds.
03

Trigger a pipeline

pipeline.trigger

Ce que tu vois dans n8n

Notes & cas d'usage

Démarre un nouveau pipeline sur le projet indiqué. Le déploiement devient une étape de workflow, déclenchée par ta logique, et non un bouton à cliquer.

Paramètres clés

  • Project Slug : le projet, au format org-name/repo-name.
  • Branch, dans Additional Fields : la branche à construire, dont le commit HEAD sert de base au pipeline.
  • Tag, dans Additional Fields : le tag à construire à la place, qui pointe vers le commit utilisé. Branch et Tag s'excluent mutuellement, donc tu en envoies un, jamais les deux.
Cas d'usage
une demande de déploiement déposée dans un formulaire interne, qui finit en pipeline lancé sur un tag, sans distribuer d'accès à la console.
Besoin d'aide

Besoin d'aide pour automatiser CircleCI avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui viennent ensuite

01L'intégration CircleCI n8n est-elle gratuite ?
Côté n8n, oui. Le nœud CircleCI est livré avec n8n : rien à installer, aucun coût supplémentaire pour le nœud lui-même, que tu sois sur n8n Cloud ou sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne à l'identique de l'autre, ce qui compte si tu prototypes sur le Cloud avant de passer sur ton propre serveur. Ce que coûte le compte CircleCI lui-même se règle avec CircleCI, et cette page ne parle pas à leur place. Compte donc la partie n8n comme incluse, et la partie CircleCI comme le plan que tu as déjà.
02Quels credentials faut-il pour connecter CircleCI à n8n ?
Un seul élément : un Personal API Token. C'est la méthode d'authentification prise en charge par le credential CircleCI dans n8n, et elle suppose un compte CircleCI déjà ouvert. Le token se génère depuis CircleCI, en suivant leur documentation sur la création d'un personal API token, puis se colle dans un credential CircleCI créé depuis le menu Credentials de n8n. Ensuite le credential se réutilise : chaque nœud CircleCI de chaque workflow le prend dans une liste déroulante au lieu d'en garder sa propre copie. Le jour où tu fais tourner le token, tu modifies un credential, pas quinze workflows.
03Quelles sont les limites du nœud CircleCI dans n8n ?
Deux choses à garder en tête. La pagination d'abord : Get many pipelines ne ramène tout que si Return All est coché, sinon Limit fixe le nombre d'items renvoyés, et c'est le premier réglage à vérifier quand un rapport paraît plus court que la réalité. Le périmètre ensuite : le nœud couvre 3 opérations, toutes sur la ressource Pipeline. Ce qui sort de ce catalogue passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API CircleCI en réutilisant le même credential via l'authentification prédéfinie. En pratique, nœud dédié pour le chemin courant, HTTP Request pour l'appel de bord.
04Est-ce que n8n peut réagir à un build CircleCI en temps réel ?
Pas tout seul, puisque CircleCI n'a pas de nœud trigger dans n8n. Un workflow qui touche à CircleCI démarre toujours d'une autre porte d'entrée : un Schedule Trigger qui se déclenche à intervalle fixe, un Webhook n8n, c'est-à-dire une URL qu'un service extérieur appelle, ou le trigger d'un autre outil déjà en place. Pour surveiller les builds, le montage habituel combine Schedule Trigger et Get many pipelines, en comparant ce qui revient avec ce qui avait été vu au passage précédent. Pour réagir à un événement de code, c'est un webhook de ton gestionnaire de code qui finit sur Trigger a pipeline.
05n8n ou Make pour automatiser CircleCI ?
Ça dépend de l'endroit où tu veux que le workflow vive. Make est hébergé par Make, sans option d'auto-hébergement, et facturé à l'opération : le coût suit le volume et les données transitent par leur plateforme. n8n tourne sur n8n Cloud ou sur ton propre serveur via Docker ou npm, ce qui tranche la question pour une équipe dont l'outillage de build et les secrets doivent rester dans son infrastructure. Les deux offrent une logique visuelle. Le choix se fait sur l'hébergement, la maîtrise des données et la façon dont le coût doit évoluer, pas sur un tableau comparatif.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations