Aktivieren von Log-Rotationen für bestehende Connector Host Container vor Ort

Zweck

Dieser Leitfaden ist sehr technischer Natur und sollte mit der IT-Abteilung Ihres Unternehmens besprochen werden.

In diesem Dokument werden die Schritte aufgeführt, mit denen Kunden Log-Rotations für ihre bestehenden Docker-Container, die keine Log-Rotations verwenden, aktivieren können.

Wenn Sie den On-Premise Connector Host von Tulip in einem Docker-Container betreiben und bereits Log-Rotations für Docker auf der VM aktiviert haben, können Sie diesen Artikel ignorieren. Wenn Sie weitere Informationen zur Installation des On-Premise Connector Host von Tulip benötigen, lesen Sie bitte diesen Artikel.

Was ist Log-rotations in Docker?

Der On-Premise-Connector-Host von Tulip läuft in einem Docker-Container, der einen json-logging-Treiber für die lokale Speicherung von Log-Dateien auf der VM verwendet. Diese Dateien können eine beträchtliche Menge an Speicherplatz verbrauchen, wenn Log-Rotations für Docker nicht aktiviert ist. Die Log-Rotation ermöglicht es, die Größe einer Log-Datei und die Anzahl solcher Dateien für jeden Container zu begrenzen.

Implementierung

Die folgenden Schritte zeigen, wie man Log-Rotationen für Docker aktiviert, Docker neu startet, den bestehenden Container löscht und einen neuen Container für Tulips On-Premise-Connector-Host erstellt.

Diese Prozedur wird eine geringe Ausfallzeit auf dem Connector-Host verursachen. Es ist daher ratsam, die folgenden Befehle während geplanter Ausfallzeiten auszuführen, oder wenn der Connector-Host nicht in Gebrauch ist.

Log-Rotationen

Log-Rotationen können mit den folgenden Befehlen auf einer Linux-VM aktiviert werden

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

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


### Neustart von Docker


Damit Docker die Log-Rotations-Konfiguration verwenden kann, starten Sie bitte Docker neu, indem Sie den folgenden Befehl ausführen 


`$ sudo systemctl restart docker`


### Löschen eines bestehenden Containers


``` $ sudo docker ps 


## Dies wird die Details des existierenden Containers auflisten, Sie können die Container-ID kopieren, die im nächsten Schritt verwendet wird

$ sudo docker stop <Container-ID>

$ sudo docker rm <Behälter-ID>

Erstellen eines neuen Containers

Führen Sie den folgenden Befehl docker run erneut aus, der bei der ersten Einrichtung des Tulip-On-Premise-Connector-Hosts ausgeführt wurde

$ 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 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

Wenn die oben genannten Anmeldeinformationen nicht verfügbar sind, wenden Sie sich bitte an Tulip.

Der Container, auf dem Tulips On-Premise Connector Host läuft, sollte jetzt eingerichtet und die Log-Rotationen aktiviert sein.

Um zu überprüfen, ob der Container wieder in Betrieb ist, können Sie die Logs des neuen Containers mit folgendem Befehl überprüfen

$ docker logs <Name des Containers>