Se connecter à Bitbucket Cloud

Cette page explique comment créer des connexions à Bitbucket Cloud et des liens vers des dépôts Bitbucket Cloud. Vous pouvez effectuer ces tâches à l'aide de la console Google Cloud ou de la Google Cloud CLI.

Ces instructions s'adressent aux développeurs d'applications, aux administrateurs de plate-forme et aux responsables de la sécurité qui souhaitent utiliser les dépôts de code source Bitbucket Cloud avec Google. Plus précisément, vous pouvez utiliser les dépôts Bitbucket Cloud avec Gemini Code Assist.

Pour en savoir plus sur Developer Connect, consultez la présentation de Developer Connect.

Avant de commencer

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

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

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Developer Connect API.

    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 API

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

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Developer Connect API.

    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 API

    8.

    L'activation de Developer Connect active également l'API Secret Manager.

  8. Assurez-vous d'avoir accès à un compte sur Bitbucket Cloud.

    Pour protéger le travail de votre équipe, nous vous recommandons d'effectuer les tâches de ce guide à l'aide d'un compte de robot ou d'un compte partagé par votre équipe, et non d'un compte personnel.

  9. Assurez-vous de posséder un dépôt Bitbucket Cloud ou de disposer d'autorisations de niveau administrateur sur un dépôt partagé.
  10. Facultatif : Créez une clé de chiffrement gérée par le client (CMEK) pour chiffrer les secrets d'authentification créés par Developer Connect.
  11. Facultatif : Pour utiliser les instructions de ligne de commande de ce guide, procédez comme suit :
    1. Installez la Google Cloud CLI. Si vous avez déjà installé la gcloud CLI, assurez-vous de disposer de la dernière version disponible en exécutant gcloud components update.
    2. Créez un compte de service Developer Connect en exécutant la commande suivante, où PROJECT_ID correspond à l'ID de votre projet :Google Cloud 
              gcloud beta services identity create \
            --service=developerconnect.googleapis.com \
            --project=PROJECT_ID

Rôles requis

Pour obtenir les autorisations nécessaires à la création de connexions et de liens, demandez à votre administrateur de vous accorder les rôles IAM suivants :

  • Si vous n'êtes pas le propriétaire du projet : Administrateur Developer Connect (roles/developerconnect.admin) sur votre compte utilisateur.
  • Si vous prévoyez d'utiliser une clé CMEK pour chiffrer les secrets créés par Developer Connect : Chiffreur/Déchiffreur de CryptoKeys Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter) sur le compte de service Secret Manager.
  • Si vous prévoyez d'utiliser la gcloud CLI pour effectuer les étapes de ce guide : Rôle Administrateur Secret Manager (roles/secretmanager.admin) sur le compte de service Developer Connect.
  • Si vous prévoyez d'utiliser la console Google Cloud pour effectuer les étapes de ce guide : Administrateur IAM de projet (roles/resourcemanager.projectIamAdmin) sur votre compte utilisateur.

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer des jetons d'accès

Créez des jetons d'accès personnels dans Bitbucket Cloud en procédant comme suit :

  1. Connectez-vous à Bitbucket Cloud.

  2. Pour créer deux jetons d'accès dans Bitbucket Cloud, procédez comme suit. Il peut s'agir de jetons d'accès au dépôt, de jetons d'accès au projet ou de jetons d'accès à l'espace de travail.

    1. Choisissez les instructions correspondant au type de jeton d'accès que vous allez utiliser :

    2. Créez le premier jeton avec les champs d'application suivants :

      • Repositories : read.
      • Demandes d'extraction : read.
      • Webhooks : read et write.

      Dans Developer Connect, il s'agit de votre jeton d'accès de l'agent d'autorisation.

    3. Créez le deuxième jeton avec le champ d'application suivant :

      • Repositories : read.

      Dans Developer Connect, il s'agit de votre jeton d'accès en lecture.

    Vous êtes responsable de la gestion de la durée de vie des jetons dans Bitbucket Cloud. Les jetons Bitbucket Cloud n'ont pas de date d'expiration et restent valides jusqu'à ce que vous les révoquiez.

    Certains types de jetons Bitbucket sont des fonctionnalités Premium exclusivement disponibles dans les forfaits payants. Pour en savoir plus, consultez Jetons Bitbucket Cloud.

  3. Copiez les jetons d'accès pour les utiliser dans les procédures suivantes.

Créer une connexion

Cette section explique comment créer une connexion entre Developer Connect et Bitbucket Cloud. Si vous utilisez la console Google Cloud , vous pouvez également commencer à ajouter des liens vers des dépôts une fois que vous avez terminé de configurer votre connexion.

Pour créer une connexion Bitbucket Cloud, sélectionnez l'une des options suivantes :

Console

Pour lancer une connexion, procédez comme suit :

  1. Dans la console Google Cloud , ouvrez Developer Connect.

    Accéder à Developer Connect

    Developer Connect affiche la page Dépôts Git.

    • Si une liste de fournisseurs de gestion de code source s'affiche : commencez à configurer votre première connexion en sélectionnant un fournisseur de gestion de code source. Cliquez sur Connecter sur la fiche Bitbucket Cloud.

    • Si un tableau listant les connexions existantes s'affiche : définissez le fournisseur de gestion du code source en cliquant sur Créer une connexion > Bitbucket Cloud.

      La page Créer une connexion s'ouvre.

  2. Dans le champ Région, sélectionnez une région pour vos ressources de connexion.

    1. Dans le champ Nom, saisissez un nom pour votre nouvelle connexion.

  3. Pour Workspace (Espace de travail), saisissez l'ID de votre espace de travail Bitbucket Cloud.

  4. Dans la section Jetons d'accès, saisissez vos jetons d'accès Bitbucket Cloud :

  5. Cliquez sur Afficher plus pour afficher les paramètres de configuration facultatifs.

    1. Facultatif : Dans la section Chiffrement, sélectionnez une clé CMEK pour chiffrer les secrets Secret Manager créés par Developer Connect.

    2. Facultatif : Par défaut, Developer Connect peut agir en tant que proxy pour les appels Git vers Bitbucket Cloud. Pour désactiver cette option, décochez la case Activer le proxy Developer Connect.

  6. Pour terminer la configuration de votre connexion, cliquez sur le bouton Continuer.

    Developer Connect crée votre connexion. Ce processus peut prendre quelques secondes.

Une fois la connexion créée, la page Associer des dépôts s'affiche.

Pour associer des dépôts à votre connexion, procédez comme suit :

  1. Dans la liste des dépôts disponibles, sélectionnez ceux que vous souhaitez utiliser.

  2. Cliquez sur OK.

  3. Cliquez sur Associer.

Votre connexion est ajoutée à la page Connexions et les liens vers vos dépôts sont ajoutés à la page Dépôts de la console Google Cloud . Vous pouvez ajouter des liens à des connexions existantes à tout moment.

Si vous configurez Gemini Code Assist, poursuivez le processus en suivant les étapes décrites dans Configurer et utiliser la personnalisation du code Gemini Code Assist.

gcloud

  1. Créez un secret de webhook dans Secret Manager en exécutant la commande suivante, où WEBHOOK_SECRET_NAME correspond au nom de votre secret de webhook :

    cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAME

  2. Stockez vos jetons d'accès personnels dans Secret Manager en exécutant les commandes suivantes :

    gcloud secrets create AUTHORIZER_SECRET_NAME

echo -n AUTHORIZER_SECRET_DATA | gcloud secrets versions add AUTHORIZER_SECRET_NAME --data-file=-

gcloud secrets create READ_SECRET_NAME

echo -n READ_SECRET_DATA | gcloud secrets versions add READ_SECRET_NAME --data-file=-

    Remplacez les éléments suivants :

    • AUTHORIZER_SECRET_NAME : nom du secret dans lequel Secret Manager stocke votre jeton d'accès à l'autorisation.
    • AUTHORIZER_SECRET_DATA : jeton d'accès de votre autorisateur.
    • READ_SECRET_NAME : nom du secret dans lequel Secret Manager stocke votre jeton d'accès en lecture.
    • READ_SECRET_DATA : votre jeton d'accès en lecture.

  3. Exécutez la commande gcloud developer-connect connections create pour créer une connexion à Bitbucket Cloud :

    gcloud developer-connect connections create CONNECTION_NAME \
    --location=REGION \
    --bitbucket-cloud-config-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/AUTHORIZER_SECRET_NAME/versions/VERSION \
    --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/READ_SECRET_NAME/versions/VERSION \
    --bitbucket-cloud-config-webhook-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET_NAME/versions/VERSION
    --git-proxy-config-enabled

    Remplacez les éléments suivants :

    • CONNECTION_NAME : nom de votre connexion.
    • REGION : région à utiliser pour votre connexion.
    • PROJECT_ID : ID de votre projet Google Cloud.
    • AUTHORIZER_SECRET_NAME : nom du secret Secret Manager contenant votre jeton au niveau de l'autorisation provenant de Bitbucket Cloud.
    • READ_SECRET_NAME : nom du secret Secret Manager contenant votre jeton en lecture seule provenant de Bitbucket Cloud.
    • WEBHOOK_SECRET_NAME : nom du secret Secret Manager contenant votre secret de webhook.
    • VERSION : numéro de version de chaque secret. Vous pouvez utiliser latest pour utiliser le numéro de version le plus récent.
    • --git-proxy-config-enabled : indicateur facultatif qui permet à Developer Connect d'agir en tant que proxy pour les appels Git vers Bitbucket Cloud. Cette fonctionnalité est en version preview.

    Developer Connect établit la connexion à Bitbucket Cloud. Ensuite, associez-le à des dépôts.

Une fois que vous avez établi une connexion à Bitbucket Cloud, vous pouvez l'associer à des dépôts. Vous pourrez répéter ces étapes ultérieurement pour associer d'autres dépôts si nécessaire.

Pour créer des liens de dépôt sur une connexion Bitbucket Cloud existante, sélectionnez l'une des options suivantes :

Console

Pour créer des liens vers des dépôts, procédez comme suit :

  1. Ouvrez la page Dépôts dans la console Google Cloud .

    Ouvrir la page Dépôts

  2. Cliquez sur Associer un dépôt.

    Le volet Associer des dépôts Git s'ouvre.

  3. Dans la liste des connexions, sélectionnez-en une.

  4. Cliquez sur Continuer.

  5. Dans la liste des dépôts, sélectionnez ceux que vous souhaitez associer.

    Developer Connect affiche des noms suggérés pour les ressources de votre dépôt.

  6. Sélectionnez une option de dénomination des ressources de dépôt :

    • Généré : utilisez les noms de ressources de dépôt générés.
    • Manuelle : saisissez vos propres noms.

  7. Cliquez sur Créer.

    Developer Connect crée les liens vers le dépôt et les affiche dans la console Google Cloud .

gcloud

Créez un lien vers votre dépôt Bitbucket Cloud en exécutant la commande suivante :

gcloud developer-connect connections git-repository-links create REPO_NAME \
    --clone-uri=REPO_URI \
    --connection=CONNECTION_NAME \
    --location=REGION

Remplacez les éléments suivants :

  • REPO_NAME : nom du nouveau lien entre Developer Connect et votre dépôt Bitbucket Cloud.
  • REPO_URI : URL de votre dépôt dans Bitbucket Cloud, y compris le préfixe https:// et le suffixe .git.
  • CONNECTION_NAME : nom de votre connexion à Bitbucket Cloud.
  • REGION : région de votre connexion.

Developer Connect crée les liens vers les dépôts.

Pour lister les dépôts associés, exécutez la commande developer-connect connections git-repository-linkslist.

Si vous configurez Gemini Code Assist, poursuivez le processus en suivant les étapes décrites dans Configurer et utiliser la personnalisation du code Gemini Code Assist.

Étapes suivantes