Difference between revisions of "Docker"

Revision as of 10:29, 20 June 2024

Instalação

Importante: para estas configurações é necessário que a máquina tenha um docker instalado com versão >= 20.10

Este processo ainda se encontra em uma fase experimental e não está disponível em todas as máquinas. As máquinas disponíveis com docker até o momento são PROC6, PROC7, EVA e DALEK.

Configuração inicial

Para utilizar docker em uma máquina no laboratório é preciso que o usuário: - solicite à equipe de rede para criar uma pasta na /homeLocal/nome_do_usuario e dar permissão de leitura/escrita. - solicite à equipe de rede a instalação do docker na máquina.

Feito estas etapas, para configurar o acesso na máquina é preciso seguir os seguintes passos para executar o docker rootless:

1. Crie a pasta ~/.config/docker com o comando mkdir -p ~/.config/docker.
2. Altere a pasta de armazenamento do Docker para a /homeLocal com:

echo '{"data-root":"/homeLocal/<user>/docker"}' | tee ~/.config/docker/daemon.json

Importante: Lembre-se de trocar o /<user> para alguma pasta sua.

Esses dois primeiros passos são específicos para as máquinas do VeRLab: por padrão o Docker guarda arquivos na /home do usuário, mas essa pasta é compartilhada por NFS e o Docker não dá suporte a isso.Aqui está um issue citando o problema

1. Execute dockerd-rootless-setuptool.sh install.

Importante: Após terminar, o comando vai pedir que você altere seu .bashrc para adicionar uma linha semelhante a export DOCKER_HOST=unix:///run/user/<uid>/docker.sock (varia por usuário). Faça essa alteração antes de prosseguir copiando e colando o comando no terminal.

1. Reinicie o Bash com exec bash.
2. Ative a inicialização automática do Docker: systemctl --user enable --now docker ou manualmente: systemctl --user start docker

Com isso, a configuração está pronta. Confirme que o Docker está funciona com docker run hello-world ou docker version.

Problemas com a instalação na máquina

Caso mesmo após estes passos o docker apresente problemas, pode ser necessário realizar a configuração de modo a executar ele manualmente direcionado para a sua pasta na /homeLocal. Para isso é preciso é preciso:

1. Criar uma pasta na /homeLocal do usuário que será usada pelo runtime do dockerd-rootless, executando:
   

mkdir /homeLocal/<user>/.docker
mkdir /homeLocal/<user>/.docker/run

1. Após isso é preciso criar as variaveis de ambiente no ~/.bashrc para XDG_RUNTIME_DIR e DOCKER_HOST.

export XDG_RUNTIME_DIR=/homeLocal/<user>/.docker/run export DOCKER_HOST=unix:///homeLocal/<user>/.docker/run/docker.sock

A partir deste ponto, enquanto quiser executar o docker, é preciso deixar uma janela excutando o bash script dockerd-rootless.sh. Para isso abra uma janela do tmux ou byobu, e execute: bash dockerd-rootless.sh

Em outro terminal, é possível verificar a instalação executando docker run hello-world ou docker version.