Connetti un repository di codice sorgente

Connetti un repository di codice sorgente

Developer Connect ti consente di eseguire l'integrazione con prodotti e servizi non Google in modo da poterli utilizzare nei prodotti Google supportati.

Questa guida rapida mostra come connettersi a GitHub utilizzando una connessione al repository Git. Questo tipo di connessione è necessario quando vuoi utilizzare la personalizzazione del codice di Gemini Code Assist.

Per un elenco di tutte le integrazioni supportate da Developer Connect, consulta la panoramica di Developer Connect.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Developer Connect and Secret Manager APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs
Make sure that you have the following role or roles on the project: Developer Connect Admin
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.
3. Click Grant access.

4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

5. Click Select a role, then search for the role.
6. To grant additional roles, click Add another role and add each additional role.
7. Click Save.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect and Secret Manager APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Make sure that you have the following role or roles on the project: Developer Connect Admin

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.
3. Click Grant access.

4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

5. Click Select a role, then search for the role.
6. To grant additional roles, click Add another role and add each additional role.
7. Click Save.
1. Assicurati di avere un account GitHub e l'accesso a un repository ospitato su GitHub.com. In alternativa, segui la documentazione di GitHub per crearne di nuovi:
• Creare un account GitHub
• Crea un repository su GitHub.com
2. Se utilizzi un repository esistente e non ne sei il proprietario, chiedi al proprietario di concedere le autorizzazioni a livello di amministratore per il repository. Se il repository si trova in un'organizzazione GitHub, richiedi le autorizzazioni a livello amministrativo al proprietario dell'organizzazione. Per saperne di più sulle organizzazioni GitHub, vedi Tipi di account GitHub.

Avviare una connessione

1. Apri la pagina Developer Connect nella console Google Cloud .

   Vai a Developer Connect

   Si apre la pagina Repository Git, che mostra un elenco di fornitori di gestione del codice sorgente.

2. Seleziona un provider di gestione del codice sorgente facendo clic su Connetti sulla scheda del provider.

   Si apre la pagina Crea connessione.

3. Scegli us-central1 come regione.

4. Inserisci quickstart-connection come nome.

5. Fai clic su Continua.

   Viene visualizzata la finestra di dialogo Google Developer Connect che richiede l'autorizzazione a utilizzare il token OAuth GitHub.

   Se non vedi una finestra di dialogo, disattiva i plug-in del browser che bloccano i popup e assicurati che le impostazioni del browser consentano i popup. Ad esempio, in Chrome, segui le istruzioni per consentire i popup.

6. Fai clic su Ho capito e continua.

7. Completa i passaggi di accesso all'account GitHub, se richiesto.

8. Se ti viene richiesto, fai clic su Autorizza Developer Connect. Se non visualizzi questo prompt, l'autorizzazione è già stata concessa per questo account.

Configura la connessione

Concedi le autorizzazioni sul tuo account GitHub e sui repository seguendo i passaggi riportati di seguito. I prompt dipendono dal fatto che un utente dell'account GitHub abbia già installato l'app Google Developer Connect in GitHub.

• Se vedi un elenco di account GitHub:l'app non è ancora installata. Installa e configura l'app seguendo questi passaggi:

  1. Scegli l'account GitHub che ha accesso al repository che vuoi collegare.

  2. Specifica le autorizzazioni del repository GitHub e installa l'app. Per maggiori informazioni, consulta le istruzioni di GitHub sull'installazione delle app.

• Se viene visualizzato un messaggio che ti chiede di riutilizzare un'installazione esistente: scegli dove installare e configurare l'app seguendo questi passaggi:

  1. Fai clic su Account GitHub per visualizzare gli account in cui è installata l'app. Se visualizzi l'account che vuoi utilizzare, sceglilo.

     1. Fai clic su Conferma.

  2. Se non vedi l'account che vuoi utilizzare, scegli Installa l'app GitHub su un altro account GitHub.

     1. Fai clic su Conferma.

     2. Scegli l'account GitHub che vuoi utilizzare.

     3. Specifica le autorizzazioni del repository GitHub e installa l'app. Per maggiori informazioni, consulta le istruzioni di GitHub sull'installazione delle app.

1. In Repository, scegli il repository che vuoi collegare.

2. Fai clic su Collega.

La connessione viene aggiunta all'elenco delle connessioni e il repository collegato all'elenco dei repository.

Esegui la pulizia

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

1. Nella console Google Cloud , vai alla pagina Developer Connect.

   Vai a Developer Connect

2. Nella scheda Repository, nella riga contenente il nome del repository collegato, fai clic su Altre opzioni.

3. Scegli Scollega.

4. Fai clic su Conferma.

5. Fai clic sulla scheda Connessioni.

6. Nella riga contenente il nome della connessione, fai clic su Altre opzioni.

7. Scegli Elimina.

8. Inserisci il nome della connessione.

9. Fai clic su Conferma.

L'eliminazione di connessioni e link non comporta l'eliminazione dei repository su GitHub.com. Se hai creato un nuovo repository GitHub per questa guida rapida e vuoi eliminarlo, segui le istruzioni di GitHub per eliminare un repository.

Se vuoi disinstallare l'app Google Developer Connect, segui le istruzioni di GitHub su come modificare le app installate.

Passaggi successivi

• Scopri di più sulla personalizzazione del codice di Gemini Code Assist.
• Crea app in Firebase App Hosting utilizzando i repository GitHub.