Déployer l'agent Onagre avec le script d'installation
Présentation
Onagre fournit un script d'installation interactif qui automatise le téléchargement, la configuration et la mise en place du service d'un agent privé sous Linux. C'est le moyen le plus rapide de mettre un agent en service.
Le script gère la détection d'architecture, le téléchargement du binaire, la création du service systemd et l'activation du service — le tout en une seule commande.
Prérequis
- Un système Linux avec systemd (Debian, Ubuntu, RHEL, etc.)
- Accès root ou sudo
- curl ou wget installé
- Votre token d'agent Onagre (disponible depuis l'interface Onagre)
Installation rapide
Téléchargez et exécutez le script en une seule commande :
curl -fsSL https://d.onag.re/onagent.sh | sudo bash
Ou avec wget :
wget -qO- https://d.onag.re/onagent.sh | sudo bash
Le script vous demandera de manière interactive :
- Nom de l'agent — Un libellé pour cette instance d'agent (par défaut
default). Cela permet d'exécuter plusieurs agents sur le même hôte. - Token — Votre token d'agent Onagre.
Une fois fournis, le script automatiquement :
- Détecte l'architecture du système (x64, ARM, ARM64)
- Télécharge le binaire approprié dans
/usr/local/bin/onagent@<nom> - Crée un service systemd dans
/etc/systemd/system/onagent@<nom>.service - Active et démarre le service
- Affiche les logs du service pour confirmation
Architectures prises en charge
| Architecture | Valeurs détectées |
|---|---|
| x86_64 | x86_64, amd64 |
| ARM 64 bits | aarch64, arm64 |
| ARM 32 bits | armv7l, armhf |
Le script détecte automatiquement votre architecture — aucune sélection manuelle requise.
Gestion des agents
Le script d'installation fournit également des commandes pour gérer les agents déployés.
Lister les agents installés
sudo bash onagent.sh list
Affiche tous les services d'agent Onagre installés avec leur statut (UP / DOWN).
Redémarrer un agent
sudo bash onagent.sh restart <nom_agent>
Mettre à jour tous les agents
sudo bash onagent.sh update
Arrête tous les agents en cours d'exécution, télécharge les derniers binaires et redémarre les services.
Désinstaller un agent
sudo bash onagent.sh uninstall <nom_agent>
Arrête et désactive le service, supprime le binaire et le fichier de service, et recharge systemd.
Plusieurs agents sur le même hôte
Le script prend en charge le déploiement de plusieurs instances d'agent sur un seul hôte. Chaque agent dispose de son propre nom de service (onagent@<nom>), binaire et token.
Exécutez simplement le script d'installation à nouveau et fournissez un nom d'agent différent :
curl -fsSL https://d.onag.re/onagent.sh | sudo bash
Chaque instance fonctionne de manière indépendante et apparaît comme un agent distinct dans l'interface Onagre.
Ce que le script crée
| Élément | Chemin |
|---|---|
| Binaire de l'agent | /usr/local/bin/onagent@<nom> |
| Service systemd | /etc/systemd/system/onagent@<nom>.service |
Le service systemd est configuré avec :
- Redémarrage automatique en cas d'échec (délai de 5 secondes)
- Limite de descripteurs de fichiers de 65 535
- Exécution en tant que
root - Démarrage après
network.target
Résumé
Le script d'installation est la méthode recommandée pour déployer les agents Onagre sous Linux. Il automatise l'ensemble du processus d'installation et fournit des commandes intégrées pour lister, mettre à jour, redémarrer et désinstaller les agents.
Pour une installation manuelle pas à pas, consultez le Déploiement manuel.