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 rotations de journaux pour leurs conteneurs Docker existants qui n'utilisent pas les rotations de journaux.

Si vous exécutez l'hôte connecteur sur site de Tulip 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 de l'hôte connecteur sur site de Tulip, veuillez vous référer à cet article.

Qu'est-ce que les rotations de logs dans Docker ?

L'hôte 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 l'option log-rotations pour Docker n'est pas activée. La rotation des journaux permet de limiter la taille d'un fichier journal et le nombre de ces fichiers pour chaque conteneur.

Mise en œuvre

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

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

Rotations de 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

$ cat > /etc/docker/daemon.json <<EOF 



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


### Redémarrage de Docker


Pour que docker puisse utiliser 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é à l'étape suivante.

`$ sudo docker stop <id de 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 connecteur sur site de Tulip a été configuré


`$ docker run -d \ 
--name tulip-connector-host \ 
-e TULIP_FACTORY='https://<FACTORY>.tulip.co' \ 
-e TULIP_UUID='<UUID>' \ 
-e TULIP_MACHINE_SECRET='<SECRET>' \ 
-e TULIP_DEVICE_TYPE=onprem 
-e HTTP_PROXY=" \ 
-e HTTPS_PROXY='' -e HTTPS_PROXY='' -e HTTPS_PROXY='' \ 
-e EXIT_ON_DISCONNECT=true \ 
--restart=unless-stopped \ 
--net=host \ 
--mount type=volume,source=tuliplog,target=/log \ 
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](mailto:support@tulip.co).


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


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


`$ docker logs <nom du conteneur>`