Creare e clonare un repository

Creare e clonare un repository

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

Prima di iniziare

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

2. Installa Google Cloud CLI.

3. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

4. Per inizializzare gcloud CLI, esegui questo comando:

   gcloud init

Ruoli obbligatori

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

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

Per saperne di più 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 di amministratore di Secure Source Manager (roles/securesourcemanager.admin) o il ruolo di base IAM di 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 test.

Per informazioni sulla concessione dei ruoli di 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 dell'istanza. Google CloudPer 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 nel menu di navigazione.

4. Inserisci i dettagli del repository:

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

      Nota: gli ID repository devono seguire 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. Descrizione: facoltativa. 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 di servizio in conformità con l' Google Cloud Informativa sulla privacy.

   3. Branch predefinito: nome del branch predefinito.

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

   5. .gitignore: facoltativa. Scegli i file da non monitorare utilizzando i modelli del menu a discesa.

   6. license: facoltativa. Seleziona una licenza comune dal menu a discesa.

5. Fai clic su Crea repository.

Il repository viene creato nell'istanza di Secure Source Manager.

Il ruolo di amministratore del repository (roles/securesourcemanager.repoAdmin) ti viene concesso quando crei un nuovo repository. La propagazione della nuova autorizzazione IAM potrebbe richiedere fino a 2 minuti, 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.

Configura le credenziali

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

Linux

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

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

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 caratter jolly. Per aggiungere l'helper di autenticazione senza caratteri jolly, esegui il comando seguente:

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 di Secure Source Manager.
• PROJECT_NUMBER con il numero del progetto. Per assistenza nella ricerca del numero del progetto, consulta Identificazione dei progetti.
• LOCATION con la regione dell'istanza. Per saperne di più sulle regioni, consulta Località.

L'helper di autenticazione utilizza gcloud CLI per recuperare le Google Cloud credenziali quando utilizzi i comandi Git con Secure Source Manager.

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

gcloud auth login

Clona 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 il comando seguente:

   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.

Esegui il push in un repository

1. In una finestra del terminale, cambia directory nel 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 nel repository remoto:

   git push -u origin main
   

   Git esegue il push del file dal branch 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'.
   

Visualizza 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.

Libera spazio

Per evitare che al tuo Google Cloud account 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 sostituzioni seguenti:

• 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, consulta 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 di pull e i problemi in Secure Source Manager.