- Descargar los sistemas
- Configuración del fichero hosts
- Ejecutar Docker Compose del sistema de ayuda
- Ejecutar el frontend
- Ejecutar el backend
- Añade datos del SIU en el panel de administración
- Añadir una edición con el año actual
- Listo
- Pruebas
Disclaimer inicial:
Al acceder a la página en desarrollo hosteada localmente, aparecerá un aviso de que se están usando certificados autofirmados (self-signed certificates). Esto es normal en entornos locales.
 |
|
-
Backend
Clona la repo del backend:git clone git@github.com:DA-ETSIINF/tryit-frontend.git
Recuerda que necesitas tener acceso permitido a este repositorios
-
Frontend
Clona la repo del frontend:
git clone git@github.com:DA-ETSIINF/tryit-backend.git
Recuerda que necesitas tener acceso permitido a este repositorios
-
Sistema de ayuda (este sistema) Clona la repo de este sistema:
git clone <ENLACE_REPO_DE_AYUDA>
Este paso es opcional y no es necesario para el desarollo de la aplicación. Solo es necesario si no quieres conectar el frontend con el backend por tu cuenta y hacer que el SIU funcione en local por tu cuenta.
Para poder acceder al sistema usando el alias tryit.upm.es, hay que añadir la siguiente línea al fichero hosts:
127.0.0.1 tryit.upm.es
Abre el fichero hosts del sistema:
sudo nano /etc/hostsAñade la línea 127.0.0.1 tryit.upm.es y guarda (Ctrl+O, Enter, Ctrl+X).
Abre Bloc de notas como administrador.
Abre el fichero C:\Windows\System32\drivers\etc\hosts
Añade la línea 127.0.0.1 tryit.upm.es y guarda.
Si esta parte falla (tryit.upm.es no apunta a localhost) asegurate de que se haya guardado bien el fichero y que lo editaste con permisos de administrador
Tras realizar este paso se recomienda realizar la prueba Prueba 9.3: tryit.upm.es Apunta a Localhost, ya que si esto falla no va a funcionar el sistema.
Disclaimer: Para acceder a la página real de tryit.upm.es después de hacer este paso, hay que eliminar o comentar esta línea del fichero hosts.
Este paso no es necesario para el funcionamiento del sistema. Solo sirve para que la página de admin y del api root del backend se vea mejor.
Imagenes con y sin esta configuración:
 |
 |
 |
 |
En el docker-compose.yml hay una ruta a ficheros estáticos que puede necesitar edición según dónde hayas descargado el backend:
volumes:
- ../tryit-backend/tryit/static:/usr/share/nginx/static:roActualmente está configurado asumiendo que tienes el backend y el sistema de ayuda clonados en la misma carpeta.
Cambia esa ruta para que apunte al repositorio del backend en tu sistema de ficheros.
Este paso hace que tryit.upm.es no solo apunte a localhost, sinó que apunte a las partes del sistema del tryit. Así se conecta también el frontend y el backend.
Ejecuta el docker compose de este repositorio:
docker-compose up -dDisclaimer importante:
Los puertos 80 y 443 deben estar libres.
Desde la carpeta del frontend:
npm install
npm run dev
docker-compose up -ddocker exec -it tryit-backend-web-1 python manage.py migrate
docker exec -it tryit-backend-web-1 python manage.py import_upm_schools
docker exec -it tryit-backend-web-1 python manage.py createsuperuserAl final del ultimo comando vas a tener que intriducir datos para tu superusuario. Introduce el nombre de usuario y contraseña que prefieras. El correo se puede dejar en blanco.
Con este perfil accederás luego a la pagina de administrador del backend.
Abre el navegador en:
Inicia sesión con el usuario creado en el paso anterior.
Disclaimer: Si olvidas la contraseña, ejecuta de nuevo el comando createsuperuser del paso anterior para crear un nuevo usuario.
Añade una instancia de Socialaplication con
- Provider: Keylocak
- Provider ID: Keycloak
- nombre: SIU
- Client id: Llave proporcionada por el coordinador web
- Secret key: Otra llave proporcionada por el coordinador web
- Key: La Secret Key
En la imagen falta el client id, secret key y key. Estos serán proporcionados por el coordinador web.
Para que el frontend conecte correctamente con el backend tiene que haber una instancia de Edition para el año actual.
Si no existe ninguna edición para el año actual crea una. Para propositos de desarollo el único campo importante es
- Year: Año actual
Si sigue habiendo un error a la hora de realizar peticiones entre el frontend y el backend revisa para que año está configurado el frontend. Eso se puede revisar en nuxt.config.ts del frontend:
env: {
dev: process.env.NODE_ENV !== "production",
//api: "https://api.congresotryit.es",
api: "https://tryit.upm.es",
edition: 2025
},
El sistema de desarrollo debería estar completamente funcional y accesible mediante https://tryit.upm.es.
A continuación se van a explicar varias pruebas que se pueden realizar para comprobar que se ha deployeado el sistema correctamente.
Revisa que el backend no mande un error al frontend cuando le pida información de la edición actual.
Para hacer eso entra en la pestaña de 📅Horarios y mira si hay un error.
| Problema en la configuración | Sin problema en la configuración |
|---|---|
 |
 |
DISCLAIMER IMPORTANTE: Si salta el error prueba realizar la prueba en NAVEGACIÓN PRIVADA. A veces se queda guardado en el navegador una mala configuración a pesar de que luego se haya creado la edición para el año actual.
Si sigue saliendo el error revisa el paso Paso 7. Asegurate de que existe una edición para el año para el cual está configurado el frontend.
Si quieres revisar si existe abre la consola pulsando F12, pulsa el botón de Reintentar y revisa en el apartado de red a que dirección está mandando la petición.
Copia esa dirección y ponla en otra pestaña del buscador. Si sale un error 404 es que no existe una edición para ese año. Si devuelve un 200 OK si existe una edición para ese año y el error es otro.
Primera imagen: pestaña de red para ver url de petición. Segunda imagen: API root tras pegar la dirección en un buscador. Devuelve 200 OK.
 |
 |
Si salta un error en la pagina pero en la API root devuelve un 200 OK recuerda intentar acceder a la página en navegación privada!
Para revisar que el SIU está correctamente configurado, y por lo tanto que podrás realizar pruebas con perfiles de verdad, haz la siguiente prueba.
Inicia sesión con el SIU. Para esto hay que hacer click en el apartado de Iniciar Sesión y seleccionar Usuario UPM.
Esto te redirigirá al SIU de la UPM (la página con la que inicias sesión en Moodle). Pon tus datos e inicia sesión. Tus datos de inicio de sisión NO serán guardados en nuestro sistema, así que no hay que preocuparse de eso.
Después de eso te debería de redirigir a la homepage del tryit. En vez de Iniciar sesión el apartado se debería de llamar Logout y debería de haber aparecido un pequeño pop up naranja momentaneo si es la primera vez que inicias sesión y todavía no te has sacado entrada.
Si no ha ocurrido esto, esta es una lista de errores que puede ocurrir:
Si cuando le das al botón de lógin no te redirigue a la página del SIU, sino que te redirige a una página de error como esta:
Entonces tienes una mala configuración del SIU. Vete a La página de administración y revisa que exista el SIU como especificado en el paso Paso 6.. Si existe el SIU asegurate de que las claves/llaves sean correctas.
DISCLAIMER!: Si te sale este error y crees que tienes la configuración bien recuerda realizar la prueba en NAVEGACIÓN PRIVADA!
Si cuando le das al botón de login redirigue correctamente al SIU, pero trás iniciar sesión ahi te redirige a la página de error mostrada en el paso anterior en vez de a la homepage o una pagina de error blanca donde pone Cannot GET /login:
Prueba ejecutar la prueba en navegación privada. Si sigue fallando pide ayuda al coordinador web para asegurarte de que el entorno de desarollo se está ejecutando en target server y no target static.
Revisa el paso Paso 4.. Asegurate que al ejecutar
npm run devSaliera el texto
cross-env NUXT_MODE=server nuxt --hostname=0.0.0.0
al principió del proceso de construcción del frontend.
Si no sale asegurate que tienes la versión más nueva del frontend. Comprueba en package.json, en la sección de scripts, que el texto anterior sea el comando de dev
"scripts": {
"dev": "cross-env NUXT_MODE=server nuxt --hostname 0.0.0.0",
"build": "nuxt build",
"start": "nuxt start",
"generate": "nuxt generate"
},Se recomienda ejecutar esta prueba tras el paso Paso 2..
Para comprobar que se ha realizado exitosamente la generación del alias de tryit.upm.es a localhost abre una terminal nueva y ejecuta el siguiente comando:
ping tryit.upm.esDebería de devolver lo siguiente:
PS C:\Users\YourUser> ping tryit.upm.es
Pinging tryit.upm.es [127.0.0.1] with 32 bytes of data:
Reply from 127.0.0.1: bytes=32 time<1ms TTL=128
Reply from 127.0.0.1: bytes=32 time<1ms TTL=128
Reply from 127.0.0.1: bytes=32 time<1ms TTL=128
Reply from 127.0.0.1: bytes=32 time<1ms TTL=128
Ping statistics for 127.0.0.1:
Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
Minimum = 0ms, Maximum = 0ms, Average = 0msEs importante que ponga Reply from 127.0.0.1 y no otra IP.
Si pone otra dirección IP prueba ejecutar las siguienes instrucciones:
ipconfig /flushdnssudo systemd-resolve --flush-caches
# or
sudo /etc/init.d/nscd restartsudo dscacheutil -flushcache
sudo killall -HUP mDNSResponderEsto ocurre porque a veces el sistema cachea busquedas previas.
Si sigue ocurriendo el error asegurate de que has realizado bien el paso Paso 2. y que la linea del alias no está comentada.
9.4 tryit.upm.es o tryit.upm.es/admin o tryit.upm.es/api devuelven 502 Bad Gateway o un Unable to conect
Si al intentar acceder a cualquier parte del sistema recibes un Unable to conect revisa que el contenedor nginx de este sistema de ayuda este ejecutando correctamente:
Recuerda que para que pueda ejecutarse correctamente necesita que los puertos 80 y 443 estén libres en el momento de ejecutar el docker compose up -d.
Para revisar que el contenedor esté ejecutando puedes usar el siguiente comando:
docker ps -aEste comando te enseña todos los contenedores que tienes levantados. Busca el contenedor de este sistema de ayuda (tendrá un nombre similar a setup-nginx-1) y mira su estado. Debería de ser Up. Si es otra cosa (Stopped o Exited) prueba levantarlo sin la flag -d y con la flag --build
docker compose up --buildy comprueba que error lanza.
Si funciona después de esto usa Ctrl+C y vuelve a ejecutar
docker compose up -d Si al intentar acceder al frontend o a alguna parte del backend te devuelve un 502 Bad Gateway:
Comprueba que los sistemas estén corriendo.
En el navegador intenta acceder a http://localhost:8000 y http://localhost:8050 para comprobar la ejecución del backend y el frontend respectivamente.
Si alguno falla intenta levantarlo. Mira los pasos Paso 4 y Paso 5. Para diagnosticar errores al levantar el backend usa los comandos del paso anterior.