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 einer geplanten Ausfallzeit 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

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



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


### Docker neu starten


Damit Docker die Log-Rotations-Konfiguration verwenden kann, starten Sie bitte Docker neu, indem Sie 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](mailto:support@tulip.co).


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