Introdução
Neste laboratório, você aprenderá como usar efetivamente o comando docker search para encontrar imagens de contêiner no Docker Hub. Você começará realizando pesquisas básicas por imagens pelo nome.
A partir da pesquisa básica, você explorará opções para exibir as descrições completas, não truncadas, dos resultados da pesquisa. Além disso, você aprenderá como refinar suas pesquisas filtrando os resultados com base em critérios como o número de estrelas e o status oficial. Por fim, você descobrirá como limitar o número de resultados exibidos e formatar a saída da pesquisa usando um template Go para visualização personalizada.
Pesquisar imagens no Docker Hub por nome
Nesta etapa, você aprenderá como pesquisar imagens Docker no Docker Hub usando o comando docker search. O Docker Hub é um serviço de registro baseado em nuvem fornecido pela Docker que permite encontrar e compartilhar imagens de contêiner.
A sintaxe básica para o comando docker search é:
docker search [OPTIONS] TERM
Onde TERM é o termo de pesquisa que você deseja usar para encontrar imagens.
Vamos começar pesquisando imagens relacionadas a "ubuntu". Abra seu terminal no ambiente LabEx e execute o seguinte comando:
docker search ubuntu
Você deverá ver uma lista de imagens relacionadas ao Ubuntu. A saída normalmente inclui o nome da imagem, descrição, estrelas (número de curtidas), status oficial e status de build automatizado.
A saída pode ser semelhante a esta (a saída exata pode variar):
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
ubuntu Ubuntu is a Debian-based Linux operating sys... 15000 [OK]
ubuntu-upstart Upstart is an event-based replacement for th... 50 [OK]
ubuntu/apache2 Apache2 web server 60 [OK]
ubuntu/nginx Nginx web server 50 [OK]
...
Este comando pesquisa no Docker Hub por imagens cujos nomes ou descrições correspondem ao termo "ubuntu". Os resultados são exibidos em formato de tabela.
Exibir descrição não truncada dos resultados da pesquisa
Na etapa anterior, você pesquisou imagens Docker e viu que a coluna de descrição pode ser truncada, o que significa que a descrição completa não é exibida. Para ver a descrição completa, você pode usar a opção --no-trunc com o comando docker search.
Vamos pesquisar por "ubuntu" novamente, mas desta vez, usaremos a flag --no-trunc para exibir a descrição completa.
docker search --no-trunc ubuntu
Observe a saída. Agora você deve ver a descrição completa de cada imagem, sem nenhum truncamento. Isso é útil quando você precisa ler todos os detalhes sobre uma imagem antes de decidir usá-la.
A opção --no-trunc é útil para obter informações completas na saída de vários comandos Docker, não apenas docker search.
Filtrar resultados da pesquisa por estrelas e status oficial
Nesta etapa, você aprenderá como filtrar os resultados da pesquisa com base em critérios como o número de estrelas e se a imagem é oficial. Isso ajuda você a encontrar imagens mais relevantes e confiáveis.
Você pode usar a opção --filter para aplicar filtros à sua pesquisa. A opção --filter recebe um par chave=valor.
Para filtrar pelo número de estrelas, use a chave stars seguida pelo número mínimo de estrelas desejado. Por exemplo, para encontrar imagens Ubuntu com pelo menos 1000 estrelas, execute:
docker search --filter stars=1000 ubuntu
Observe a saída. Agora você deve ver apenas as imagens Ubuntu que têm 1000 ou mais estrelas.
Você também pode filtrar por imagens oficiais usando a chave is-official com o valor true. Imagens oficiais são mantidas pelo Docker ou pelos fornecedores originais de software e são geralmente consideradas mais confiáveis.
Para encontrar imagens Ubuntu oficiais, use o seguinte comando:
docker search --filter is-official=true ubuntu
A saída mostrará apenas as imagens Ubuntu oficiais.
Você pode combinar vários filtros usando a opção --filter várias vezes. Por exemplo, para encontrar imagens Ubuntu oficiais com pelo menos 1000 estrelas, você usaria:
docker search --filter is-official=true --filter stars=1000 ubuntu
Este comando restringirá os resultados para mostrar apenas as imagens Ubuntu oficiais que receberam pelo menos 1000 estrelas.
Limitar o número de resultados da pesquisa
Nesta etapa, você aprenderá como limitar o número de resultados da pesquisa exibidos pelo comando docker search. Isso é útil quando você está pesquisando um termo amplo e deseja ver apenas os principais resultados.
Você pode usar a opção --limit para especificar o número máximo de resultados a serem exibidos. A opção --limit recebe um valor inteiro.
Por exemplo, para pesquisar por "ubuntu" e limitar os resultados aos 5 primeiros, execute o seguinte comando:
docker search --limit 5 ubuntu
Observe a saída. Agora você deve ver no máximo 5 resultados para sua consulta de pesquisa.
Você pode combinar a opção --limit com outras opções como --filter e --no-trunc. Por exemplo, para encontrar as 3 principais imagens Ubuntu oficiais com pelo menos 1000 estrelas e exibir suas descrições completas, você usaria:
docker search --filter is-official=true --filter stars=1000 --limit 3 --no-trunc ubuntu
Este comando demonstra como você pode combinar diferentes opções para refinar sua pesquisa e controlar a saída.
Formatar a saída da pesquisa usando um template Go
Nesta etapa, você aprenderá como formatar a saída do comando docker search usando um template Go. Isso permite que você personalize as informações exibidas e sua apresentação.
A opção --format permite que você especifique um template Go para formatar a saída. Templates Go são poderosos e flexíveis para controlar a saída.
Vamos formatar a saída para exibir apenas o nome da imagem e o número de estrelas, separados por uma tabulação. O template ficará assim: {{.Name}}\t{{.Stars}}.
Execute o seguinte comando para pesquisar por "ubuntu" e formatar a saída:
docker search --format "{{.Name}}\t{{.Stars}}" ubuntu
Você deve ver uma lista onde cada linha contém o nome da imagem seguido por uma tabulação e o número de estrelas.
Vamos tentar um template um pouco mais complexo para exibir o nome, o status oficial e a descrição, cada um em uma nova linha. O template será Name: {{.Name}}\nOfficial: {{.IsOfficial}}\nDescription: {{.Description}}\n.
docker search --format "Name: {{.Name}}\nOfficial: {{.IsOfficial}}\nDescription: {{.Description}}\n" --limit 3 ubuntu
Este comando exibirá o nome, o status oficial e a descrição das 3 principais imagens Ubuntu, com cada informação em uma linha separada. Também incluímos a opção --limit 3 para manter a saída concisa.
Usar templates Go fornece uma maneira poderosa de extrair e apresentar as informações específicas que você precisa dos resultados de docker search.
Resumo
Neste laboratório, você aprendeu como usar o comando docker search para encontrar imagens Docker no Docker Hub. Você começou realizando uma pesquisa básica por imagens pelo nome, observando o formato de saída padrão, incluindo nome, descrição, estrelas, status oficial e status de build automatizado.
Em seguida, você explorou como exibir a descrição completa, não truncada, dos resultados da pesquisa usando a opção --no-trunc. Além disso, você aprendeu a refinar suas pesquisas filtrando os resultados com base no número de estrelas e no status oficial, e como limitar o número de resultados exibidos. Por fim, você descobriu como personalizar o formato de saída dos resultados da pesquisa usando um template Go.
