Habilitação de log-rotations para contêineres Connector Host existentes no local

Objetivo

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

Este documento listará as etapas para que os clientes habilitem os log-rotations para seus contêineres portuários existentes que não estejam usando log-rotations.

Se você estiver executando o Connector Host on-premise da Tulip em um container portuário, e já tiver os log-rotations habilitados para o docker no VM, você pode ignorar este artigo ou se precisar de mais informações sobre a instalação do Connector Host on-premise da Tulip, por favor, consulte este artigo.

O que são Log-rotations no Docker?

O host de conectores da Tulip no local funciona em um container portuário que usa um driver json-logging para armazenar arquivos de log localmente na VM. Estes arquivos podem usar uma quantidade substancial de espaço em disco se os log-rotations para o Docker não estiverem habilitados. O log-rotation permite restringir o tamanho de um arquivo de log e o número de tais arquivos para cada contêiner.

Implementação

Os passos seguintes destacarão como habilitar as log-rotações para o atracadouro, reiniciar o atracadouro, apagar o container existente e criar um novo container para o host de conectores no local da Tulip.

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

Log-Rotations

As rotações de log podem ser habilitadas executando os seguintes comandos em uma VM Linux

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

> 
> {  
> 
> "live-restore": verdade,  
> 
> "motorista de troncos": "json-file",  
> 
> "log-opts": {  
> 
> "tamanho máximo": "10m",  
> 
> "max-file": "3"  
> 
> }  
> 
> }  
> 
> EOF````
> 
> 
> 


### Docker de reinício


Para que o docker possa utilizar a configuração de log-rotations, favor reiniciar o docker executando o seguinte comando 


`US$ sudo systemctl reiniciar doca`


### Eliminação do contêiner existente


```$ sudo docker ps 


## Isto listará os detalhes do container existente, você pode copiar a identificação do container que será usado na próxima etapa

$ sudo docker stop <container id>

$ sudo docker rm <container id>

Criação de um novo container

Executar novamente o seguinte comando de execução de doca que foi executado na primeira vez que o host de conectores da Tulip no local foi configurado

TULIP_FACTORY='https://<FACTORY>.tulip.co' -e TULIP_UUID='<UUID>' -e TULIP_MACHINE_SECRET='<SECRET>' -e TULIP_DEVICE_TYPE=onprem -e HTTP_PROXY='' \ HTTPS_PROXY=''' -e HTTPS_PROXY=''. \ EXIT_ON_DISCONNECT=true \ --restart=unless-stopped \ --net=host=host

Se as credenciais acima não estiverem disponíveis, por favor, entre em contato com a Tulip.

O contêiner que opera o Connector Host on-premise da Tulip deve ser configurado agora, juntamente com as log-rotações habilitadas.

Para confirmar, se o container estiver de volta, você pode verificar os logs do novo container, executando o seguinte comando

$ logs de doca <nome do contêiner>