Tutorial

Creare un commit e una pull request con Bob

Usa Bob per creare un branch, preparare le modifiche, generare un messaggio di commit, fare push nel tuo repository e aprire una pull request.

Bob ha supporto integrato per il controllo di versione Git e ti permette di gestire le modifiche al codice senza uscire dall'IDE.

In questo tutorial, usi Bob per creare un branch, preparare modifiche al codice, generare un messaggio di commit descrittivo, fare push delle modifiche nel tuo repository e aprire una pull request che puoi revisionare e mergeare.

Prerequisiti

Configurare il progetto

Prepara una copia di lavoro del repository.

Fare fork del repository

Lavorerai da un fork del repository Galaxium Travels.

  1. Vai al repository Galaxium Travels su GitHub.
  2. Clicca sul pulsante Fork nell'angolo in alto a destra della pagina.
  3. Seleziona il tuo account GitHub come proprietario del fork.

Per saperne di più sul fork di un repository, consulta la documentazione di GitHub sul fork di un repository.

Clonare il repository

  1. In un terminale, clona il repository Galaxium Travels di cui hai fatto il fork. Sostituisci <your-id> con il tuo nome utente GitHub nel seguente comando:

    git clone git@github.com:<YOUR_ID>/galaxium-travels.git

Se ottieni un errore di autenticazione, assicurati di aver aggiunto la tua chiave SSH all'ssh-agent. Consulta la documentazione di GitHub per ulteriori informazioni.

  1. In Bob, clicca su File poi su Apri cartella.

  2. Naviga alla directory galaxium-travels che hai appena clonato e aprila.

Passare alla modalità Agent

Se l'interfaccia chat di Bob non è già aperta, aprila cliccando sull'icona Bob accanto alla barra di navigazione o usa la scorciatoia Option + Command + B (Mac) o Ctrl + Alt + B (Windows).

Pannello chat di Bob aperto in IBM Bob IDE

Usa la modalità Agent in modo che Bob possa scrivere e modificare codice, eseguire comandi Git e guidarti nel workflow. Bob chiede comunque il permesso prima di ogni operazione a meno che non sia esplicitamente consentito.

Clicca sul menu a discesa del selettore di modalità nella chat agente e seleziona Agent, o digita /agent nella chat.

Creare un branch

Prima di apportare modifiche, crea un branch di feature in modo che il tuo lavoro rimanga separato da main.

Esegui il seguente prompt:

Crea e passa a un nuovo branch chiamato update-header.

Bob richiede il permesso di eseguire git checkout -b update-header.

Clicca su Approva per l'attività per creare il branch e passarvi.

Apportare una modifica al codice

Apporta una piccola modifica per dare a Bob qualcosa da committare.

Aprire il componente Header

Nel codebase di Galaxium Travels, apri booking_system_frontend/src/components/layout/Header.tsx.

Modificare il testo dell'header

Chiedi a Bob di apportare la modifica da Galaxium Travels a Galaxium Travel Agency. Il prefisso @ aggiunge un file al contesto di Bob in modo che sappia esattamente quale file modificare.

Cambia il nome dell'Header da `Galaxium Travels` a `Galaxium Travel Agency`
in @booking_system_frontend/src/components/layout/Header.tsx

In alternativa, puoi modificare manualmente il file e cambiare Galaxium Travels in Galaxium Travel Agency.

<span className="text-2xl font-bold bg-cosmic-gradient bg-clip-text text-transparent">
    Galaxium Travel Agency
</span>

Eseguire il workflow Git

Usa Bob per preparare, committare, fare push delle modifiche e poi aprire una pull request.

Preparare le modifiche

Esegui il seguente prompt per preparare le modifiche:

Prepara tutte le modifiche che ho fatto per l'aggiornamento del componente header.

Bob ispeziona l'albero di lavoro, identifica i file modificati e richiede il permesso di eseguire git add.

Clicca su Approva per l'attività per consentire a Bob di eseguire il comando.

Committare le modifiche

Esegui il seguente prompt per committare le modifiche preparate:

Committa le modifiche preparate con un messaggio di commit descrittivo che riassuma ciò che è stato aggiunto.

Bob esamina il diff preparato e genera un messaggio di commit che descrive lo scopo e la portata delle modifiche.

Bob mostra un prompt di autorizzazione nell'IDE per eseguire i comandi.

Clicca su Capisco i rischi, poi clicca su Approva per consentire a Bob di eseguire git commit.

Fare push delle modifiche

Esegui il seguente prompt per fare push del tuo commit nel repository remoto:

Fai push delle mie modifiche nel repository remoto.

Bob identifica il branch corrente e il remoto, poi richiede il permesso di eseguire git push.

Clicca su Approva per l'attività per fare push del commit. Bob conferma nella history della chat che il push è riuscito.

Aprire una pull request

Esegui il seguente prompt per creare una pull request:

Crea una pull request per mergeare le mie modifiche nel branch main. Scrivi un titolo e una descrizione chiari basati su ciò che è stato modificato.

Bob richiede l'autenticazione GitHub la prima volta che crei una pull request. Bob apre una finestra del browser per autorizzare l'accesso. Una volta autorizzato, Bob apre la pull request. Clicca sul link fornito per accedere alla pull request nel tuo browser. Dopo aver revisionato il titolo e la descrizione, clicca su Crea pull request.

Bob restituisce l'URL della pull request in modo che tu possa revisionarla, condividerla o mergearla direttamente dal tuo browser.

Per fare in modo che Bob crei pull request senza una finestra di conferma, installa il GitHub CLI e chiedi a Bob di usarlo per creare pull request.

Risoluzione dei problemi

  • Push rifiutato o autenticazione fallita: Conferma che Git è configurato con credenziali che possono fare push nel tuo fork.
  • Il branch update-header esiste già: Chiedi a Bob di passare al branch esistente o scegli un altro nome di branch.
  • La pull request punta a IBM/galaxium-travels: Cambia il repository di base nel tuo fork prima di creare la pull request.

Pulizia

Dopo aver completato questo tutorial, puoi rimuovere le risorse che hai creato:

  • Torna al branch main nel tuo clone locale.
  • Chiudi o mergea la pull request su GitHub.
  • Elimina il branch update-header dal tuo fork.
  • Elimina il tuo fork di Galaxium Travels se non ne hai più bisogno.

Prossimi passi

In questo tutorial, hai imparato a usare l'integrazione Git nativa di Bob per gestire le modifiche al codice senza uscire dall'IDE.

Passa a Standardizzare il comportamento di Bob per imparare a definire regole persistenti che controllano il comportamento di Bob in ogni conversazione e modalità.

Come valuti questo argomento?