Tutoriales

Crear un commit y pull request con Bob

Usa Bob para crear un branch, preparar cambios, generar un mensaje de commit, hacer push a tu repositorio y abrir un pull request.

Bob tiene soporte integrado para el control de versiones Git y te permite gestionar los cambios en tu código sin salir del IDE.

En este tutorial, usas Bob para crear un branch, preparar cambios de código, generar un mensaje de commit descriptivo, hacer push de los cambios a tu repositorio y abrir un pull request que puedes revisar y mergear.

Requisitos previos

Configurar el proyecto

Prepara una copia de trabajo del repositorio.

Hacer fork del repositorio

Trabajarás desde un fork del repositorio Galaxium Travels.

  1. Ve al repositorio Galaxium Travels en GitHub.
  2. Haz clic en el botón Fork en la esquina superior derecha de la página.
  3. Selecciona tu cuenta de GitHub como propietario del fork.

Para obtener más información sobre cómo hacer fork de un repositorio, consulta la documentación de GitHub sobre cómo hacer fork de un repositorio.

Clonar el repositorio

  1. En una terminal, clona el repositorio Galaxium Travels del que hiciste fork. Reemplaza <your-id> con tu nombre de usuario de GitHub en el siguiente comando:

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

Si obtienes un error de autenticación, asegúrate de haber agregado tu clave SSH al ssh-agent. Consulta la documentación de GitHub para obtener más información.

  1. En Bob, haz clic en Archivo y luego en Abrir carpeta.

  2. Navega al directorio galaxium-travels que acabas de clonar y ábrelo.

Cambiar al modo Agent

Si la interfaz de chat de Bob no está ya abierta, ábrela haciendo clic en el ícono de Bob junto a la barra de navegación o usa el atajo Option + Command + B (Mac) o Ctrl + Alt + B (Windows).

Panel de chat de Bob abierto en IBM Bob IDE

Usa el modo Agent para que Bob pueda escribir y modificar código, ejecutar comandos Git y guiarte a través del flujo de trabajo. Bob aún pide permiso antes de cada operación a menos que se le permita explícitamente.

Haz clic en el selector de modo desplegable en el chat agéntico y selecciona Agent, o escribe /agent en el chat.

Crear un branch

Antes de hacer cambios, crea un branch de feature para que tu trabajo permanezca separado de main.

Ejecuta el siguiente prompt:

Crea y cambia a un nuevo branch llamado update-header.

Bob solicita permiso para ejecutar git checkout -b update-header.

Haz clic en Aprobar para la tarea para crear el branch y cambiar a él.

Hacer un cambio de código

Haz un pequeño cambio para que Bob tenga algo que commitear.

Abrir el componente Header

En el codebase de Galaxium Travels, abre booking_system_frontend/src/components/layout/Header.tsx.

Editar el texto del header

Pide a Bob que haga el cambio de Galaxium Travels a Galaxium Travel Agency. El prefijo @ agrega un archivo al contexto de Bob para que sepa exactamente qué archivo editar.

Cambia el nombre del Header de `Galaxium Travels` a `Galaxium Travel Agency`
en @booking_system_frontend/src/components/layout/Header.tsx

Alternativamente, puedes editar manualmente el archivo y cambiar Galaxium Travels a Galaxium Travel Agency.

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

Ejecutar el flujo de trabajo de Git

Usa Bob para preparar, commitear, hacer push de tus cambios y luego abrir un pull request.

Preparar tus cambios

Ejecuta el siguiente prompt para preparar tus cambios:

Prepara todos los cambios que hice para la actualización del componente header.

Bob inspecciona el árbol de trabajo, identifica los archivos modificados y solicita permiso para ejecutar git add.

Haz clic en Aprobar para la tarea para permitir que Bob ejecute el comando.

Commitear tus cambios

Ejecuta el siguiente prompt para commitear los cambios preparados:

Commitea los cambios preparados con un mensaje de commit descriptivo que resuma lo que se agregó.

Bob revisa el diff preparado y genera un mensaje de commit que describe el propósito y el alcance de los cambios.

Bob muestra un prompt de permiso en el IDE para ejecutar comandos.

Haz clic en Entiendo los riesgos y luego en Aprobar para que Bob pueda ejecutar git commit.

Hacer push de los cambios

Ejecuta el siguiente prompt para hacer push de tu commit al repositorio remoto:

Haz push de mis cambios al repositorio remoto.

Bob identifica el branch actual y el remoto, luego solicita permiso para ejecutar git push.

Haz clic en Aprobar para la tarea para hacer push del commit. Bob confirma en el historial del chat que el push fue exitoso.

Abrir un pull request

Ejecuta el siguiente prompt para crear un pull request:

Crea un pull request para mergear mis cambios en el branch main. Escribe un título y una descripción claros basados en lo que se cambió.

Bob requiere autenticación de GitHub la primera vez que creas un pull request. Bob abre una ventana del navegador para que autorices el acceso. Una vez que lo autorices, Bob abre el pull request. Haz clic en el enlace proporcionado para acceder al pull request en tu navegador. Después de revisar el título y la descripción, haz clic en Crear pull request.

Bob devuelve la URL del pull request para que puedas revisarlo, compartirlo o mergearlo directamente desde tu navegador.

Para que Bob cree pull requests sin una ventana de confirmación, instala el GitHub CLI y pide a Bob que lo use para crear pull requests.

Solución de problemas

  • Push rechazado o autenticación fallida: Confirma que Git está configurado con credenciales que pueden hacer push a tu fork.
  • El branch update-header ya existe: Pide a Bob que cambie al branch existente o elige otro nombre de branch.
  • El pull request apunta a IBM/galaxium-travels: Cambia el repositorio base a tu fork antes de crear el pull request.

Limpiar

Después de completar este tutorial, puedes eliminar los recursos que creaste:

  • Cambia tu clon local de vuelta al branch main.
  • Cierra o mergea el pull request en GitHub.
  • Elimina el branch update-header de tu fork.
  • Elimina tu fork de Galaxium Travels si ya no lo necesitas.

Próximos pasos

En este tutorial, aprendiste a usar la integración nativa de Git de Bob para gestionar tus cambios de código sin salir del IDE.

Avanza a Estandarizar el comportamiento de Bob para aprender a definir reglas persistentes que controlen el comportamiento de Bob en cada conversación y modo.

¿Cómo es este tema?