Mudanças entre as edições de "Instalação do Docker no WSL"
Ir para navegação
Ir para pesquisar
| (6 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 | + | 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 | + | == 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 === | |
| − | <syntaxhighlight lang="bash"> sudo apt install --no-install-recommends apt-transport-https ca-certificates curl gnupg2 lsb-release -y </syntaxhighlight> | + | Instale os pacotes essenciais para que o `apt` possa se comunicar com repositórios HTTPS e manipular chaves GPG. |
| − | === Adicionando o repositório oficial | + | |
| + | <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=== | ||
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> | ||
| + | |||
| + | 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 === | ||
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 sudo apt upgrade -y sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y </syntaxhighlight> | + | <syntaxhighlight lang="bash"> |
| + | sudo apt update | ||
| + | sudo apt upgrade -y | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | <syntaxhighlight lang="bash"> | ||
| + | sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y | ||
| + | </syntaxhighlight> | ||
| + | |||
=== Iniciando o serviço e configurando permissões === | === Iniciando o serviço e configurando permissões === | ||
| − | Inicie o serviço do Docker e permita o uso do socket sem precisar de sudo: | + | Inicie o serviço do Docker e permita o uso do socket sem precisar de `sudo`: |
| + | |||
| + | <syntaxhighlight lang="bash"> | ||
| + | service docker start | ||
| + | chmod 666 /var/run/docker.sock | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | 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"> | + | <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 == | ||
| + | |||
| + | 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: | ||
| + | |||
| + | <syntaxhighlight lang="bash"> | ||
| + | sudo apt install git git-lfs | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | Configure seu nome e e-mail, que serão usados em cada commit realizado: | ||
| + | |||
| + | <syntaxhighlight lang="bash"> | ||
| + | git config --global user.email "<seu-email@exemplo.com>" | ||
| + | git config --global user.name "<Seu Nome>" | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | === Verificando a configuração atual === | ||
| − | + | 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> | ||
| − | + | 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.