Habilitación de las rotaciones de registros para el contenedor Connector Host existente en las instalaciones

Objetivo

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

Este documento enumerará los pasos para que los clientes habiliten las rotaciones de registro para sus contenedores Docker existentes que no están utilizando las rotaciones de registro.

Si está ejecutando el Connector Host de Tulip en un contenedor Docker, y ya tiene habilitadas las rotaciones de registro para Docker en la máquina virtual, puede ignorar este artículo o si necesita más información sobre la instalación del Connector Host de Tulip, por favor consulte este artículo.

¿Qué es Log-rotations en Docker?

El host del conector de Tulip se ejecuta en un contenedor Docker que utiliza un controlador de registro json 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. La rotación de registros 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 las rotaciones de registro para Docker, reiniciar Docker, eliminar el contenedor existente y crear un nuevo contenedor para el host del conector local de Tulip.

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

Rotación de registros

Las rotaciones de registro pueden activarse ejecutando los siguientes comandos en una máquina virtual 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
> ```
> 
> 
> 


### Cómo reiniciar Docker


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


`$ sudo systemctl restart docker`


### Eliminación del 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 <contenedor id>`


`$ sudo docker rm <contenedor id>`


### 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 \N - nombre tulip-connector-host 
--name tulip-connector-host \_nombre 
-e TULIP_FACTORY='https://<FACTORY>.tulip.co' \N -e TULIP_UUID 
-e TULIP_UUID='<UUID>' \N -e TULIP_MACHINE='<FACTORY>.tulip.co 
-e TULIP_MACHINE_SECRET='<SECRET>' \N -e TULIP_DEVOLUTION='<SECRET>' 
-e TULIP_DEVICE_TYPE=onprem 
-e HTTP_PROXY='' \ 
-e HTTPS_PROXY='' \ 
-e EXIT_ON_DISCONNECT=true \N -e HTTPS_PROXY='' -e EXIT_ON_DISCONNECT=true 
--restart=sin paradas \N -e EXIT_ON_DISCONNECT=true 
--net=host \N -mount type=volumen,\Ny 
--mount type=volume,source=tuliplog,target=/log \N --mount type=volume,source=tuliplog,target=/log 
bckca2dh98.execute-api.us-east-1.amazonaws.com/public/conector-host:prod`


Si las credenciales anteriores no están disponibles, por favor, póngase en contacto con [Tulip](mailto:support@tulip.co).


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 registros del nuevo contenedor ejecutando el siguiente comando 


`$ docker logs <nombre del contenedor>`