GUIDE TECHNIQUE · RUNDECK
Rundeck : Créer et exécuter son premier job
Créer un premier job Rundeck pour automatiser une vérification non destructive, sélectionner les nœuds ciblés et contrôler l'historique d'exécution.
L’ESSENTIEL EN BREF
Les étapes clés
Ce guide présente 4 étapes, de « Préparer projet et nœuds » à « Exécuter et inspecter le résultat ».
Avant de commencer : Instance Rundeck accessible en HTTPS, utilisateur habilité à créer et exécuter un job.
01 · CADRAGE
Périmètre et résultat visé
Résultat attendu : Le job apparaît dans le projet de recette.
Public concerné : Administrateurs systèmes, opérateurs RUN et équipes d'automatisation
Rundeck Community ou Runbook Automation avec projet autorisé et exécuteur configuré. Les libellés de menus et plugins peuvent varier selon l'édition.
Contrôlez les versions, les droits et les options disponibles dans votre environnement avant de suivre la procédure.
02 · AVANT DE COMMENCER
Prérequis et points de contrôle
- Instance Rundeck accessible en HTTPS, utilisateur habilité à créer et exécuter un job.
- Projet de recette et nœud de test opérationnel ; pas d'accès implicite aux nœuds de production.
- Commande non destructive disponible sur le nœud de laboratoire.
03 · VUE D’ENSEMBLE
Comprendre l’architecture et les flux
04 · TUTORIEL
Procédure complète, étape par étape
Suivez les étapes dans l’ordre et contrôlez chaque résultat avant de poursuivre. Renseignez les paramètres adaptés à votre environnement.
ÉTAPE 1 / 4
Préparer projet et nœuds
Un job valide sur le mauvais nœud reste un incident potentiel.
- Choisir un projet de recette et contrôler les sources de nœuds.
- Étiqueter le nœud de démonstration et vérifier les droits Run/Read.
# Sur le nœud cible, contrôler l'identité :
hostname
idÀ vérifier : Le nœud cible est identifié sans ambiguïté.
Point de vigilance : Exécuter les opérations uniquement sur un environnement de recette autorisé, sans secret ni donnée de production.
ÉTAPE 2 / 4
Créer un job simple
Une définition minimale doit être explicite et relisible.
- Dans le projet, ouvrir Jobs puis créer un job nommé verifier-hote-recette.
- Ajouter un Workflow Step de type Command et renseigner une commande de lecture seule.
hostname && uname -sÀ vérifier : Le job est enregistré avec une seule commande non destructive.
Point de vigilance : Exécuter les opérations uniquement sur un environnement de recette autorisé, sans secret ni donnée de production.
ÉTAPE 3 / 4
Délimiter l'exécution
Le filtre de nœuds évite une exécution involontaire sur tout un parc.
- Définir un filtre de nœuds qui ne retourne que le laboratoire.
- Prévisualiser la sélection et ajuster éventuellement la concurrence des nœuds.
# Exemple conceptuel de filtre par tag :
tags: labÀ vérifier : La prévisualisation montre uniquement la cible autorisée.
Point de vigilance : Exécuter les opérations uniquement sur un environnement de recette autorisé, sans secret ni donnée de production.
ÉTAPE 4 / 4
Exécuter et inspecter le résultat
Le statut de succès doit être corroboré par le journal et la cible.
- Lancer manuellement et vérifier les nœuds réellement sélectionnés.
- Lire stdout, code retour, heure et auteur de l'exécution.
# La sortie attendue affiche le hostname du laboratoireÀ vérifier : L'exécution termine en succès et la trace correspond au bon hôte.
Point de vigilance : Exécuter les opérations uniquement sur un environnement de recette autorisé, sans secret ni donnée de production.
RÉFÉRENCES TECHNIQUES
Documentation officielle
Retrouvez les prérequis, les fonctionnalités et les versions prises en charge par Rundeck. Vérifiez les commandes sur un environnement de test avant leur utilisation en production.
05 · RECETTE
Comment vérifier que tout fonctionne ?
Le job apparaît dans le projet de recette.
Une exécution cible exactement le nœud prévu.
Le journal et le code retour permettent d'identifier le résultat.
06 · DIAGNOSTIC
Problèmes fréquents et résolution
No nodes matched
Cause probable : Filtre inadapté ou source de nœuds indisponible
Que faire : Vérifier tags, sources et permissions du projet.
Permission denied
Cause probable : Droits de l'exécuteur ou ACL insuffisants
Que faire : Contrôler le compte d'exécution, la politique ACL et la clé SSH.
Job succeeded mais sortie inattendue
Cause probable : Cible ou environnement erroné
Que faire : Comparer le hostname réel et le filtre enregistré.
07 · QUESTIONS PRATIQUES
Questions fréquentes
Un job Rundeck remplace-t-il Ansible ?
Non. Rundeck orchestre des opérations et peut déclencher des playbooks ou scripts existants.
Faut-il commencer par une planification ?
Non. Une première exécution manuelle et observable évite de multiplier un défaut.
Comment prouver la bonne cible ?
Afficher la liste de nœuds visés et la sortie du hostname du système exécutant.
AUTRES TECHNOLOGIES
Guides complémentaires
VOTRE ENVIRONNEMENT
Besoin d’aller plus loin sur votre environnement ?
Automatisation, sécurité et exploitation : échangeons sur vos pratiques Rundeck.
Échanger avec ADN Consulting