GitHub Download Custom Node für n8n

Dieser benutzerdefinierte n8n-Node ermöglicht den Download eines GitHub-Repositories als ZIP-Archiv. Er ist ideal für Workflows, die Repository-Inhalte verarbeiten, sichern oder analysieren müssen.

Features

• 📂 Download eines vollständigen Repositories als ZIP-Datei.
• branch-Unterstützung: Wähle zwischen main, master oder einem spezifischen Tag/Commit-Hash.
• 🔐 Authentifizierung: Unterstützt öffentliche Repositories (ohne Auth) und private Repositories via Personal Access Token (PAT).
• 📤 Binärausgabe: Das Ergebnis wird als n8n-Binärdatei bereitgestellt.

Installation

Lokale Entwicklung

1. Klone dieses Repository in deinen n8n-POC-Ordner.
2. Installiere die Abhängigkeiten:

   npm install

3. Baue das Projekt:

   npm run build

4. Verlinke den Node global:

   npm link

5. Gehe in dein lokales n8n-Installationsverzeichnis (z. B. ~/.n8n) und verknüpfe den Node:

   cd ~/.n8n
   npm link @imraz/n8n-nodes-git-downloader

6. Starte n8n neu.

Konfiguration

Parameter

• Repository Owner: Der Benutzer oder die Organisation (z. B. n8n-io).
• Repository Name: Der Name des Repositories (z. B. n8n).
• Reference: Der Branch, Tag oder Commit (Standard: main).
• Authentication:
  • None: Für öffentliche Repositories.
  • Personal Access Token: Für private Repositories (erfordert einen GitHub PAT).

Beispiel-Szenario

1. Füge den GitHub Download Node hinzu.
2. Gib n8n-io als Owner und n8n als Repository an.
3. Wähle None als Authentifizierung.
4. Der Node gibt eine Datei namens n8n-io-n8n-main.zip aus, die im nächsten Schritt (z. B. "Extract ZIP") weiterverarbeitet werden kann.

Entwicklung

• npm run dev: Kompiliert TypeScript im Watch-Modus.
• npm run build: Erstellt die produktionsbereiten Dateien im dist-Ordner.
• npm test: Führt einen Mock-Test der Node-Logik aus.

Lizenz

MIT