Activación de las rotaciones de registro para el contenedor Connector Host local existente

Propósito

Esta guía es de naturaleza altamente técnica y debe ser revisada con el departamento de TI de su organización.

Este documento enumera los pasos para que los clientes habiliten las rotaciones de registro para sus contenedores Docker existentes que no utilizan rotaciones de registro.

Si está ejecutando Tulip's on-premise Connector Host en un contenedor docker, y ya tiene log-rotations habilitado para docker en la VM, puede ignorar este artículo o si necesita más información sobre la instalación de Tulip's on-premise connector host, por favor consulte este artículo.

¿Qué es Log-rotations en Docker?

Tulip's on-premise connector host se ejecuta en un contenedor docker que utiliza un controlador json-logging para almacenar archivos de registro localmente en la máquina virtual. Estos archivos pueden utilizar una cantidad sustancial de espacio en disco si log-rotations para docker no está habilitado. Log-rotation permite restringir el tamaño de un archivo de registro y el número de tales archivos para cada contenedor.

Implementación

Los siguientes pasos resaltarán cómo habilitar log-rotations para docker, reiniciar docker, borrar el contenedor existente y crear un nuevo contenedor para el host conector local de Tulip.

Este procedimiento causará un pequeño tiempo de inactividad en el host del conector, por lo que se recomienda ejecutar los siguientes comandos durante el tiempo de inactividad programado, o cuando el host del conector no esté en uso.

Rotación de registros

La rotación de registros puede activarse ejecutando los siguientes comandos en una máquina virtual Linux

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

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


### Reiniciando Docker


Para que docker utilice la configuración de log-rotations, reinicie docker ejecutando el siguiente comando 


`$ sudo systemctl restart docker`


### Borrar contenedor existente


``` $ sudo docker ps 


## Esto mostrará los detalles del contenedor existente, puede copiar el id del contenedor que se utilizará en el siguiente paso

$ sudo docker stop <id contenedor>

$ sudo docker rm <id contenedor>

Creación de un nuevo contenedor

Vuelve a ejecutar el siguiente comando docker run que se ejecutó la primera vez que se configuró el host del conector local de 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

Si no dispone de las credenciales anteriores, póngase en contacto con Tulip.

El contenedor que ejecuta el Connector Host local de Tulip debería estar configurado ahora junto con las rotaciones de registro habilitadas.

Para confirmar, si el contenedor está de vuelta, puedes comprobar los logs del nuevo contenedor ejecutando el siguiente comando

$ docker logs <nombre del contenedor>