Cómo instalar uno mismo una herramienta de notificación de defectos

Mark-a-Spot es una plataforma de código abierto para la monitorización de problemas ciudadanos y un servidor Open311 basado en el sistema de gestión de contenidos Drupal. El repositorio Github asociado ofrece una configuración Docker para facilitar el funcionamiento de Mark-a-Spot.

Primeros pasos

Esta guía le llevará a través de la configuración de un proyecto local Mark-a-Spot para fines de desarrollo y pruebas.

Requisitos previos

Para comenzar la instalación, necesitará

• Docker: Una plataforma para contenerizar aplicaciones.
• Docker Compose: Una herramienta para definir y ejecutar aplicaciones Docker multicontenedor.

Pasos de la instalación

1. Clonar el repositorio:
   El primer paso es clonar el repositorio y cambiar al directorio:

   
   git clone https://github.com/markaspot/mark-a-spot.git
   
   cd mark-a-spot
   
   

2. Iniciar los contenedores Docker:
   El siguiente comando inicializa los contenedores Docker y los inicia en segundo plano:

   
   docker-compose up -d
   
   

3. Ejecutar el script de inicio:
   El script start.sh inicializa la aplicación. Si hay problemas de permisos, el script debe hacerse ejecutable con el comando chmod a+x ./scripts/start.sh.
   ``bash
   docker exec -it markaspot ./scripts/start.sh

   El script ofrece dos opciones además de la elección de ubicación y país:
   
   - `-y`: Instalación automática con valores predefinidos (Nueva York, EE.UU.)
   
   - `-t`: Importa los archivos de traducción y activa la traducción de los términos.
   
   

Una vez ejecutado el script, se puede acceder a la aplicación en http://localhost. Tenga en cuenta que el script reinicia la base de datos e inicializa Mark-a-Spot desde cero. Por lo tanto, familiarícese con el proceso de desarrollo de Drupal.

Servicios Docker

La configuración de Docker Compose incluye

• web: El servidor web Nginx.
• markaspot: La aplicación Mark-a-Spot de Drupal.
• db: La base de datos MariaDB.
• phpmyadmin: PHPMyAdmin para la gestión de la base de datos.

Configuración

La configuración de los servicios Docker se puede ajustar en el fichero docker-compose.yml.

Uso

La aplicación Drupal es accesible en http://localhost.

PHPMyAdmin para la gestión de la base de datos se puede encontrar en http://localhost:8080.

Desarrollo con Docksal

Para el desarrollo local, se recomienda Docksal, un entorno de desarrollo basado en Docker.

Prerrequisitos

• Docksal
• Docker
• Docker Compose

Licencia

Mark-a-Spot está bajo la Licencia Pública General GNU, versión 2 o cualquier versión posterior.