Activation des rotations de journaux pour le conteneur Connector Host existant sur site

Objectif

Ce guide est de nature très technique et doit être revu avec le département informatique de votre organisation.

Ce document énumère les étapes permettant aux clients d'activer les log-rotations pour leurs conteneurs Docker existants qui n'utilisent pas les log-rotations.

Si vous utilisez le Connector Host de Tulip sur site dans un conteneur Docker, et que les log-rotations sont déjà activées pour Docker sur la VM, vous pouvez ignorer cet article. Si vous avez besoin de plus d'informations sur l'installation du Connector Host de Tulip sur site, veuillez vous référer à cet article.

Qu'est-ce que Log-rotations dans Docker ?

L'hôte du connecteur sur site de Tulip fonctionne dans un conteneur Docker qui utilise un pilote json-logging pour stocker les fichiers journaux localement sur la VM. Ces fichiers peuvent utiliser une quantité substantielle d'espace disque si la rotation des logs pour Docker n'est pas activée. La rotation des logs permet de limiter la taille d'un fichier de log et le nombre de ces fichiers pour chaque conteneur.

Mise en œuvre

Les étapes suivantes montrent comment activer la rotation des logs pour Docker, redémarrer Docker, supprimer le conteneur existant et créer un nouveau conteneur pour l'hôte du connecteur sur site de Tulip.

Cette procédure entraînera un petit temps d'arrêt sur le connector host, il est donc conseillé d'exécuter les commandes suivantes pendant les temps d'arrêt planifiés, ou lorsque le connector host n'est pas utilisé.

Rotations des journaux

Les rotations de journaux peuvent être activées en exécutant les commandes suivantes sur une VM Linux

sudo su $ touch /etc/docker/daemon.json

> 
> {  
> 
> "live-restore" : true,  
> 
> "log-driver" : "json-file",  
> 
> "log-opts" : {  
> 
> "max-size" : "10m",  
> 
> "max-file" : "3"  
> 
> }  
> 
> }  
> 
> EOF ````
> 
> 
> 


### Redémarrage de Docker


Pour que docker utilise la configuration log-rotations, veuillez redémarrer docker en exécutant la commande suivante 


`sudo systemctl restart docker`


### Suppression d'un conteneur existant


``` $ sudo docker ps 


## Ceci listera les détails du conteneur existant, vous pouvez copier l'identifiant du conteneur qui sera utilisé dans l'étape suivante

$ sudo docker stop <identifiant du conteneur>

$ sudo docker rm <conteneur id>

Création d'un nouveau conteneur

Réexécutez la commande docker run suivante qui a été exécutée la première fois que l'hôte du connecteur sur site de Tulip a été configuré

$ docker run -d \N --name tulip-connector-host \N -e TULIP_FACTORY='https://<FACTORY>.tulip.co' \N -e TULIP_UUID='<UUID>' \N -e TULIP_MACHINE_SECRET='<SECRET>' \N -e TULIP_DEVICE_TYPE=onprem -e HTTP_PROXY='' \N-e HTTPS_PROXY='' -e HTTPS_PROXY='' \e -e EXIT_ON_DISCONNECT=true \e --restart=unless-stopped \e --net=host \e --mount type=volume,source=tuliplog,target=/log \e bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:prod

Si les informations d'identification ci-dessus ne sont pas disponibles, veuillez contacter Tulip.

Le conteneur qui exécute le Connector Host de Tulip sur site devrait être configuré maintenant avec les rotations de logs activées.

Pour confirmer, si le conteneur est de retour, vous pouvez vérifier les logs du nouveau conteneur en exécutant la commande suivante

$ docker logs <nom du conteneur>