WebAppTemplate FARM

Modèle d'application Web Full Stack - FARM Stack

Ce référentiel contient un modèle d'application Web complète qui s'exécute sur la pile de solutions FARM, qui signifie :

• F lask, un framework Web backend Python .
• Un Amazon Web Services, un service cloud pouvant héberger des logiciels.
• React , un framework Web JavaScript frontal.
• M ySQL, un système de gestion de bases de données relationnelles.

Qu’est-ce que la FERME ?

La pile FARM est plus ou moins une extension de la pile LAMP avec ces changements notables :

• Le framework middleware est explicite (Flask)
• Comme la stack MEAN, elle inclut une couche de présentation des applications (React)
• L'environnement sur lequel le logiciel s'exécute est remplacé par des services de cloud computing PaaS/IaaS (AWS).
• Il n'y a pas d'opinion sur le système d'exploitation à utiliser

Ballon

Flask est utilisé pour écrire les API/middleware Web qui peuvent communiquer entre l'interface utilisateur Web et le backend/base de données Web. Il s’agit du cœur de l’ensemble de l’application qui rassemble les éléments de l’application full stack.

Notez que ce modèle particulier n'utilise pas d'ORM, mais utilise à la place le module pymysql . Cela signifie que les développeurs doivent écrire des requêtes SQL, mais peuvent maximiser la complexité des requêtes dont ils ont besoin pour exécuter sur la base de données.

Services Web Amazon

AWS est le service cloud sur lequel l'application peut être hébergée. Nous pouvons héberger l’intégralité de la pile logicielle sur les services suivants :

• AWS Lambda pour l'hébergement de nos applications sur une infrastructure sans serveur. Nous pouvons également choisir d'héberger nos API Flask via Zappa, ce qui rend le déploiement en production extrêmement facile.
• AWS RDS pour l'hébergement de notre base de données.
• AWS S3 pour stocker toutes sortes d'autres objets comme des images et des fichiers.

Cela signifie que les développeurs peuvent tout conserver sur une seule plateforme et minimiser le travail DevOps/IT.

Réagir

React est le framework sur lequel s'exécute l'interface utilisateur Web. L'application React peut également être exécutée sur AWS Lambda avec NodeJS.

Ce modèle utilise JavaScript/JSX, mais TypeScript peut également être utilisé.

MySQL

MySQL est la base de données relationnelle utilisée par le backend Web. Celui-ci peut également être hébergé sur AWS via son service RDS.

Comment exécuter localement

Pour exécuter cette application Web, les opérations suivantes doivent être effectuées :

1. Configurer une instance MySQL locale à l'aide du schéma dans db/
2. Installer des modules pour l'API et l'interface utilisateur
3. Exécutez l'API et l'interface utilisateur localement

Configuration de la base de données

Pour configurer l'instance MySQL, procédez comme suit :

1. Créez et connectez-vous à une instance de base de données MySQL. Les moyens les plus courants de procéder sont d'utiliser MySQL Workbench ou mysql sur l'interface de ligne de commande Linux.
2. Exécutez sample.sql dans l'instance. Il créera un schéma appelé SampleInventory puis initialisera une table appelée Inventory .

Configuration de l'API

La base de code de l'API Flask se trouve dans le répertoire api/ .

Première installation (macOS)

1. Créez un environnement virtuel Python avec virtualenv farm-stack après avoir accédé à ce répertoire.
2. Activez-le avec source farm-stack/bin/activate
3. Accédez à api/ et exécutez pip3 install -r requirements.txt pour installer tous les modules Python nécessaires à l'API.
4. Ouvrez dbcreds.py dans le répertoire api/ et modifiez les informations d'identification de la base de données si nécessaire.

Exécuter l'API

1. Activez l'environnement virtuel par le haut.
2. Exécutez python3 app.py pour exécuter l'API sur http://localhost:8080 .

Configuration de l'interface utilisateur

La base de code de l'interface utilisateur de React se trouve dans le répertoire ui/ . Ce modèle utilise yarn comme gestionnaire de packages ; il est crucial que les développeurs ne mélangent pas d'autres gestionnaires de packages comme npm lors de l'ajout de nouveaux modules.

Notez que des packages comme react-bootstrap sont absents de ce modèle.

Première installation (macOS)

1. Exécutez yarn install pour installer toutes les dépendances requises.

Exécuter l'interface utilisateur

1. Exécutez yarn start pour s'exécuter en mode développement.
2. Accédez à http://localhost:3000 sur le navigateur.