GitHub archivos y ramas nodo

Lee y escribe archivos, ramas y commits en un repositorio, p. ej. «¿Qué pone en el README de main?» o guardar un archivo con un commit. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.

10 min de lecturaActualizado el 10 de septiembre de 2026

Qué hace este nodo

Lee y escribe archivos, ramas y commits en un repositorio, p. ej. «¿Qué pone en el README de main?» o guardar un archivo con un commit.

Usa GitHub archivos y ramas como un paso claramente definido en un workflow de anymize.

Procesa 1 entrada.
Ofrece 1 salida para los pasos siguientes.
Se ejecuta como un paso normal del flujo.

Configurar el nodo

01Abre un workflow y añade GitHub archivos y ramas desde el catálogo de nodos.
02Si tu cuenta de GitHub aún no está conectada, conéctala directamente desde el panel del nodo o en Conectores.
03Completa los campos obligatorios y asigna valores de los pasos anteriores.
04Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
05Conecta la salida correcta y activa el workflow después de una prueba completa.

Acciones y modos

Elige la función necesaria en Acción. El panel mostrará los ajustes correspondientes.

Listar ramas
Listar commits
Leer archivo
Leer rama
Crear rama
Eliminar rama
Leer commit
Comparar versiones
Leer README
Guardar archivo
Eliminar archivo
Buscar código
Listar tags

Ajustes

Campo	Significado	Área
Acción	Opciones: Listar ramas, Listar commits, Leer archivo, Leer rama, Crear rama, Eliminar rama, Leer commit, Comparar versiones, Leer README, Guardar archivo, Eliminar archivo, Buscar código, Listar tags	Estándar
Propietario (usuario u org)	El nombre de GitHub al que pertenece el repo, p. ej. anymize.	Estándar
Repository	Nombre del repositorio, p. ej. hello-world.	Estándar
Solo ramas protegidas	Configura este valor en el panel del nodo.	Estándar
Cantidad (máx. 100)	Cuántas entradas se cargan por consulta. Sin efecto con «Cargar todas las páginas»: entonces siempre son 100 por página.	Estándar
Cargar todas las páginas	Carga más páginas hasta tenerlo todo, como máximo 1000 entradas.	Estándar
Página	Desde qué página se carga, p. ej. la página siguiente de la consulta anterior. Vacío: la primera. Sin efecto con «Cargar todas las páginas».	Estándar
Branch	Qué rama, p. ej. main.	Estándar
Ruta del archivo	Ruta en el repositorio, p. ej. src/index.ts o README.md.	Estándar
De la persona	Nombre de GitHub o correo.	Estándar
Modificado desde	Solo entradas modificadas desde ese momento, p. ej. 2026-01-31T00:00:00Z.	Estándar
Modificado hasta	Configura este valor en el panel del nodo.	Estándar
Versión (Branch)	De qué rama se lee, p. ej. main. Los expertos pueden indicar un hash de commit.	Estándar
Nueva rama	Configura este valor en el panel del nodo.	Estándar
Punto de partida	Rama, tag o commit del que se parte. Vacío: la rama predeterminada.	Estándar
Commit o rama	Configura este valor en el panel del nodo.	Estándar
Desde	Versión anterior, rama o commit.	Estándar
Hasta	Versión más reciente, rama o commit.	Estándar
Contenido	El nuevo contenido del archivo.	Estándar
El contenido está en	Opciones: Texto, Base64	Estándar
Mensaje del commit	En pocas palabras, qué se ha cambiado.	Estándar
Versión anterior del archivo	Solo para expertos. Vacío: se detecta automáticamente.	Estándar
Término de búsqueda	Hace falta un término de búsqueda. Los expertos pueden usar filtros, p. ej. repo:octocat/hello-world.	Estándar
Cuenta de GitHub	Déjalo vacío y el paso usará tu cuenta de GitHub conectada.	Estándar
Ejecutar una vez por elemento	Desactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada.	Estándar
Si un elemento falla	«Omitir» escribe un campo `error` para el elemento fallido y sigue con el resto, en lugar de perder toda la ejecución por un único archivo ilegible.	Estándar
Pausa entre elementos (milisegundos)	Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos).	Estándar

Entradas y salidas

Entrada	Significado	Tipo
Estándar	Recibe el resultado completo del paso anterior.	JSON

Salida	Significado	Tipo
Estándar	Entrega el resultado al paso siguiente como JSON.	JSON

Este nodo puede procesar listas elemento por elemento. La gestión de errores y la pausa están en los ajustes avanzados.

Ejemplo y prueba

Leer el README de la rama predeterminada: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.

Ejemplo de prueba

{
  "owner": "octocat",
  "repo": "hello-world",
  "path": "README.md"
}

Acceso y seguridad

El nodo trabaja con tu propia cuenta de GitHub conectada. Solo ve y cambia lo que esa cuenta tiene permitido. Revisa los permisos que aparecen al conectarla. Además, el área correspondiente (Issues, Pull requests, Repos) tiene que estar activada en los ajustes de tu conexión de GitHub en Conectores. Por defecto, todas las áreas están activadas.

«Acciones permitidas» en los ajustes de tu conexión de GitHub en Conectores también se aplica a este nodo y se comprueba en cada ejecución. Con «Solo lectura» o «Leer y crear borradores» solo se ejecutan las acciones de lectura: Listar ramas, Listar commits, Leer archivo, Leer rama, Leer commit, Comparar versiones, Leer README, Buscar código, Listar tags. Estas acciones necesitan «Permitir cambios»: Crear rama, Eliminar rama, Guardar archivo, Eliminar archivo.

Las claves y credenciales van en Secretos de workflows o en tus cuentas conectadas. Nunca las pegues como texto normal en campos del workflow, datos de prueba ni descripciones.

Resolver errores

Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
Conexión rechazada: vuelve a conectar el servicio con los permisos necesarios.
Acción bloqueada: pon «Acciones permitidas» de la conexión en Conectores en «Permitir cambios» o elige una acción de lectura.
La lista se procesa una sola vez: activa la ejecución por elemento.