✒️SAP BTPFIORI / La conexión al GitHub mediante la terminal en el BAS Por Jose Baz Suarez

La conexión al GitHub mediante la terminal en el BAS

---

1. Introducción

SAP Business Application Studio (BAS) es el entorno de desarrollo basado en la nube de SAP, diseñado especialmente para la creación de aplicaciones SAPUI5, Fiori y extensiones de SAP S/4HANA.
Dentro de este entorno, el uso de Git está completamente integrado y permite gestionar proyectos mediante la línea de comandos (terminal) o la interfaz visual de control de versiones.

La conexión entre BAS y GitHub permite sincronizar los proyectos locales del espacio de trabajo en la nube con los repositorios remotos alojados en GitHub.
Este proceso asegura que el código esté respaldado, versionado y disponible para otros desarrolladores del equipo.

---

2. Requisitos previos

Antes de establecer la conexión entre BAS y GitHub, es necesario cumplir los siguientes requisitos:

1. Tener una cuenta activa en GitHub.

2. Contar con un espacio de desarrollo activo dentro de BAS.

3. Tener Git configurado en BAS (ya viene preinstalado).

4. Disponer de las credenciales o token de acceso personal (PAT) de GitHub, ya que desde 2021 GitHub no permite autenticación con contraseña.

---

3. Configuración inicial en BAS

Al abrir el entorno BAS, el desarrollador puede verificar si Git está disponible ejecutando el siguiente comando en la terminal:

Este comando mostrará la versión instalada de Git.
A continuación, se deben configurar las credenciales del usuario que se utilizarán para registrar los commits:

Estas configuraciones identifican al autor de cada cambio realizado en el proyecto.

---

4. Conexión del proyecto con GitHub

Para conectar un proyecto SAPUI5 en BAS con un repositorio de GitHub, se siguen los siguientes pasos:

1. Inicializar el repositorio local en el proyecto:

   git init

2. Agregar todos los archivos al área de preparación (staging area):

   git add .

3. Realizar el primer commit:

   git commit -m "Primer commit del proyecto SAPUI5"

4. Conectar el repositorio local con el remoto de GitHub:

   git remote add origin https://github.com/usuario/nombre-repositorio.git

5. Subir los cambios iniciales al repositorio remoto:

   git push -u origin main

Con esto, el proyecto SAPUI5 queda vinculado entre BAS y GitHub.

---

5. Autenticación mediante token personal (PAT)

Al ejecutar por primera vez un comando git push o git pull, BAS solicitará las credenciales de acceso.
Desde 2021, GitHub requiere autenticación mediante token personal (PAT), que reemplaza el uso de contraseñas.

Pasos para generar un token en GitHub:

1. Acceder a GitHub → Settings → Developer Settings → Personal Access Tokens.

2. Crear un nuevo token con los permisos necesarios (repo, workflow, admin:repo_hook, etc.).

3. Copiar el token generado (solo se muestra una vez).

4. En BAS, cuando se solicite usuario y contraseña:

   • Usuario: tu usuario de GitHub.

   • Contraseña: el token generado.

De esta forma, el entorno BAS queda autenticado para interactuar con el repositorio remoto.

---

6. Verificación de la conexión

Para comprobar que el proyecto está correctamente conectado con el repositorio remoto se puede ejecutar:

Este comando mostrará la URL asociada al repositorio de GitHub (por ejemplo, origin https://github.com/usuario/proyecto.git).

Si la conexión está activa, los comandos git push, git pull y git fetch funcionarán correctamente, permitiendo sincronizar los cambios entre BAS y GitHub.

---

7. Sincronización de cambios

Una vez establecida la conexión, el flujo de trabajo habitual es:

1. Modificar el código del proyecto en BAS.

2. Verificar los cambios con git status.

3. Agregar los archivos al staging area:

   git add .

4. Confirmar los cambios:

   git commit -m "Descripción del cambio realizado"

5. Subir las actualizaciones al repositorio remoto:

   git push

6. Traer cambios remotos realizados por otros colaboradores:

   git pull

Este flujo garantiza que el repositorio remoto y el local estén siempre sincronizados.

---

8. Solución de errores comunes

• Error de autenticación: verificar que el token de GitHub sea válido y que no haya expirado.

• Permiso denegado: comprobar que la URL del repositorio esté correctamente configurada (HTTPS o SSH).

• Conflictos de fusión: pueden resolverse en BAS utilizando la interfaz visual de comparación de archivos (merge tool).

• Error en la rama: asegurarse de estar trabajando en la rama correcta (main o master).

---

9. Buenas prácticas al conectar BAS con GitHub

• Usar nombres de repositorios claros y descriptivos.

• Realizar commits frecuentes con mensajes precisos.

• No subir archivos binarios o de configuración del entorno BAS.

• Usar .gitignore para excluir archivos temporales o carpetas como node_modules.

• Sincronizar el código al final de cada sesión de trabajo.

• Renovar el token de GitHub periódicamente (cada 6 o 12 meses según su configuración).

---

10. Conclusión

La conexión de SAP Business Application Studio con GitHub mediante la terminal es un proceso simple pero fundamental para el desarrollo profesional de aplicaciones SAPUI5.
Permite integrar el control de versiones, la colaboración en equipo y la trazabilidad de los cambios directamente dentro del entorno de desarrollo en la nube, garantizando seguridad, respaldo y eficiencia.

---

Preguntas de repaso

1. ¿Qué comando se utiliza para inicializar un repositorio Git en un proyecto SAPUI5 dentro del BAS?
   git init

2. ¿Qué comando sirve para asociar el repositorio local con el remoto de GitHub?
   git remote add origin <URL-del-repositorio>

3. ¿Qué tipo de autenticación reemplazó al uso de contraseñas simples en GitHub?
   El uso de Personal Access Token (PAT).

4. ¿Qué comando permite verificar la conexión con el repositorio remoto?
   git remote -v

5. ¿Qué comando se utiliza para subir los cambios locales al repositorio remoto?
   git push

6. ¿Qué comando se utiliza para obtener y fusionar los cambios remotos?
   git pull

7. ¿Dónde se configura el nombre y correo del usuario de Git?
   Mediante los comandos git config --global user.name y git config --global user.email.

8. ¿Cuál es una buena práctica al trabajar con GitHub desde BAS?
   Realizar commits frecuentes, usar .gitignore para excluir archivos innecesarios y sincronizar el código regularmente.