Crea e clona un repository

Crea e clona un repository

Crea un repository in Secure Source Manager e clonalo sulla tua macchina locale.

Prima di iniziare

1. Crea o richiedi l'accesso a un'istanza Secure Source Manager. Per saperne di più, vedi Creare un'istanza di Secure Source Manager.

2. Install the Google Cloud CLI.

3. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

4. To initialize the gcloud CLI, run the following command:

   gcloud init

5. Installa il componente alpha Google Cloud CLI:

   gcloud components install alpha

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare un repository, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Ruolo Creatore repository di istanze Secure Source Manager (roles/securesourcemanager.instanceRepositoryCreator) nell'istanza Secure Source Manager
• Ruolo Secure Source Manager Repo Creator (roles/securesourcemanager.repoCreator) nel progetto dell'istanza

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.

Nota :il ruolo Amministratore di Secure Source Manager (roles/securesourcemanager.admin) o il ruolo IAM di base Proprietario (roles/owner) nel tuo progetto contiene anche le autorizzazioni per creare e clonare un repository. Non devi concedere ruoli di amministratore o ruoli di base in un ambiente di produzione, ma puoi concederli in un ambiente di sviluppo o di test.

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

Crea un repository

Interfaccia web

1. Per accedere all'istanza di Secure Source Manager tramite la sua interfaccia web, copia il seguente URL nella barra degli indirizzi del browser.

   INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

   Sostituisci quanto segue:

   • INSTANCE_ID con il nome dell'istanza.
   • PROJECT_NUMBER con il numero di progetto Google Cloud dell'istanza. Per informazioni sull'identificazione dei progetti, consulta Identificazione dei progetti.
   • LOCATION con la regione dell'istanza.

2. Se necessario, esegui l'autenticazione utilizzando le credenziali di Secure Source Manager.

3. Fai clic sull'icona + Crea nuovo repository in alto a destra del menu di navigazione.

4. Compila i dettagli del repository:

   1. ID repository: inserisci un nome per il repository.

      Nota :gli ID repository devono rispettare la convenzione di denominazione delle risorse. Devono includere solo lettere minuscole, numeri o trattini, devono iniziare con una lettera e non possono essere modificati dopo la creazione del repository.

   2. (Facoltativo) Descrizione. Descrizione del repository.

      Attenzione :non inserire dati sensibili o identificativi nella descrizione o in altri campi di risorse simili. Questi campi vengono trattati come dati del servizio in conformità con l' Google Cloud Informativa sulla privacy.

   3. Inizializza repository: facoltativo. Seleziona questa opzione se vuoi inizializzare il repository e aggiungere i file .gitignore, license e README.

   4. .gitignore: facoltativo. Scegli i file da non monitorare utilizzando i modelli di menu a discesa.

   5. license: facoltativo. Seleziona una licenza comune dal menu a discesa.

   6. Branch predefinito: nome del branch predefinito.

5. Fai clic su Invia.

Il repository viene creato nell'istanza Secure Source Manager.

Il ruolo di amministratore del repository (roles/securesourcemanager.repoAdmin) ti viene concesso quando crei un nuovo repository. La nuova autorizzazione IAM potrebbe richiedere fino a 2 minuti per la propagazione, quindi se ricevi un errore di autorizzazione quando provi ad accedere al repository dopo la creazione, attendi qualche minuto e riprova.

I repository che hai creato sono elencati nell'interfaccia web di Secure Source Manager nella pagina I miei repository.

Configurare le credenziali

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

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

Clonare un repository

1. Nell'interfaccia web di Secure Source Manager, vai alla pagina del repository.

2. Copia l'URL HTTPS nella parte superiore della pagina del repository.

3. Clona il repository eseguendo questo comando:

   git clone REPOSITORY_URL
   

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

   Ignora l'avviso relativo alla clonazione di un repository vuoto.

Eseguire il push in un repository

1. In una finestra del terminale, cambia directory impostandola su quella del repository clonato.

   cd REPOSITORY_NAME
   

   dove REPOSITORY_NAME è il nome del repository.

2. Crea un file README vuoto:

   touch README.md
   

3. Aggiungi il file README a Git e crea un messaggio di commit:

   git add README.md
   git commit -m "initial commit"
   

4. Esegui il push delle modifiche al repository remoto:

   git push -u origin main
   

   Git esegue il push del file dal ramo principale al repository remoto di origine. L'output è simile al seguente:

   Enumerating objects: 3, done.
   Counting objects: 100% (3/3), done.
   Writing objects: 100% (3/3), 211 bytes | 211.00 KiB/s, done.
   Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
   remote: . Processing 1 references
   remote: Processed 1 references in total
   To https://instance-id-123456789012-git.us-central1.sourcemanager.dev/my-project/my-repo.git
   * [new branch]      main -> main
   branch 'main' set up to track 'origin/main'.
   

Visualizzare i file in Secure Source Manager

Nell'interfaccia web di Secure Source Manager, fai clic sul nome del repository.

Si apre la pagina del repository e il file README.md è elencato nella scheda <> Codice.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Prima di rimuovere il repository, assicurati che tutti i file che vuoi conservare siano disponibili in un'altra posizione.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto del progetto Google Cloud in cui è in esecuzione Secure Source Manager.
• LOCATION: la regione in cui si trova l'istanza. Per informazioni sulle località supportate, vedi Località.
• REPOSITORY_ID: l'ID repository.

Metodo HTTP e URL:

DELETE https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}
```

La risposta è simile alla seguente:

{"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}

Passaggi successivi

• Elenca e visualizza i repository nell'interfaccia web di Secure Source Manager.
• Utilizza le richieste pull e i problemi in Secure Source Manager.