Utilizzare la gestione del codice sorgente Git

Secure Source Manager supporta tutti i comandi client Git SCM e dispone di richieste di pull e monitoraggio dei problemi integrati. Sono supportati sia HTTPS sia l'autenticazione SSH.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare Git per interagire con un repository Secure Source Manager, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per informazioni sulla concessione dei ruoli Secure Source Manager, consulta Controllo dell'accesso con IAM e Concedere agli utenti l'accesso all'istanza.

Installa Git e Google Cloud CLI

  1. Installa Git.

  2. Se il programma di installazione di Git ti chiede di Scegliere un helper delle credenziali, seleziona Nessuno (non utilizzare un helper delle credenziali).

  3. Installa gcloud CLI.

  4. Per utilizzare Git con HTTPS è necessaria la versione 395.0.0 o successive di gcloud CLI. Per controllare la versione di gcloud CLI, esegui il seguente comando:

    gcloud --version

  5. Per aggiornare gcloud CLI, esegui il comando seguente.

    gcloud components update

  6. Dopo l'aggiornamento, esegui gcloud init per inizializzare gcloud CLI.

    Per ulteriori informazioni, consulta la documentazione dell'interfaccia a riga di comando gcloud CLI sull'aggiornamento dei componenti.

Configurare le credenziali

Se esegui l'autenticazione a Secure Source Manager utilizzando un provider di identità di terze parti e la federazione delle identità per la forza lavoro, non devi completare questa sezione. Devi invece creare una configurazione di accesso al pool di identità per la forza lavoro.

Aggiungi l'helper di autenticazione di Secure Source Manager alla configurazione Git globale eseguendo il seguente comando:

Linux 

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

Le versioni precedenti di Git potrebbero non supportare i caratteri jolly. Per aggiungere l'helper di autenticazione senza caratteri jolly, esegui questo comando:

git config --global credential.'https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev'.helper gcloud.sh

Sostituisci quanto segue:

  • INSTANCE_ID con il nome dell'istanza Secure Source Manager.
  • PROJECT_NUMBER con il numero del tuo progetto. Per assistenza su come trovare il numero del progetto, consulta Identificazione dei progetti.
  • LOCATION con la regione dell'istanza. Per saperne di più sulle regioni, consulta Località.

Windows

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

Le versioni precedenti di Git potrebbero non supportare i caratteri jolly. Per aggiungere l'helper di autenticazione senza caratteri jolly, esegui questo comando:

git config --global credential.https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev.helper gcloud.cmd

Sostituisci quanto segue:

  • INSTANCE_ID con il nome dell'istanza Secure Source Manager.
  • PROJECT_NUMBER con il numero del tuo progetto. Per assistenza su come trovare il numero del progetto, consulta Identificazione dei progetti.
  • LOCATION con la regione dell'istanza. Per saperne di più sulle regioni, consulta Località.

L'helper per l'autenticazione utilizza gcloud CLI per recuperare le tue credenzialiGoogle Cloud quando utilizzi i comandi Git con Secure Source Manager.

Per eseguire nuovamente l'autenticazione dopo la configurazione iniziale delle credenziali, esegui questo comando gcloud CLI:

gcloud auth login

Crea una configurazione di accesso al pool di identità per la forza lavoro

Non è necessario compilare questa sezione a meno che tu non utilizzi la federazione delle identità della forza lavoro per l'autenticazione a Secure Source Manager con un provider di identità di terze parti.

Per autenticarti con le credenziali del tuo pool di identità della forza lavoro nell'istanza di Secure Source Manager utilizzando i comandi gcloud CLI o Git, devi creare una configurazione di accesso con il tuo pool di identità della forza lavoro.

Per creare una configurazione di accesso al pool di identità della forza lavoro, segui le istruzioni riportate in Recuperare token di breve durata per la federazione delle identità per la forza lavoro per creare un accesso basato sul browser con gcloud CLI.

Una volta eseguita l'autenticazione, puoi utilizzare i comandi Git per interagire con l'istanza Secure Source Manager. Devi eseguire nuovamente l'autenticazione quando scade la durata della sessione per il tuo pool di identità della forza lavoro.

Clonare un repository

Clona un repository eseguendo il seguente comando:

git clone REPOSITORY_URL

dove REPOSITORY_URL è l'URL HTTPS o SSH visualizzato nella parte superiore della pagina del repository che vuoi clonare.

Eseguire il push di un repository esistente in Secure Source Manager

Prima di poter eseguire il push, devi creare un repository Secure Source Manager da utilizzare come repository remoto.

Per eseguire il push del repository Git esistente in un repository Secure Source Manager vuoto, devi aggiungere il repository Secure Source Manager come repository remoto ed eseguire il push.

  1. Per impostare il repository Secure Source Manager come repository remoto, esegui questo comando:

    git remote add origin REPOSITORY_URL

    Dove REPOSITORY_URL è l'URL HTTPS o SSH visualizzato nella parte superiore della pagina del repository.

  2. Per eseguire il push nel repository, esegui questo comando:

    git push -u origin main

Per ulteriori informazioni sulla gestione del codice sorgente Git, consulta la documentazione di Git.

Passaggi successivi