Como usar o comando docker version para verificar a versão do plugin do Docker Desktop

DockerBeginner
Pratique Agora

Introdução

Neste laboratório, você aprenderá como usar o comando docker version para verificar a versão do plugin CLI do Docker Desktop. Você começará executando o comando básico para ver a saída padrão, que fornece informações detalhadas da versão para vários componentes do Docker.

Em seguida, você explorará como formatar a saída do comando docker version como JSON, o que é útil para scripting e automação. Finalmente, você aprenderá como filtrar a saída para mostrar apenas o número da versão abreviada, demonstrando como extrair informações específicas da saída do comando.

Verificar a versão do plugin CLI do Docker Desktop

Nesta etapa, você aprenderá como verificar a versão do plugin CLI do Docker Desktop. Esta é uma operação fundamental para entender o ambiente com o qual você está trabalhando.

Primeiro, vamos usar o comando docker version. Este comando exibe informações da versão para o Docker e seus componentes.

docker version

Você deve ver uma saída semelhante a esta, mostrando vários componentes e suas versões:

Client: Docker Engine - Community
 Version:           20.10.21
 API version:       1.41
 Go version:        go1.16.15
 Git commit:        f362210
 Built:             Tue Dec 13 08:14:44 2022
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true

Server: Docker Engine - Community
 Engine:
  Version:          20.10.21
  API version:      1.41 (minimum version 1.12)
  Go version:       go1.16.15
  Git commit:       305620d
  Built:            Tue Dec 13 08:13:56 2022
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.6.10
  GitCommit:        b34a5c8cd550b1d5803ceac35179cc101f7da787
 runc:
  Version:          1.1.4
  GitCommit:        v1.1.4-0-g5fd4c4d
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

A saída fornece informações detalhadas sobre o cliente Docker e o servidor Docker (engine). O campo Version em Client indica a versão da Docker CLI que você está usando.

Formatar a saída como JSON

Na etapa anterior, você viu a saída padrão do comando docker version. Essa saída é legível por humanos, mas não é ideal para processamento programático. Os comandos Docker geralmente suportam a formatação da saída de diferentes maneiras, incluindo JSON.

Para formatar a saída de docker version como JSON, você pode usar a flag --format com o valor json.

docker version --format json

Após executar este comando, a saída será um objeto JSON contendo as mesmas informações da versão. Terá uma aparência semelhante a esta:

{
  "Client": {
    "Version": "20.10.21",
    "ApiVersion": "1.41",
    "GoVersion": "go1.16.15",
    "GitCommit": "f362210",
    "Built": "Tue Dec 13 08:14:44 2022",
    "Os": "linux",
    "Arch": "amd64",
    "Context": "default",
    "Experimental": true
  },
  "Server": {
    "Engine": {
      "Version": "20.10.21",
      "ApiVersion": "1.41",
      "MinimumApiVersion": "1.12",
      "GoVersion": "go1.16.15",
      "GitCommit": "305620d",
      "Built": "Tue Dec 13 08:13:56 2022",
      "Os": "linux",
      "Arch": "amd64",
      "Experimental": false
    },
    "Containerd": {
      "Version": "1.6.10",
      "GitCommit": "b34a5c8cd550b1d5803ceac35179cc101f7da787"
    },
    "Runc": {
      "Version": "1.1.4",
      "GitCommit": "v1.1.4-0-g5fd4c4d"
    },
    "DockerInit": {
      "Version": "0.19.0",
      "GitCommit": "de40ad0"
    }
  }
}

Esta saída JSON é dados estruturados que podem ser facilmente analisados por outras ferramentas ou scripts, tornando-a útil para automação e integração.

Mostrar apenas o número da versão abreviada

Nas etapas anteriores, você aprendeu como obter as informações completas da versão do Docker e formatá-las como JSON. Às vezes, você só precisa do número da versão abreviada para scripting ou verificações rápidas.

Para obter apenas o número da versão abreviada do cliente Docker, você pode usar a flag --version.

docker --version

Este comando exibirá apenas a string da versão, assim:

Docker version 20.10.21, build f362210

Esta saída é concisa e fornece diretamente as informações da versão sem os detalhes adicionais mostrados por docker version. Isso é particularmente útil quando você precisa verificar rapidamente a versão do Docker instalada em um script ou na linha de comando.

Resumo

Neste laboratório, você aprendeu como verificar a versão do plugin CLI do Docker Desktop usando o comando docker version. Este comando fornece informações detalhadas sobre os componentes cliente e servidor do Docker, incluindo suas versões. Você também explorou como formatar a saída do comando docker version como JSON usando a flag --format json, o que é útil para processamento programático.