Risoluzione dei problemi

Questa pagina mostra come risolvere i problemi relativi a Secure Source Manager.

Messaggio di errore durante la creazione di un repository

Quando tenti di creare un repository, viene visualizzato il seguente errore:

There was an error while loading /repo/create. Try refreshing the page.

Questo problema si verifica quando:

• L'API Secure Source Manager non è abilitata nel tuo progetto.
• Non disponi del ruolo di Amministratore repository nel tuo progetto o delle autorizzazioni per creare repository nell'istanza Secure Source Manager.

Per risolvere il problema:

• Abilita l'API Secure Source Manager nel tuo progetto.
• Chiedi al tuo amministratore di concederti i seguenti ruoli:
  • Ruolo Amministratore repository (roles/securesourcemanager.repoAdmin) nel progetto.
  • Funzione di accesso alle istanze (roles/securesourcemanager.instanceAccessor) nell'istanza Secure Source Manager.
  • Creatore repository di istanze (roles/securesourcemanager.instanceRepositoryCreator) nell'istanza Secure Source Manager.

Per ulteriori dettagli, consulta la pagina Controllo dell'accesso con IAM.

Messaggio di errore durante la clonazione di un repository su un Mac

Quando tenti di clonare un repository, viene visualizzato il seguente errore:

git: 'credential-gcloud.sh' is not a git command.  See 'git --help'.
fatal: Authentication failed for [repo-url]

Questo problema si verifica quando:

• gcloud CLI è installata utilizzando Homebrew o un'altra installazione non standard.
• git-credential-gcloud.sh non è aggiunto al tuo PATH.

Per risolvere il problema:

• Esegui source $HOMEBREW_PREFIX/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/path.zsh.inc

• Controlla che git-credential-gcloud.sh sia nel percorso eseguendo questo comando:

  which git-credential-gcloud.sh
  

Le richieste HTTPS Git non riescono a causa di un errore di autorizzazione negata o non autorizzata

Quando vengono tentati comandi Git tramite HTTPS, viene visualizzato un messaggio di errore di autorizzazione negata o non autorizzata.

Questo problema si verifica quando si verifica una delle seguenti condizioni:

• Nel file di configurazione Git globale manca l'helper di autenticazione di Secure Source Manager.
• Viene utilizzato l'archivio delle credenziali integrato di Git anziché chiamare l'helper di autenticazione di Secure Source Manager per ottenere una nuova credenziale.
• Viene utilizzato un helper delle credenziali di sistema anziché chiamare l'helper di autenticazione di Secure Source Manager per ottenere una nuova credenziale.
• Quando interagisci con i repository Secure Source Manager utilizzando HTTPS, viene utilizzata una versione precedente di Google Cloud CLI. Secure Source Manager richiede Google Cloud CLI versione 395.0.0 o successive.

Per risolvere il problema:

1. Esegui questo comando per determinare i contenuti del file Git config globale.

   git config --list | grep credential
   

2. Se vedi una riga simile a *credential*.helper=store su macOS o credential.helper = manager su Windows, rimuovila e autenticati di nuovo utilizzando gcloud auth login prima di riprovare a eseguire il comando Git.

3. Se la risposta non include credential.https://*.*.sourcemanager.dev.helper=gcloud.sh su macOS o Linux oppure credential.https://*.*.sourcemanager.dev.helper=gcloud.cmd su Windows, aggiungi l'helper di autenticazione di Secure Source Manager alla configurazione Git globale:

   Linux

   1. Per aggiungere l'helper di autenticazione di Secure Source Manager alla configurazione Git globale, esegui questo comando:

      git config --global credential.'https://*.*.sourcemanager.dev'.helper gcloud.sh
      

   2. Verifica che la riga dell'helper di autenticazione sia stata aggiunta alla configurazione Git globale eseguendo questo comando:

      git config --list | grep credential
      

      L'output dovrebbe includere credential.https://*.*.sourcemanager.dev.helper=gcloud.sh.

   3. Esegui l'autenticazione eseguendo gcloud auth login.

   4. Esegui un comando Git per testare l'autenticazione.

   Windows

   1. Controlla la versione di gcloud CLI seguendo le istruzioni per installare Git e Google Cloud CLI.

   2. Per aggiungere l'helper di autenticazione di Secure Source Manager alla configurazione Git globale, esegui questo comando:

      git config --global credential.https://*.*.sourcemanager.dev.helper gcloud.cmd
      

   3. Verifica che la riga dell'helper di autenticazione sia stata aggiunta alla configurazione Git globale eseguendo questo comando:

      git config --list | grep credential
      

      L'output dovrebbe includere credential.https://*.*.sourcemanager.dev.helper=gcloud.cmd.

   4. Esegui l'autenticazione eseguendo gcloud auth login.

   5. Esegui un comando Git per testare l'autenticazione.

Le richieste HTTPS Git non vanno a buon fine con un token non valido

Per le operazioni HTTPS di Git è necessario un token OAuth valido come password. Questa operazione viene normalmente gestita da Git credential helper, ma può funzionare anche con i token OAuth generati utilizzando altri approcci (ad esempio, le credenziali predefinite dell'applicazione).

Se una richiesta Git viene rifiutata a causa di un token non valido, in genere significa che non è stato possibile estrarre le informazioni dell'utente dal token in entrata. Esistono diverse cause possibili di questo errore:

• Il tuo accesso a gcloud CLI potrebbe essere scaduto

  Accedi di nuovo utilizzando gcloud auth login.

• Il token non ha un ambito sufficiente. I token OAuth devono avere i seguenti ambiti:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/userinfo.email

  Puoi controllare l'ambito del token chiamando curl https://oauth2.googleapis.com/tokeninfo?access_token=${TOKEN}

• Stai utilizzando un token generato da Workload Identity del parco risorse GKE:

  • I token non elaborati generati da Workload Identity della flotta GKE non sono supportati. In alternativa, puoi associare il workload a un service account Google.

• Hai criteri dell'organizzazione che impediscono l'utilizzo di token al di fuori di determinati perimetri, ad esempio l'accesso sensibile al contesto:

  Secure Source Manager non supporta in modo nativo l'Accesso sensibile al contesto. Contatta l'assistenza per i passaggi successivi.

Il progetto non viene visualizzato nel selettore dei prodotti dell'interfaccia web

Quando utilizzi il selettore di prodotti dell'interfaccia web di Secure Source Manager, il tuo progetto non viene visualizzato.

Questo problema si verifica quando hai più credenziali di accesso per Secure Source Manager.

Per risolvere il problema:

• Cancella i cookie aggiungendo quanto segue all'URL dell'istanza Secure Source Manager: /_oauth/consent

  Ad esempio, se l'URL dell'istanza è https://my-instance-098765432123.us-central1.sourcemanager.dev/, inserisci https://my-instance-098765432123.us-central1.sourcemanager.dev/_oauth/consent nella barra degli indirizzi del browser e poi accedi con le credenziali corrette.

Il file dei trigger non attiva le build

Se le build non vengono attivate come previsto dopo l'invio del file dei trigger, potresti riscontrare uno dei seguenti problemi:

• Il file dei trigger non si trova nel ramo predefinito. Per risolvere il problema, sposta il file dei trigger nel branch predefinito.
• Il formato del file dei trigger non è valido. Questo errore è indicato da un banner nella pagina del repository con il messaggio Build triggers configuration error: .... Per risolvere il problema, leggi lo schema del file dei trigger. Quando la configurazione del file dei trigger è corretta, il banner nella pagina del repository indica Valid build triggers configuration.

Errore di configurazione dei trigger di build

Dopo aver inviato il file triggers.yaml al repository Secure Source Manager, nel banner viene visualizzato il seguente errore:

Build cannot be created.

Questo problema si verifica per i seguenti motivi:

• Il file di configurazione di Cloud Build contiene opzioni non valide.
• Il formato del file di configurazione di Cloud Build non è valido.
• Il account di servizio Secure Source Manager non dispone delle autorizzazioni necessarie per utilizzare ilaccount di serviziot Cloud Build specificato dall'utente.

Per risolvere questo problema:

• Assicurati di seguire lo schema del file dei trigger corretto.
• Assicurati che il account di servizio Secure Source Manager e ilaccount di serviziot Cloud Build dispongano delle autorizzazioni necessarie. Per visualizzare le autorizzazioni richieste, consulta Ruoli account di servizio richiesti.

La build non riesce durante l'esecuzione

Se una build viene attivata correttamente, ma non riesce durante l'esecuzione, il commit associato ha lo stato di commit Errore.

Per risolvere i problemi relativi a una build non riuscita, nella pagina del repository, accanto allo stato del commit non riuscito, fai clic su Dettagli.

Si apre il log di esecuzione di Cloud Build. Per saperne di più sulla risoluzione dei problemi delle build in Cloud Build, consulta Risoluzione degli errori di build.