WebAppTemplate FARM

Plantilla de aplicación web de pila completa - FARM Stack

Este repositorio contiene una plantilla de aplicación web de pila completa que se ejecuta en la pila de soluciones FARM, que significa:

• F lask, un marco web backend de Python .
• A mazon Web Services, un servicio en la nube que puede alojar software.
• R eact, un marco web frontend JavaScript .
• M ySQL, un sistema de gestión de bases de datos relacionales.

¿Qué es la GRANJA?

La pila FARM es más o menos una extensión de la pila LAMP con estos cambios notables:

• El marco de middleware es explícito (Flask)
• Al igual que la pila MEAN, incluye una capa de presentación de aplicaciones (React)
• El entorno en el que se ejecuta el software se sustituye por servicios de computación en la nube (AWS) PaaS/IaaS.
• No hay opinión sobre qué sistema operativo utilizar

Matraz

Flask se utiliza para escribir las API web/middleware que pueden comunicarse entre la interfaz de usuario web y el backend/base de datos web. Este es el núcleo de toda la aplicación que une las piezas de la aplicación de pila completa.

Tenga en cuenta que esta plantilla en particular no utiliza un ORM, sino que utiliza el módulo pymysql . Esto significa que los desarrolladores necesitan escribir consultas SQL, pero pueden maximizar la complejidad de las consultas que necesitan ejecutar en la base de datos.

Servicios web de Amazon

AWS es el servicio en la nube en el que se puede alojar la aplicación. Podemos alojar toda la pila de software en los siguientes servicios:

• AWS Lambda para alojar nuestras aplicaciones en una infraestructura sin servidor. También podemos optar por alojar nuestras API de Flask a través de Zappa, lo que facilita enormemente la implementación en producción.
• AWS RDS por alojar nuestra base de datos.
• AWS S3 para almacenar todo tipo de objetos como imágenes y archivos.

Esto significa que los desarrolladores pueden mantener todo en una plataforma y minimizar el trabajo de DevOps/TI.

Reaccionar

React es el marco en el que se ejecuta la interfaz de usuario web. La aplicación React también se puede ejecutar en AWS Lambda con NodeJS.

Esta plantilla utiliza JavaScript/JSX, pero también se puede utilizar TypeScript.

mysql

MySQL es la base de datos relacional que utiliza el backend web. Este también se puede alojar en AWS a través de su servicio RDS.

Cómo ejecutar localmente

Para ejecutar esta aplicación web, se debe hacer lo siguiente:

1. Configure una instancia local de MySQL usando el esquema en db/
2. Instalar módulos para la API y la UI
3. Ejecute la API y la UI localmente

Configuración de la base de datos

Para configurar la instancia de MySQL, siga estos pasos:

1. Cree y conéctese a una instancia de base de datos MySQL. Las formas más comunes de hacer esto son con MySQL Workbench o mysql en la interfaz de línea de comandos de Linux.
2. Ejecute sample.sql dentro de la instancia. Creará un esquema llamado SampleInventory y luego inicializará una tabla llamada Inventory .

Configuración de API

El código base para la API de Flask se puede encontrar en el directorio api/ .

Configuración por primera vez (macOS)

1. Cree un entorno virtual Python con virtualenv farm-stack después de navegar a ese directorio.
2. Actívalo con source farm-stack/bin/activate
3. Navegue hasta api/ y ejecute pip3 install -r requirements.txt para instalar todos los módulos de Python necesarios para la API.
4. Abra dbcreds.py en el directorio api/ y edite las credenciales de la base de datos según sea necesario.

Ejecutando la API

1. Activa el entorno virtual desde arriba.
2. Ejecute python3 app.py para ejecutar la API en http://localhost:8080 .

Configuración de la interfaz de usuario

El código base para la interfaz de usuario de React se puede encontrar en el directorio ui/ . Esta plantilla utiliza yarn como administrador de paquetes; Es fundamental que los desarrolladores no mezclen otros administradores de paquetes como npm al agregar nuevos módulos.

Tenga en cuenta que en esta plantilla faltan paquetes como react-bootstrap .

Configuración por primera vez (macOS)

1. Ejecute yarn install para instalar todas las dependencias necesarias.

Ejecutando la interfaz de usuario

1. Ejecute yarn start a ejecutarse en modo de desarrollo.
2. Navegue hasta http://localhost:3000 en el navegador.