Queste istruzioni sono destinate agli sviluppatori di applicazioni, agli amministratori della piattaforma e ai 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 scoprire di più su Developer Connect, consulta la panoramica di Developer Connect.
Prima di iniziare
-
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, Secret Manager APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
Assicurati di avere accesso a un account su Bitbucket Cloud.
Per contribuire a proteggere il lavoro del tuo team, ti consigliamo di completare le attività di questa guida utilizzando un account bot o un account condiviso dal tuo team, non un account personale.
- Assicurati di possedere un Bitbucket Cloud repository o di disporre delle autorizzazioni di livello amministratore su un repository condiviso.
- (Facoltativo) Crea una chiave di crittografia gestita dal cliente (CMEK) per criptare i secret di autenticazione creati da Developer Connect.
- (Facoltativo) Per utilizzare le istruzioni della riga di comando in questa guida, completa i seguenti passaggi:
- Installa Google Cloud CLI. Se hai già installato gcloud CLI, assicurati di avere l'ultima versione disponibile eseguendo
gcloud components update. - Crea un service account Developer Connect
eseguendo questo comando, dove PROJECT_ID è il tuo ID progettoGoogle Cloud :
gcloud beta services identity create \ --service=developerconnect.googleapis.com \ --project=PROJECT_ID
- Installa Google Cloud CLI. Se hai già installato gcloud CLI, assicurati di avere l'ultima versione disponibile eseguendo
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 Project Owner:
Developer Connect Admin (
roles/developerconnect.admin) sul tuo account utente. -
Se prevedi di utilizzare una CMEK per criptare i secret creati da Developer Connect:
Cloud KMS CryptoKey Encrypter/Decrypter (
roles/cloudkms.cryptoKeyEncrypterDecrypter) sul service account Secret Manager. -
Se prevedi di utilizzare gcloud CLI per completare i passaggi di questa guida:
Ruolo Amministratore Secret Manager (
roles/secretmanager.admin) per il service account Developer Connect. -
Se prevedi di utilizzare la console Google Cloud per completare i passaggi di questa guida:
Project IAM Admin (
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.
Crea token di accesso
Crea token di accesso personale in Bitbucket Cloud completando i seguenti passaggi:
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.
Scegli le istruzioni per il tipo di token di accesso che utilizzerai:
Crea il primo token con i seguenti ambiti:
- Repository: lettura.
- Richieste di pull: lettura.
- Webhook: lettura e scrittura.
In Developer Connect, questo è chiamato token di accesso dell'autorizzatore.
Crea il secondo token con il seguente ambito:
- Repository: lettura.
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 fino alla revoca.
Alcuni tipi di token Bitbucket sono funzionalità premium disponibili esclusivamente nei piani a pagamento. Per ulteriori informazioni, consulta Token Bitbucket Cloud.
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 console Google Cloud , puoi anche iniziare ad aggiungere link ai repository mentre completi la configurazione della connessione.
Per creare una nuova connessione Bitbucket Cloud, seleziona una delle seguenti opzioni:
Console
Avvia una connessione completando i seguenti passaggi:
Nella console Google Cloud , apri Developer Connect.
Developer Connect visualizza la pagina Repository Git.
- Se vedi un elenco di provider di gestione del codice sorgente: inizia a configurare la tua prima connessione selezionando un provider di gestione del codice sorgente. Fai clic su Connetti nella scheda Bitbucket Cloud.
Se vedi una tabella con l'elenco delle connessioni esistenti: imposta il provider di gestione del codice sorgente facendo clic su Crea connessione > Bitbucket Cloud.
Viene visualizzata la pagina Crea connessione.
In Regione, scegli una regione per le risorse di connessione.
- In Nome, inserisci un nome per la nuova connessione.
In Workspace, inserisci l'ID del tuo workspace Bitbucket Cloud.
Nella sezione Token di accesso, inserisci i token di accesso di Bitbucket Cloud:
- Token di accesso dell'Authorizer: inserisci il tuo token di accesso dell'Authorizer.
- Token di accesso in lettura: inserisci il tuo token di accesso in lettura.
Fai clic su Mostra altro per visualizzare le impostazioni di configurazione facoltative.
(Facoltativo) Nella sezione Crittografia, seleziona una chiave CMEK per criptare i secret di Secret Manager creati da Developer Connect.
(Facoltativo) Per impostazione predefinita, Developer Connect può agire come proxy per le chiamate Git a Bitbucket Cloud. Per disattivare questa opzione, deseleziona la casella di controllo Abilita proxy Developer Connect.
Per completare la configurazione della connessione, fai clic sul pulsante Continua.
Developer Connect crea la connessione. Questo processo può richiedere alcuni secondi.
Una volta creata la connessione, viene visualizzata la pagina Collega repository.
Per collegare i repository alla connessione, completa i seguenti passaggi:
Nell'elenco dei repository disponibili, seleziona quelli che vuoi utilizzare.
Fai clic su OK.
Fai clic su Collega.
La connessione viene aggiunta alla pagina Connessioni e i link al repository vengono aggiunti alla pagina Repository nella console Google Cloud . Puoi aggiungere altri link ai collegamenti esistenti in qualsiasi momento.
Se stai configurando Gemini Code Assist, continua il processo seguendo i passaggi descritti in Configura e utilizza la personalizzazione di codice di Gemini Code Assist.
gcloud
Crea un secret webhook in Secret Manager eseguendo il seguente comando, dove WEBHOOK_SECRET_NAME è un nome per il secret webhook:
cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAMEArchivia i tuoi token di accesso personale 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 tuo token di accesso dell'autorizzatore.
- AUTHORIZER_SECRET_DATA: il tuo token di accesso dell'autorizzatore.
- READ_SECRET_NAME: un nome per il secret in cui Secret Manager archivia il tuo token di accesso in lettura.
- READ_SECRET_DATA: il tuo token di accesso in lettura.
Esegui il comando
gcloud developer-connect connections createper 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-enabledSostituisci 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 autorizzatore 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 del webhook.
- VERSION: il numero di versione di ogni secret. Può essere
latestper utilizzare il numero di versione più recente. --git-proxy-config-enabled: un flag facoltativo che consente a Developer Connect di agire come proxy per le chiamate Git a Bitbucket Cloud.
Developer Connect completa la connessione a Bitbucket Cloud. Poi, collega i repository.
Collega ai repository utilizzando una connessione esistente
Una volta stabilita una connessione a Bitbucket Cloud, puoi collegarti 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 i link ai repository completando i seguenti passaggi:
Apri la pagina Repository nella console Google Cloud .
Fai clic su Collega repository.
Si apre il riquadro Collega repository Git.
Nell'elenco delle connessioni, scegli una connessione.
Fai clic su Continua.
Nell'elenco dei repository, seleziona quelli a cui vuoi collegarti.
Developer Connect mostra i nomi suggeriti per le risorse del repository.
Seleziona un'opzione di denominazione delle risorse del repository:
- Generati: utilizza i nomi delle risorse repository generati.
- Manuale: inserisci i nomi che preferisci.
Fai clic su Crea.
Developer Connect crea i link al repository e li visualizza nella console Google Cloud .
gcloud
Crea un link al tuo repository Bitbucket Cloud eseguendo questo comando:
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 collegamento tra Developer Connect e il tuo repository Bitbucket Cloud.
- REPO_URI: l'URL del tuo 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 al repository.
Per elencare i repository collegati, esegui il comando developer-connect connections git-repository-linkslist.
Se stai configurando Gemini Code Assist, continua il processo seguendo i passaggi descritti in Configura e utilizza la personalizzazione di codice di Gemini Code Assist.