Use o Bob para criar um branch, preparar mudanças, gerar uma mensagem de commit, fazer push para seu repositório e abrir um pull request.

O Bob tem suporte integrado para controle de versão Git e permite gerenciar suas mudanças de código sem sair do IDE.

Neste tutorial, você usa o Bob para criar um branch, preparar mudanças de código, gerar uma mensagem de commit descritiva, fazer push das mudanças para seu repositório e abrir um pull request que você pode revisar e mergear.

Pré-requisitos

IBM Bob IDE

Baixe e instale o aplicativo IBM Bob no seu computador. Bob é um aplicativo IDE autônomo e não uma extensão.

Git

Instale o Git para clonar o repositório de exemplo.

GitHub

Uma conta do GitHub e um fork do repositório de exemplo Galaxium Travels. Para criar o fork, siga a documentação do GitHub sobre como fazer fork de um repositório. Configure o Git com credenciais que possam fazer push para seu fork.

Autenticação SSH do GitHub

Gere uma chave SSH e adicione-a ao ssh-agent para poder fazer push para seu fork via SSH.

Configurar o projeto

Prepare uma cópia de trabalho do repositório.

Fazer fork do repositório

Você trabalhará a partir de um fork do repositório Galaxium Travels.

Acesse o repositório Galaxium Travels no GitHub.
Clique no botão Fork no canto superior direito da página.
Selecione sua conta do GitHub como proprietária do fork.

Para saber mais sobre como fazer fork de um repositório, consulte a documentação do GitHub sobre fazer fork de um repositório.

Clonar o repositório

Em um terminal, clone o repositório Galaxium Travels do qual você fez fork. Substitua <your-id> pelo seu nome de usuário do GitHub no seguinte comando:
```
git clone git@github.com:<YOUR_ID>/galaxium-travels.git
```

Se você obtiver um erro de autenticação, certifique-se de ter adicionado sua chave SSH ao ssh-agent. Consulte a documentação do GitHub para mais informações.

No Bob, clique em Arquivo e depois em Abrir Pasta.
Navegue até o diretório galaxium-travels que você acabou de clonar e abra-o.

Mudar para o modo Agent

Se a interface de chat do Bob não estiver já aberta, abra-a clicando no ícone do Bob ao lado da barra de navegação ou use o atalho Option + Command + B (Mac) ou Ctrl + Alt + B (Windows).

Painel de chat do Bob aberto no IBM Bob IDE

Use o modo Agent para que o Bob possa escrever e modificar código, executar comandos Git e guiá-lo pelo workflow. O Bob ainda pede permissão antes de cada operação, a menos que seja explicitamente permitido.

Clique no menu suspenso do seletor de modo no chat agente e selecione Agent, ou digite /agent no chat.

Criar um branch

Antes de fazer mudanças, crie um branch de feature para que seu trabalho fique separado do main.

Execute o seguinte prompt:

Crie e mude para um novo branch chamado update-header.

O Bob solicita permissão para executar git checkout -b update-header.

Clique em Aprovar para a tarefa para criar o branch e mudar para ele.

Fazer uma mudança de código

Faça uma pequena mudança para que o Bob tenha algo para commitar.

Abrir o componente Header

No codebase do Galaxium Travels, abra booking_system_frontend/src/components/layout/Header.tsx.

Editar o texto do header

Peça ao Bob para fazer a mudança de Galaxium Travels para Galaxium Travel Agency. O prefixo @ adiciona um arquivo ao contexto do Bob para que ele saiba exatamente qual arquivo editar.

Mude o nome do Header de `Galaxium Travels` para `Galaxium Travel Agency`
em @booking_system_frontend/src/components/layout/Header.tsx

Alternativamente, você pode editar manualmente o arquivo e mudar Galaxium Travels para Galaxium Travel Agency.

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

Executar o workflow Git

Use o Bob para preparar, commitar, fazer push das suas mudanças e depois abrir um pull request.

Preparar suas mudanças

Execute o seguinte prompt para preparar suas mudanças:

Prepare todas as mudanças que fiz para a atualização do componente header.

O Bob inspeciona a árvore de trabalho, identifica os arquivos modificados e solicita permissão para executar git add.

Clique em Aprovar para a tarefa para permitir que o Bob execute o comando.

Commitar suas mudanças

Execute o seguinte prompt para commitar as mudanças preparadas:

Commite as mudanças preparadas com uma mensagem de commit descritiva que resuma o que foi adicionado.

O Bob revisa o diff preparado e gera uma mensagem de commit que descreve o propósito e o escopo das mudanças.

O Bob exibe um prompt de permissão no IDE para executar comandos.

Clique em Entendo os riscos e depois clique em Aprovar para que o Bob possa executar git commit.

Fazer push das mudanças

Execute o seguinte prompt para fazer push do seu commit para o repositório remoto:

Faça push das minhas mudanças para o repositório remoto.

O Bob identifica o branch atual e o remoto, depois solicita permissão para executar git push.

Clique em Aprovar para a tarefa para fazer push do commit. O Bob confirma no histórico do chat que o push foi bem-sucedido.

Abrir um pull request

Execute o seguinte prompt para criar um pull request:

Crie um pull request para mergear minhas mudanças no branch main. Escreva um título e uma descrição claros com base no que foi mudado.

O Bob requer autenticação do GitHub na primeira vez que você cria um pull request. O Bob abre uma janela do navegador para você autorizar o acesso. Após autorizar, o Bob abre o pull request. Clique no link fornecido para acessar o pull request no seu navegador. Após revisar o título e a descrição, clique em Criar pull request.

O Bob retorna a URL do pull request para que você possa revisá-lo, compartilhá-lo ou mergeá-lo diretamente do seu navegador.

Para que o Bob crie pull requests sem uma janela de confirmação, instale o GitHub CLI e peça ao Bob que o use para criar pull requests.

Solução de problemas

Push rejeitado ou autenticação falhou: Confirme que o Git está configurado com credenciais que podem fazer push para seu fork.

Branch update-header já existe: Peça ao Bob para mudar para o branch existente ou escolha outro nome de branch.

Pull request aponta para IBM/galaxium-travels: Mude o repositório base para seu fork antes de criar o pull request.

Limpeza

Após concluir este tutorial, você pode remover os recursos que criou:

Mude seu clone local de volta para o branch main.

Feche ou mergea o pull request no GitHub.

Exclua o branch update-header do seu fork.

Exclua seu fork do Galaxium Travels se não precisar mais dele.

Próximos passos

Neste tutorial, você aprendeu a usar a integração Git nativa do Bob para gerenciar suas mudanças de código sem sair do IDE.

Avance para Padronizar o comportamento do Bob para aprender a definir regras persistentes que controlam o comportamento do Bob em cada conversa e modo.

Criar um commit e pull request com Bob