Migliorare il codice con Bitbucket: 4 passaggi iniziali

Iniziamo.

Passaggio 1: Inserire il codice in Bitbucket

I repository (per gli amici "repo") sono il luogo in cui si trova il codice in Bitbucket. Ci sono modi diversi per iniziare, a seconda delle esigenze:

Iniziare da zero

Creare un repository vuoto

1. Clicca su + nella barra laterale globale a sinistra e, in Create new (Crea nuovo), seleziona Repository.

2. Assegna un nome al repository. Questo è un passaggio importante perché il nome del repository verrà incluso nel suo URL.

3. Imposta l'opzione Include a README? (Includere un file LEGGIMI?) su Yes, with a template (Sì, con un modello).

4. Puoi lasciare il resto delle impostazioni predefinite, quindi cliccare su Create (Crea).

Da un altro provider

Importare un repository da un altro provider di Git

1. Clicca su + nella barra laterale globale a sinistra e, in Import (Importa), seleziona Repository.

2. Inserisci l'URL da cui è possibile accedere al repository.

3. Se per il repository è richiesta l'autorizzazione, seleziona Requires authorization (Autorizzazione richiesta) e inserisci le credenziali di accesso.

4. Assegna un nome al repository. Questo è un passaggio importante perché il nome del repository verrà incluso nel suo URL.

5. Puoi lasciare il resto delle impostazioni predefinite, quindi cliccare su Import repository (Importa repository).

Passaggio 2: Configurazione locale, collaborazione globale

Clonare un repository di Bitbucket

1. Clicca su + nella barra laterale globale a sinistra e, in Get to work (Mettiamoci al lavoro), seleziona Clone this repository (Clona questo repository).

2. Seleziona HTTPS nel menu in alto a destra (a meno che tu non abbia già configurato le chiavi SSH).

3. Copia il comando clone.

Dalla CLI

• Effettua la modifica in base alla directory in cui desideri clonare il repository. cd

• Incolla il comando git clone copiato da Bitbucket (qualcosa di simile a questo): git clone https://username@bitbucket.org/teamsinspace/documentation-test.git

Nell'unità locale viene visualizzata una nuova sottodirectory con lo stesso nome del repository che hai clonato. Se hai clonato un repository vuoto, questa directory locale potrebbe essere ancora vuota. 

Modificare un file in Bitbucket online

Un attimo, non ho nessun file in Bitbucket...

Hai saltato il passaggio facoltativo di aggiunta del file LEGGIMI al repository di Bitbucket? Non c'è problema! Se il repository è ancora vuoto, vai al repository e creane uno adesso cliccando su Create a README (Crea un file LEGGIMI). Adesso il repository non è più vuoto, ma contiene un elemento da clonare.

Eseguire il pull degli aggiornamenti da Bitbucket

Dalla CLI

1. Effettua la modifica in base alla directory in cui desideri clonare il repository. cd

2. Incolla il comando copiato da Bitbucket (qualcosa di simile a questo): git clone

Hai scaricato le modifiche apportate a questi file sul sistema locale.

Passaggio 3: Nozioni di base sulla creazione di branch con Bitbucket

La creazione di branch consente a ciascun membro del team di lavorare contemporaneamente su elementi diversi senza interferire con la codebase originale o con il lavoro degli altri colleghi. Quando è il momento di eseguire il merge delle modifiche, esegui il push del branch su Bitbucket per fare in modo che venga rivisto in una richiesta pull.

Ci sono diversi modi per creare i branch, quindi scegli il più adatto in base alle esigenze del tuo team.

Creare un branch

Da Bitbucket (opzione più facile)

1. Dal repository, clicca su + nella barra laterale globale e, in Get to work (Mettiamoci al lavoro), seleziona Create a branch (Crea un branch).

2. Nel pop-up visualizzato, seleziona un tipo (se usi il modello di branch), inserisci un nome del branch e clicca su Create (Crea).

Dalla CLI

1. In seguito alla creazione, esegui git fetch e recupera ed estrai il branch dal tuo sistema locale. In Bitbucket verrà visualizzato automaticamente il comando necessario, che avrà su per giù questo aspetto: git fetch && git checkout

2. Apporta le modifiche in locale e successivamente aggiungi ed esegui il commit e il push delle modifiche sul branch:

   git add .

   git commit -m "adding a change from the feature branch"git push origin

3. Clicca sulla pagina Source (Origine) del repository. Dovresti vedere sia il branch main sia l'altro branch in un menu a discesa

Dalla CLI

Dalla CLI, all'interno della directory del repository locale

1. Crea un branch con il comando Git branch.

2. Elenca i branch per questo repository. Vedrai il branch main predefinito e il nuovo branch creato. 

3. Dai un'occhiata al branch.

4. Esegui il push del nuovo branch su Bitbucket. 

Adesso, andiamo a Bitbucket per vedere il branch.

1. Vai al repository. 

2. Clicca su Branches (Branch).

Da Jira

Per eseguire questa azione, devi disporre dell'accesso a Jira Software Cloud, che deve essere integrato con Bitbucket. A questo scopo ti serviranno le autorizzazioni di amministratore, ma se vuoi soltanto provare l'integrazione per vedere come funziona, puoi sempre registrarti alla prova gratuita di Jira Software Cloud.

Consulta Connettere Bitbucket Cloud a Jira Software Cloud per istruzioni sull'integrazione dei due prodotti una volta configurato il tuo sito Jira.

Passaggio 4: Rivedere le modifiche del codice con una pull request

Dopo avere eseguito il push su Bitbucket delle modifiche apportate al codice, è il momento di chiedere a un collega di rivederle. Tramite le pull request, puoi richiedere la revisione del codice e collaborare in un ambiente condiviso con il tuo team in modo semplice ed efficace.

Creare una pull request

1. Dal repository aperto, clicca sul + nella barra laterale globale e, in Get to work (Mettiamoci al lavoro), seleziona Create a pull request (Crea una pull request).

2. Compila il resto del modulo della pull request:

1. Source (Origine): il repository e il branch in cui hai apportato le modifiche al codice di cui intendi eseguire il merge.

2. Destination (Destinazione): il repository e il branch in cui vuoi eseguire il merge.

3. Title e Description (Titolo e Descrizione): li vedrai entrambi nelle notifiche tramite e-mail; il titolo viene visualizzato nell'elenco delle richieste pull.

4. Reviewers (Revisori): scegli i revisori che forniranno un feedback valido e che dovranno approvare le modifiche.

5. Close branch (Chiudi branch): seleziona se chiudere automaticamente il branch dopo il merge della richiesta pull.

6. Diff e Commits (Differenze e Commit): controlla queste schede per vedere le modifiche apportate (differenze) o i commit inclusi.

1. Clicca su Create pull request (Crea pull request).

Puoi vedere questa pull request dall'elenco corrispondente nella navigazione laterale del repository.

Rivedere una pull request

In qualità di revisore, riceverai una notifica quando è presente una richiesta pull da rivedere. Puoi trovare le richieste pull aperte anche nella scheda Pull requests (Richieste pull) della dashboard. Esistono tanti modi diversi per rivedere il codice per il controllo qualità, e quello scelto dal tuo team dipende interamente da te. Ecco alcune modalità per comunicare in modo efficace con i tuoi colleghi per assicurarti che tutti comprendano le modifiche e approvino il merge di una modifica.

Vedere la differenza Quando visualizzi una richiesta pull, vedrai le differenze (le modifiche) di tutti i file modificati nella richiesta pull. Le righe in verde sono quelle che sono state aggiunte, mentre quelle in rosso sono quelle rimosse. Puoi inoltre cliccare sulla scheda Commits (Commit) nella parte superiore di una richiesta pull per vedere i commit inclusi, cosa che può tornarti utile per la revisione di richieste pull di grandi dimensioni.

Lasciare un feedback e porre domande nei commenti In Bitbucket, puoi commentare un'intera richiesta pull, un file specifico o una parte precisa di un file. Questa opzione è utile se desideri fornire il contesto o specificità con il feedback. I commenti possono contenere immagini, link, testo con formattazione, nonché un URL univoco per la condivisione rapida di commenti specifici.

Approvare o rifiutare una richiesta pull Al termine della revisione delle modifiche del codice, devi comunicare all'autore se la sua richiesta pull è pronta per il merge. Clicca sul pulsante Approve (Approva) per inviare una notifica all'autore della richiesta pull e comunicargli che ritieni sia arrivato il momento di eseguire il merge delle modifiche. Se invece rifiuti la richiesta pull, il merge delle modifiche non verrà eseguito. Le richieste pull rifiutate non potranno essere riaperte. Per eseguire il merge del branch dovrai aprire una nuova richiesta pull.

Tieni presente che non è piacevole per l'autore di una pull request quando questa viene rifiutata. Per questo motivo, rifiuta le pull request solo quando le modifiche sono completamente sbagliate o se il lavoro non è più necessario. Ricorda di essere gentile quando rivedi il lavoro dei colleghi e cerca sempre di capire prima di voler essere capito.

Eseguire il merge di una richiesta pull Una volta che il codice è stato rivisto e approvato in una richiesta pull, clicca sul pulsante Merge (Esegui il merge) per eseguire il merge del tuo branch e del branch principale. Le modifiche al codice presenti nel branch di origine sono adesso completamente incorporate nel branch di destinazione.