Recursos · Integración n8n

Nodo Git n8nConfigura Git en n8n.

El nodo Git n8n ejecuta comandos de git sobre un repositorio guardado en el disco de tu instancia. Trae 15 operaciones, desde clone y commit hasta log, tag o switch branch, y todas parten de una ruta de repositorio. Encaja cuando un flujo de trabajo genera archivos que merecen un historial.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve el nodo Git n8n?

Git es uno de los nodos core que vienen con n8n: envuelve la línea de comandos de git alrededor de un repositorio situado en una ruta que la instancia puede leer y escribir. Eliges una operación por nodo, indicas la ruta del repositorio y n8n hace lo mismo que alguien escribiendo en una terminal. Nada que instalar y ningún coste extra por parte de n8n, tanto en n8n Cloud como en una instancia autoalojada.

El primer escenario es el más habitual: dar historial a los archivos que produce un flujo de trabajo. Una exportación cae cada noche en una carpeta, Add prepara las rutas, Commit guarda el cambio con un mensaje y Push lo envía al repositorio remoto. Tres nodos, y cada exportación se convierte en una diferencia que alguien podrá leer semanas después.

El segundo escenario solo lee. Log devuelve el historial de commits de un repositorio o de un único archivo, Status indica qué se ha movido desde el último commit y Reflog reconstruye por dónde ha pasado una referencia. Esa salida alimenta un If que decide si el flujo continúa, o pasa por Edit Fields (Set) para quedarse solo con los campos que van al informe.

El tercero prepara una copia de trabajo. Clone trae un repositorio a una carpeta nueva, Switch Branch se coloca en la rama del trabajo en curso y Add Config junto a User Setup fijan la identidad con la que se firmarán los commits. Al final de esa secuencia, una carpeta vacía ya es un repositorio utilizable por el siguiente flujo.

Llega el límite, y conviene tenerlo claro. Este nodo habla con git, no con GitHub ni con GitLab. Abrir una pull request, comentar una incidencia o consultar un repositorio mediante una API web queda fuera de su alcance, y ahí toma el relevo HTTP Request o un nodo dedicado, siempre sobre endpoints HTTP. Además el repositorio tiene que existir en un sistema de archivos accesible para la instancia, lo que en la práctica significa una instancia autoalojada con un volumen montado.

Dos detalles antes de montar nada. El nodo se ejecuta sobre cada item entrante, así que seis rutas de archivo llegadas del paso anterior suponen seis acciones de git salvo que las agrupes antes. Y nunca abre un flujo de trabajo por sí mismo: siempre lo precede un disparador, sea Schedule Trigger, Webhook o el trigger de otra herramienta. Para el contexto de plataforma, tienes la Reseña n8n y el Curso n8n.

Conexión

¿Qué hay que autenticar aquí?

  1. 01

    Elegir el modo de autenticación

    Solo dos operaciones muestran el selector Authentication, Clone y Push, con dos valores: gitPassword (Authenticate) y none (None). None sirve cuando el repositorio remoto es público o cuando se trata de una ruta local. Authenticate hace falta en cuanto el remoto exige una cuenta. El resto de operaciones trabajan en local y ni siquiera plantean la pregunta.

  2. 02

    Crear la credencial de Git

    Con Authenticate, el nodo pide un Credential for Git, es decir un juego de credenciales guardado dentro de n8n. Se crea una sola vez desde el menú Credentials y se reutiliza en todos los flujos de trabajo que lo necesiten. Esta credencial funciona con basic auth y guarda dos campos: un Username y un Password válidos en GitHub, GitLab o una plataforma parecida.

  3. 03

    Señalar el repositorio de trabajo

    Cada operación pide un Repository Path, la ruta local del repositorio git en la máquina donde corre n8n. Clone es la excepción: espera un New Repository Path para la carpeta de destino y un Source Repository con la URL o la ruta que se va a copiar. Esa ruta puede venir de un paso anterior como expresión, la sintaxis de n8n que recoge un campo del item: {{ $json.path }}.

Acciones

¿Qué operación de Git te conviene?

El nodo Git expone 15 operaciones. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

01

Add a file or folder to commit

add

Lo que ves en n8n

Notas y casos de uso

Antes de guardar nada, git necesita saber qué archivos entran en el lote. Esta operación hace justo eso: prepara archivos o carpetas para el commit siguiente.

Parámetros clave

  • Paths to Add: la lista de rutas separadas por comas, obligatoria, absolutas o relativas al Repository Path, con README.md como placeholder.
  • Repository Path: la ruta local del repositorio git afectado.
Casos de uso
un flujo deja un CSV generado en la carpeta del repositorio y este nodo prepara solo ese archivo, para que el commit no arrastre nada más.
02

Add configuration property

addConfig

Lo que ves en n8n

Notas y casos de uso

La configuración de un repositorio se guarda en pares de clave y valor. Esta operación escribe uno de ellos en la configuración local.

Parámetros clave

  • Key: el nombre de la clave a definir, obligatorio, placeholder user.email.
  • Value: el valor que se guarda, obligatorio, placeholder name@example.com.
  • Mode: opción con dos posibilidades, set para sustituir el ajuste y append para añadirlo en lugar de reemplazarlo.
Casos de uso
recién clonado un repositorio, un primer nodo escribe el correo con el que firmará sus commits un robot.
03

Clone a repository

clone

Lo que ves en n8n

Notas y casos de uso

Mientras casi todas las operaciones dan por hecho que el repositorio ya está, esta lo crea copiando uno remoto dentro de una carpeta local.

Parámetros clave

  • New Repository Path: la ruta local de destino, obligatoria, placeholder /tmp/repository.
  • Source Repository: la URL o la ruta del repositorio que se copia, obligatoria, placeholder https://github.com/n8n-io/n8n.
  • Authentication: Authenticate para pasar una credencial, None para clonar sin ella.
Casos de uso
una tarea programada clona un repositorio de plantillas en una carpeta temporal, lee lo que necesita y deja que la carpeta desaparezca.
04

Commit files or folders to git

commit

Lo que ves en n8n

Notas y casos de uso

Esta es la operación que convierte los cambios preparados en una entrada definitiva del historial, con un mensaje que la explica.

Parámetros clave

  • Message: el mensaje del commit, que el nodo no exige, aunque un historial sin mensajes resulta ilegible más adelante.
  • Branch: opción que indica la rama a la que cambiar antes de hacer commit, placeholder main; vacía, el commit se queda en la rama actual.
  • Paths to Add: opción con las rutas a incluir, placeholder /data/file1.json; sin definir, entra todo lo preparado.
Casos de uso
una exportación diaria firma su commit con la fecha de la ejecución.
05

Fetch from remote repository

fetch

Lo que ves en n8n

Notas y casos de uso

Descargar sin tocar nada: el fetch trae lo que conoce el repositorio remoto y deja intacta la copia de trabajo.

Casos de uso
un flujo de vigilancia hace fetch y después un Log para comprobar si ha aparecido algo nuevo arriba durante la noche, y se detiene si la respuesta es que no. Ningún archivo local cambia, así que ejecutarlo de forma periódica no rompe nada.
06

Return current configuration

listConfig

Lo que ves en n8n

Notas y casos de uso

Contrapartida de la escritura de configuración: esta operación devuelve los ajustes aplicados ahora mismo al repositorio.

Casos de uso
después de un clone, una comprobación confirma que la identidad está puesta antes de que se ejecute un nodo Commit, con lo que se evita un fallo al final de una cadena larga. La salida es un dato más, así que el nodo siguiente puede evaluar un valor concreto.
07

Return git commit history

log

Lo que ves en n8n

Notas y casos de uso

Aquí el historial pasa a ser dato de trabajo: la operación devuelve los commits y la paginación decide cuántos.

Parámetros clave

  • Return All: activado, n8n devuelve todos los commits; desactivado, se detiene en Limit.
  • Limit: el número máximo de commits devueltos, disponible solo mientras Return All está desactivado.
  • File: opción con la ruta de un archivo o una carpeta, absoluta o relativa al Repository Path, para obtener únicamente su historial.
Casos de uso
un resumen semanal recoge los commits que han tocado un archivo de configuración delicado.
08

Pull from remote repository

pull

Lo que ves en n8n

Notas y casos de uso

A diferencia del fetch, el pull aplica los cambios remotos a la copia de trabajo: los archivos del disco acaban igualados con el remoto.

Casos de uso
un flujo que lee plantillas compartidas hace pull antes de leerlas, para contar con el cambio que un compañero subió esta mañana. Como los archivos cambian, reserva esa carpeta a una sola tarea a la vez.
09

Push to remote repository

push

Lo que ves en n8n

Notas y casos de uso

Un commit se queda en local mientras esta operación no lo envíe, y es el segundo sitio donde aparece la autenticación.

Parámetros clave

  • Authentication: Authenticate para pasar un Credential for Git, None para subir sin credencial.
  • Branch: opción con la rama a la que cambiar antes del push, placeholder main; vacía, sale la rama actual.
  • Target Repository: opción con la URL o la ruta del repositorio de destino, placeholder https://github.com/n8n-io/n8n.
Casos de uso
último nodo de un flujo de publicación, cuando el commit ya ha confirmado.
10

Push tags to remote repository

pushTags

Lo que ves en n8n

Notas y casos de uso

Un push normal deja las etiquetas atrás, y esta operación cubre exactamente ese hueco.

Casos de uso
un flujo de publicación de versiones crea una etiqueta, sube los commits y luego ejecuta este nodo para que la etiqueta también aparezca en el remoto. Conviene encadenarlo con la operación Tag en la misma ejecución, porque si no hay nada nuevo que enviar el nodo no produce ningún efecto visible.
11

Return reference log

reflog

Lo que ves en n8n

Notas y casos de uso

Si Log enumera commits, el reference log enumera las posiciones que ha ido ocupando una referencia: así se rastrea una rama que se ha movido.

Parámetros clave

  • Reference: opción con la referencia a mostrar, un nombre de rama por ejemplo; vacía se usa HEAD, placeholder HEAD.
  • Return All: activado, vuelven todas las entradas; desactivado, el resultado se corta en Limit.
  • Limit: el número máximo de entradas devueltas.
Casos de uso
una auditoría deja registrados los movimientos recientes de una rama de versión junto a los propios commits.
12

Return status of current repository

status

Lo que ves en n8n

Notas y casos de uso

Status responde a una sola pregunta: qué difiere ahora mismo entre la copia de trabajo y el último commit.

Casos de uso
un control colocado antes del Commit, para que el flujo siga solo si de verdad ha cambiado algo y el historial no se llene de commits vacíos. También es el primer paso razonable cuando una tarea programada ha fallado y nadie sabe en qué estado quedó la carpeta.
13

Switch to a different branch

switchBranch

Lo que ves en n8n

Notas y casos de uso

Las ramas tienen su propia operación, y sus opciones abarcan tanto crearlas como simplemente moverse a ellas.

Parámetros clave

  • Branch Name: el nombre de la rama de destino, obligatorio, placeholder feature/new-feature.
  • Create Branch If Not Exists y Start Point: crear la rama si no existe, a partir del commit, la rama o la etiqueta indicada, o desde el HEAD actual.
  • Force Switch, Set Upstream y Remote Name: forzar el cambio descartando modificaciones locales, seguir una rama remota y nombrar el remoto, placeholder origin.
Casos de uso
una tarea abre una rama con la fecha en cada ejecución.
14

Create a new tag

tag

Lo que ves en n8n

Notas y casos de uso

Una etiqueta pone un nombre sobre el estado actual del repositorio: es lo que da a una versión algo legible a lo que referirse.

Parámetros clave

  • Name: el nombre de la etiqueta que se crea, obligatorio.
Casos de uso
un flujo de compilación etiqueta el repositorio con el número de versión que recibió en el paso anterior y luego cede el turno a Push Tags para que ese nombre llegue al remoto. Como la operación solo admite un nombre, el valor casi siempre llega en forma de expresión y no escrito a mano.
15

Set up a user

userSetup

Lo que ves en n8n

Notas y casos de uso

Todo commit lleva un autor. Esta operación define el usuario del repositorio sin obligarte a detallar claves de configuración.

Casos de uso
primer nodo tras un clone, para que los commits posteriores queden atribuidos en vez de rechazados por falta de identidad. Cuando hace falta controlar la clave exacta que se escribe, el relevo lo toma Add Config con su pareja de Key y Value.
Necesitas ayuda

¿Necesitas ayuda para automatizar Git con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Git y n8n, preguntas frecuentes

01¿El nodo Git n8n es gratis?
Sí. Git es un nodo core que viene con n8n: no hay nada que instalar ni coste adicional por parte de n8n. Está disponible en n8n Cloud, la oferta alojada por n8n, y también en una instancia autoalojada instalada con Docker o npm, en Community Edition bajo licencia Sustainable Use. Un flujo de trabajo montado en un sitio se comporta igual en el otro. Lo que sí puede seguir costando dinero queda fuera de n8n: la cuenta que uses en GitHub, GitLab o una plataforma parecida depende de las condiciones de esa plataforma, y esta página no entra en eso.
02¿Qué credenciales necesita el nodo Git?
Depende de la operación. Clone y Push muestran un selector Authentication con dos valores, Authenticate y None, y son las dos únicas operaciones capaces de pasar una credencial. Si eliges Authenticate, hay que seleccionar o crear un Credential for Git: funciona con basic auth y guarda un Username y un Password de GitHub, GitLab o una plataforma similar. Esa credencial se crea una vez desde el menú Credentials y se reutiliza en cualquier flujo. Las demás operaciones trabajan sobre el repositorio local indicado en Repository Path y no piden credencial alguna.
03¿Qué límites tiene el nodo Git?
El principal es su alcance. El nodo cubre 15 operaciones de git sobre un repositorio en disco, y ahí termina. No habla con la API web de una plataforma de alojamiento, así que las pull requests, las incidencias y los ajustes del repositorio quedan fuera. El repositorio además tiene que estar en un sistema de archivos que la instancia pueda leer y escribir, lo que descarta un montaje puramente remoto. Para Clone y Push solo se admite basic auth. Y el nodo se ejecuta sobre cada item entrante, así que un lote de items es un lote de acciones de git.
04¿Nodo Git o HTTP Request para automatizar un repositorio?
La pregunta correcta es con quién estás hablando. Si la acción es propia de git, clonar, hacer commit, etiquetar o subir cambios, el nodo Git la resuelve leyendo el repositorio del disco. Si la acción pertenece a la plataforma que aloja ese repositorio, abrir una pull request o listar incidencias por ejemplo, eso es una API HTTP y el nodo indicado es HTTP Request. Los dos conviven bien en el mismo flujo: commit y push con Git, y después una llamada HTTP para todo lo que git nunca supo hacer. HTTP Request sirve solo para endpoints HTTP.
05¿n8n o Make para automatizar git?
Las dos son plataformas visuales de automatización y la diferencia se juega en tres puntos. El alojamiento: Make funciona solo alojado, mientras que n8n también se autoaloja con Docker o npm. Aquí pesa mucho, porque el nodo Git necesita un repositorio en un sistema de archivos accesible, algo mucho más fácil de montar en tu propia instancia. El control de los datos va en la misma línea, ya que repositorio y credencial se quedan en tu infraestructura. El modelo de coste también cambia, Make se factura por operación. La comparación completa está en la reseña enlazada arriba.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.