Como verificar o status de login do Docker usando o comando info

Introdução

Docker é uma plataforma de containerização poderosa que permite empacotar e executar aplicações em ambientes isolados. Ao trabalhar com Docker, você frequentemente precisa interagir com registros de containers, que exigem autenticação. Conhecer o seu status de login atual é essencial para gerenciar seu fluxo de trabalho Docker de forma eficiente.

Neste laboratório, você aprenderá como verificar seu status de login do Docker usando o comando docker info. Esta habilidade é fundamental para usuários do Docker, pois ajuda a garantir que você tenha o acesso adequado para puxar (pull) e enviar (push) imagens de registros privados.

Verificar a Instalação do Docker

Antes de verificarmos o status de login, vamos primeiro verificar se o Docker está corretamente instalado e em execução em nosso sistema. Esta etapa garante que temos um ambiente Docker funcional para as operações subsequentes.

Verificando o Status do Docker

Abra um terminal no ambiente LabEx. Você pode fazer isso clicando no ícone do terminal no ambiente de desktop.

Assim que o terminal estiver aberto, execute o seguinte comando para verificar se o Docker está instalado e em execução:

docker --version

Este comando deve exibir a versão do Docker instalada em seu sistema. Você deve ver uma saída semelhante a esta:

Docker version 20.10.21, build 20.10.21-0ubuntu1~22.04.3

Em seguida, vamos verificar se o daemon do Docker está funcionando corretamente. Execute o seguinte comando:

docker run hello-world

Se o Docker estiver funcionando corretamente, ele fará o download de uma imagem de teste e a executará em um container. Você deve ver uma saída que inclui:

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

Isso confirma que o Docker está corretamente instalado e em execução em seu sistema. Se você encontrar algum erro, verifique se o serviço Docker está em execução com:

sudo systemctl status docker

A saída deve mostrar que o serviço Docker está ativo (em execução).

Agora que confirmamos que o Docker está funcionando corretamente, podemos prosseguir para aprender sobre o comando docker info na próxima etapa.

Entendendo o Comando Docker Info

Nesta etapa, exploraremos o comando docker info e entenderemos como ele fornece informações valiosas sobre seu ambiente Docker.

Executando o Comando Docker Info

O comando docker info fornece uma visão geral abrangente da sua instalação do Docker. Ele exibe informações em todo o sistema, como o número de containers e imagens, a versão do servidor, o driver de armazenamento e muito mais.

Vamos executar o comando docker info no terminal:

docker info

Você deve ver uma saída detalhada com várias seções. A saída será semelhante a esta:

Client:
 Context:    default
 Debug Mode: false
 Plugins:
  buildx: Docker Buildx (Docker Inc.)
    Version:  v0.9.1
    Path:     /usr/libexec/docker/cli-plugins/docker-buildx
  ...

Server:
 Containers: 1
  Running: 0
  Paused: 0
  Stopped: 1
 Images: 1
 Server Version: 20.10.21
 Storage Driver: overlay2
  Backing Filesystem: extfs
  Supports d_type: true
  Native Overlay Diff: true
  userxattr: false
 ...

 Registry: https://index.docker.io/v1/
 ...

A saída contém várias seções com informações sobre o cliente Docker e o servidor Docker.

Seções Chave na Saída do Docker Info

Vamos entender algumas seções-chave da saída do docker info:

1. Client: Informações sobre a configuração do cliente Docker.
2. Server: Informações sobre o servidor Docker (daemon).
3. Containers: O número de containers em seu sistema, incluindo containers em execução, pausados e parados.
4. Images: O número de imagens Docker em seu sistema.
5. Server Version: A versão do servidor Docker.
6. Storage Driver: O driver de armazenamento usado pelo Docker.
7. Registry: Informações sobre os registros Docker configurados.

Para verificar o status de login, estamos particularmente interessados na seção Registry, que exploraremos na próxima etapa.

Verificando o Status de Login do Docker

Agora que entendemos o comando docker info, vamos nos concentrar em como usá-lo para verificar nosso status de login do Docker.

Interpretando o Status de Login no Docker Info

Quando você executa o comando docker info, a saída contém informações sobre o seu status de login no Docker Hub. Especificamente, você deve procurar a seção Registry.

Execute o comando novamente:

docker info

Agora, procure a seção Registry na saída.

Se você não estiver logado em nenhum registro Docker, a saída simplesmente mostrará a URL do registro padrão:

Registry: https://index.docker.io/v1/

Se você estiver logado, verá informações adicionais, incluindo seu nome de usuário:

Registry: https://index.docker.io/v1/
Username: yourusername

Atualmente, é muito provável que você não esteja logado no Docker Hub ou em qualquer outro registro.

Logando no Docker Hub

Vamos tentar logar no Docker Hub para ver como as informações de status de login mudam. Para logar no Docker Hub, use o comando docker login:

docker login

Este comando solicitará seu nome de usuário e senha do Docker Hub:

Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, head over to https://hub.docker.com to create one.
Username:
Password:

Para fins deste laboratório, você não precisa inserir credenciais reais. Em vez disso, pressione Ctrl+C para cancelar o processo de login.

Método Alternativo para Verificar o Status de Login

Além de usar o comando docker info, você também pode verificar se está logado no Docker Hub examinando o arquivo de configuração do Docker:

ls -la ~/.docker/

Se você estiver logado, deverá ver um arquivo chamado config.json neste diretório. Este arquivo contém suas informações de autenticação. Você pode visualizar seu conteúdo com:

cat ~/.docker/config.json

Se você não estiver logado, o arquivo pode não existir ou pode não conter informações de autenticação.

Desconectando do Registro Docker

Agora que entendemos como verificar o status de login e tentar logar, vamos aprender como desconectar de um registro Docker.

Usando o Comando Docker Logout

Para desconectar de um registro Docker, você pode usar o comando docker logout. Este comando remove as credenciais armazenadas para o registro especificado, ou o registro padrão se nenhum for especificado.

Execute o seguinte comando:

docker logout

Se você não estava logado, verá uma mensagem como:

Not logged in to https://index.docker.io/v1/

Se você estava logado e o logout foi bem-sucedido, você verá:

Removing login credentials for https://index.docker.io/v1/

Verificando o Status de Logout

Após desconectar, vamos verificar nosso status de login usando o comando docker info:

docker info

Procure a seção Registry novamente. Ela agora deve mostrar apenas a URL do registro sem nenhuma informação de nome de usuário:

Registry: https://index.docker.io/v1/

Você também pode verificar o arquivo de configuração do Docker novamente:

cat ~/.docker/config.json

Se você estava logado anteriormente, o arquivo teria sido atualizado para remover as informações de autenticação do registro do qual você se desconectou.

Entendendo a Autenticação do Registro Docker

O Docker usa autenticação baseada em token para gerenciar o acesso aos registros. Quando você faz login em um registro, o Docker armazena o token de autenticação no arquivo de configuração (~/.docker/config.json). Este token é usado para interações subsequentes com o registro até que você se desconecte ou o token expire.

Entender como verificar seu status de login e gerenciar sua autenticação é essencial para operações Docker seguras, especialmente ao trabalhar com registros privados.

Resumo

Neste laboratório, você aprendeu habilidades essenciais para gerenciar a autenticação do registro Docker:

1. Verificando se o Docker está corretamente instalado e em execução
2. Usando o comando docker info para visualizar informações detalhadas sobre seu ambiente Docker
3. Verificando seu status de login do Docker usando o comando docker info
4. Compreendendo o processo de login no Docker Hub
5. Desconectando de um registro Docker e verificando se o logout foi bem-sucedido

Essas habilidades são fundamentais para trabalhar com o Docker, especialmente quando você precisa interagir com registros privados ou proteger suas credenciais de autenticação.

Agora você tem o conhecimento para gerenciar com confiança seu status de login do Docker, garantindo operações Docker seguras e eficientes em seus projetos futuros.