You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2.5 KiB

Artimañas 2020

Este es el repositorio para el código del sitio web de Artimañas 2020.

Instrucciones para desarrollo

La aplicación web consiste de dos partes:

  1. CMS: Directus
  2. Componente de SSR (Server Side Rendering): Next.js

Configurando el entorno

Hay 3 variables de entorno que se deben configurar en el archivo .env, la primera corresponde a la contraseña de la base de datos de MySQL y las otras dos a la seguridad de Directus:

  • MYSQL_PASSWORD
  • DIRECTUS_AUTH_PUBLICKEY
  • DIRECTUS_AUTH_SECRETKEY

Estas pueden ser cualquier string, pero se deben asignar antes de crear los contenedores, y si se modifican posteriormente, los contenedores no funcionaran correctamente.

El script setup-env.sh permite generar valores para las variables de entorno automáticamente y crear e iniciar los contenedores de docker después de esto.

./setup-env.sh

CMS y base de datos

Directus depende de una base de datos SQL que se puede levantar usando Docker con el archivo de docker-compose provisto:

docker-compose up -d

Cuando el contenedor de la base de datos se cree por primera vez, la base de datos se inicializará con el dump que se encuentra en ./db/init.sql. Este contiene las tablas para las obras, biografías, e información general del sitio, así como los usuarios correspondientes a cada alumno de la materia. Para modificar los datos una vez iniciados los contenedores, se puede acceder a la interfaz web de directus en http://localhost:8080 con las siguientes credenciales:

  • Usuario: admin@artiweb.net
  • Contraseña: password

Eventualmente, este dump deberá ser actualizado con el contenido real/final, para que el entorno de desarrollo sea lo mas fiel posible con respecto al de producción. Esto se puede llevar a cabo con el script provisto en la raíz del repositorio (manage-db):

./manage-db.sh backup

Sitio web (front end)

Una vez que la base de datos haya sido inicializada, se puede iniciar el servidor de desarrollo (componente de SSR) con:

npm run dev

Los archivos en el directorio src se pueden editar y los cambios se verán reflejados en el navegador sin la necesidad de recargar la página.

Screencasts