Déployer l'agent Onagre avec Docker

Présentation

L'agent Onagre peut être déployé en tant que conteneur Docker, permettant une installation et une gestion simplifiées. Cette méthode est particulièrement utile pour déployer l'agent dans des environnements Linux tout en assurant un monitoring transparent des infrastructures publiques et privées.

⚠️ Compatibilité de plateforme

L'agent Onagre pour Docker est actuellement compatible uniquement avec les architectures Linux-x64.

Récupération de l'image Docker

Pour récupérer la dernière version de l'agent Onagre, exécutez la commande suivante :

docker pull onagreio/agent

Exécution du conteneur de l'agent Onagre

Pour déployer l'agent Onagre avec Docker, suivez ces étapes :

Assurez-vous de disposer d'un token d'agent Onagre valide.
Créez un répertoire de configuration sur votre système pour stocker les fichiers de configuration de l'agent.
Assurez-vous que le répertoire de configuration dispose de permissions d'écriture suffisantes pour que le conteneur puisse stocker les fichiers nécessaires.
Exécutez l'agent avec Docker, en passant les variables d'environnement et les montages de volumes nécessaires.

Exemple de commande de déploiement

docker run -d \
    --ulimit nofile=65536:65536 \
    --network host \
    -e "TOKEN=YOUR_TOKEN" \
    -v $(pwd)/onagre_conf:/etc/onagre \
    --name onagre-agent \
    --restart=always \
    onagreio/agent

Explication des paramètres

Paramètre	Description
`--ulimit nofile=65536:65536`	Augmente la limite de descripteurs de fichiers pour de meilleures performances.
`--network host`	Exécute le conteneur en mode réseau hôte pour un accès direct aux services surveillés.
`-e "TOKEN=YOUR_TOKEN"`	Transmet le token d'agent Onagre requis en tant que variable d'environnement.
`-v $(pwd)/onagre_conf:/etc/onagre`	Monte un répertoire local comme dossier de configuration pour l'agent. Assurez-vous que ce répertoire dispose des permissions d'écriture pour le conteneur.
`--name onagre-agent`	Attribue un nom identifiable au conteneur.
`--restart=always`	Garantit le redémarrage automatique de l'agent si le conteneur s'arrête.

Gestion de l'agent

Consultation des logs

Pour surveiller les logs de l'agent Onagre en cours d'exécution, utilisez :

docker logs -f onagre-agent

Redémarrage de l'agent

Pour redémarrer le conteneur de l'agent manuellement, exécutez :

docker restart onagre-agent

Arrêt et suppression de l'agent

Pour arrêter et supprimer le conteneur de l'agent :

docker stop onagre-agent && docker rm onagre-agent

Résumé

Déployer l'agent Onagre via Docker offre un moyen simple et flexible d'intégrer des capacités de monitoring dans votre infrastructure. Grâce à la conteneurisation, l'agent reste facile à gérer, évolutif et sécurisé.