Ressources · Intégration n8n

Intégration Rundeck n8nAutomatiser Rundeck avec n8n.

Un job Rundeck qu'on lance à la main, c'est un job qu'on oublie un lundi matin. L'intégration Rundeck n8n pose un nœud avec 2 opérations sur la ressource Job : exécuter un job, ou lire ses métadonnées. Pas de trigger Rundeck côté n8n, donc le workflow démarre ailleurs.

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

Pourquoi automatiser

À quoi sert l'intégration Rundeck n8n ?

Deux opérations, toutes deux sur la ressource Job et adressées par un identifiant de job : voilà tout ce que porte le nœud Rundeck dans n8n. Il relie les jobs que ton équipe programme sur les serveurs Rundeck à tout ce que n8n gère autour, la surveillance capable d'en déclencher un, la validation qui l'autorise, le message qui referme la boucle une fois le job terminé.

Commence par la contrainte, elle dessine le reste : Rundeck n'a pas de nœud trigger dans n8n. Un workflow qui le concerne démarre donc avec un Schedule Trigger à intervalle fixe, avec un Webhook n8n (une URL que n8n crée et qu'un service tiers appelle) ou avec le trigger d'un autre outil. Le nœud Rundeck arrive ensuite, jamais en premier.

Premier usage typique, le rattrapage d'astreinte. Une alerte tombe, elle entre dans n8n, le workflow exécute le job de remise en route avec job.execute et pousse une notification via Pushover. La personne d'astreinte lit ce qui s'est passé au lieu de se connecter pour taper une commande.

Deuxième usage, la vérification avant l'acte. job.getMetadata lit les métadonnées d'un job à partir de son ID. Quand l'identifiant vient d'un formulaire ou d'une ligne de Google Sheets, ça évite de déclencher à l'aveugle : le workflow interroge d'abord, teste ce qui revient, exécute seulement sur la branche qui va bien.

Troisième usage, la demande formulée par un humain. Un client écrit à une adresse relevée par Gmail, le workflow extrait ce qu'il faut et le passe au job sous forme d'Arguments. Rundeck reste l'endroit où le job est défini et tracé. n8n ne fournit que le moment et les entrées.

Deux opérations, c'est une surface réduite, et elle se complète simplement. Pour un endpoint de l'API Rundeck absent du nœud dédié, le nœud HTTP Request l'appelle directement en réutilisant le même credential Rundeck via l'authentification prédéfinie : pas de second token à gérer. Si tu montes ce type de chaîne pour la première fois, la Formation n8n traite ces branchements, et l'Avis n8n dit ce que l'outil fait bien et moins bien.

Connexion

Comment connecter Rundeck à n8n ?

  1. 01

    Générer un token API dans Rundeck

    Tout part de ton compte utilisateur sur un serveur Rundeck : c'est le prérequis de ce credential. Depuis ce compte, va dans Profile, puis User API Tokens, et génère un token. Le token API est la méthode d'authentification prise en charge par le credential Rundeck de n8n, donc inutile de chercher un mot de passe ou un OAuth ailleurs dans le menu.

  2. 02

    Créer le credential Rundeck dans n8n

    Dans n8n, ouvre le menu Credentials et choisis Rundeck. Un credential, c'est un accès enregistré une seule fois et réutilisable dans tous tes workflows : le nœud te le propose ensuite dans une liste déroulante. Deux champs à remplir. URL attend l'URL de base de ton serveur Rundeck, du type http://myserver:4440. Token reçoit la valeur générée à l'étape précédente.

  3. 03

    Récupérer l'ID du job

    Le job ID se cache sous le nom du job, écrit en plus petit dans le coin supérieur gauche du panneau, une fois que le job est ouvert. Pour y arriver : dashboard Rundeck, puis le projet concerné, puis JOBS dans la barre latérale, puis All Jobs, puis le nom du job. Copie cette chaîne et colle-la dans le champ Job Id du nœud n8n.

Actions

Ce que le nœud Rundeck sait faire

Le nœud Rundeck expose 2 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
RessourceExecuteGet Metadata
Job✓✓

Job

2 opérations
01

Execute a job

job.execute

Ce que tu vois dans n8n

Notes & cas d'usage

Cette opération lance un job Rundeck depuis le workflow : le nœud contacte ton serveur avec le credential enregistré et demande l'exécution du job désigné par son identifiant.

Paramètres clés

  • Job ID : requis, la chaîne affichée sous le nom du job (placeholder : Rundeck Job ID). Saisis-la, ou récupère-la d'un nœud précédent avec {{ $json.field }}. Un champ requis laissé vide bloque le nœud.
  • Arguments : optionnel, la collection intitulée Add Argument, pour les arguments transmis au job.
  • Filter : optionnel, un champ texte qui filtre les nœuds Rundeck par nom, placeholder Add Filters.
Cas d'usage
une demande d'environnement de test arrive dans n8n, le workflow exécute le job de provisionnement, et le demandeur reçoit la confirmation sur Slack.
02

Get metadata of a job

job.getMetadata

Ce que tu vois dans n8n

Notes & cas d'usage

Deuxième emploi du même identifiant : l'opération lit les métadonnées que Rundeck conserve sur un job, désigné lui aussi par son ID, et les passe au nœud suivant du workflow.

Paramètres clés

  • Job ID : requis, le même identifiant que celui copié sous le nom du job dans le dashboard. Quand il vient d'une ligne de tableur ou d'un formulaire, référence-le avec {{ $json.field }} plutôt qu'en dur dans le nœud.
Cas d'usage
un inventaire des jobs automatisés. Un workflow parcourt une liste d'identifiants à intervalle fixe, appelle cette opération sur chacun, et consigne ce qui revient dans un tableur. L'équipe garde une vue à jour des jobs qu'elle pilote depuis n8n.
Besoin d'aide

Besoin d'aide pour automatiser Rundeck avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Rundeck et n8n, les questions qui reviennent

01L'intégration Rundeck n8n est-elle gratuite ?
Un compte utilisateur sur un serveur Rundeck est le seul prérequis avant de commencer, puisque c'est de là que sort le token API. Côté n8n, le nœud Rundeck est livré d'office : rien à installer, aucun coût supplémentaire pour l'ajouter à un workflow. Cette gratuité vaut aussi bien sur n8n Cloud, l'offre hébergée par n8n, que sur une instance auto-hébergée en Docker ou npm sous licence Sustainable Use de la Community Edition, un workflow marchant à l'identique dans les deux cas. Ce que facture Rundeck pour son propre serveur reste une question à part, que cette page laisse de côté.
02Quels identifiants faut-il pour le nœud Rundeck ?
Le formulaire de credential Rundeck ne demande que deux valeurs, parce que le token API est la seule méthode d'authentification prise en charge. Token attend le token API utilisateur que tu génères depuis ton compte Rundeck, dans Profile puis User API Tokens. URL attend l'URL de base de ton serveur, par exemple http://myserver:4440. Une fois ce credential créé depuis le menu Credentials, chaque nœud Rundeck de chaque workflow le retrouve dans une liste déroulante, et les appels HTTP Request vers l'API Rundeck peuvent réutiliser le même via l'authentification prédéfinie.
03Quelles sont les limites du nœud Rundeck dans n8n ?
Dans la pratique, la plupart des équipes combinent deux outils : le nœud dédié pour l'usage quotidien, HTTP Request pour l'appel occasionnel. La raison tient au catalogue, réduit à 2 opérations sur la ressource Job, Execute a job et Get metadata of a job, toutes deux appelées par un identifiant de job, ce qui suppose que le job existe déjà dans Rundeck et que tu connais son ID. Pour n'importe quel autre endpoint de l'API Rundeck, le nœud HTTP Request l'appelle directement en réutilisant le même credential via l'authentification prédéfinie.
04Rundeck peut-il déclencher un workflow n8n ?
Trois portes d'entrée remplacent l'absence de trigger Rundeck dans n8n : le Schedule Trigger, qui se déclenche à intervalle fixe et convient aux jobs de nuit ou horaires ; le nœud Webhook de n8n, qui fournit une URL qu'un service tiers appelle quand quelque chose se produit de son côté ; ou le trigger d'un autre outil déjà présent dans tes automatisations, un nouveau message, une nouvelle ligne. Le nœud Rundeck n'intervient qu'ensuite, pour exécuter le job : Rundeck ne déclenche donc jamais directement un workflow n8n.
05n8n ou Make pour Rundeck ?
Teste les deux sur un job réel avant de trancher, la logique visuelle étant avant tout une question de goût. Le reste tient à l'hébergement : Make, ex-Integromat, est une plateforme hébergée, sans option d'auto-hébergement, facturée à l'opération, quand n8n tourne sur son Cloud ou sur ton propre serveur. Ce choix compte quand le workflow parle à un serveur Rundeck interne, jamais exposé sur internet : en auto-hébergé, les exécutions restent sur une infrastructure qui t'appartient. Le modèle de coût suit la même logique, à l'opération d'un côté, à l'instance ou au plan de l'autre.