Connettersi a Bitbucket Cloud

Questa pagina descrive come creare connessioni a Bitbucket Cloud e link ai repository Bitbucket Cloud. Puoi completare queste attività utilizzando la Google Cloud console, o Google Cloud CLI.

Queste istruzioni sono destinate a sviluppatori di applicazioni, amministratori di piattaforme e responsabili della sicurezza che vogliono utilizzare i repository di codice sorgente Bitbucket Cloud con Google. In particolare, puoi utilizzare i repository Bitbucket Cloud con Gemini Code Assist.

Per saperne di più su Developer Connect, consulta la panoramica di Developer Connect.

Prima di iniziare

Accedi al tuo Account Google.

Se non ne hai già uno, registrati per creare un nuovo account.

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

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

L'abilitazione di Developer Connect abilita anche l' API Secret Manager.

1. Assicurati di avere accesso a un account su Bitbucket Cloud.

   Per proteggere il lavoro del tuo team, ti consigliamo di completare le attività descritte in questa guida utilizzando un account bot o un account condiviso dal tuo team, non un account personale.

2. (Facoltativo) Assicurati di essere il proprietario di un repository Bitbucket Cloud o di disporre delle autorizzazioni a livello di amministratore su un repository condiviso.
3. (Facoltativo) Crea una chiave di crittografia gestita dal cliente (CMEK) per criptare i secret di autenticazione creati da Developer Connect.
4. (Facoltativo) Per utilizzare le istruzioni della riga di comando in questa guida, completa i seguenti passaggi:
   1. Installa la Google Cloud CLI. Se hai già installato gcloud CLI, assicurati di avere l'ultima versione disponibile eseguendo gcloud components update.
   2. Crea un service account Developer Connect eseguendo il comando seguente, dove PROJECT_ID è il tuo Google Cloud ID progetto:

              gcloud beta services identity create \
                  --service=developerconnect.googleapis.com \
                  --project=PROJECT_ID
              

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare connessioni e link, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Se non sei il proprietario del progetto: Amministratore di Developer Connect (roles/developerconnect.admin) sul tuo account utente.
• Se prevedi di utilizzare una CMEK per criptare i secret creati da Developer Connect: Autore crittografia/decrittografia CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter) sul service account Secret Manager.
• Se prevedi di utilizzare gcloud CLI per completare i passaggi descritti in questa guida: ruolo Amministratore di Secret Manager (roles/secretmanager.admin) sul service account Developer Connect.
• Se prevedi di utilizzare la Google Cloud console per completare i passaggi descritti in questa guida: Amministratore IAM progetto (roles/resourcemanager.projectIamAdmin) sul tuo account utente.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Nota: quando hai il ruolo Amministratore IAM progetto (roles/resourcemanager.projectIamAdmin) la Google Cloud console può concedere automaticamente le autorizzazioni necessarie per tuo conto. Se l'amministratore non ti consente di avere il ruolo Amministratore IAM progetto, chiedigli di concedere il ruolo Amministratore di Secret Manager (roles/secretmanager.admin) sul service account Developer Connect (service-{projectNumber}@gcp-sa-devconnect.iam.gserviceaccount.com).

Crea token di accesso

Crea token di accesso personali in Bitbucket Cloud completando i seguenti passaggi:

1. Accedi a Bitbucket Cloud.

2. Completa i seguenti passaggi per creare due token di accesso in Bitbucket Cloud. Questi possono essere token di accesso al repository, token di accesso al progetto, o token di accesso allo spazio di lavoro.

   1. Scegli le istruzioni per il tipo di token di accesso che utilizzerai:

      • Crea token di accesso al repository
      • Crea token di accesso al progetto
      • Crea token dello spazio di lavoro

   2. Crea il primo token con gli ambiti seguenti:

      • Repository: read.
      • Richieste di pull: read.
      • Webhook: read e write.

      In Developer Connect, questo è chiamato token di accesso dell'Authorizer.

   3. Crea il secondo token con l'ambito seguente:

      • Repository: read.

      In Developer Connect, questo è chiamato token di accesso in lettura.

   Sei responsabile della gestione della durata dei token in Bitbucket Cloud. I token Bitbucket Cloud non hanno scadenza e rimarranno validi finché non li revochi.

   Alcuni tipi di token Bitbucket sono funzionalità premium disponibili esclusivamente nei piani a pagamento. Per saperne di più, consulta Token Bitbucket Cloud.

3. Copia i token di accesso da utilizzare nelle procedure seguenti.

Crea una connessione

Questa sezione descrive come creare una connessione tra Developer Connect e Bitbucket Cloud. Se utilizzi la Google Cloud console, puoi anche iniziare ad aggiungere link ai repository al termine della configurazione della connessione.

Per creare una nuova connessione Bitbucket Cloud, seleziona una delle seguenti opzioni:

Console

Avvia una connessione completando i seguenti passaggi:

1. Nella Google Cloud console, apri Developer Connect.

   Vai a Developer Connect

   Developer Connect mostra la pagina Repository Git.

   • Se vedi un elenco di provider di gestione del codice sorgente: inizia a configurare la prima connessione selezionando un provider di gestione del codice sorgente. Fai clic su Connetti nella scheda Bitbucket Cloud.

   • Se vedi una tabella che elenca le connessioni esistenti: imposta il provider di gestione del codice sorgente facendo clic su Crea connessione > Bitbucket Cloud.

     Si apre la pagina Crea connessione.

2. In Regione, scegli una regione per le risorse di connessione.

   1. In Nome, inserisci un nome per la nuova connessione.

3. In Spazio di lavoro, inserisci l'ID dello spazio di lavoro Bitbucket Cloud.

4. Nella sezione Token di accesso, inserisci i token di accesso Bitbucket Cloud:

   • Token di accesso dell'Authorizer: inserisci il token di accesso dell'Authorizer.
   • Token di accesso in lettura: inserisci il tuo token di accesso in lettura.

5. Fai clic su Mostra altro per visualizzare le impostazioni di configurazione facoltative.

   1. (Facoltativo) Nella sezione Crittografia, seleziona una chiave CMEK per criptare i secret di Secret Manager creati da Developer Connect.

   2. (Facoltativo) Per impostazione predefinita, Developer Connect può fungere da proxy per le chiamate Git a Bitbucket Cloud. Per disattivare questa opzione, deseleziona la casella di controllo Abilita proxy Developer Connect.

6. Per completare la configurazione della connessione, fai clic sul pulsante Continua.

   Developer Connect crea la connessione. Questa procedura può richiedere alcuni secondi.

Una volta creata la connessione, viene visualizzata la pagina Collega repository.

Completa i seguenti passaggi per collegare i repository alla connessione:

1. Nell'elenco dei repository disponibili, seleziona quelli che vuoi utilizzare.

2. Fai clic su OK.

3. Fai clic su Collega.

La connessione viene aggiunta alla pagina Connessioni e i link ai repository vengono aggiunti alla pagina Repository nella Google Cloud console. Puoi aggiungere altri link alle connessioni esistenti in qualsiasi momento.

Se stai configurando Gemini Code Assist, continua la procedura seguendo i passaggi descritti in Configurare e utilizzare la personalizzazione del codice di Gemini Code Assist.

gcloud

1. Crea un secret webhook in Secret Manager eseguendo il comando seguente, dove WEBHOOK_SECRET_NAME è un nome per il secret webhook:

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

2. Archivia i token di accesso personali in Secret Manager eseguendo i seguenti comandi:

   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=-
   

   Sostituisci quanto segue:

   • AUTHORIZER_SECRET_NAME: un nome per il secret in cui Secret Manager archivia il token di accesso dell'Authorizer.
   • AUTHORIZER_SECRET_DATA: il token di accesso dell'Authorizer.
   • READ_SECRET_NAME: un nome per il secret in cui Secret Manager archivia il token di accesso in lettura.
   • READ_SECRET_DATA: il token di accesso in lettura.

3. Esegui il gcloud developer-connect connections create comando per creare una connessione a 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
   

   Sostituisci quanto segue:

   • CONNECTION_NAME: un nome per la connessione.
   • REGION: la regione da utilizzare per la connessione.
   • PROJECT_ID: il tuo Google Cloud ID progetto.
   • AUTHORIZER_SECRET_NAME: il nome del secret di Secret Manager che contiene il token a livello di Authorizer di Bitbucket Cloud.
   • READ_SECRET_NAME: il nome del secret di Secret Manager che contiene il token di sola lettura di Bitbucket Cloud.
   • WEBHOOK_SECRET_NAME: il nome del secret di Secret Manager che contiene il secret webhook.
   • VERSION: il numero di versione di ogni secret. Può essere latest per utilizzare il numero di versione più recente.
   • --git-proxy-config-enabled: un flag facoltativo che consente a Developer Connect di fungere da proxy per le chiamate Git a Bitbucket Cloud. Questa funzionalità è in anteprima.

   Developer Connect completa la connessione a Bitbucket Cloud. Ora, crea un link ai repository.

Crea un link ai repository utilizzando una connessione esistente

Una volta stabilita una connessione a Bitbucket Cloud, puoi creare un link ai repository. Puoi ripetere questi passaggi in un secondo momento per collegare altri repository, se necessario.

Per creare link ai repository su una connessione Bitbucket Cloud esistente, seleziona una delle seguenti opzioni:

Console

Crea link ai repository completando i seguenti passaggi:

1. Apri la pagina Repository nella Google Cloud console.

   Apri la pagina Repository

2. Fai clic su Collega repository.

   Si apre il riquadro Collega repository Git.

3. Nell'elenco delle connessioni, scegli una connessione.

4. Fai clic su Continua.

5. Nell'elenco dei repository, seleziona quelli a cui vuoi creare un link.

   Developer Connect mostra i nomi suggeriti per le risorse del repository.

6. Seleziona un'opzione di denominazione delle risorse del repository:

   • Generato: utilizza i nomi delle risorse del repository generati.
   • Manuale: inserisci i nomi che preferisci.

7. Fai clic su Crea.

   Developer Connect crea i link ai repository e li visualizza in the Google Cloud console.

gcloud

Crea un link al repository Bitbucket Cloud eseguendo il comando seguente:

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

Sostituisci quanto segue:

• REPO_NAME: un nome per il nuovo link tra Developer Connect e il repository Bitbucket Cloud.
• REPO_URI: l'URL del repository in Bitbucket Cloud, inclusi il prefisso https:// e il suffisso .git.
• CONNECTION_NAME: il nome della connessione a Bitbucket Cloud.
• REGION: la regione della connessione.

Developer Connect crea i link ai repository.

Per elencare i repository collegati, esegui il developer-connect connections git-repository-linkslist comando.

Se stai configurando Gemini Code Assist, continua la procedura seguendo i passaggi descritti in Configurare e utilizzare la personalizzazione del codice di Gemini Code Assist.

Passaggi successivi

• Completa la configurazione della personalizzazione del codice di Gemini Code Assist.
• Scopri come Gemini Code Assist ti aiuta ad accelerare lo sviluppo di software.
• Esplora altre integrazioni disponibili tramite Developer Connect.