Começar a usar a CLI Checks

A CLI Checks traz a funcionalidade de verificações para seu fluxo de trabalho de desenvolvimento. É possível executar a CLI localmente, no seu pipeline de CI/CD ou por outros tipos de scripts e automação.

Para configurar e usar a CLI Checks, siga estas etapas:

  1. Instalar a CLI Checks
  2. Autenticar sua máquina
  3. Integre e use a CLI Checks executando comandos na linha de comando ou integrando a CLI Checks ao seu ambiente de CI/CD.

Configurar a CLI Checks

É possível instalar ou atualizar a CLI Checks usando os executáveis independentes nas tabelas para Linux ou macOS.

Depois de instalar a CLI Checks, é preciso fazer a autenticação. Em seguida, comece a testar e corrigir suas vulnerabilidades, começando pela instalação.

Instalar com executáveis independentes

O Checks fornece links para download de executáveis independentes da versão mais recente e de versões específicas. Por exemplo, os links a seguir são para macOS e Linux:

Por exemplo, para fazer o download e executar a CLI Checks mais recente no macOS, execute:

curl --compressed https://dl.google.com/checks/cli/latest/checks-macos -o checks
chmod +x ./checks
mv ./checks /usr/local/bin/
  1. Verifique se você instalou o gerenciador de pacotes e as ferramentas de terceiros necessárias.
  2. Faça o download do binário da CLI Checks para sua plataforma:

Linux

Plataforma

Pacote

Tamanho

Soma de verificação SHA256

Linux

checks-linux

35,1 MB

cc12317c0d5b0a2edfe8d5bf28a3a0739d5bd469ccd771772bf65129ae97c94f

Execute chmod +x ./checks para tornar o binário executável. (Opcional) Mova o binário para um local onde ele possa ser executado globalmente: mv ./checks /usr/local/bin/

macOS

Plataforma

Pacote

Tamanho

Soma de verificação SHA256

macOS

checks-macos

29,4 MB

a82699336aaf0f6b0a9502c293c84be45459d79d348a74eae3bbaaf89d1daa33

Execute chmod +x ./checks para tornar o binário executável. Opcional: mova o binário para um local em que ele possa ser executado globalmente: mv ./checks /usr/local/bin/

Windows

Plataforma

Pacote

Tamanho

Soma de verificação SHA256

Windows 8.1 e versões mais recentes e Windows Server 2012 e versões mais recentes

checks-win.exe

29,5 MB

7ca465e28ffec9a7e16bc71e01bbaf9629c95d517e5846a31280a49af400d3c7

(Opcional) Renomeie o arquivo para checks.exe para poder executar comandos de verificação conforme documentado, por exemplo, checks help.

Atualizar para a versão mais recente da CLI

Para garantir que você está recebendo os recursos e correções de bugs mais recentes, recomendamos que verifique com frequência se há atualizações da CLI.

Faça o download da nova versão nas tabelas anteriores e substitua a versão anterior no seu sistema.

Testar a instalação

Depois de fazer a autenticação, teste a instalação. Para um teste rápido, execute checks --help.

Informações adicionais

Execute checks --help ou consulte o resumo de comandos e opções da CLI.

Como receber suporte

Envie um e-mail para checks-support@google.com sempre que precisar de ajuda com a CLI Checks ou com o Checks em geral.

Autenticar a CLI

Depois de instalar a CLI, faça login em uma Conta do Google. Para autorizar o acesso da CLI Checks ao Checks, use uma conta de serviço ou de usuário.

Uma conta de serviço é uma conta do Google Cloud associada ao seu projeto do Google Cloud e não a um usuário específico. As contas de serviço são úteis para configurar verificações em um ambiente de CI.

Uma conta de usuário é uma Conta do Google que tem acesso à sua conta do Checks. Essa é a melhor opção para usar a CLI Checks na linha de comando.

Autenticar com uma conta de serviço

  1. Abra o console do Google Cloud e selecione seu projeto.
  2. Na biblioteca de APIs, ative a API Checks.
  3. Crie uma conta de serviço para seu projeto acessando a página Contas de serviço do IAM no console do Google Cloud. Clique em Criar conta de serviço e insira os detalhes da conta de serviço.
    1. Crie uma chave JSON privada para a conta de serviço recém-criada e mova a chave para um local acessível ao seu ambiente de build. Mantenha esse arquivo em algum lugar seguro, porque ele concede acesso de administrador aos Checks.
    2. Defina a variável de ambiente CHECKS_CREDENTIALS como o caminho do arquivo JSON da chave privada ao usar a CLI. Se você estiver usando um plug-in de CI/CD do Checks, consulte a documentação dele para saber como fornecer as credenciais.
  4. Para conceder acesso à conta de serviço, adicione o endereço de e-mail e atribua a função Proprietário na página "Configurações do console do Checks". Para mais informações sobre como convidar usuários para sua conta do Checks, consulte Gerenciar o acesso da equipe.

Autenticar com uma conta de usuário

Importante:se você estiver se conectando por SSH, encaminhe a porta 9005.

  1. Faça login na CLI Checks usando sua Conta do Google com o seguinte comando: checks login

    Esse comando conecta sua máquina local ao Checks e concede acesso às suas contas.

    • Use checks login --reauth se você já fez login, mas quer mudar para outra Conta do Google.
    • Use checks logout para sair.

  2. Abra o URL de autenticação gerado no navegador.

  3. Faça login na sua Conta do Google.

  4. Autorize o Checks a acessar sua conta do serviço.