Mudanças entre as edições de "Instalação do Docker no WSL"

De IT's Instruções de Trabalho - FAHOR/CFJL
Ir para navegação Ir para pesquisar
 
(2 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
−
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.
+
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, configuração do ambiente para uso com permissões adequadas e instalação do Git para versionamento de código.
  
−
=== Removendo versões anteriores do Docker ===
+
== 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.
 
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.
  
−
<syntaxhighlight lang="bash">sudo apt remove docker docker.io containerd runc</syntaxhighlight>
+
<syntaxhighlight lang="bash">
 +
sudo apt remove docker docker.io containerd runc
 +
</syntaxhighlight>
 +
 
 
=== Instalando dependências básicas ===
 
=== Instalando dependências básicas ===
  
−
Instale os pacotes essenciais para que o apt possa se comunicar com repositórios HTTPS e manipular chaves GPG.
+
Instale os pacotes essenciais para que o `apt` possa se comunicar com repositórios HTTPS e manipular chaves GPG.
 +
 
 +
<syntaxhighlight lang="bash">
 +
sudo apt install --no-install-recommends apt-transport-https ca-certificates curl gnupg2 lsb-release -y
 +
</syntaxhighlight>
  
−
<syntaxhighlight lang="bash">sudo apt install --no-install-recommends apt-transport-https ca-certificates curl gnupg2 lsb-release -y</syntaxhighlight>
+
=== Adicionando o repositório oficial===
−
=== Adicionando o repositório oficial do Docker ===
 
  
 
Carregue as variáveis de versão no ambiente:
 
Carregue as variáveis de versão no ambiente:
  
−
<syntaxhighlight lang="bash">. /etc/os-release</syntaxhighlight>
+
<syntaxhighlight lang="bash">
 +
. /etc/os-release
 +
</syntaxhighlight>
 +
 
 
Adicione a chave GPG oficial do Docker:
 
Adicione a chave GPG oficial do Docker:
  
−
<syntaxhighlight lang="bash">curl -fsSL https://download.docker.com/linux/${ID}/gpg | sudo tee /etc/apt/trusted.gpg.d/docker.asc</syntaxhighlight>
+
<syntaxhighlight lang="bash">
−
Inclua o repositório Docker na lista de fontes do sistema:
+
curl -fsSL https://download.docker.com/linux/${ID}/gpg | sudo tee /etc/apt/trusted.gpg.d/docker.asc
 +
</syntaxhighlight>
  
−
<syntaxhighlight lang="bash">echo "deb [arch=amd64] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list</syntaxhighlight>
+
Inclua o repositório do Docker na lista de fontes do sistema:
  
 +
<syntaxhighlight lang="bash">
 +
echo "deb [arch=amd64] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list
 +
</syntaxhighlight>
  
 
=== Instalando o Docker e seus componentes ===
 
=== Instalando o Docker e seus componentes ===
Linha 28: Linha 43:
 
Atualize os pacotes e instale o Docker com seus principais componentes:
 
Atualize os pacotes e instale o Docker com seus principais componentes:
  
−
<syntaxhighlight lang="bash">sudo apt update  
+
<syntaxhighlight lang="bash">
 +
sudo apt update
 +
sudo apt upgrade -y
 +
</syntaxhighlight>
  
−
sudo apt upgrade -y  
+
<syntaxhighlight lang="bash">
 +
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
=== Iniciando o serviço e configurando permissões ===
 +
 +
Inicie o serviço do Docker e permita o uso do socket sem precisar de `sudo`:
 +
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y</syntaxhighlight>
+
service docker start
−
=== Iniciando o serviço e configurando permissões ===
+
chmod 666 /var/run/docker.sock
 +
</syntaxhighlight>
  
−
Inicie o serviço do Docker e permita o uso do socket sem precisar de sudo:
+
Se você não estiver executando como root, adicione seu usuário ao grupo `docker` (substitua `<user>` pelo seu nome de usuário):
  
−
<syntaxhighlight lang="bash">service docker start chmod 666 /var/run/docker.sock</syntaxhighlight>
+
<syntaxhighlight lang="bash">
−
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>
 +
</syntaxhighlight>
  
−
<syntaxhighlight lang="bash">sudo usermod -aG docker <user></syntaxhighlight>
 
 
=== Verificando o Docker Compose ===
 
=== Verificando o Docker Compose ===
  
−
Crie um link simbólico para o comando docker-compose e verifique a versão instalada:
+
Crie um link simbólico para o comando `docker-compose` e verifique a versão instalada:
 +
 
 +
<syntaxhighlight lang="bash">
 +
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
 +
</syntaxhighlight>
 +
 
 +
== Instalando e configurando o Git ==
  
−
<syntaxhighlight lang="bash">sudo ln -s /usr/libexec/docker/cli-plugins/docker-compose /usr/local/bin/docker-compose </syntaxhighlight>
+
Para utilizar o Git no controle de versões de seus projetos, é necessário instalá-lo e configurar sua identidade de usuário. Isso garante que suas alterações sejam corretamente atribuídas.
  
−
<syntaxhighlight lang="bash">chmod +x /usr/local/bin/docker-compose</syntaxhighlight>
+
Instale o Git e o Git LFS (Large File Storage), útil para trabalhar com arquivos grandes:
  
−
<syntaxhighlight lang="bash">docker-compose --version</syntaxhighlight>
+
<syntaxhighlight lang="bash">
 +
sudo apt install git git-lfs
 +
</syntaxhighlight>
  
−
=== Instalando e configurando Git ===
+
Configure seu nome e e-mail, que serão usados em cada commit realizado:
  
−
Instale o Git e configure a identidade global para utilizar versionamento de código:
+
<syntaxhighlight lang="bash">
 +
git config --global user.email "<seu-email@exemplo.com>"
 +
git config --global user.name "<Seu Nome>"
 +
</syntaxhighlight>
  
−
<syntaxhighlight lang="bash">sudo apt install git git-lfs</syntaxhighlight>
+
=== Verificando a configuração atual ===
−
<syntaxhighlight lang="bash">git config --global user.email "<email>"
+
 
 +
Caso queira conferir os valores configurados para o Git, utilize os comandos abaixo:
 +
 
 +
<syntaxhighlight lang="bash">
 +
git config --global user.email
 +
git config --global user.name
 +
</syntaxhighlight>
  
−
git config --global user.name "<nome>"</syntaxhighlight>
+
Esses comandos irão retornar o e-mail e nome atualmente definidos no seu ambiente.

Edição atual tal como às 14h40min de 17 de abril de 2025

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, 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 do 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 garante 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.

Disponível em “http://wiki.fahor.com.br/index.php?title=Instalação_do_Docker_no_WSL&oldid=22333”