Para hacer un pull request en AWS CodeCommit, debes seguir algunos pasos para asegurarte de que tus cambios puedan ser revisados y eventualmente unidos al repositorio principal. Aquí te detallo un proceso paso a paso:
Crear una rama de feature o corrección: Antes de empezar a trabajar en tus cambios, es una buena práctica crear una nueva rama en tu repositorio local. Esto te permite aislar tus cambios del resto del código. Puedes hacer esto con el comando:
git checkout -b username-feature-or-fix
# Example: git checkout -b leader-cart
Hacer tus cambios: Realiza las modificaciones, añadidos o eliminaciones en tu código localmente en esta nueva rama.
Comprometer los cambios: Una vez que hayas realizado tus cambios, debes "comprometerlos" (commit) en tu rama local. Esto se hace en dos pasos: primero agregas los archivos modificados al área de preparación con git add y luego haces un commit:
# step 1:
git add .
# step 2:
git commit -m "feat(scope): :gitemoji_name: Title" -m "Short description" -m "Long description" -m "footer notes (BRACKING CHANGE or affected files)"
# Example: git commit -m "feat(cart): :sparkles: New Cart Product"
-
Note: Visitar https://gitmoji.dev/ para encontrar todos los emojis como estos:
- 🎨 (:art:) - Mejora la estructura/formato del código.
- ⚡️ (:zap:) - Mejora el rendimiento.
- 🐛 (:bug:) - Corrige un error.
- 🚑️ (:ambulance:) - Corrección urgente de un bug crítico.
- ✨ (:sparkles:) - Introduce nuevas características.
- 📝 (:memo:) - Añade o actualiza la documentación.
- 🚀 (:rocket:) - Implementa una nueva funcionalidad.
- 💄 (:lipstick:) - Actualiza la interfaz y el estilo del frontend.
Publicar la rama en el repositorio remoto: Para que otros puedan ver tu rama, necesitas publicarla en CodeCommit:
git push --set-upstream origin user-branch-name
# Example: git push --set-upstream origin leader-cart
Crear el pull request: Ahora que tu rama está en el repositorio remoto, puedes crear un pull request. Esto NO SE HACE desde la línea de comandos, sino desde la interfaz de usuario de AWS CodeCommit:
- Ve al repositorio en AWS CodeCommit.
- Selecciona la opción de "Pull requests" en el menú lateral.
- Haz clic en "Create pull request".
- Selecciona tu rama y la rama hacia la que quieres que se mezclen tus cambios (normalmente la rama principal se llama master o main).
- Proporciona un título y descripción para tu pull request.
- Puedes revisar tus cambios y, si todo está correcto, hacer clic en "Create" para crear el pull request.
- Revisión y fusión del pull request: Una vez creado el pull request, otros miembros de tu equipo o revisores designados pueden comentar, solicitar cambios o aprobar los cambios. El proceso específico puede variar según la organización. Una vez que el pull request ha sido aprobado, se puede fusionar con la rama destino.
Nota: Es importante recordar que los detalles de la interfaz de usuario pueden cambiar con el tiempo, por lo que si encuentras alguna diferencia, puede ser útil consultar la documentación actualizada de AWS CodeCommit.
Una vez que tus cambios han sido fusionados, es una buena práctica eliminar la rama para mantener limpio el repositorio, tanto en tu entorno local como en el remoto. Aquí te explico cómo hacerlo:
- Eliminar la rama localmente Para eliminar la rama en tu repositorio local, primero debes asegurarte de no estar en la rama que deseas eliminar. Puedes cambiar a otra rama, como la principal o master, usando el siguiente comando:
git checkout main
O si tu rama principal se llama master:
git checkout master
- Una vez que estás en otra rama, puedes eliminar la rama local con el siguiente comando:
git branch -d user-branch-name
# Example: git branch -d leader-cart
Usa -d para asegurarte de que solo se eliminen las ramas que han sido completamente fusionadas en la rama en la que te encuentras. Si necesitas forzar la eliminación de una rama (lo cual se debe hacer con cuidado), puedes usar -D en lugar de -d.
- Eliminar la rama remotamente Para eliminar la rama del repositorio remoto en AWS CodeCommit, necesitas usar el siguiente comando:
git push origin --delete user-branch-name
# Example: git push origin --delete leader-cart
Este comando le indica a Git que elimine la rama específica en el repositorio remoto. origin es el nombre convencional del repositorio remoto, pero podrías tener un nombre diferente si configuraste tu repositorio de esa manera.
Al seguir estos pasos, te asegurarás de mantener tu repositorio tanto local como remoto organizado y libre de ramas que ya no son necesarias.