IBM Cloud Docs
Configurazione di Bitbucket

Configurazione di Bitbucket

Memorizzate il vostro codice sorgente in un repository (repo) nuovo o esistente su bitbucket.org e partecipate al social coding attraverso wiki, issue tracking e pull request.

Configura Bitbucket per collaborare sul codice con il tuo team:

  1. Dalla console IBM Cloud, fare clic sull'icona Menu > Automazione piattaforma > Toolchains. Nella pagina Toolchains, fai clic sulla toolchain a cui vuoi aggiungere Bitbucket. In alternativa, nella pagina della panoramica dell'applicazione, nella scheda di fornitura continua, fai clic su View toolchain. Fai quindi clic su Overview.

    a. Fai clic su Add tool.

    b. Nella sezione Integrazioni strumento, fai clic su Bitbucket.

    Se stai configurando questa integrazione dello strumento su IBM Cloud Pubblico e non avevi autorizzato IBM Cloud ad accedere a Bitbucket, fai clic su Authorize per andare al sito web Bitbucket. Se non hai una sessione di Bitbucket attiva, ti viene richiesto di eseguire l'accesso. Fai clic su Grant access per consentire alle toolchain IBM Cloud di accedere alle seguenti parti del tuo account Bitbucket:

    • Leggi le informazioni del tuo account. Ottieni le informazioni sull'utente di base per popolare l'interfaccia utente.

    • Leggi e modifica i problemi dei tuoi repository. Consenti a Continuous Delivery di aggiornare i problemi per indicare quando la pipeline distribuisce i commit collegati a tali problemi.

    • Leggi le impostazioni del progetto del tuo team e leggi i repository contenuti nei progetti del tuo team. Consenti a Continuous Delivery di integrarsi con i repository gestiti dai team.

    • Leggi e modifica i tuoi repository e le rispettive richieste di pull. Consenti a Continuous Delivery di eseguire il push del codice nei repository, quando gli utenti richiedono il codice.

    • Gestisci i tuoi repository. Consenti a Continuous Delivery di creare nuovi repository, quando richiesto dagli utenti.

    • Leggi le informazioni di appartenenza al tuo team. Consenti a Continuous Delivery di mostrare un elenco dei tuoi team nel menu Owner visualizzato quando crei un nuovo repository.

    • Leggi e modifica i webhook dei tuoi repository. Consenti alla pipeline di attivare le build quando viene eseguito il push dei commit a un repository.

    Se hai una sessione di Bitbucket attiva ma non avevi immesso la tua password recentemente, ti potrebbe essere richiesto di immettere la tua password Bitbucket per la conferma.

  2. Fai clic sul server Bitbucket che vuoi utilizzare.

  3. Se hai un repository Bitbucket che vuoi utilizzare, immetti l'URL per il repository. Per il tipo di repository, fai clic su Existing.

  4. Se desideri utilizzare un nuovo repository Bitbucket, immetti un nome per il repository, digita l'URL per il repository che stai clonando o dividendo e seleziona il tipo di repository:

    a. Per creare un repository vuoto, fai clic su New.

    b. Per creare una copia di un repository, fai clic su Clone.

    c. Per biforcare un repository in modo che sia possibile fornire le modifiche attraverso le richieste di importazione, fai clic su Fork.

  5. Per creare un repository privato sul server, seleziona la casella di spunta Make this repository private.

  6. Per utilizzare Bitbucket Issues per la traccia dei problemi, seleziona la casella di spunta Enable Bitbucket Issues.

  7. Per tracciare la distribuzione delle modifiche del codice creando tag e commenti sui commit, ed etichette e commenti sui problemi a cui fanno riferimento i commit, seleziona la casella di spunta Track deployment of code changes. Per ulteriori informazioni, vedere Tracciamento della distribuzione del codice con le toolchain.

  8. Fai clic su Crea integrazione.

  9. Dalla tua toolchain, sulla scheda Strumenti di terze parti, fai clic sull'integrazione dello strumento Bitbucket per il repository Bitbucket con cui vuoi lavorare. Si apre il sito web Bitbucket, dove puoi visualizzare il contenuto del repository.

  10. Se hai abilitato Problemi Bitbucket, fai clic su Bitbucket Issues per aprirlo. Puoi utilizzare questa istanza dei problemi Bitbucket per la toolchain completa, anche se la toolchain contiene più repository Bitbucket.

Se non hai i privilegi Proprietario o Master per il repository a cui sei collegato, la tua integrazione è limitata perché non puoi utilizzare un webhook. I webhook sono richiesti per eseguire automaticamente una pipeline quando si esegue il push di un commit al repository. Senza un webhook, devi avviare le tue pipeline manualmente.

Configurazione di Bitbucket utilizzando l'API

L'integrazione dello strumento Bitbucket supporta i seguenti parametri di configurazione che puoi utilizzare con le integrazioni dello strumento Toolchain HTTP API e SDK quando crei, leggie aggiorna.

È necessario specificare la proprietà tool_type_id nel corpo della richiesta con il valore bitbucketgit.

Parametri di integrazione dello strumento Bitbucket
Parametro Utilizzo Immettere Argomento Terraform Descrizione
url root API facoltativo, aggiornabile Stringa url root API L'URL dell'API Bitbucket, come https://api.bitbucket.org.
diramazione predefinita facoltativo, aggiornabile Stringa diramazione predefinita Il nome del ramo predefinito, ad esempio main.
enable_traceability facoltativo, aggiornabile, " Default: false Booleano enable_traceability Impostare questo valore su 'true per tracciare la distribuzione delle modifiche al codice creando tag, etichette e commenti su commit, richieste di pull e problemi referenziati.
id_git facoltativo, immutabile Stringa id_git Imposta questo valore su bitbucketgit per bitbucket.orgo sul GUID di un server Bitbucket personalizzato.
has_issues facoltativo, aggiornabile, " Default: true Booleano toolchain_issues_enabled Imposta questo valore su true per abilitare i problemi sul repository Bitbucket e per aggiungere una scheda dello strumento Issues alla toolchain. Imposta questo valore su false per rimuovere la scheda di integrazione dello strumento dalla toolchain. Questa impostazione non influisce se i problemi sono abilitati sul repository Bitbucket stesso.
proprietario_integrazione facoltativo, aggiornabile Stringa proprietario_integrazione L'utente che effettua operazioni Git.
id_proprietario facoltativo, immutabile Stringa id_proprietario L'utente o il gruppo Bitbucket che possiede il repository. Questo parametro è obbligatorio quando crei un repository o cloni o biforca un repository. Questo valore viene calcolato quando ti colleghi a un repository esistente.
repo privato opzionale, immutabile, " Default: false Booleano repo privato Imposta questo valore su true per rendere il repository privato quando crei un repository o quando cloni o biforchi un repository. Questo parametro non viene utilizzato quando ti colleghi a un repository esistente.
id_repo facoltativo, immutabile Stringa id_repo L'ID del repository Bitbucket.
repo_name facoltativo, immutabile Stringa repo_name Il nome del repo Bitbucket da creare. Questo parametro è obbligatorio quando crei un repository o cloni o biforca un repository. Questo valore viene calcolato quando ti colleghi a un repository esistente.
repo_url facoltativo, immutabile Stringa repo_url L'URL del repository Bitbucket per questa integrazione dello strumento. Questo parametro è obbligatorio quando ti colleghi a un repository esistente. Questo valore viene calcolato quando crei un repository o cloni o biforca un repository.
url_repo_origine facoltativo, immutabile Stringa url_repo_origine L'URL del repository che vuoi duplicare o clonare. Questo parametro è obbligatorio quando esegui il fork o la clonazione di un repository, ma non viene utilizzato quando crei un repository o un link a un repository esistente.
url_token facoltativo, aggiornabile Stringa url_token L'URL del token utilizzato per autorizzare con il server Bitbucket.
Immettere richiesto, immutabile Stringa Immettere L'operazione da eseguire per inizializzare la nuova integrazione dello strumento. Utilizza new per creare un repository Git, clone per clonare un repository esistente in un nuovo repository Git, fork per biforcare un repository Git esistente o link per collegarlo a un repository Git esistente.

Ulteriori informazioni su Bitbucket

Per ulteriori informazioni su Bitbucket, vedi le risorse Bitbucket Cloud.