Framework de plugins
Étendez les fonctionnalités de Xcellerate RMM avec des plugins communautaires et personnalisés.
Aperçu
Le framework de plugins vous permet d'étendre Xcellerate RMM avec des fonctionnalités supplémentaires sans modifier la plateforme de base. Les plugins peuvent ajouter de nouveaux widgets au tableau de bord, des moniteurs personnalisés, des types de rapports, des connecteurs d'intégration, et même des pages d'interface entièrement nouvelles.
RMM Labs gère une place de marché de plugins officielle avec des plugins proposés par la communauté et des plugins maison. Vous pouvez aussi développer vos propres plugins privés avec le Plugin SDK et TypeScript/JavaScript.
Concepts clés
- Plugin — un paquet d'extension autonome comprenant un manifeste, du code et des ressources facultatives (icônes, modèles). Installé au niveau du serveur.
- Place de marché de plugins — le catalogue intégré où vous parcourez, installez et mettez à jour les plugins. Accessible depuis Administration → Plugins.
- Plugin SDK — un kit de développement qui fournit des API pour interagir avec les données, les composants d'interface et les événements de Xcellerate RMM. Disponible sous forme de paquet npm.
- Hook — un point d'extension de la plateforme où les plugins peuvent injecter un comportement (par ex.
onEndpointCreated,onAlertFired,beforePatchInstall). - Widget — un composant fourni par un plugin que l'on peut ajouter au tableau de bord ou aux pages de détail des endpoints (par ex. un graphique personnalisé, un bouton d'action rapide).
- Paramètres du plugin — des valeurs de configuration exposées par le plugin (par ex. une clé API pour un service tiers). Les administrateurs les définissent après l'installation.
Pas à pas
Parcourez la place de marché
Allez dans Administration → Plugins → Marketplace. Parcourez par catégorie (supervision, rapports, intégrations, interface) ou recherchez par nom. Chaque fiche de plugin affiche une description, l'auteur, la version, la note et le nombre d'installations.
Installez un plugin
Cliquez sur un plugin pour afficher sa page de détail, puis cliquez sur Install. Le plugin est téléchargé et activé. Certains plugins nécessitent un redémarrage du serveur — l'interface vous le signale le cas échéant.
Configurez le plugin
Après l'installation, allez dans Administration → Plugins → Installed. Cliquez sur le nom du plugin et remplissez les paramètres requis (par ex. clés API, paramètres par défaut). Enregistrez.
Utilisez le plugin
Selon le type de plugin, vous verrez peut-être un nouvel élément dans le menu latéral, un nouveau widget sur le tableau de bord, des options supplémentaires dans les menus contextuels ou un nouveau type de rapport. Consultez la documentation du plugin pour plus de détails.
Mettez à jour ou supprimez un plugin
Sur la page des plugins installés, vous pouvez rechercher les mises à jour (un badge apparaît lorsqu'une nouvelle version est disponible) ou cliquer sur Uninstall pour supprimer proprement un plugin.
Développer un plugin personnalisé
Pour créer votre propre plugin, installez le Plugin SDK et générez la structure d'un nouveau projet :
npm install -g @xcellerate/plugin-sdk
xcellerate-plugin init my-custom-plugin
cd my-custom-plugin
npm run devLe projet généré contient un fichier manifeste (plugin.json), un point d'entrée et des exemples de hooks. Le SDK fournit des types TypeScript pour toutes les API de la plateforme et un serveur de développement local qui recharge votre plugin à chaud sur une instance Xcellerate isolée.
Conseils et bonnes pratiques
- Consultez la place de marché avant de développer une solution sur mesure — il existe peut-être déjà un plugin qui fait ce dont vous avez besoin.
- Tenez vos plugins à jour — les auteurs corrigent souvent des bugs et ajoutent des fonctionnalités dans les nouvelles versions.
- Lorsque vous développez un plugin personnalisé, appliquez le principe du moindre privilège : ne demandez que les autorisations API dont votre plugin a réellement besoin.
- Testez les plugins personnalisés dans un environnement de préproduction avant de les déployer en production.
- Utilisez des hooks pour la logique pilotée par les événements (par ex. étiqueter automatiquement les endpoints à leur création) plutôt que d'interroger l'API en boucle.
- Proposez vos plugins utiles sur la place de marché pour les partager avec la communauté et recueillir des retours.