Ativação de rotações de log para contêineres existentes do Connector Host no local

Objetivo

Este guia é de natureza altamente técnica e deve ser revisado com o departamento de TI da sua organização.

Este documento listará as etapas para que os clientes habilitem as rotações de log para seus contêineres docker existentes que não estejam usando rotações de log.

Se estiver executando o Connector Host local da Tulip em um contêiner docker e já tiver o log-rotations habilitado para docker na VM, você pode ignorar este artigo ou, se precisar de mais informações sobre a instalação do Connector Host local da Tulip, consulte este artigo.

O que é o Log-rotations no Docker?

O host do conector local da Tulip é executado em um contêiner do Docker que usa um driver de registro json para armazenar arquivos de registro localmente na VM. Esses arquivos podem usar uma quantidade substancial de espaço em disco se a rotação de registros para o Docker não estiver ativada. A rotação de logs permite restringir o tamanho de um arquivo de log e o número de arquivos desse tipo para cada contêiner.

Implementação

As etapas a seguir destacarão como habilitar as rotações de log para o docker, reiniciar o docker, excluir o contêiner existente e criar um novo contêiner para o host do conector local da Tulip.

Esse procedimento causará um pequeno tempo de inatividade no host do conector, portanto, é aconselhável executar os seguintes comandos durante o tempo de inatividade programado ou quando o host do conector não estiver em uso.

Rotações de registro

As rotações de registro podem ser ativadas com a execução dos seguintes comandos em uma VM 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 o Docker


Para que o Docker use a configuração de rotações de registro, reinicie o Docker executando o seguinte comando 


`$ sudo systemctl restart docker`


### Exclusão do contêiner existente


``` $ sudo docker ps 


## Isso listará os detalhes do contêiner existente. Você pode copiar o ID do contêiner que será usado na próxima etapa

$ sudo docker stop <id do contêiner>

$ sudo docker rm <container id>

Criação de um novo contêiner

Execute novamente o seguinte comando docker run, que foi executado na primeira vez em que o host do conector local da Tulip foi configurado

$ 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 as credenciais acima não estiverem disponíveis, entre em contato com a Tulip.

O contêiner que executa o Connector Host local da Tulip deve estar configurado agora, juntamente com as rotações de log ativadas.

Para confirmar se o contêiner está de volta, você pode verificar os logs do novo contêiner executando o seguinte comando

$ docker logs <nome do contêiner>