Scopri di più sulla revisione del codice in Bitbucket Cloud

Obiettivo

Crea un repository e aggiungi un revisore alla tua pull request per iniziare a collaborare sul tuo codice.

Avvertenza: la sezione seguente di questo tutorial descrive i passaggi per aggiungere un revisore (o membro del team) alle pull request, in modo da poter collaborare al codice in Bitbucket Cloud. Se non lavori con altri membri del team o non hai bisogno di aggiungere revisori in questo momento, sentiti libero di passare al prossimo tutorial: Informazioni sul branching in Bitbucket Cloud.

Brief della missione

Finora sei stato l'unica persona a lavorare nei tuoi repository e sul tuo codice. Se tuttavia volessi che qualcuno esaminasse il tuo codice e fornisse un feedback? L'aggiunta di un revisore alla tua pull request ti permette di fare proprio questo, sia che vi troviate nello stesso ufficio, sia che lavoriate agli antipodi.

Informazioni su branch e pull request

Quando lavori in un team con più utenti Bitbucket, ti consigliamo di lavorare sul tuo set di codice separato dal codebase principale. I branch ti permettono di fare proprio questo. Un branch rappresenta una linea indipendente di sviluppo per il repository. Puoi pensare al branch come a una nuova directory di lavoro, un'area di staging e una cronologia di progetto. Dopo aver creato un branch, lavori ed esegui il commit del codice in quel branch, esegui il pull degli aggiornamenti da Bitbucket per mantenerlo aggiornato e poi esegui il push di tutto il tuo lavoro a Bitbucket.

Una volta apportate le modifiche al codice su un branch di Bitbucket, puoi creare una pull request, dove avviene la revisione del codice. I tuoi compagni di team commenteranno il tuo codice con feedback e domande e alla fine (si spera) approveranno la pull request. Quando hai un numero sufficiente di approvazioni, esegui il merge della pull request per unire il branch al codice principale.

Crea un repository Git

Sei appena arrivato alla stazione spaziale Bitbucket ed è ora di seguire il processo di orientamento, parte del quale prevede l'aggiornamento e l'approvazione del tuo pacchetto di benvenuto.

1. Clicca sul + nella barra laterale globale e seleziona Repository (Repository) in Create (Crea).

2. Assicurati che il team che hai creato sia il responsabile del repository.

3. Inserisci il nome del progetto e il nome del repository che desideri. Se non ti viene in mente niente, che ne dici di Pacchetto di benvenuto e Prime impressioni?

4. In Include a README? (Includere un file README?), seleziona una delle opzioni Yes (Sì).

5. In Version control system (Sistema di controllo delle versioni), scegli un'opzione per il tipo di repository che desideri creare. Se non sei sicuro, lascia l'opzione così com'è.

6. Clicca su Create repository (Crea repository) per accedere alla vista Source (Sorgente) del tuo brand, nuovo repository.

7. In Source (Sorgente) seleziona > Add file (Aggiungi file).

8. Assegna al file il nome survey.html, quindi copia questo codice e incollalo nell'area di testo principale.

1\<\!DOCTYPE html>
2<html>
3<head>
4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5 <style media="screen" type="text/css">
6 body {
7 margin: auto;
8 width: 700px;
9 color: #FFFFFF;
10 font-family: Arial, sans-serif;
11 background-color: #172B4D;
12 }
13 body>h1 {
14 margin: 50px;
15 font-size: 50px;
16 text-align: center;
17 color: #0052CC;
18 }
19 </style>
20</head>
21<body>
22 <h1>Team up in space</h1>
23 <p>
24 Welcome to the team! You've made it this far so we know that you've got the potential to do great things. Because you're going to be collaborating with other awesome people, anything you add needs to be code reviewed and approved. That's just how a team works! You should have already created a branch and checked it out locally. If you haven't, go back to the tutorial and do that now. We'll be here.
25 </p>
26 <p>
27 Because you're on your own branch, you can go crazy. Spice up this file any way you like. Add more files to this repository if you see fit. If want to take it slow and are just here to learn about pull requests, you can use this opportunity to fill out our short questionaire.
28 </p>
29 <br>
30 <p>
31 <b>Question 1</b>: Have you used pull requests before?
32 </p>
33 <p>
34 <b>Answer 1</b>: **** Your answer here **** </p>
35 <p>
36 <b>Question 2</b>: Why do you want to learn about code review?
37 </p>
38 <p>
39 <b>Answer 2</b>: **** Your answer here **** </p>
40 <p>
41 <b>Question 3</b>: Who do you plan to work with on Bitbucket? </p>
42 <p>
43 <b>Answer 3</b>: **** Your answer here **** </p>
44</body>
45</html>

9. Clicca su Commit (Esegui commit) e poi di nuovo su Commit (Esegui commit) nella finestra di dialogo.

Il tuo repository ora sembra decisamente valido. Esploralo!

Clonare e apportare una modifica su un nuovo branch

Se sai che aggiungerai dei revisori per esaminare e approvare il codice prima del merge, molto probabilmente avrai già clonato il repository prima di creare un branch. Quindi è quello che faremo prima che tu crei un branch tutto tuo.

Se stai usando la riga di comando

Passaggio 1. Clonazione del repository nel sistema locale

1. Dal repository, clicca sul pulsante Clone (Clona) in alto a destra.Si aprirà la finestra di dialogo Clone this repository (Clona repository). Per impostazione predefinita, la finestra di dialogo relativa alla clonazione imposta il protocollo su HTTPS o su SSH, a seconda delle tue impostazioni. Di conseguenza, non è necessario modificare il protocollo predefinito.

2. Copia il comando clone.

3. Da una finestra del PC, passa alla directory locale in cui desideri clonare il tuo repository.

1$ cd ~/<path_to_directory>

4. Incolla il comando che hai copiato da Bitbucket, ad esempio:

1$ git clone https://breezy@bitbucket.org/powerstars/first-impressions.git
2
3Cloning into 'first-impressions'...
4Password for 'https://breezycloud@bitbucket.org': 
5remote: Counting objects: 6, done.
6remote: Compressing objects: 100% (5/5), done.
7remote: Total 6 (delta 1), reused 0 (delta 0)
8Unpacking objects: 100% (6/6), done.

Per maggiori dettagli, dai un'occhiata al nostro video sulla clonazione per vedere come si fa:

Fase 2. Crea un branch e accedi a livello locale

Ora che il tuo repository è tutto configurato, arriva la parte divertente. Puoi creare branch localmente o tramite Bitbucket. Creiamone uno da Bitbucket per gli scopi di questo tutorial.

1. Clicca su Branches (Branch) nella barra di navigazione a sinistra. Vedrai che hai già un branch: il tuo branch principale main.

2. Clicca su Create a branch (Crea branch) nell'angolo in alto a destra.

3. Dopo aver creato un branch, devi verificarlo nel sistema locale. Bitbucket ti fornisce un comando di fetching e verifica che puoi copiare e incollare nella riga di comando, simile al seguente:

1$ git fetch && git checkout my-updates
2
3Password for 'https://breezycloud@bitbucket.org': 
4From https://bitbucket.org/planetbreezycloud/first-impressions
5 * [new branch]      my-updates -> origin/my-updates
6Branch 'my-updates' set up to track remote branch 'my-updates' from 'origin'.
7Switched to a new branch 'my-updates'

Come puoi vedere, sei passato al nuovo branch locale, permettendoti di gestire ed eseguire il push di quella riga di codice separata.

Fase 3. Apporta modifiche al branch

Ora tocca a te apportare modifiche al tuo repository. Spetta a te scegliere se rendere le cose più o meno complesse. Cambia il CSS. Aggiungi altri file. Componi un'opera spaziale. O semplicemente, rispondi alle domande.

1. Apri il file survey.html (o comunque tu lo abbia chiamato) con un editor di testo.

2. Apporta le tue modifiche, sostanziali o minime, quindi salva e chiudi il file.

3. Dalla finestra del tuo terminale, dovresti essere ancora nella directory del repository a meno che tu non abbia cambiato qualcosa. Visualizza lo stato del repository con git status. Dovresti vedere il file survey.html che hai modificato. Se hai aggiunto o modificato altri file, vedrai anche quelli.

1$ git status
2On branch my-updates
3Your branch is up-to-date with 'origin/my-updates'.
4Changes not staged for commit:
5  (use "git add <file>..." to update what will be committed)
6  (use "git checkout -- <file>..." to discard changes in working directory)
7        modified:   survey.html
8no changes added to commit (use "git add" and/or "git commit -a")

4. Aggiungi le tue modifiche localmente con git add:

1$ git add survey.html

5. Conferma le modifiche localmente con git commit -m "messaggio di commit":

1$ git commit -m "Answered questions"
2[my-updates 7506040] Answered questions
3 1 file changed, 3 insertions(+), 3 deletions(-)

6. Inserisci git push origin per eseguire il push delle modifiche al tuo branch su Bitbucket e inserisci la tua password per completare l'invio delle modifiche.

1$ git push origin my-updates
2
3Password for 'https://breezycloud@bitbucket.org': 
4
5Counting objects: 3, done.
6
7Delta compression using up to 8 threads.
8
9Compressing objects: 100% (3/3), done.
10
11Writing objects: 100% (3/3), 350 bytes | 350.00 KiB/s, done.
12
13Total 3 (delta 1), reused 0 (delta 0)
14
15To https://bitbucket.org/planetbreezycloud/first-impressions.git
16
17   454ccaf..7506040  my-updates -> my-updates
18
19Branch main set up to track remote branch main from origin.

7. Da Bitbucket, clicca sulla pagina Source (Sorgente) del repository. Dovresti vedere entrambi i branch nel menu a discesa. Qualsiasi altro commit che esegui per il branch "my-updates" apparirà anche in quel branch.

Se stai usando Sourcetree

Passaggio 1. Clonazione del repository nel sistema locale

Inseriamolo nel tuo sistema locale in modo che tu possa iniziare realmente a lavorarci.

1. Dal repository, clicca sul + nella barra laterale globale e seleziona Clone this repository (Clona questo repository) in Get to work (Mettiamoci al lavoro).

2. Clicca sul pulsante Clone in Sourcetree (Clona in Sourcetree ).

3. Dalla finestra Clone New (Clona nuovo), aggiorna il percorso di destinazione in <path_to_repo_directory>/first-impressions/.

4. Clicca sul pulsante Clone (Clona). 

Per vedere come si fa, dai un'occhiata alla parte Clonare un repository del nostro video qui:

Fase 2. Crea un branch e accedi a livello locale

Ora che il tuo repository è tutto configurato, arriva la parte divertente. Poiché i branch non sono solo un concetto di Bitbucket, puoi crearne uno a livello locale. Creiamone uno da Bitbucket per gli scopi di questo tutorial.

1. Clicca su Branches (Branch) nella barra di navigazione a sinistra. Vedrai che hai già un branch, quello principale.

2. Clicca su Create a branch (Crea branch) nell'angolo in alto a destra.

3. Inserisci un nome per il branch (Branch name) e clicca su Create (Crea). Se non sai come denominare il branch, scegli qualcosa del tipo "my-updates".

4. Dopo aver creato un branch, devi verificarlo nel sistema locale. Per farlo, clicca sul pulsante Check-out in Sourcetree (Verifica in Sourcetree).

5. Dalla finestra di dialogo Checkout Existing (Verifica branch esistente) in Sourcetree, clicca su Checkout (Verifica).

Ora hai un branch in Bitbucket che è stato trasferito nel tuo sistema locale, permettendoti di gestire ed eseguire il push di quella riga di codice separata.

Fase 3. Apporta modifiche al branch

Ora tocca a te apportare modifiche al tuo repository. Spetta a te scegliere se rendere le cose più o meno complesse. Cambia il CSS. Aggiungi altri file. Componi un'opera spaziale. O semplicemente, rispondi alle domande.

1. Dal repository di Sourcetree, clicca sul pulsante Show in Finder (Mostra nel Finder).

2. Apri il file survey.html (o comunque tu lo abbia chiamato) con un editor di testo.

3. Apporta le tue modifiche, sostanziali o minime, quindi salva e chiudi il file.

4. Apri Sourcetree; come puoi notare, nel repository sono presenti modifiche senza commit.

5. (Solo Git) Aggiungi il file all'area staging:

     1. Seleziona la riga Uncommitted changes (Modifiche senza commit).

     2. Dall'elenco Unstaged files (File senza staging), metti un segno di spunta accanto al file survey.html e a ogni altro file con modifiche senza commit.

      3. Dalla finestra di dialogo Confirm Stage? (Confermare la fase?) clicca su OK.

6. Clicca sul pulsante Commit (Esegui commit) in alto per eseguire il commit del file.

7. Inserisci un messaggio di commit nell'apposito spazio, del tipo Risposta data.

8. Clicca sul pulsante Commit (Esegui commit) sotto la casella del messaggio. Quando torni alla visualizzazione, vedrai che il file è stato salvato ma non inviato al repository Bitbucket.

9. In Sourcetree, clicca sul pulsante Push (Esegui push) per eseguire il push delle modifiche sottoposte a commit.

10. Dalla finestra di dialogo che appare, clicca su OK per eseguire il push del branch con il commit a Bitbucket.

11. Da Bitbucket, clicca sulla pagina Source (Sorgente) del repository. Dovresti vedere entrambi i branch nel menu a discesa. Qualsiasi altro commit che esegui per il branch "my-updates" apparirà anche in quel branch.

Crea una pull request ed esegui il merge delle modifiche

Per aggiungere revisori che controllino e approvino il tuo codice prima del merge, il passaggio successivo consiste nel creare una pull request. Oltre a uno spazio per la revisione del codice, una pull request mostra un confronto tra le modifiche apportate e il repository originale (noto anche come diff) e fornisce un modo semplice per eseguire il merge del codice quando è pronto.

Fase 1. Crea la pull request

Seleziona un branch per creare una pull request. Per fortuna ne hai già uno.

1. Nel repository, clicca sul segno + nella barra laterale globale. Quindi, clicca su Create a pull request (Crea una richiesta pull) in Get to work (Mettiamoci al lavoro).

Bitbucket visualizza il modulo richiesta.

2. Compila il modulo:

    1. Hai già un titolo automatico (Title), il tuo ultimo messaggio di commit.

    2. Aggiungi una descrizione (Description), se preferisci.

(Facoltativo - aggiunta di un revisore) Se hai bisogno di qualcuno che riveda e/o approvi il tuo codice prima del merge, aggiungilo nel campo Reviewers (Revisori). Come puoi vedere, Breezy Cloud è stato aggiunto come revisore all'esempio di pull request qui sotto.

Per aggiungere un revisore a una pull request, devi prima concedere all'utente l'accesso al tuo repository aggiungendolo a un gruppo. Per ulteriori informazioni e passaggi dettagliati, fai riferimento a quanto segue: Concedere l'accesso al repository a utenti e gruppi. Nota: puoi sempre creare la pull request e aggiungere revisori in un secondo momento.

Al termine, il modulo avrà un aspetto simile a questo:

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

Fase 2. Esegui il merge della pull request

Non così in fretta. Avrai notato il pulsante Merge in alto. Prima di cliccare, devi attendere l'approvazione delle tue modifiche. Oltre alla notifica via email ricevuta, i colleghi del team vedranno anche la pull request apparire nella sezione Pull requests to review (Pull request da esaminare) nella dashboard Your work (Il tuo lavoro).

Dalla pull request, il revisore può visualizzare il diff e aggiungere commenti per avviare una discussione prima di cliccare sul pulsante Approve (Approva).

Quando qualcuno approva la tua pull request, riceverai una notifica via email. Una volta ottenute le approvazioni di cui hai bisogno (in questo caso solo una), potrai procedere al merge. Dalla pull request, clicca su Merge. Fatto! Se vuoi vedere che cosa accade quando il branch è sottoposto a merge con il branch principale, clicca su Commit per vedere l'albero di commit.