Introdução
Neste laboratório, você aprenderá como usar o comando docker scout integration list para visualizar as integrações do Docker Scout configuradas para sua organização. O Docker Scout ajuda você a entender e melhorar a postura de segurança de suas imagens de contêiner, e as integrações permitem que ele se conecte a outros serviços.
Primeiro, você aprenderá como listar todas as integrações configuradas, depois como listar os detalhes de configuração para uma integração específica por nome usando o comando docker scout integration inspect, e finalmente como listar integrações para uma organização diferente. Este laboratório irá guiá-lo pelos comandos necessários e demonstrar a saída esperada.
Listar todas as integrações do Docker Scout configuradas para sua organização
Nesta etapa, você aprenderá como listar todas as integrações do Docker Scout configuradas para sua organização. O Docker Scout ajuda você a entender e melhorar a postura de segurança de suas imagens de contêiner. As integrações permitem que o Docker Scout se conecte a outros serviços para reunir informações sobre suas imagens.
Para listar as integrações, você usará o comando docker scout integration list. Este comando exige que você esteja logado no Docker Hub.
Primeiro, vamos garantir que você está logado no Docker Hub. Se você ainda não estiver logado, pode usar o comando docker login.
docker login
Você será solicitado a inserir seu Docker ID e senha. Insira suas credenciais para fazer login.
Depois de fazer login, você pode listar as integrações configuradas usando o seguinte comando:
docker scout integration list
Este comando exibirá uma lista de todas as integrações do Docker Scout configuradas para sua organização. A saída normalmente incluirá o nome da integração, o tipo de integração e seu status.
Por exemplo, a saída pode ser semelhante a esta:
NAME TYPE STATUS
my-github github configured
my-gitlab gitlab configured
Esta saída indica que você tem duas integrações configuradas: uma chamada my-github do tipo github e outra chamada my-gitlab do tipo gitlab. Ambas estão no status configured.
Listar a configuração de uma integração específica do Docker Scout por nome
Nesta etapa, você aprenderá como listar os detalhes de configuração para uma integração específica do Docker Scout por seu nome. Isso é útil quando você deseja ver as configurações específicas para uma integração em particular que você configurou.
Para listar a configuração de uma integração específica, você usará o comando docker scout integration inspect seguido pelo nome da integração.
Vamos supor que você tenha uma integração chamada my-github, como mostrado na etapa anterior. Para inspecionar sua configuração, você usaria o seguinte comando:
docker scout integration inspect my-github
Este comando exibirá informações detalhadas sobre a integração my-github. A saída estará em formato YAML e incluirá vários parâmetros de configuração, dependendo do tipo de integração.
Por exemplo, a saída para uma integração do GitHub pode incluir detalhes como o repositório do GitHub ao qual está conectado, as branches que estão sendo monitoradas e outras configurações relevantes.
name: my-github
type: github
status: configured
config:
repository: your-github-org/your-repo
branches:
- main
- develop
## Other configuration details...
Se você tentar inspecionar uma integração que não existe, o comando retornará um erro indicando que a integração não foi encontrada.
Lembre-se de substituir my-github pelo nome real da integração que você deseja inspecionar. Você pode obter os nomes de suas integrações executando o comando docker scout integration list da etapa anterior.
Listar integrações do Docker Scout configuradas para uma organização diferente
Nesta etapa, você aprenderá como listar as integrações do Docker Scout configuradas para uma organização diferente da qual você é membro. Por padrão, os comandos do Docker Scout operam em sua organização atual. No entanto, você pode especificar uma organização diferente usando a flag --org.
Isso é útil se você gerencia integrações para várias organizações dentro do Docker Hub e precisa visualizá-las ou gerenciá-las sem alternar sua organização principal.
Para listar as integrações de uma organização diferente, você usará o comando docker scout integration list com a flag --org seguida pelo nome da organização.
Vamos supor que você seja membro de outra organização chamada another-org. Para listar as integrações configuradas para another-org, você usaria o seguinte comando:
docker scout integration list --org another-org
Substitua another-org pelo nome real da organização que você deseja inspecionar.
Este comando exibirá uma lista de todas as integrações do Docker Scout configuradas para a organização especificada, semelhante à saída que você viu na Etapa 1, mas mostrando as integrações para another-org.
NAME TYPE STATUS
another-int github configured
Se a organização especificada não existir ou você não tiver permissão para acessá-la, o comando retornará um erro.
Isso demonstra como você pode gerenciar as integrações do Docker Scout em diferentes organizações com as quais você está associado usando a flag --org.
Resumo
Neste laboratório, você aprendeu como usar o comando docker scout integration list para visualizar as integrações do Docker Scout configuradas para sua organização. Você praticou a listagem de todas as integrações e a inspeção de uma integração específica por nome. Você também aprendeu como listar integrações para uma organização diferente. Esses comandos são essenciais para gerenciar e entender as integrações que aprimoram os recursos de análise de segurança do Docker Scout.
