A partire dal 17 giugno 2024, Cloud Source Repositories non è disponibile per i nuovi clienti. Se la tua organizzazione non ha utilizzato in precedenza Cloud Source Repositories, non puoi abilitare l'API o utilizzare Cloud Source Repositories. I nuovi progetti non connessi a un'organizzazione non possono abilitare l'API Cloud Source Repositories. Le organizzazioni che hanno utilizzato Cloud Source Repositories prima del 17 giugno 2024 non sono interessate da questa modifica.

Questa pagina è stata tradotta dall'API Cloud Translation.

Configurazione dell'autenticazione locale

Prima di poter accedere o interagire con i repository ospitati dal tuo sistema, devi configurare l'autenticazione locale nel tuo ambiente.

Dopo aver configurato l'autenticazione locale, potrai accedere ai repository ospitati per: di cui disponi dell'appropriata ruoli e autorizzazioni. Puoi anche eseguire operazioni Git standard come git clone, git pull e git push. L'autenticazione locale non è necessaria per eseguire operazioni nel Console Google Cloud, ad esempio per sfogliare i contenuti di un repository.

Cloud Source Repositories supporta i seguenti tipi di autenticazione:

SSH
Google Cloud CLI
Credenziali generate manualmente

Esegui l'autenticazione mediante SSH

Cloud Source Repositories consente di utilizzare l'autenticazione a chiave pubblica SSH per accedere ai repository ospitati. In questo scenario, prima generi una coppia di chiavi al sistema locale da cui vuoi accedere al repository. Poi registrati la chiave pubblica con Google Cloud. Se hai già una coppia di chiavi SSH nel sistema, puoi riutilizzare queste chiavi per l'autenticazione. Puoi registrarti fino a 20 chiavi pubbliche per Account Google.

Cloud Source Repositories supporta tre tipi di chiavi SSH:

RSA (solo per chiavi con più di 2048 bit)
ECDSA
ED25519

Genera una coppia di chiavi

La coppia di chiavi SSH è composta da una chiave privata che risiede nel sistema locale una chiave pubblica da registrare in Google Cloud.

Linux o macOS

Assicurati che OpenSSH sia installata sul sistema locale.
Al prompt dei comandi, inserisci il seguente comando:
```
ssh-keygen -t [KEY_TYPE] -C "[USER_EMAIL]"
```
Dove:
- [USER_EMAIL] è il tuo indirizzo email.
- [KEY_TYPE] corrisponde a uno dei seguenti:
  - rsa
  - ecdsa
  - ed25519
Ad esempio:
```
ssh-keygen -t rsa -C "user@example.com"
```
1. Quando richiesto, inserisci un nome file per il file della chiave pubblica. Per accettare i posizione predefinita di ~/.ssh, premi Invio, altrimenti specifica un nome file.
2. Quando richiesto, lascia la passphrase vuota e premi Invio.
Registrare il token

Windows

Assicurati che PuTTY sia installata sul sistema locale.
Dal menu Start di Windows, avvia PuTTYGen.
Nella finestra che si apre, seleziona il tipo di chiave in Parametri. .
Fai clic su Genera.

PuTTYGen visualizza la stringa di chiave pubblica generata.
Specifica una passphrase per proteggere la coppia di chiavi.
Per salvare la coppia di chiavi generata nel sistema locale, fai clic su Salva chiave pubblica e Salva chiave privata.

Usa chiavi esistenti

Puoi anche utilizzare una coppia di chiavi esistente per l'autenticazione SSH.

Linux o macOS

Per impostazione predefinita, i file delle chiavi pubbliche si trovano nella directory ~/.ssh.

Al prompt dei comandi, inserisci il seguente comando:

ls -a ~/.ssh

I nomi file predefiniti sono:

id_rsa.pub
id_ecdsa.pub
id_ed25519.pub

Windows

Dal menu Start di Windows, avvia PuTTYGen.
Nella finestra che si apre, fai clic su Carica.
Cerca nel file system locale il file di chiave pubblica e seleziona l'icona .

PuTTYGen visualizza la stringa della chiave pubblica. Se hai specificato una passphrase quando hai salvato il file della chiave, PuTTYGen ti chiede di inserirlo prima di possono visualizzare la chiave pubblica.

Registra una chiave pubblica

Nella console Google Cloud, apri la pagina Gestisci chiavi SSH.

Apri Cloud Source Repositories
Fai clic su Registra chiave SSH.

Viene visualizzata la finestra di dialogo Registra chiave SSH.
Nel campo Nome chiave, digita un nome univoco per la chiave.
Nel campo Chiave, copia la stringa della chiave dal file della chiave pubblica.
Fai clic su Registrati.

Dopo aver configurato l'autenticazione SSH, puoi clona qualsiasi repository per il quale disponi dei ruoli e delle autorizzazioni richiesti oppure esegui il push dei contenuti di un repository locale in un repository ospitato vuoto.

Esegui l'autenticazione utilizzando gcloud CLI

Cloud Source Repositories consente di eseguire l'autenticazione mediante con gcloud CLI. In questo scenario, gcloud init sul tuo sistema per configurare l'autenticazione locale.

Assicurati che gcloud CLI sia installata sul sistema locale.
A un prompt dei comandi, esegui gcloud init:
```
gcloud init
```
Segui le istruzioni.

Dopo aver configurato l'autenticazione mediante gcloud CLI, puoi utilizzare tramite comandi Git standard per interagire con il repository Cloud Source Repositories.

Esegui l'autenticazione utilizzando credenziali generate manualmente

Puoi anche utilizzare le credenziali generate manualmente per l'autenticazione. Cloud Source Repositories fornisce un set di script che puoi usare per eseguire manualmente e generare le credenziali necessarie per accedere ai repository ospitati.

Vai alla pagina Configura Git per generare le tue credenziali.

Vai alla pagina Configura Git
Apri una finestra del terminale.
Digita il seguente comando:
```
git clone https://source.developers.google.com/p/PROJECT_ID/r/REPOSITORY_NAME
```
Dove:
- PROJECT_ID è il nome del tuo progetto
- REPOSITORY_NAME è il nome del tuo repository

Dopo aver configurato l'autenticazione con credenziali generate manualmente, puoi interagire con il repository ospitato su Cloud Source Repositories utilizzando tramite i comandi Git standard.