Abilitazione delle rotazioni dei log per il contenitore Connector Host esistente in sede

Scopo

Questa guida è di natura altamente tecnica e deve essere esaminata con il reparto IT dell'organizzazione.

Questo documento elenca i passi da seguire per abilitare le rotazioni dei log per i container docker esistenti che non utilizzano le rotazioni dei log.

Se state eseguendo il Connector Host di Tulip in un container docker e avete già abilitato le rotazioni dei log per docker sulla macchina virtuale, potete ignorare questo articolo o se avete bisogno di ulteriori informazioni sull'installazione del connector host di Tulip in sede, fate riferimento a questo articolo.

Cos'è la rotazione dei log in Docker?

L'host del connettore on-premise di Tulip viene eseguito in un contenitore docker che utilizza un driver di json-logging per memorizzare i file di log localmente sulla macchina virtuale. Questi file possono utilizzare una notevole quantità di spazio su disco se la rotazione dei log per docker non è abilitata. La rotazione dei log consente di limitare le dimensioni di un file di log e il numero di tali file per ciascun contenitore.

Implementazione

I passaggi seguenti evidenziano come abilitare la rotazione dei log per docker, riavviare docker, eliminare il container esistente e creare un nuovo container per l'host del connettore on-premise di Tulip.

Questa procedura causerà una piccola quantità di tempo di inattività sull'host del connettore, quindi si consiglia di eseguire i seguenti comandi durante i tempi di inattività programmati o quando l'host del connettore non è in uso.

Rotazioni dei registri

La rotazione dei registri può essere attivata eseguendo i seguenti comandi su una macchina virtuale Linux

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

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


### Riavviare Docker


Per far sì che docker utilizzi la configurazione di log-rotations, riavviare docker eseguendo il seguente comando 


`$ sudo systemctl restart docker`


### Eliminazione del contenitore esistente


``` $ sudo docker ps 


## Questo elencherà i dettagli del contenitore esistente; si può copiare l'id del contenitore che sarà usato nel prossimo passo

$ sudo docker stop <contenitore id>

$ sudo docker rm <contenitore id>

Creare un nuovo contenitore

Eseguire nuovamente il seguente comando docker run che è stato eseguito la prima volta che è stato configurato l'host del connettore on-premise di Tulip

$ 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

Se le credenziali di cui sopra non sono disponibili, contattare Tulip.

Il contenitore che esegue il Connector Host on-premise di Tulip dovrebbe essere configurato ora con le rotazioni dei log abilitate.

Per confermare, se il container è di nuovo attivo, è possibile controllare i log del nuovo container eseguendo il seguente comando

docker logs <nome del container>