Inizia a utilizzare l'interfaccia a riga di comando di Checks

L'interfaccia a riga di comando di Checks introduce la funzionalità di Checks nel flusso di lavoro di sviluppo. Puoi eseguire l'interfaccia a riga di comando in locale, nella tua pipeline CI/CD o tramite altri tipi di script e automazione.

La configurazione e l'utilizzo dell'interfaccia a riga di comando Checks richiede i seguenti passaggi:

  1. Installa l'interfaccia a riga di comando Checks
  2. Autentica la macchina
  3. Integra e utilizza l'interfaccia a riga di comando di Checks eseguendo i comandi dalla riga di comando o integrando l'interfaccia a riga di comando di Checks nel tuo ambiente CI/CD.

Configura l'interfaccia a riga di comando Checks

Puoi installare o aggiornare l'interfaccia a riga di comando di Checks utilizzando gli eseguibili autonomi nelle tabelle per Linux o macOS.

Dopo aver installato l'interfaccia a riga di comando Checks, devi eseguire l'autenticazione. Dopodiché puoi iniziare a testare e correggere le vulnerabilità, iniziando con il test dell'installazione.

Installazione con file eseguibili autonomi

Checks fornisce link di download eseguibili autonomi per la release più recente e per versioni specifiche. I seguenti link, ad esempio, sono per macOS e Linux:

Ad esempio, per scaricare ed eseguire l'ultima interfaccia a riga di comando di Checks su macOS, esegui:

curl --compressed https://dl.google.com/checks/cli/latest/checks-macos -o checks
chmod +x ./checks
mv ./checks /usr/local/bin/
  1. Assicurati di aver installato il gestore di pacchetti e tutti gli strumenti di terze parti richiesti.
  2. Scarica il programma binario dell'interfaccia a riga di comando di Checks per la tua piattaforma:

Linux

Piattaforma

Pacchetto

Dimensioni

Checksum SHA256

Linux

checks-linux

23,6 MB

81f75ffb52ca1a1184badadfc5ef35f55888e75652e8dab6cd02d237ecd36c1c

Rendi eseguibile il programma binario eseguendo chmod +x ./checks. (Facoltativo) Sposta il programma binario in una località in cui sia possibile eseguirlo a livello globale: mv ./checks /usr/local/bin/

macOS

Piattaforma

Pacchetto

Dimensioni

Checksum SHA256

macOS

checks-macos

18,9 MB

10b8b16799c172b38a95fba8236b82d55e82c955a0627fc747354c7587ccda96

Rendi eseguibile il programma binario eseguendo chmod +x ./checks (facoltativo). Sposta il programma binario in una posizione in cui sia possibile eseguirlo a livello globale: mv ./checks /usr/local/bin/

Windows

Piattaforma

Pacchetto

Dimensioni

Checksum SHA256

Windows 8.1 e versioni successive e Windows Server 2012 e versioni successive

checks-win.exe

18,8 MB

eb201c9f82aa1dc0ed597d76bfc7480ecedea249ef1fbcca7a5b73bcdcbfdad9

(Facoltativo) Rinomina il file in checks.exe in modo da poter eseguire i comandi di controllo come documentato, ad esempio checks help.

Aggiorna all'ultima versione dell'interfaccia a riga di comando

Per assicurarti di ricevere le funzionalità e le correzioni di bug più recenti, ti consigliamo di controllare spesso la disponibilità di aggiornamenti dell'interfaccia a riga di comando.

Puoi scaricare la nuova versione dalle tabelle precedenti e quindi sostituire la versione precedente nel sistema.

Testa l'installazione

Dopo l'autenticazione, puoi testare l'installazione. Per un rapido test, esegui checks --help.

Informazioni aggiuntive

Esegui checks --help o consulta il riepilogo dei comandi e delle opzioni dell'interfaccia a riga di comando.

Richiedere assistenza

Invia un'email all'indirizzo contacts-support@google.com ogni volta che hai bisogno di aiuto con l'interfaccia a riga di comando di Checks o Checks in generale.

Autenticazione dell'interfaccia a riga di comando

Dopo aver installato l'interfaccia a riga di comando, devi accedere a un Account Google. Per autorizzare l'accesso dell'interfaccia a riga di comando di Checks a Checks, utilizza un account di servizio o un account utente.

Un account di servizio è un account Google Cloud associato al tuo progetto Google Cloud e non a un utente specifico. Gli account di servizio sono utili per configurare Controlli in un ambiente CI.

Un account utente è un Account Google che ha accesso al tuo account Checks. Questa è l'opzione migliore per utilizzare l'interfaccia a riga di comando Checks dalla riga di comando.

Autenticazione con un account di servizio

  1. Apri la console Google Cloud e seleziona il tuo progetto.
  2. Nella libreria API, abilita l'API Checks.
  3. Per creare un account di servizio per il tuo progetto, accedi alla pagina Account di servizio IAM nella console Google Cloud. Fai clic su Crea account di servizio e inserisci i dettagli dell'account di servizio.
    1. Crea una chiave JSON privata per l'account di servizio appena creato e spostala in una posizione accessibile all'ambiente di build. Assicurati di conservare questo file in un luogo sicuro, perché concede l'accesso amministrativo a Checks.
    2. Imposta la variabile di ambiente CHECKS_CREDENTIALS sul percorso del file JSON della chiave privata.

Autenticazione con un account utente

Importante:se ti connetti tramite SSH, inoltra la porta 9005.

  1. Accedi a Firebase utilizzando il tuo Account Google con il seguente comando: checks login

    Questo comando connette la tua macchina locale a Checks e ti concede l'accesso ai tuoi account Checks.

    • Utilizza checks login --reauth se hai già eseguito l'accesso, ma vuoi passare a un altro Account Google.
    • Usa checks logout per uscire.

  2. Apri l'URL di autenticazione generato nel browser.

  3. Accedi al tuo Account Google.

  4. Concedi il consenso a Checks per accedere al tuo account Checks.