Instalação do Docker no WSL

De IT's Instruções de Trabalho - FAHOR/CFJL
Revisão de 14h35min de 17 de abril de 2025 por Huanan (discussão | contribs)
Ir para navegação Ir para pesquisar

Este guia tem como objetivo orientar a instalação do Docker em uma distribuição Ubuntu executada no WSL (Windows Subsystem for Linux). O processo inclui a remoção de instalações anteriores, adição dos repositórios oficiais do Docker, instalação dos componentes necessários e configuração do ambiente para uso com permissões adequadas e instalação do git para versionamento de código.

Preparando o ambiente para o Docker

Removendo versões anteriores

Antes de iniciar a instalação, é importante garantir que não existam versões antigas ou conflitantes do Docker já instaladas no sistema, evitando possíveis problemas.

sudo apt remove docker docker.io containerd runc

Instalando dependências básicas

Instale os pacotes essenciais para que o apt possa se comunicar com repositórios HTTPS e manipular chaves GPG.

sudo apt install --no-install-recommends apt-transport-https ca-certificates curl gnupg2 lsb-release -y

Adicionando o repositório oficial

Carregue as variáveis de versão no ambiente:

. /etc/os-release

Adicione a chave GPG oficial do Docker:

curl -fsSL https://download.docker.com/linux/${ID}/gpg | sudo tee /etc/apt/trusted.gpg.d/docker.asc

Inclua o repositório Docker na lista de fontes do sistema:

echo "deb [arch=amd64] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list


Instalando o Docker e seus componentes

Atualize os pacotes e instale o Docker com seus principais componentes:

sudo apt update 

sudo apt upgrade -y
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Iniciando o serviço e configurando permissões

Inicie o serviço do Docker e permita o uso do socket sem precisar de sudo:

service docker start chmod 666 /var/run/docker.sock

Se você não estiver executando como root, adicione seu usuário ao grupo docker (substitua <user> pelo seu nome de usuário):

sudo usermod -aG docker <user>

Verificando o Docker Compose

Crie um link simbólico para o comando docker-compose e verifique a versão instalada:

sudo ln -s /usr/libexec/docker/cli-plugins/docker-compose /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
docker-compose --version

Instalando e configurando o Git

Para utilizar o Git no controle de versões de seus projetos, é necessário instalá-lo e configurar sua identidade de usuário. Isso permite que suas alterações sejam corretamente atribuídas.

Instale o Git e o Git LFS (Large File Storage), útil para trabalhar com arquivos grandes:

 sudo apt install git git-lfs

Configure seu nome e e-mail, que serão usados em cada commit realizado:

git config --global user.email "<seu-email@exemplo.com>"

git config --global user.name "<Seu Nome>"

Verificando a configuração atual

Caso queira conferir os valores configurados para o Git, utilize os comandos abaixo:

git config --global user.email 

git config --global user.name

Esses comandos irão retornar o e-mail e nome atualmente definidos no seu ambiente.