Integración CircleCI n8nAutomatiza CircleCI con n8n.
¿Y si el despliegue fuera un paso más del flujo? La integración CircleCI n8n trae 3 operaciones sobre un único recurso Pipeline: lanzar un pipeline, consultar uno o recuperar varios. Sin nodo trigger de CircleCI, el flujo arranca con un Schedule Trigger, un Webhook u otra herramienta.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué te aporta la integración CircleCI n8n?
La integración CircleCI n8n coloca tus pipelines en el mismo lienzo que el resto de tus herramientas. n8n incluye un nodo CircleCI con 3 operaciones, todas sobre el recurso Pipeline, autenticadas con un Personal API Token que se guarda una vez como credential, es decir, la credencial que n8n conserva por ti. Desde cualquier flujo puedes arrancar un pipeline, releer uno concreto o traerte la lista y seguir trabajando con lo que devuelve.
Empieza por donde más se nota. pipeline.trigger arranca un pipeline nuevo en el proyecto que le indiques, y son Branch o Tag, dentro de Additional Fields, los que deciden qué se construye. Así una petición recogida en un formulario interno, o una aprobación escrita en Slack, termina en un despliegue real sin repartir accesos a la consola de CircleCI.
Después llega la comprobación. Cuando el flujo ya conoce un número de pipeline, pipeline.get recupera ese pipeline exacto con Pipeline Number, y las ramas siguientes deciden sobre su registro y no sobre una suposición. Encaja justo detrás de un lanzamiento, o detrás de un evento que llega desde GitHub con el número ya resuelto.
La tercera operación mira hacia atrás en lugar de hacia delante. pipeline.getAll devuelve un conjunto de pipelines del proyecto, Branch dentro de Filters lo acota a una sola rama y Return All activado hace que n8n recorra todas las páginas de la API en vez de detenerse en Limit. Con un Schedule Trigger y una escritura en Postgres tienes un histórico de builds que nadie transcribe a mano.
¿Y lo que la API de CircleCI ofrece más allá de estas 3 operaciones? Sigue a tu alcance. El nodo HTTP Request llama a cualquier endpoint de la API y reutiliza el mismo credential mediante la autenticación predefinida, de modo que un flujo combina sin problema el nodo dedicado para lo habitual y una llamada directa para lo demás.
Queda un detalle de diseño que conviene tener claro antes de montar nada: al no existir un nodo trigger de CircleCI, aquí nada escucha por su cuenta. Todo flujo nace en otro sitio y después habla con CircleCI. En el Curso n8n se practica precisamente ese montaje, que reaparece con cualquier herramienta que ofrezca acciones y ningún evento.
¿Cómo se conecta CircleCI con n8n?
- 01
Genera el token en CircleCI
Necesitas una cuenta de CircleCI y un Personal API Token, el único método de autenticación que acepta el credential de CircleCI en n8n. El token se crea desde los ajustes de tu cuenta de CircleCI, siguiendo su documentación sobre cómo crear un personal API token. Cópialo en el momento en que aparece en pantalla: un token que ya no puedes volver a leer es un token que toca rehacer.
- 02
Guarda el credential en n8n
En n8n, abre el menú Credentials y crea un credential de CircleCI. Pega el Personal API Token en su campo y guarda. A partir de ahí el credential existe una sola vez y aparece en el desplegable de cada nodo CircleCI que añadas. En n8n Cloud y en una instancia autoalojada el flujo se comporta igual, así que cambiar de alojamiento no obliga a reescribir nada.
- 03
Apunta el nodo a un proyecto real
Añade el nodo CircleCI, elige el credential y rellena Provider con el sistema de control de versiones donde vive el proyecto, GitHub o Bitbucket. Project Slug espera el proyecto escrito como
org-name/repo-name, la misma forma del placeholdern8n-io/n8nque ves en el campo. Ejecuta una vezpipeline.getAllcon un Limit pequeño y confirma que la pareja responde antes de construir encima.
Qué sabe hacer el nodo CircleCI
El nodo CircleCI expone 3 operaciones en 1 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
Pipeline
3 operacionesGet a pipeline
pipeline.getLo que ves en n8n
Notas y casos de uso
Devuelve un pipeline concreto de un proyecto, el que identificas por su número, para que el flujo trabaje sobre su registro real.
Parámetros clave
- Provider: el sistema de control de versiones del proyecto,
githubobitbucket. - Project Slug: el proyecto como
org-name/repo-name, igual que el placeholdern8n-io/n8n. - Pipeline Number: el número del pipeline buscado, tomado casi siempre con una expresión que recoge ese valor de la salida de un nodo anterior en lugar de escribirlo a mano.
Get many pipelines
pipeline.getAllLo que ves en n8n
Notas y casos de uso
Trae un conjunto de pipelines de un proyecto en lugar de uno solo, que es lo que necesitas cuando la pregunta va de un periodo y no de una ejecución.
Parámetros clave
- Project Slug: el proyecto en formato
org-name/repo-name, con Provider en GitHub o Bitbucket. - Return All: activado, n8n recorre las páginas de la API hasta el último pipeline; desactivado, Limit marca el máximo de items devueltos.
- Branch, dentro de Filters: reduce la lista a una sola rama vcs, para que un seguimiento de la rama principal siga siéndolo.
Trigger a pipeline
pipeline.triggerLo que ves en n8n
Notas y casos de uso
Arranca un pipeline nuevo en el proyecto indicado. El despliegue pasa a ser un paso del flujo, disparado por tu lógica. Deja de depender de un botón.
Parámetros clave
- Project Slug: el proyecto, en formato
org-name/repo-name. - Branch, dentro de Additional Fields: la rama que se construye, cuyo commit HEAD sirve de base al pipeline.
- Tag, dentro de Additional Fields: la etiqueta que se construye en su lugar, apuntando al commit usado. Branch y Tag son mutuamente excluyentes, así que envías uno u otro, nunca los dos.
¿Necesitas ayuda para automatizar CircleCI con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
