Associer un dépôt de code source
Developer Connect vous permet de vous intégrer à des produits et services autres que Google afin de pouvoir les utiliser dans les produits Google compatibles.
Ce guide de démarrage rapide vous explique comment vous connecter à GitHub à l'aide d'une connexion à un dépôt Git. Ce type de connexion est requis lorsque vous souhaitez utiliser la personnalisation du code Gemini Code Assist.
Pour obtenir la liste de toutes les intégrations compatibles avec Developer Connect, consultez Présentation de Developer Connect.
Avant de commencer
- Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
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 theserviceusage.services.enablepermission. Learn how to grant roles.-
Make sure that you have the following role or roles on the project: Developer Connect Admin
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
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.
- 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
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
- Click Grant access.
-
In the New principals field, enter your user identifier. This is typically the email address for a Google Account.
- Click Select a role, then search for the role.
- To grant additional roles, click Add another role and add each additional role.
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
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 theserviceusage.services.enablepermission. Learn how to grant roles.-
Make sure that you have the following role or roles on the project: Developer Connect Admin
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
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.
- 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
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
- Click Grant access.
-
In the New principals field, enter your user identifier. This is typically the email address for a Google Account.
- Click Select a role, then search for the role.
- To grant additional roles, click Add another role and add each additional role.
- Click Save.
-
- Assurez-vous de disposer d'un compte GitHub et d'avoir accès à un dépôt hébergé sur GitHub.com. Vous pouvez également suivre la documentation GitHub pour en créer un :
- Si vous utilisez un dépôt existant et que vous n'en êtes pas le propriétaire, demandez-lui de vous accorder des autorisations d'administrateur pour le dépôt. Si le dépôt se trouve dans une organisation GitHub, demandez des autorisations d'administrateur au propriétaire de l'organisation. Pour en savoir plus sur les organisations GitHub, consultez Types de comptes GitHub.
Établir une connexion
Ouvrez la page Developer Connect dans la console Google Cloud .
La page Dépôts Git s'ouvre et affiche la liste des fournisseurs de gestion du code source.
Sélectionnez un fournisseur de gestion de code source en cliquant sur Connecter sur la fiche de ce fournisseur.
La page Créer une connexion s'ouvre.
Sélectionnez
us-central1comme région.Saisissez
quickstart-connectioncomme nom.Cliquez sur Continuer.
La boîte de dialogue Google Developer Connect s'affiche et vous demande l'autorisation d'utiliser votre jeton OAuth GitHub.
Si aucune boîte de dialogue ne s'affiche, désactivez les plug-ins de blocage des pop-ups dans votre navigateur et assurez-vous que les paramètres de votre navigateur autorisent les pop-ups. Par exemple, dans Chrome, suivez les instructions pour autoriser les pop-ups.
Cliquez sur J'ai compris et continuer.
Si vous y êtes invité, suivez les étapes de connexion à votre compte GitHub.
Si vous y êtes invité, cliquez sur Autoriser Developer Connect. Si vous ne voyez pas cette invite, cela signifie que l'autorisation a déjà été accordée pour ce compte.
Configurer la connexion
Accordez des autorisations sur votre compte et vos dépôts GitHub en suivant les étapes ci-dessous. Les invites dépendent du fait qu'une personne utilisant le compte GitHub a déjà installé l'application Google Developer Connect dans GitHub.
Si une liste de comptes GitHub s'affiche : l'application n'est pas encore installée. Pour l'installer et le configurer, procédez comme suit :
Choisissez le compte GitHub ayant accès au dépôt que vous souhaitez associer.
Spécifiez les autorisations du dépôt GitHub et installez l'application. Pour en savoir plus, consultez les instructions GitHub sur l'installation d'applications.
Si vous êtes invité à réutiliser une installation existante : choisissez où installer et configurer l'application en suivant ces étapes :
Cliquez sur Compte GitHub pour afficher les comptes sur lesquels l'application est installée. Si le compte que vous souhaitez utiliser s'affiche, sélectionnez-le.
- Cliquez sur Confirmer.
Si le compte que vous souhaitez utiliser ne s'affiche pas, sélectionnez Installer l'application GitHub sur un autre compte GitHub.
Cliquez sur Confirmer.
Choisissez le compte GitHub que vous souhaitez utiliser.
Spécifiez les autorisations du dépôt GitHub et installez l'application. Pour en savoir plus, consultez les instructions GitHub sur l'installation d'applications.
Dans Dépôts, sélectionnez le dépôt que vous souhaitez associer.
Cliquez sur Associer.
La connexion est ajoutée à la liste des connexions, et le dépôt associé est ajouté à la liste des dépôts.
Effectuer un nettoyage
Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :
Dans la console Google Cloud , accédez à la page Developer Connect.
Dans l'onglet Dépôts, sur la ligne contenant le nom du dépôt associé, cliquez sur Plus d'options.
Sélectionnez Dissocier.
Cliquez sur Confirmer.
Cliquez sur l'onglet Connexions.
Sur la ligne contenant le nom de votre connexion, cliquez sur Plus d'options.
Sélectionnez Supprimer.
Saisissez le nom de votre connexion.
Cliquez sur Confirmer.
La suppression des connexions et des liens n'entraîne pas la suppression des dépôts sur GitHub.com. Si vous avez créé un dépôt GitHub pour ce démarrage rapide et que vous souhaitez le supprimer, suivez les instructions GitHub pour supprimer un dépôt.
Si vous souhaitez désinstaller l'application Google Developer Connect, suivez les instructions GitHub pour modifier les applications installées.