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, puoi accedere ai repository ospitati per i quali disponi dei ruoli e delle autorizzazioni appropriati.
Puoi eseguire anche operazioni Git standard come git clone
, git pull
e git push
. L'autenticazione locale non è necessaria per eseguire operazioni nella console Google Cloud, ad esempio per sfogliare i contenuti di un repository.
Cloud Source Repositories supporta i seguenti tipi di autenticazione:
Autenticazione tramite SSH
Cloud Source Repositories consente di utilizzare l'autenticazione tramite chiave pubblica SSH per accedere ai repository ospitati. In questo scenario, devi prima generare una coppia di chiavi sul sistema locale da cui vuoi accedere al repository. Quindi, registra la chiave pubblica in Google Cloud. Se sul sistema è già presente una coppia di chiavi SSH, puoi riutilizzare le chiavi per l'autenticazione. Puoi registrare fino a 20 chiavi pubbliche per ogni Account Google.
Cloud Source Repositories supporta tre tipi di chiavi SSH:
- RSA (solo per le 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 sul sistema locale e da una chiave pubblica registrata in Google Cloud.
Linux o macOS
Assicurati che OpenSSH sia installato sul tuo 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]
è uno dei seguenti:rsa
ecdsa
ed25519
Ad esempio:
ssh-keygen -t rsa -C "[email protected]"
Quando richiesto, inserisci un nome file per il file della chiave pubblica. Per accettare la posizione
~/.ssh
predefinita, premi Invio, altrimenti specifica un nome file.Quando richiesto, lascia la passphrase vuota e premi Invio.
Windows
Assicurati che PuTTY sia installato sul tuo sistema locale.
Dal menu Start di Windows, avvia PuTTYGen.
Nella finestra che si apre, seleziona il tipo di chiave dal campo 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 di chiave pubblica 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 il file della chiave pubblica nel file system locale e selezionalo.
PuTTYGen visualizza la stringa della chiave pubblica. Se hai specificato una passphrase quando hai salvato il file della chiave, PuTTYGen ti chiede di inserirla per poter visualizzare la chiave pubblica.
Registra una chiave pubblica
Nella console Google Cloud, apri la pagina Gestisci chiavi SSH.
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 di chiave dal file della chiave pubblica.
Fai clic su Registrati.
Dopo aver configurato l'autenticazione SSH, puoi clonare qualsiasi repository per cui disponi dei ruoli e delle autorizzazioni richiesti oppure eseguire 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 utilizzando gcloud CLI. In questo scenario, per configurare l'autenticazione locale devi eseguire il comando gcloud init
sul tuo sistema.
Assicurati che gcloud CLI sia installato sul tuo sistema locale.
Al prompt dei comandi, esegui
gcloud init
:gcloud init
Segui le istruzioni.
Dopo aver configurato l'autenticazione mediante gcloud CLI, puoi utilizzare i comandi Git standard per interagire con il repository ospitato in 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 insieme di script che puoi utilizzare per generare manualmente le credenziali necessarie per accedere ai repository ospitati.
Vai alla pagina Configura Git per generare le tue credenziali.
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 i comandi Git standard.