Docker

2024-06-20T12:29:51Z

Raphaelsilva: Destaca o install no comando de setup

==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:

# Crie a pasta <code>~/.config/docker</code> com o comando <code>mkdir -p ~/.config/docker</code>.
# Altere a pasta de armazenamento do Docker para a /homeLocal com:

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

'''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.[https://github.com/docker/for-linux/issues/1172 Aqui está um issue citando o problema]

# Execute <code>dockerd-rootless-setuptool.sh install</code>.
Importante: Após terminar, o comando vai pedir que você altere seu .bashrc para adicionar uma linha semelhante a <code>export DOCKER_HOST=unix:///run/user/<uid>/docker.sock</code> (varia por usuário). Faça essa alteração antes de prosseguir copiando e colando o comando no terminal.
# Reinicie o Bash com <code>exec bash</code>.
# Ative a inicialização automática do Docker: <code>systemctl --user enable --now docker</code> ou manualmente: <code>systemctl --user start docker</code>

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

==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:
# Criar uma pasta na /homeLocal do usuário que será usada pelo runtime do dockerd-rootless, executando:<br>
<code>mkdir /homeLocal/<user>/.docker</code><br>
<code>mkdir /homeLocal/<user>/.docker/run</code>
#Após isso é preciso criar as variaveis de ambiente no ~/.bashrc para XDG_RUNTIME_DIR e DOCKER_HOST.
<code>export XDG_RUNTIME_DIR=/homeLocal/<user>/.docker/run</code>
<code>export DOCKER_HOST=unix:///homeLocal/<user>/.docker/run/docker.sock</code>

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

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

VeRLab Wiki - User contributions [en]

Docker